其他 Agent

Claude Code 和 Codex 以外的 Agent 都经 Agent Client Protocol 接入;各类怎么安装、更新和设置。

Claude Code 和 Codex 以外的 Agent 都通过 Agent Client Protocol(ACP)接入。Agent 列表内置在 Kettu 里,跟着 ACP Registry,每个包的版本由 Kettu 定。列表以外的 Agent 加不进来。完整列表见首页。

各类怎么安装

类型例子你要准备的会怎样
npm 包Gemini CLI、GitHub Copilot、Qwen Code、Cline带 npm 的 Node.js,有的要 22 或更高版本点安装,包装进 Kettu 的数据目录,用你的 Node.js 运行
Python 包fast-agent、Minion Codeuv用 uvx 运行,第一次用时由它安装
发布压缩包Cursor、goose、Junie不用准备PATH 上有你自己的副本时优先用它;没有时点安装,把 ACP Registry 收录的压缩包下载到 Kettu 的数据目录
你自己的程序OpenCode、Hermes Agent按你的方式装好这个程序Kettu 以它的 ACP 模式启动,比如 opencode acp;OpenCode 的安装会列出厂商的装法

安装在设置 › Harness 里,列表里那个 Agent 旁边或者它的页面上都有。npm 包用你自己的 npm 安装,所以 .npmrc 里的镜像和代理照用。下载的压缩包,Registry 给了 SHA-256 时会核对。Pi 经适配器 pi-acp 运行,PATH 上还要有你自己的 pi,版本 0.81.0 或更高。

安装失败时,设置 › Harness 里它的页面会说明原因,可以重试。程序在 PATH 找不到的地方时,在它的页面上点选择可执行文件…。在自己的终端里装好东西后,点设置 › Harness 底部的重新加载环境。

更新

Kettu 每天在 npm 上查一次它装的包;点检查更新会马上查。点更新,新版本装在当前版本旁边:正在运行的会话不受影响,Agent 下次启动时用新版本;装不上也不影响现在的版本。Kettu 更新后要用某个包的新版本时,下次启动会装它;装不上就继续用旧版本。

压缩包、uvx 包和你自己装的程序,Kettu 不负责更新。你自己的程序按你装它的方式更新,再点重新加载环境。

两个设置页

设置 › Harness 里它的页面讲的是程序:

  • 版本,旁边是检查更新。
  • 程序:正在用的程序的路径和版本,可以选择可执行文件…或者重置。
  • Kettu 装的包:包名和版本,有更新时显示更新到。
  • 高级:启动命令和复制启动命令;Kettu 装的包还有重新安装(删掉 Kettu 装的这一份,重新安装),以及它运行用的 Node.js 版本。

设置 › Agent 里它的页面讲的是你用来干活的 Agent:Agent 报出时显示账号和邮箱,支持时有退出登录,报出限额时有套餐用量,还有 Kettu 知道的配置文件。

登录

要先登录的 Agent,会在 Agent 菜单和设置 › Agent 里它的页面上提示。要运行命令的登录方式有在终端中登录,Kettu 在自己的终端里运行它。由 Agent 自己完成的登录方式是一个按钮,名字照 Agent 给的。Agent 没说怎么登录时,在它自己的命令行里登录,再重试。

隐藏 Agent

只有 Claude Code 和 Codex 能有不止一个 Agent。其余每个都只有一个默认 Agent,不能删除。不想在 Agent 菜单里看到它,在设置 › Agent 里它的页面上打开在 Agent 菜单里隐藏。