安装
macOS、Windows、Linux 的环境要求与安装方式。
环境要求
- Node.js ≥ 22.5
- 一个已登录的本地 agent 运行时——当前支持 Claude Code 或 Codex。Soloco 使用这个 运行时和你已有的订阅，所以不需要 API key。
- 平台： macOS · Windows · Linux。
用 npm 安装
npm i -g @soloco/client@latest然后启动：
soloco首次运行时，Soloco 会引导你完成设置，探测机器上可用的 agent 运行时，并自动在浏览器 打开本地 UI。
让 AI 助手帮你装
因为 Soloco 本身就是为"agent 优先"的工作流设计的，你也可以让 AI 助手来安装。把下面 这段粘贴给 Claude Code 或 Codex：
帮我安装 Soloco。先确认 Node.js ≥ 22.5，然后执行：npm i -g @soloco/client@latest
再运行 "soloco" 并按引导设置。它是一个 local-first 编排器，用我自己的订阅协调我
已经装好的本地 agent 运行时（Claude Code / Codex 等）——不需要 API key。它跑在
我的机器上；我的目标、文件和产出都留在本地。如果某一步需要我的账号或付款，停下来
问我——不要替我输入凭据。保持更新
soloco update或者重装最新版：npm i -g @soloco/client@latest。
检查安装
如果哪里不对劲，跑内置的自检：
soloco doctor它会逐项报告并给出下一步：你的 Node 版本（Soloco 需要 Node ≥ 22.5）、daemon 是否
在运行并托管本地 UI、以及本机 agent 运行时是否已安装并登录。Node 版本过低时，soloco
会打印升级提示而不是直接运行——请装 Node 22.5 或更新版本，再用
npm i -g @soloco/client@latest 重装。
想看 Soloco 探测到了哪些运行时，跑 soloco runtimes。
说明
- 如果还没有任何本地 agent 运行时，请先装一个（例如 Claude Code）——Soloco 需要一个 运行时来派发工作。
- Soloco V2 核心目前闭源；注册已开放，装好即可用你的账号登录使用。