在本地运行 AI agent
什么是本地 AI agent，本地编排与托管平台有什么区别，以及如何用已有账号或自己的服务商 Key 跑起来。
本地 AI agent 在你自己的电脑上执行，并使用由你控制的模型访问方式——已有账号或 订阅，或者你自己的服务商 API Key。你的工作区与编排状态默认留在本地；所选运行时 仍会把推理所需的上下文发送给对应模型服务商。这篇指南讲清楚：本地何时优于托管、 三条实现路径，以及如何在五分钟内让第一个本地 agent 开始推进一个长期目标。
为什么要在本地跑？
托管 agent 平台把你的工作放到别人的服务器上，按平台积分计费。本地运行把这个 模式整个翻过来：
| 托管 agent 平台 | 本地 AI agent | |
|---|---|---|
| 工作发生在哪 | 厂商的云端 | 你的电脑 |
| 你的文件和产出 | 上传给厂商处理 | 留在你的设备上 |
| 模型访问 | 平台指定的积分或服务商账号 | 你的 Claude / ChatGPT 账号，或用于内置 DSH 的 DeepSeek API Key |
| 长时间运行 | 受厂商运行时限制 | 电脑开着就能一直跑 |
| 可用工具 | 平台开放什么用什么 | 所选本地运行时开放的工具 |
三个换到本地的理由：
- 本地工作区控制。代码、文档、编排状态和产出默认留在你的磁盘上，不需要整体 搬进托管 agent 的云端工作区；所选运行时仍会与模型服务商通信来完成推理。
- 自己选择模型访问方式。复用已有的 Claude 或 ChatGPT 账号，或者通过内置 DSH 使用自己的 DeepSeek API Key；服务商计费取决于你选择的路径。
- 真实工具。本地 agent 用的是你真实的环境——你的 shell、你的仓库、你装的 CLI——而不是阉割版云沙箱。
三条实现路径
自己写循环。把 LLM API 接进一个「规划—执行—重试」的脚本。控制力最强，但调度、 恢复、上下文管理、审查工具从此都归你自己维护，而且按 token 付费。
用 agent 框架。开源框架（LangChain、AutoGen、CrewAI 等）提供了在代码里搭 多智能体系统的积木。适合做 agent 产品的人；如果你只是想让 agent 替你干活， 它们偏重，而且大多仍然走 API key 计费。
编排本地 agent 运行时。Claude Code、Codex CLI 本身已经是能力完整的本地 agent， 可以使用已有账号或订阅。Soloco 也为自带 DeepSeek API Key 的用户内置兼容版本的 DeepSeek Harness。Soloco 走的就是第三条路：它不运行任何托管 agent——它协调你机器 上的所选运行时，把一个目标变成可执行、可审计、可恢复的任务树。运行时负责执行， Soloco 提供组织力。
三步跑起来
简版如下，完整流程见快速上手：
- 选择受支持的运行时：安装并登录 Claude Code 或 Codex CLI；或者在 macOS、 Linux 上使用 Soloco 内置的 DSH，并输入你自己的 DeepSeek API Key。几条路径的差异 见 Agent 运行时。
- 安装 Soloco：
npm i -g @soloco/client@latest（Node.js ≥ 22.5，macOS / Windows / Linux 均可，详见安装）。 - 运行
soloco，打开本地界面，描述一个目标。Soloco 会把它规划成任务、分派给 你的运行时、校验结果，并持续推进——你离开电脑它也在干。任务树、常驻使命与 心跳如何协作，见核心概念。
常见问题
合上电脑 agent 还会继续干吗？ 睡眠期间不会——agent 在电脑清醒时运行。状态在本地持久化，电脑醒来后目标从中断处 恢复，而不是重头再来。
这是开源的吗？ Soloco V2 核心是闭源的；注册开放。它编排的运行时（以及上表中的 各框架）有各自的许可证。费用以价格页为唯一事实来源。
什么数据会离开我的电脑？ 你的工作区、编排状态和产出默认留在本地。所选运行时会把推理所需的上下文发送给对应 模型服务商：Claude Code 与 Codex CLI 使用各自配置好的账号，内置 DSH 使用你提供的 DeepSeek API Key。
想要一份机器可读的事实摘要（AI 助手替你评估 Soloco 时有用），见 /zh/agent 或 /llms-zh.txt。想知道 Soloco 不是什么，读简介。