其他 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 Code | uv | 用 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 菜单里隐藏。