AI Agent CLI 安装
本页是 repos/docs 中统一的 AI Agent CLI 本地安装入口。HagiCode 当前活跃支持 11 个 Agent CLI，顺序以后端 PrimaryProfessions 为准：Claude Code、Codex、GitHub Copilot、OpenCode、Hermes、QoderCLI、Kiro、Kimi、Gemini、DeepAgents、Codebuddy。
使用方式
先看下表确认某个 CLI 的当前状态与安装方式，再跳到对应官方文档完成安装、登录、ACP、权限与排错。重点是：是否支持，与是否支持一键安装，是两件事。
当前支持矩阵
| 工具 | 当前状态 | 安装方式 | 官方安装入口 | 官方参考入口 | 备注 |
|---|---|---|---|---|---|
| Claude Code | 当前支持 | 一键安装 | Getting Started | Overview | 默认一键安装路径。 |
| Codex | 当前支持 | 一键安装 | OpenAI Codex CLI repository | OpenAI Codex docs | 默认一键安装路径。 |
| GitHub Copilot | 当前支持 | 一键安装 | Install Copilot CLI | Copilot CLI overview | 默认一键安装路径。 |
| OpenCode | 当前支持 | 一键安装 | OpenCode CLI docs | OpenCode docs | 安装后通常还要补一次登录或 /connect。 |
| Hermes | 当前支持 | 手动安装 / 认证 | Hermes installation | Hermes quickstart | 当前支持，但需先完成本地安装与认证。 |
| QoderCLI | 当前支持 | 一键安装 | Qoder Quick Start | Qoder ACP | 安装后按官方流程完成登录。 |
| Kiro | 当前支持 | 一键安装 | Kiro Installation | Kiro Authentication, Kiro ACP | 官方安装器会在首轮启动时引导认证。 |
| Kimi | 当前支持 | 一键安装 | Kimi Getting Started | Kimi ACP Reference | 安装后按官方流程完成登录。 |
| Gemini | 当前支持 | 手动安装 / 认证 | Gemini CLI installation, execution, and releases | Gemini CLI authentication setup | 当前支持，但需先完成本地 CLI 安装与认证。 |
| DeepAgents | 当前支持 | 手动安装 / 认证 | DeepAgents CLI overview | DeepAgents ACP | 当前支持，但需先准备可用的 deepagents --acp。 |
| Codebuddy | 当前支持 | 一键安装 | CodeBuddy CLI Installation | CodeBuddy ACP | 默认一键安装路径。 |
状态说明
- 当前支持：属于 HagiCode 当前活跃支持范围，可在系统中作为现行 Agent CLI 使用。
- 一键安装：HagiCode 提供引导式安装入口；部分 CLI 安装后仍要按厂商流程继续登录或认证。
- 手动安装 / 认证：该 CLI 已在当前支持范围内，但需要你先完成本地安装、登录或认证，再回到 HagiCode 刷新可用状态。
- 历史兼容保留：
IFlowCli仅为旧数据兼容保留值，不属于当前活跃支持列表，也不应视为现行推荐项。
下一步建议
- 想先搭好基础环境，可继续阅读 安装 Node.js 与 安装 OpenSpec。
- 如果你想把多个 OpenAI 兼容工具统一接到同一个本地网关，可继续阅读 OmniRoute 安装与应用。
- 想了解整体安装路径，可返回 安装指南。
- 若你是从历史文章进入本站，请以本页和安装总览页的现行支持说明为准。