AI Agent CLI 安装

本页是 HagiCode 统一的 AI Agent CLI 本地安装入口。HagiCode 当前活跃支持 16 个 Agent CLI：Claude Code、Codex、GitHub Copilot、OpenCode、Hermes、QoderCLI、Kiro、Kimi、Gemini、DeepAgents、Codebuddy、Reasonix、Pi、OMP、Junie、DSH。

使用方式

先看下表确认某个 CLI 的当前状态与安装方式，再跳到对应官方文档完成安装、登录、ACP、权限与排错。重点是：是否支持，与是否支持一键安装，是两件事。

安装前先准备 Node.js 24+

多数支持一键安装的 CLI 依赖 Node.js 与 npm，Desktop 也会使用你系统里的 node 与 npm（Desktop 不再内置 Node.js）。请先按安装 Node.js 准备 24 或更高版本，并在安装完成后完成登录或认证：初始化向导只会列出本机已检测到的 CLI。

当前支持矩阵

工具	当前状态	安装方式	官方安装入口	官方参考入口	备注
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	默认一键安装路径。
Reasonix	当前支持	手动安装 / 认证	Reasonix GitHub 仓库	Reasonix 官网	当前支持，但需先安装 `reasonix` 并完成认证；ACP 模式由 `reasonix acp` 提供。
Pi	当前支持	手动安装 / 认证	Pi GitHub 仓库	Pi GitHub 仓库	当前支持，上游 npm 包要求 Node.js 22.19.0 或更高版本。
OMP	当前支持	手动安装 / 认证	Oh My Pi 安装脚本	Oh My Pi GitHub 仓库	当前支持，安装后可用 `omp --version` 确认可执行。
Junie	当前支持	手动安装 / 认证	Junie CLI 文档	Junie ACP 文档	当前支持，需先完成 Junie 登录或令牌配置；ACP 模式使用 `junie --acp`。
DSH	当前支持	手动安装 / 认证	DeepSeek Harness 仓库	DeepSeek Harness 仓库	当前支持，需先执行 `npm install -g @deepseek-ai/dsh`（预发布版本，接口可能变化），凭据保存在 `$DSH_HOME`。