安装

环境要求

• Node.js ≥ 22.5
• 选择一种受支持的运行时：
  • 在本机安装 Claude Code 或 Codex CLI，并用已有账号或订阅登录；或者
  • 在 macOS 或 Linux 上使用 Soloco 内置的 DeepSeek Harness，在 Soloco 中输入 自己的 DeepSeek API Key，无需另行安装 DSH。
• Soloco 支持的平台： macOS · Windows · Linux。DSH 当前只支持 macOS 和 Linux； Windows 请使用 Claude Code 或 Codex CLI。

各运行时的平台与能力差异见 Agent 运行时。

用 npm 安装

npm i -g @soloco/client@latest

然后启动：

soloco

首次运行时，Soloco 会引导你完成设置，探测机器上可用的 agent 运行时，并自动在浏览器 打开本地 UI；在支持的平台上也可以选择内置 DSH。

让 AI 助手帮你装

因为 Soloco 本身就是为"agent 优先"的工作流设计的，你也可以让 AI 助手来安装。把下面 这段粘贴给 Claude Code 或 Codex：

帮我安装 Soloco。先确认 Node.js ≥ 22.5，然后执行：npm i -g @soloco/client@latest
再运行 "soloco" 并按引导设置。它是一个 local-first 编排器。我可以使用已有的 Claude
Code 或 Codex CLI 账号；在 macOS 或 Linux 上，也可以选择 Soloco 内置的 DeepSeek
Harness，并在 Soloco UI 中输入我自己的 DeepSeek API Key。不要让我把 API Key 粘贴到
聊天里，也不要替我输入凭据。如果某一步需要我的账号、API Key 或付款，停下来问我。

保持更新

soloco update

或者重装最新版：npm i -g @soloco/client@latest。

检查安装

如果哪里不对劲，跑内置的自检：

soloco doctor

它会逐项报告并给出下一步：你的 Node 版本（Soloco 需要 Node ≥ 22.5）、daemon 是否 在运行并托管本地 UI、以及是否有受支持的运行时已经就绪。Node 版本过低时，soloco 会打印升级提示而不是直接运行——请装 Node 22.5 或更新版本，再用 npm i -g @soloco/client@latest 重装。

想看 Soloco 探测到了哪些运行时，跑 soloco runtimes。

说明

• Claude Code 和 Codex CLI 是独立的本地工具：请安装并登录你要使用的那个。DSH 随 Soloco 提供，不需要单独安装。
• DSH 需要你自己的 DeepSeek API Key 和出站网络，当前不支持 Windows，也不会被自动 选中。当前能力限制见 Agent 运行时。
• Soloco V2 核心目前闭源；注册已开放，装好即可用你的账号登录使用。