AI Agent CLI 安裝

本頁是 HagiCode 統一的 AI Agent CLI 本機安裝入口。HagiCode 目前活躍支援 11 個 Agent CLI：Claude Code、Codex、GitHub Copilot、OpenCode、Hermes、QoderCLI、Kiro、Kimi、Gemini、DeepAgents、Codebuddy。

使用方式

先看下表確認某個 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	預設一鍵安裝路徑。

狀態說明

• 目前支援：屬於 HagiCode 目前活躍支援範圍，可在系統中作為現行 Agent CLI 使用。
• 一鍵安裝：HagiCode 提供引導式安裝入口；部分 CLI 安裝後仍要依廠商流程繼續登入或驗證。
• 手動安裝 / 驗證：該 CLI 已在目前支援範圍內，但需要你先完成本機安裝、登入或驗證，再回到 HagiCode 重新整理可用狀態。
• 歷史相容保留：iFlow CLI 僅為相容舊資料而保留，不屬於目前活躍支援清單，也不應視為現行建議項目。

下一步建議

• 想先搭好基礎環境，可繼續閱讀 安裝 Node.js，並視需要閱讀 OpenSpec 介紹。
• 如果你想把多個 OpenAI 相容工具統一接到同一個本機閘道，可繼續閱讀 OmniRoute 安裝與應用。
• 如果你想在這些 Agent CLI 上試用規格驅動開發，可以閱讀 Spec Kit 安裝教學，並對照 Spec Kit 與 OpenSpec 比較。
• 想了解整體安裝路徑與 Node.js、Git 等前置條件，可返回 安裝指南。
• 若你是從歷史文章進入本站，請以本頁和安裝總覽頁的現行支援說明為準。