为长任务设计的 harness
Deep Agents 内置了规划、可对接本地、沙盒或远程后端的文件系统、会摘要长对话并把工具输出转存到磁盘的上下文管理,以及上下文窗口相互隔离的子 Agent。默认配置面向多步骤任务,而不是单次补全。
DeepAgents 对比 HagiCode: 功能与差异
HagiCode 是一款提案驱动的 AI 编码工作台，可将需求转化为可审阅的提案，通过 Claude Code、Codex、GitHub Copilot 等 Agent CLI 执行，并把结果沉淀为团队知识。
DeepAgents 是 LangChain 开源的 Agent harness,它的终端编码 Agent 现在叫 Deep Agents Code(`dcode`);HagiCode 是通过 ACP 把它当作执行器的工作台。需要沙盒、SDK 开发和脚本就留在命令行;需要并行会话、提案和托管提交时,再加上 HagiCode。
简短结论
DeepAgents 是 LangChain 基于 LangGraph 开源的 Agent harness。它的终端编码 Agent(HagiCode 里叫 DeepAgents)现在以 Deep Agents Code 之名发布:安装后运行 dcode,就是一个在终端里工作的编码 Agent。HagiCode 是桌面与网页端的 AI 编程工作台,把包括 DeepAgents 在内的 Agent CLI 当作执行器来驱动。它不取代这个 CLI,而是以 ACP 模式启动它,并在外层提供会话、提案和提交处理。
如果你在 Deep Agents SDK 上构建自己的 Agent、需要远程沙盒或 LangSmith 追踪,或者只用终端,就单用 DeepAgents。如果想让它与其他 Agent 并排运行,配上提案和并行会话,再加 HagiCode。有一个实际提醒:这个 CLI 改过名,连接之前请先看下面的设置步骤。
DeepAgents 与 HagiCode 对比一览
对比项DeepAgentsHagiCode
类别
LangChain 开源的 Deep Agents harness;终端编码 Agent 是 Deep Agents Code(dcode)
工作台,把包括 DeepAgents 在内的 Agent CLI 当执行器运行
界面与平台
终端界面,支持恢复对话,另有适用于脚本和 CI 的 headless 模式;需要 Python 3.12+
桌面端(Windows、macOS、Linux)、Docker Compose 容器版、Microsoft Store 版
价格与许可
MIT 许可,免费;费用付给模型提供商;LangSmith 追踪是另外的可选服务
桌面版和容器版免费;Store 版基础免费,可选一次性购买 TurboEngine
模型与提供商
默认含 OpenAI、Anthropic、Gemini;NVIDIA、Ollama 等通过附加包;任何支持工具调用的模型
不托管模型,把你选的模型传给 CLI;可选 OmniRoute 路由
并行工作
会话内有上下文隔离的子 Agent;会话可恢复
同时运行多个会话,每个是带状态的命名 Agent
规范与规划流程
Agent 自己做计划并管理上下文;没有提案生命周期
OpenSpec 提案:提出、校验、实施、归档(免费版同时 3 个,TurboEngine 为 32 个)
Git 与提交
可使用 shell,并有人工审批;未记载专门的提交流程
AI 生成提交信息,提交期间锁定仓库;内置 Git 与 GitHub 集成
上手成本
curl -LsSf https://langch.in/dcode | bash,然后运行 dcode
安装桌面端,并保证 CLI 在 HagiCode 要启动的命令名下可用
最适合
想要可扩展的 LangChain 系 harness、沙盒和追踪的开发者
跨仓库的编码工作,要求并行会话和可追溯规范
DeepAgents 的长处
远程沙盒与坦率的安全模型
Deep Agents Code 可以在 LangSmith、AgentCore、Daytona、Modal、Runloop 等远程沙盒中运行代码。它的 README 直接说明:默认信任你运行它的目录,并会在任何审批提示之前读取项目文件,所以不受信任的仓库应放进沙盒。
模型无关,易于扩展
任何支持工具调用的模型都能用,从前沿 API 到 Ollama、vLLM、llama.cpp。你可以用自定义斜杠命令添加技能、使用持久记忆和 MCP 工具。同一套 harness 也以 deepagents Python SDK 提供,dcode --acp 则把它提供给 ACP 客户端。
更新很快,但改过名
发布很频繁:2026 年 10 月有 deepagents 0.7.26 和 deepagents-code 0.1.85。Deep Agents Code 在 2026 年 5 月从旧的 deepagents-cli v0.1.0 分叉而来,PyPI 上的 deepagents-cli 包现已标为弃用并另作他用,所以搜索和安装时请用新名字。
什么时候选 DeepAgents,什么时候选 HagiCode
这些情况继续用 DeepAgents
- 你在 Deep Agents SDK 或 LangGraph 上构建自己的 Agent,想把这个 CLI 当作可运行的参考;
- 你需要远程沙盒,或想用 LangSmith 追踪每一次 Agent 决策;
- 你想自由选择任何支持工具调用的模型,包括通过 Ollama 或 vLLM 的本地模型;
- 你跑 headless 脚本,或只需要终端;
- 你想在
dcode新功能发布当天就用上。
这些情况选 HagiCode
- 你要同时运行多个 DeepAgents 会话,并把每个作为命名 Agent 跟踪;
- 你希望每次改动都从 OpenSpec 提案开始,有校验和归档;
- 你想让 DeepAgents 的修改用生成的提交信息提交，并在同一窗口里用内嵌编辑器;
- 你还用其他 Agent CLI,想在一个工作区里管理它们;
- 你想把 DeepAgents 之前运行的笔记存进共享 Vault，并用 Monospecs 管理跨仓库规范。
把 DeepAgents 和 HagiCode 一起用
HagiCode 是架在 CLI 之上的工作台。它在你打开的仓库里以 --acp 启动 DeepAgents,实际干活的是你自己安装的 CLI 和你的提供商密钥。HagiCode 不增加模型计费。
不存在锁定:CLI 仍是一个普通安装,随时可以用 dcode 直接运行。
- 用
curl -LsSf https://langch.in/dcode | bash安装 Deep Agents Code,运行一次dcode并配置模型提供商。 - 确认 HagiCode 能找到哪个命令:它先找
deepagents,再回退到uvx --from deepagents-cli。如果都不行,就在 HagiCode 里把 DeepAgents 的可执行文件路径指向你的dcode(dcode --acp是文档中的 ACP 入口;这一组合尚未做端到端测试)。 - 安装 HagiCode Desktop(Windows、macOS 或 Linux,免费),把 Agent CLI 选为 DeepAgents。
- 按需设置模型、Agent 名称、技能目录和记忆文件,然后打开仓库。
- 开始会话或 OpenSpec 提案;HagiCode 通过 ACP 与 CLI 通信。
- 想回到纯 dcode,在同一目录直接运行它即可。
HagiCode 在 Agent 之上增加了什么
并行会话与 Agents 管理
DeepAgents 在单个会话里委派给子 Agent。HagiCode 提供的是上一层:跨任务或跨仓库的多个 DeepAgents 会话,每个都是能看到状态的命名 Agent。
OpenSpec 提案
LangSmith 追踪记录 Agent 做了什么,OpenSpec 提案记录为什么这么做。问题描述、商定的方案和最终改动放在一起,可以归档。
AI 提交与 Code Server
HagiCode 根据 diff 起草提交信息,并在提交期间锁定仓库。Code Server 在浏览器里打开 Agent 改过的文件。
Monospecs 与 Vault
Monospecs 在 .hagicode/monospecs.yaml 里列出子仓库,让跨仓库工作以一个提案的形式交给 Agent。Vault 存放你一次登记的参考项目和笔记,与 CLI 自己的记忆文件并存。
OmniRoute、工具调用视图与用量
OmniRoute 可以集中管理各 Agent 的模型路由。DeepAgents 的工具调用与其他 Agent 一样显示在同一种类型化视图里,可选的 TokenMonitor 会在状态栏显示今日 token 和费用。
结论
- DeepAgents 是 LangChain 可扩展、支持沙盒的 harness,它的 CLI 现在叫 Deep Agents Code。
- HagiCode 在外层增加并行 Agent、提案、AI 提交和知识库,代价是多装一个软件,并要核对一下启动命令名。
- 沙盒、SDK 开发和脚本用 dcode 就够;有组织的多仓库编码用 HagiCode 加 DeepAgents。
常见问题
DeepAgents 免费吗?
免费。Deep Agents 和 Deep Agents Code 采用 MIT 许可。你向模型提供商付费,LangSmith 追踪是 LangChain 另外的可选服务,方案请看 LangChain 价格页。
DeepAgents 怎么安装?
运行 `curl -LsSf https://langch.in/dcode | bash`,然后用 `dcode` 启动。默认含 OpenAI、Anthropic、Gemini 支持,其他提供商通过附加包安装,例如 `DEEPAGENTS_CODE_EXTRAS="nvidia,ollama"`。
DeepAgents 和 Deep Agents Code 是一回事吗?
Deep Agents Code(包名 `deepagents-code`)在 2026 年 5 月从 `deepagents-cli` 分叉而来,是现在维护中的终端 Agent。PyPI 上旧的 `deepagents-cli` 包已被弃用。
DeepAgents 能和 HagiCode 一起用吗?
可以,通过 ACP。HagiCode 启动 `deepagents --acp`,或回退到 `uvx --from deepagents-cli`;CLI 改名后,你可能需要把可执行文件路径设为 `dcode`。
HagiCode 会取代 DeepAgents 吗?
不会。CLI 负责干活,HagiCode 在外层组织会话、提案和提交,你仍可直接运行 dcode。
DeepAgents 和 HagiCode 该选哪个?
沙盒、SDK 开发和脚本,单用 CLI。需要同时处理多个会话或仓库,并想在一处管理提案、提交和 Agent 时,再加 HagiCode。