Docs

安装 AI 编程工具

安装并登录一款受支持的 AI 编程工具,让 Multica 在本机运行。

本地运行时由两部分组成:Multica 守护进程,和它能调用的一款 AI 编程工具。只装你准备用的那一款就行,不必全部安装。

选择一款工具

已经安装并登录的工具不需要额外配置。各工具在模型、MCP、会话恢复和 skill 支持上有差异,见 AI 编程工具对照。

Multica 当前会检测以下命令:

工具检测的命令官方安装说明
Antigravity CLIagyAntigravity 安装与登录
Claude CodeclaudeClaude Code 快速开始
CodeBuddy CodecodebuddyCodeBuddy 快速开始
CodeArtscodeartsCodeArts CLI 快速开始
Codex CLIcodexCodex CLI
GitHub Copilot CLIcopilot安装 Copilot CLI
Cursor Agentcursor-agent安装 Cursor CLI
DeepSeek HarnessdshDeepSeek Harness
DevEco CodedevecoDevEco Code
Grok BuildgrokGrok Build 快速开始
Hermes AgenthermesHermes 快速开始
Kimi CLIkimiKimi CLI
Kiro CLIkiro-cli安装 Kiro CLI
MiniMax Codemcode安装 MiniMax Code CLI
Muse Codemuse安装 Muse Code
ZCodezcode / ZCode DesktopZCode
OpenClawopenclaw安装 OpenClaw
OpenCodeopencodeOpenCode 快速开始
Pi coding agentpiPi coding agent
Oh-My-PiompOh-My-Pi 安装
Qoder CLIqodercliQoder CLI 快速开始
Qoder CN CLIqoderclicnQoder CN CLI 快速开始
Qwen CodeqwenQwen Code
QwenPawqwenpawQwenPaw
AmpampAmp CLI
Factory DroiddroidFactory Droid
ReasonixreasonixReasonix
TRAE CLItraecliTRAE 官方站
DimdimDimCode
Devin CLIdevin安装 Devin CLI(3000.3.22+);本机 ACP,先运行 devin auth login
ZeroClawzeroclawZeroClaw 快速开始

"受支持"表示 Multica 能够调用对应 CLI,不代表 Multica 会替你提供该工具的账号、订阅或模型额度。

在本机完成登录

安装后,先在终端里单独启动一次工具,按它自己的流程登录或配置模型服务。工具在终端中完成不了请求,守护进程调用它也会失败。

这些登录凭据由工具保存在本机。Multica 不会接收 Claude、Codex、Cursor 或其他 CLI 的登录 token。

低于最低版本时,守护进程不会注册对应运行时:

工具最低版本
Antigravity1.1.10
Claude Code2.0.0
Codex0.100.0
Copilot1.0.0
Grok0.2.89
Qwen Code0.20.0
Factory Droid1.8.0
MiniMax Code0.1.2
Muse Code1.4.10
OpenCode1.1.54
Dim0.3.10
Devin CLI3000.3.22
ZeroClaw0.8.0
ZCode0.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 的机器永远装不完:守护进程会在安装结束前退出,把安装进程一起带走。

未检测到工具

依次检查:

  1. 在终端运行工具本身,确认安装和登录都已完成。
  2. 用 command -v 或 Get-Command 检查实际命令名和路径。
  3. 运行 multica daemon logs -f,查看版本、路径或认证错误。
  4. 重启守护进程,让它重新读取当前环境。
  5. 回到运行时页面,确认电脑和工具都已上线。

工具显示在线、执行却仍然失败时,打开任务的执行记录查看 CLI 返回的具体错误,或继续看故障排查。

接下来

ZCode Desktop 的 macOS 应用包可被自动发现,需要同时安装 Node.js。Linux 下,守护进程通过 PATH 中的 zcode 或 /opt/ZCode/zcode 自动发现 ZCode Desktop,在后台运行内置 CLI,不打开桌面窗口,无需额外安装 Node.js 或手动配置环境变量。请在桌面端启用可用的 API 连接。模型与思考强度由 ZCode 原生目录提供。详见运行时对照。

本页目录