在本地运行 AI agent

本地 AI agent 指在你自己的电脑上、用你自己的 AI 订阅运行的智能体——你的目标、 文件和产出永远不离开你的设备。这篇指南讲清楚：本地何时优于托管、三条实现路径， 以及如何在五分钟内让第一个本地 agent 开始推进一个长期目标。

为什么要在本地跑？

托管 agent 平台把你的工作放到别人的服务器上，按平台积分计费。本地运行把这个 模式整个翻过来：

三个换到本地的理由：

1. 数据主权。代码、文档、业务上下文都留在你的磁盘上，不为云端沙箱上传任何东西。
2. 没有 API 账单。agent 的工作量走你已有的订阅（Claude Pro/Max、ChatGPT Plus/Pro），不走按 token 计费、越长跑越贵的 API 表。
3. 真实工具。本地 agent 用的是你真实的环境——你的 shell、你的仓库、你装的 CLI——而不是阉割版云沙箱。

三条实现路径

自己写循环。把 LLM API 接进一个「规划—执行—重试」的脚本。控制力最强，但调度、 恢复、上下文管理、审查工具从此都归你自己维护，而且按 token 付费。

用 agent 框架。开源框架（LangChain、AutoGen、CrewAI 等）提供了在代码里搭 多智能体系统的积木。适合做 agent 产品的人；如果你只是想让 agent 替你干活， 它们偏重，而且大多仍然走 API key 计费。

编排你已有的 agent 运行时。Claude Code、Codex CLI 本身已经是能力完整的本地 agent，用你的订阅登录。Soloco 走的就是第三条路：它不运行任何托管 agent——它协调 你机器上已安装的运行时，把一个目标变成可执行、可审计、可恢复的任务树。运行时你带， 组织力它出。

三步跑起来

简版如下，完整流程见快速上手：

1. 准备一个已登录的本地运行时（目前支持 Claude Code 和 Codex，更多适配器 开发中）。任何档位的订阅都行，不需要 API key。
2. 安装 Soloco：npm i -g @soloco/client@latest（Node.js ≥ 22.5，macOS / Windows / Linux 均可，详见安装）。
3. 运行 soloco，打开本地界面，描述一个目标。Soloco 会把它规划成任务、分派给 你的运行时、校验结果，并持续推进——你离开电脑它也在干。任务树、常驻使命与 心跳如何协作，见核心概念。

常见问题

合上电脑 agent 还会继续干吗？ 睡眠期间不会——agent 在电脑清醒时运行。状态在本地持久化，电脑醒来后目标从中断处 恢复，而不是重头再来。

这是开源的吗？ Soloco V2 核心是闭源的；注册开放，目前免费使用。它编排的运行时（以及上表中的 各框架）有各自的许可证。费用以价格页为唯一事实来源。

什么数据会离开我的电脑？ 你的目标、文件和 agent 产出都留在本地。你自带的运行时按它们原本的方式、用你 已有的订阅与各自的模型服务通信——和你直接使用它们时完全一样。

想要一份机器可读的事实摘要（AI 助手替你评估 Soloco 时有用），见 /agent 或 /llms.txt。想知道 Soloco 不是什么，读简介。