> ## Documentation Index
> Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 与 Claude Agent SDK 的比较

> 比较 LangChain Deep Agents 与 Claude Agent SDK，为您的用例选择合适的工具。

本页解释了 [LangChain Deep Agents](/oss/javascript/deepagents/overview) 与 [Claude Agent SDK](https://platform.anthropic.com/docs/en/agent-sdk/overview) 的对比。两者都是构建自定义代理的工具，但在执行环境、部署和供应商耦合方面做出了不同的权衡。

<Info>
  Deep Agents 已被 [OpenSWE](https://github.com/langchain-ai/open-swe) 和 [LangSmith Fleet](/langsmith/fleet/index) 用于生产环境。
</Info>

## 概览

|               | **Deep Agents**                                                                                                                                                                                                | **Claude Agent SDK**                                                                                                                                         |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **代理运行位置**    | 在沙箱内运行，或在沙箱外远程执行命令                                                                                                                                                                                             | 在沙箱内运行                                                                                                                                                       |
| **执行后端**      | 可插拔：[本地、虚拟文件系统、远程沙箱或自定义](/oss/javascript/deepagents/backends)                                                                                                                                                  | 运行所在沙箱的本地文件系统                                                                                                                                                |
| **模型提供商**     | 任意（Anthropic、OpenAI、Google、100+ 其他）                                                                                                                                                                            | Claude（Anthropic、Bedrock、Vertex、Azure）                                                                                                                       |
| **按提供商/模型调优** | [配置文件](/oss/javascript/deepagents/profiles)（测试版）：系统提示、工具、中间件和子代理调整的声明式捆绑包，按提供商或特定模型注册                                                                                                                          | 在每次模型调用处通过代码配置                                                                                                                                               |
| **部署**        | 通过 [`deepagents deploy`](/oss/javascript/deepagents/deploy) 部署到 [LangSmith 托管云](/oss/javascript/langgraph/deploy)，或通过 [`langgraph build`](/langsmith/cli#build) 自托管[独立镜像](/langsmith/deploy-standalone-server) | [自托管](https://code.claude.com/docs/en/agent-sdk/hosting)。您需要构建服务器、认证和流式传输层。[Claude 托管代理](https://platform.claude.com/docs/en/managed-agents/overview)是一个独立产品 |
| **多租户**       | [内置](/oss/javascript/deepagents/going-to-production#multi-tenancy)：作用域线程、按用户沙箱、RBAC                                                                                                                            | 需自行构建                                                                                                                                                        |
| **许可证**       | MIT                                                                                                                                                                                                            | MIT（Claude Code 本身是专有的）                                                                                                                                      |

## 主要区别

### 代理与执行环境

[代理连接沙箱有两种模式](https://www.langchain.com/blog/the-two-patterns-by-which-agents-connect-sandboxes)：在沙箱*内部*运行代理，或在沙箱外部运行并**将沙箱作为工具使用**。

Claude Agent SDK 仅支持第一种。您的代理在沙箱内运行，并针对沙箱的本地文件系统执行工具。Anthropic 的托管模型 [Claude 托管代理](https://platform.claude.com/docs/en/managed-agents/overview)使用解耦模型，这反映了生产代理架构的发展方向。

Deep Agents 支持这两种模式，并允许您选择一个[后端](/oss/javascript/deepagents/backends#quickstart)将它们连接起来。实际上，这意味着您可以：

* 在沙箱内运行代理（与 Claude Agent SDK 相同的模型）。
* 在长期运行的容器中运行代理，并[使用远程沙箱作为工具](https://www.langchain.com/blog/the-two-patterns-by-which-agents-connect-sandboxes)，通过网络执行命令。
* 为测试换用虚拟文件系统，或为您的基础设施换用自定义后端。

### 多租户

当您将应用程序投入生产时，通常会将其暴露给许多最终用户，并且必须为每个用户隔离环境。

在 Claude Agent SDK 中，SDK 将代理绑定到其沙箱。要为每个用户提供隔离的执行环境，您必须构建一个 API 包装器，该包装器为每个用户启动一个沙箱，跟踪哪个沙箱属于哪个用户，并在之后将其拆除。

Deep Agents 直接处理此问题：在配置中为[每个用户或每个助手](/oss/javascript/deepagents/going-to-production#lifecycle)配置沙箱，包含作用域线程、运行历史记录和 [RBAC](/langsmith/rbac)。如果您使用 [LangSmith Sandbox](/langsmith/sandbox-auth-proxy)，您还可以开箱即用地获得一个认证代理，这样最终用户就可以从沙箱调用第三方 API，而无需您为每个用户配置凭证。

### 生产代理服务器

要将[自托管的 Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/hosting) 应用暴露给最终用户，您需要编写自己的 HTTP/WebSocket 或 SSE 服务器来调用代理、流式传输令牌并管理对话线程。该服务器需要您自行构建、操作和保护。

Deep Agents 部署包含一个开箱即用的[代理服务器](/langsmith/agent-server)：流式端点、线程管理、运行历史记录、webhooks 和[身份验证](/langsmith/auth)。

### 托管云或自托管

Claude Agent SDK 部署是[自托管的](https://code.claude.com/docs/en/agent-sdk/hosting)。SDK 和 [Claude 托管代理](https://platform.claude.com/docs/en/managed-agents/overview)是独立的产品。针对 SDK 编写的代码不能直接部署到托管服务。

Deep Agents 无需更改代码即可在两种模式下运行：

* **托管：** 使用 [`deepagents deploy`](/oss/javascript/deepagents/deploy) 部署到 [LangSmith 托管云](/oss/javascript/langgraph/deploy)。
* **自托管：** 运行 [`langgraph build`](/langsmith/cli#build) 生成一个[独立 Docker 镜像](/langsmith/deploy-standalone-server)，您可以将其部署到任何地方。

<Tip>
  [Claude 托管代理](https://platform.claude.com/docs/en/managed-agents/overview)在 Anthropic 生态系统内运行良好；对于 LangChain 中类似的低摩擦、模型无关路径，请使用 [LangSmith Fleet](/langsmith/fleet/index)。
</Tip>

### LLM

Claude Agent SDK 执行捆绑了模型、后端和部署，并优化了三者之间的支持。

使用 Deep Agents，您可以独立选择模型提供商、执行后端和部署目标。选择此配置工具，您可以在模型和基础设施的选择上保留最大的灵活性。

### 生态系统

Claude Agent SDK 是专为 Claude 和 Anthropic 的产品界面构建的。如果您已经标准化使用 Anthropic 生态系统（Claude API 和相关平台功能），坚持使用官方 SDK 可以意味着更少的组件、单一的代理功能和支持供应商，以及假设端到端使用相同技术栈的文档。

## 总结

* **选择 Deep Agents**，如果您需要模型和基础设施灵活性、内置多租户部署，以及无需更改代码即可选择托管或自托管的选项。
* **选择 Claude Agent SDK**，如果您已经投入 Anthropic 生态系统，并希望自托管并自行构建 API、认证和多租户层。

<Note>
  **发现错误？**

  我们于 2026 年 4 月 16 日起草了此比较。如果产品已更改，请[提交 issue](https://github.com/langchain-ai/docs/issues)。
</Note>

***

<div className="source-links">
  <Callout icon="terminal-2">
    [将这些文档](/use-these-docs)通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
  </Callout>

  <Callout icon="edit">
    [在 GitHub 上编辑此页面](https://github.com/langchain-ai/docs/edit/main/src/oss/deepagents/comparison.mdx)或[提交 issue](https://github.com/langchain-ai/docs/issues/new/choose)。
  </Callout>
</div>
