配置 agent
Kumo 不自带任何 CLI。这里是它能驱动的每个 agent，以及各自怎么装。
Kumo 不自带 agent，不替你安装，也不替你登录。应用里没有 OAuth 流程，也没有粘贴 API key 的输入框。下面每个 agent 都是你自己安装、自己登录的命令行工具，有没有 Kumo 都一样。你的模型、 MCP server、hook 和规则，都留在那个工具自己的配置里。
没有哪个 agent 是内定的。装了哪些，New Agent 菜单里就按你排的顺序列出哪些，在 Kumo 里用起来都一样。
全部 agent，按字母排序
命令来自各家厂商，在 2026 年 9 月 7 日是正确的。如果哪条变了，以链接页面为准。
| Agent | 安装 | 登录 |
|---|---|---|
| Claude | npm i -g @anthropic-ai/claude-code | 运行一次 claude，在浏览器里登录。 |
| Cline | npm i -g cline | 运行一次 cline，选一个 provider。 |
| Codex | npm i -g @openai/codex | codex login |
| Copilot | npm i -g @github/copilot | 运行一次 copilot，用 GitHub 登录。 |
| Cursor | curl https://cursor.com/install -fsS | bash | cursor-agent login |
| DeepSeek Harness | npm i -g @deepseek-ai/dsh | 自备 DeepSeek API key，详见它的文档。 |
| Gemini | npm i -g @google/gemini-cli | 运行一次 gemini，用 Google 登录。 |
| Goose | curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash | goose configure |
| Grok | curl -fsSL https://x.ai/cli/install.sh | bash | grok login |
| Hermes | curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash | hermes login |
| Kilo Code | npm i -g @kilocode/cli | 运行一次 kilo，选一个 provider。 |
| Kimi Code | curl -fsSL https://code.kimi.com/kimi-code/install.sh | bash | kimi login |
| OpenCode | npm i -g opencode-ai | opencode providers login |
| Pi | npm i -g @earendil-works/pi-coding-agent | 在环境变量里配好你自己的 provider key，详见它的文档。 |
| Qwen Code | npm i -g @qwen-code/qwen-code | 运行一次 qwen 并登录。 |
Claude 和 Codex 还多要一样东西，Kumo 已经替你做了
这两个自己不会说 Agent Client Protocol，所以 Kumo 把它们的官方 ACP 适配器打包进应用，用
node 跑。你还是要自己装 claude 和 codex；适配器驱动
的就是你装的那一份。
确认装好了
打开 Settings（⌘,）→ Agents。Kumo 能跑起来的 agent 会连版本号
一起列出，跑不起来的会置灰并显示 INSTALL 链接。公开额度的那几家（Claude、Codex、Cursor、Grok、
Kimi），同一行还会显示额度用了多少。
如果 agent 装了但 Kumo 起不来，Tab 会显示一条错误，写明是哪个 agent、去哪装，还有一个 Retry。如果能起来但把你拒了，那是登录问题：在终端里跑它的 CLI，登录，再重试。Kumo 从不保存 凭据。
顺序与默认 agent
在 Settings → Agents 里，取消勾选从不用的 agent 就能把它藏起来，其余的按住左边的把手拖成你想要的顺序。
+ 菜单就按这个顺序列，排第一的就是默认 agent，行尾标着 DEFAULT。
想换默认，把另一个拖到最上面即可。
agent 用 kumo spawn 再开一个 agent 却没指定 backend 时，用的也是这个默认值。见
多 agent 协作。
其他任何支持 ACP 的
Settings → Agents → CUSTOM AGENTS 需要填一个名字、一行命令，以及可选的环境变量。
只要通过 stdio 说 Agent Client Protocol 都能用，和 Zed 的 agent_servers 格式一样。
自定义 agent 和内置 agent 平级：可以隐藏、排序、设为默认、按对话选用。Kumo 只检查可执行文件是否存在，
不会真的运行命令去探测。
自定义 agent 没有 Kumo 为内置那几家准备的附加能力：没有可恢复的会话列表，也没有额度显示。 每个权限请求照样都会交给你。
GitHub
从 issue 和 PR 新建 Workspace，以及 Task 页上一切来自 GitHub 的东西，
都需要 gh CLI。Settings → Integrations 会显示它是否已安装并登录，
旁边的按钮会替你把 brew install gh 或 gh auth login --web 敲进侧栏终端。
Kumo 自己不存 GitHub token，它只是包了一层 gh，凭据留在 gh 的钥匙串条目里。