安裝 AI 程式設計工具
安裝並登入一款受支援的 AI 程式設計工具，讓 Multica 在本機執行。
本地執行時由兩部分組成：Multica 守護程序，和它能呼叫的一款 AI 程式設計工具。只裝你準備用的那一款就行，不必全部安裝。
選擇一款工具
已經安裝並登入的工具不需要額外配置。各工具在模型、MCP、會話恢復和 skill 支援上有差異，見 AI 程式設計工具對照。
Multica 當前會檢測以下命令：
| 工具 | 檢測的命令 | 官方安裝說明 |
|---|---|---|
| Antigravity CLI | agy | Antigravity 安裝與登入 |
| Claude Code | claude | Claude Code 快速開始 |
| CodeBuddy Code | codebuddy | CodeBuddy 快速開始 |
| CodeArts | codearts | CodeArts CLI 快速開始 |
| Codex CLI | codex | Codex CLI |
| GitHub Copilot CLI | copilot | 安裝 Copilot CLI |
| Cursor Agent | cursor-agent | 安裝 Cursor CLI |
| DeepSeek Harness | dsh | DeepSeek Harness |
| DevEco Code | deveco | DevEco Code |
| Grok Build | grok | Grok Build 快速開始 |
| Hermes Agent | hermes | Hermes 快速開始 |
| Kimi CLI | kimi | Kimi CLI |
| Kiro CLI | kiro-cli | 安裝 Kiro CLI |
| MiniMax Code | mcode | 安裝 MiniMax Code CLI |
| Muse Code | muse | 安裝 Muse Code |
| ZCode | zcode / ZCode Desktop | ZCode |
| OpenClaw | openclaw | 安裝 OpenClaw |
| OpenCode | opencode | OpenCode 快速開始 |
| Pi coding agent | pi | Pi coding agent |
| Oh-My-Pi | omp | Oh-My-Pi 安裝 |
| Qoder CLI | qodercli | Qoder CLI 快速開始 |
| Qoder CN CLI | qoderclicn | Qoder CN CLI 快速開始 |
| Qwen Code | qwen | Qwen Code |
| QwenPaw | qwenpaw | QwenPaw |
| Reasonix | reasonix | Reasonix |
| TRAE CLI | traecli | TRAE 官方站 |
| Dim | dim | DimCode |
| Devin CLI | devin | 安裝 Devin CLI（3000.3.22+）；本機 ACP，先執行 devin auth login |
| ZeroClaw | zeroclaw | ZeroClaw 快速開始 |
"受支援"表示 Multica 能夠呼叫對應 CLI，不代表 Multica 會替你提供該工具的帳號、訂閱或模型額度。
在本機完成登入
安裝後，先在終端裡單獨啟動一次工具，按它自己的流程登入或配置模型服務。工具在終端中完成不了請求，守護程序呼叫它也會失敗。
這些登入憑據由工具儲存在本機。Multica 不會接收 Claude、Codex、Cursor 或其他 CLI 的登入 token。
低於最低版本時，守護程序不會註冊對應執行時：
| 工具 | 最低版本 |
|---|---|
| Antigravity | 1.1.10 |
| Claude Code | 2.0.0 |
| Codex | 0.100.0 |
| Copilot | 1.0.0 |
| Grok | 0.2.89 |
| Qwen Code | 0.20.0 |
| MiniMax Code | 0.1.2 |
| OpenCode | 1.1.54 |
| Dim | 0.3.10 |
| ZeroClaw | 0.8.0 |
以下工具除了登入，還要額外配置：
確認守護程序能夠找到命令
把 <command> 換成表格中的命令，例如 claude、codex 或 cursor-agent。第一條命令返回可執行檔案路徑。
在 macOS、Linux 或 WSL 中執行：
command -v <command>
<command> --version終端能找到工具，Desktop 或後臺守護程序卻找不到，通常是兩者用的 PATH 不同。可以重啟應用，或透過對應的 MULTICA_<PROVIDER>_PATH 環境變數指定絕對路徑；完整配置見環境變數。
重新檢測並確認上線
啟動守護程序：
multica daemon start守護程序已經在執行時，安裝新工具後重新啟動：
multica daemon restart然後開啟 Multica 的執行時頁面，目標電腦下面會出現對應工具，並顯示為線上。之後建立或編輯 AI 代理時，就可以選這條執行時。
守護程序啟動時必須先檢測到至少一款內建支援的 CLI。自定義執行時配置在守護程序啟動後才同步，所以在一臺空白機器上不能只靠它啟動。只有一個例外：守護程序剛開始自行安裝 DSH 執行時 profile（MULTICA_DSH_PROFILE_BUNDLE）時，會在沒有任何執行時的情況下啟動，安裝完成後再註冊 DeepSeek Harness。否則，一臺只裝了需要該 profile 的 DSH 的機器永遠裝不完：守護程序會在安裝結束前退出，把安裝程序一起帶走。
未檢測到工具
依次檢查：
- 在終端執行工具本身，確認安裝和登入都已完成。
- 用
command -v或Get-Command檢查實際命令名和路徑。 - 執行
multica daemon logs -f，檢視版本、路徑或認證錯誤。 - 重啟守護程序，讓它重新讀取當前環境。
- 回到執行時頁面，確認電腦和工具都已上線。
工具顯示線上、執行卻仍然失敗時，開啟任務的執行記錄檢視 CLI 返回的具體錯誤，或繼續看故障排查。
接下來
- 建立和配置 AI 代理 — 選擇剛剛連線的執行時。
- 守護程序與執行時 — 瞭解線上狀態、併發和自定義執行時。
- AI 程式設計工具對照 — 比較各工具在 Multica 中的能力。
ZCode Desktop 的 macOS 應用程式包可被自動發現；請同時安裝 Node.js，並在桌面端啟用可用的 API 連線。模型與思考強度由 ZCode 原生目錄提供。詳見執行時對照。