DeepAgents 对比 HagiCode:功能与差异

DeepAgents 是 LangChain 开源的 Agent harness,它的终端编码 Agent 现在叫 Deep Agents Code(`dcode`);HagiCode 是通过 ACP 把它当作执行器的工作台。需要沙盒、SDK 开发和脚本就留在命令行;需要并行会话、提案和托管提交时,再加上 HagiCode。

更新于: 2026年10月16日

简短结论

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 对比一览

对比项	DeepAgents	HagiCode
类别	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 的长处

为长任务设计的 harness

Deep Agents 内置了规划、可对接本地、沙盒或远程后端的文件系统、会摘要长对话并把工具输出转存到磁盘的上下文管理,以及上下文窗口相互隔离的子 Agent。默认配置面向多步骤任务,而不是单次补全。

远程沙盒与坦率的安全模型

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 管理跨仓库规范。

HagiCode 不适合 DeepAgents 用户的场景

无界面 CI 或脚本运行:请直接用 dcode 或 SDK;HagiCode 是桌面与网页应用。

CLI 改过名:HagiCode 的启动器查找带 --acp 的 deepagents 命令,或 uvx --from deepagents-cli,而旧包已弃用。你可能需要让 HagiCode 指向 dcode。

HagiCode 的 DeepAgents 设置包括可执行文件、模型、Agent 名称、技能目录和记忆文件;远程沙盒后端等其他 dcode 选项不在其中。

需要先装好 CLI 并配置模型提供商,起步比单独运行 dcode 更长。

免费版同时最多 3 个提案,不想要规范流程的团队会觉得提案是额外负担。

HagiCode 并不是深度手工编辑的 IDE 替代品,编辑能力止于内嵌的 Code Server。

把 DeepAgents 和 HagiCode 一起用

HagiCode 是架在 CLI 之上的工作台。它在你打开的仓库里以 --acp 启动 DeepAgents,实际干活的是你自己安装的 CLI 和你的提供商密钥。HagiCode 不增加模型计费。

不存在锁定:CLI 仍是一个普通安装,随时可以用 dcode 直接运行。

1. 用 curl -LsSf https://langch.in/dcode | bash 安装 Deep Agents Code,运行一次 dcode 并配置模型提供商。
2. 确认 HagiCode 能找到哪个命令:它先找 deepagents,再回退到 uvx --from deepagents-cli。如果都不行,就在 HagiCode 里把 DeepAgents 的可执行文件路径指向你的 dcode(dcode --acp 是文档中的 ACP 入口;这一组合尚未做端到端测试)。
3. 安装 HagiCode Desktop(Windows、macOS 或 Linux,免费),把 Agent CLI 选为 DeepAgents。
4. 按需设置模型、Agent 名称、技能目录和记忆文件,然后打开仓库。
5. 开始会话或 OpenSpec 提案;HagiCode 通过 ACP 与 CLI 通信。
6. 想回到纯 dcode,在同一目录直接运行它即可。

DeepAgents 在 HagiCode 里能用什么

并行会话、Agents 管理、OpenSpec 提案、AI 提交、Code Server、Monospecs、Vault 和统一工具调用视图都适用于 DeepAgents 会话。OmniRoute 是 HagiCode 的功能,对该 CLI 的覆盖程度取决于 CLI 自己的模型设置。

交互式提问只支持 Claude、Pi、OMP 和 Reasonix,Agent 工作面板只支持 Claude,所以这两项在 DeepAgents 下不可用。

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。

在你已有的 Agent 之上试试 HagiCode

安装 HagiCode 桌面版,接入你现有的 CLI,保持原来的工作方式。

安装 HagiCode 桌面版

更多对比

• Claude Code 对比 HagiCode
• CodeBuddy 对比 HagiCode
• Codex 对比 HagiCode
• GitHub Copilot 对比 HagiCode
• DeepSeek Harness (dsh) 对比 HagiCode
• Gemini 对比 HagiCode
• Hermes Agent 对比 HagiCode
• Junie 对比 HagiCode
• Kimi 对比 HagiCode
• Kiro 对比 HagiCode
• OMP 对比 HagiCode
• OpenCode 对比 HagiCode
• Pi 对比 HagiCode
• Qoder 对比 HagiCode
• Reasonix 对比 HagiCode