安装 AI 编程工具

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

1. 选择一款工具

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

Multica 当前会检测以下命令：

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

2. 在本机完成登录

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

使用 CodeArts 时，请用 codearts run --model provider/model "只回复 OK" 验证非交互模式，而不只是验证 TUI。当前 CodeArts CLI 可能允许自定义 provider 在 TUI 中工作，但 run、models 和 serve 仍要求配置 CODEARTS_CLI_AK / CODEARTS_CLI_SK。Multica 可以从 ~/.codeartsdoer/codearts_cli.json 或 .jsonc 发现自定义模型，但每次运行都会使用 codearts run，因此仍遵循该命令的授权要求。

使用 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 —— 这个 bundle 实现了 Multica 驱动的 --stdio 协议，也是单独的 dsh 无法直接使用的原因。把 MULTICA_DSH_PROFILE_BUNDLE 设为要安装的 bundle，守护进程会替你安装；也可以自己执行 dsh plugin --profile multica add <bundle>。<bundle> 可以是 dsh plugin 接受的任意形式——npm 包名、目录，或打包好的 tarball——Multica 自己的桥接实现在 multica-ai/dsh-multica-runtime。它目前还没有发布到公共 npm registry（multica#6936），所以现阶段自托管团队的做法是：从该仓库自行构建，然后把变量指向构建产物目录；如果运行守护进程的机器和构建机器不是同一台，就指向 npm pack 产出的 tarball。等桥接发布之后，直接填包名是最省事的选择。无论选哪种，都优先用你们自己发布或构建的产物：这个值会在没有二次确认的情况下被装进每一台守护进程宿主的 DSH 家目录，填一个未经审查的第三方包是供应链决策，不是图方便。如果你装的是 DeepSeek Harness Desktop 而不是 npm 包，守护进程也会去找这个应用生成的 CLI shim，位置在它自己的用户级数据目录下：macOS 是 ~/Library/Application Support/DSH Desktop，Windows 是 %APPDATA%\DSH Desktop。Windows 上这是漫游应用数据目录，不是安装目录：应用本身装在 Program Files 或 %LOCALAPPDATA%\Programs，但它驱动的 CLI 和其他用户级状态放在一起。这些路径里的版本层是生成出来的 id，所以守护进程会枚举并优先取最新的一份。不需要 PATH 上有别的东西——生成的 shim 会用绝对路径调用应用自带的运行时。如果 DSH Desktop 装在非默认位置，请用 MULTICA_DSH_PATH 指向那个 shim。守护进程只有在 dsh --profile multica --probe 成功后才注册 DeepSeek Harness；失败时会在 /health 报告缺少 profile。启动守护进程前请设置 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. 回到运行时页面，确认电脑和工具都已上线。

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

接下来

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