安装 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 |
| Amp | amp | Amp CLI |
| Factory Droid | droid | Factory Droid |
| 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 |
| Factory Droid | 1.8.0 |
| MiniMax Code | 0.1.2 |
| Muse Code | 1.4.10 |
| OpenCode | 1.1.54 |
| Dim | 0.3.10 |
| Devin CLI | 3000.3.22 |
| ZeroClaw | 0.8.0 |
| ZCode | 0.16.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 的运行时页面,目标电脑下面会出现对应工具,并显示为在线。之后创建或编辑智能体时,就可以选这条运行时。
守护进程启动时必须先检测到至少一款内置支持的 CLI。自定义运行时配置在守护进程启动后才同步,所以在一台空白机器上不能只靠它启动。只有一个例外:守护进程刚开始自行安装 DSH 运行时 profile(MULTICA_DSH_PROFILE_BUNDLE)时,会在没有任何运行时的情况下启动,安装完成后再注册 DeepSeek Harness。否则,一台只装了需要该 profile 的 DSH 的机器永远装不完:守护进程会在安装结束前退出,把安装进程一起带走。
未检测到工具
依次检查:
- 在终端运行工具本身,确认安装和登录都已完成。
- 用
command -v或Get-Command检查实际命令名和路径。 - 运行
multica daemon logs -f,查看版本、路径或认证错误。 - 重启守护进程,让它重新读取当前环境。
- 回到运行时页面,确认电脑和工具都已上线。
工具显示在线、执行却仍然失败时,打开任务的执行记录查看 CLI 返回的具体错误,或继续看故障排查。
接下来
ZCode Desktop 的 macOS 应用包可被自动发现,需要同时安装 Node.js。Linux 下,守护进程通过 PATH 中的 zcode 或 /opt/ZCode/zcode 自动发现 ZCode Desktop,在后台运行内置 CLI,不打开桌面窗口,无需额外安装 Node.js 或手动配置环境变量。请在桌面端启用可用的 API 连接。模型与思考强度由 ZCode 原生目录提供。详见运行时对照。