安装 AI 编程工具

本地运行时由两部分组成：Multica 守护进程，以及它能够调用的一款 AI 编程工具。只需要安装你准备使用的工具，不必安装全部工具。

1. 选择一款工具

已经安装并登录的工具不需要额外配置。工具之间的模型、MCP、会话恢复和 skill 支持有所不同，详细差异见 AI 编程工具对照。

Multica 当前会检测以下命令：

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

2. 在本机完成登录

安装后，先在终端中单独启动一次工具，并按照它自己的流程登录或配置模型服务。工具在终端中无法完成请求时，守护进程调用它同样会失败。

使用 Reasonix 时，请先运行 reasonix setup，配置默认的模型服务和模型，再启动守护进程。

使用 QwenPaw 时，请在 QwenPaw 自身的配置里选择模型服务和模型。Multica 无法在执行时覆盖 QwenPaw 的模型。

使用 MiniMax Code 时，请安装受支持的 Node.js 版本（>=22.19 <23 或 >=24 <27），并运行 npm install --global @minimax-ai/code@latest。全局 npm 安装会把 mcode 放入 npm 的全局可执行目录；如果 command -v mcode 或 Get-Command mcode 找不到它，请将该目录加入 PATH。然后运行 mcode login。模型由 MiniMax Code 管理，Multica 无法通过 ACP 覆盖它。

使用 DeepSeek Harness 时，请先安装 Node.js 20+ 并运行 npm install -g @deepseek-ai/dsh，然后为它安装 Multica 运行时 profile（dsh plugin --profile multica add <bundle>）。守护进程只有在 dsh --profile multica --probe 成功后才注册 DeepSeek Harness。启动守护进程前请设置 DEEPSEEK_API_KEY（或在 dsh 自身设置中保存）。

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

3. 确认守护进程能够找到命令

在 macOS、Linux 或 WSL 中运行：

command -v <command>
<command> --version

在 Windows PowerShell 中运行：

Get-Command <command>
<command> --version

把 <command> 换成表格中的命令，例如 claude、codex 或 cursor-agent。第一条命令返回可执行文件路径。

如果终端能够找到工具，但 Desktop 或后台守护进程找不到，通常是两者使用的 PATH 不同。可以重启应用，或通过对应的 MULTICA_<PROVIDER>_PATH 环境变量指定绝对路径；完整配置见环境变量。

4. 重新检测并确认上线

使用 CLI 启动守护进程：

multica daemon start

如果守护进程已经运行，安装新工具后重新启动：

multica daemon restart

使用 Multica Desktop 时，退出并重新打开应用即可。

然后打开 Multica 的运行时页面。目标电脑下面会出现对应工具，并显示为在线。现在可以在创建或编辑智能体时选择这条运行时。

未检测到工具

依次检查：

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

工具已经显示在线，但执行仍然失败时，打开 issue 的执行记录查看 CLI 返回的具体错误，或继续阅读故障排查。

接下来

• 创建和配置智能体 — 选择刚刚连接的运行时。
• 守护进程与运行时 — 了解在线状态、并发和自定义运行时。
• AI 编程工具对照 — 比较各工具在 Multica 中的能力。