English ← MyDocs

Claude 托管智能体概览

预构建、可配置的智能体框架，在托管基础设施中运行。最适合长时间运行的任务和异步工作。

Anthropic 提供两种使用 Claude 构建的方式，各自适用于不同的使用场景：

Messages APIClaude 托管智能体
是什么直接的模型提示访问预构建、可配置的智能体框架，在托管基础设施中运行
最适合自定义智能体循环和细粒度控制长时间运行的任务和异步工作
了解更多Messages API 文档Claude 托管智能体文档

Claude 托管智能体提供运行 Claude 作为自主智能体的框架和基础设施。您无需构建自己的智能体循环、工具执行和运行时，而是获得一个完全托管的环境，Claude 可以在其中安全地读取文件、运行命令、浏览网页和执行代码。该框架支持内置的提示缓存、压缩和其他性能优化，以实现高质量、高效的智能体输出。

Note

Claude 托管智能体也可在 Claude Platform on AWS 上使用，但在功能可用性和会话行为方面存在一些差异。请参阅 Claude Platform on AWS 指南中的 Claude 托管智能体。

◆快速入门

创建您的第一个智能体会话

◆API 参考

完整的端点文档

核心概念

Claude 托管智能体围绕四个概念构建：

概念描述
智能体模型、系统提示、工具、MCP 服务器和技能
环境会话运行位置的配置：Anthropic 托管的云容器，或您自己基础设施上的自托管沙箱
会话环境内运行的智能体实例，执行特定任务并生成输出
事件应用程序与智能体之间交换的消息（用户轮次、工具结果、状态更新）

工作原理

  1. 创建智能体

    定义模型、系统提示、工具、MCP 服务器和技能。创建智能体一次，然后通过 ID 在会话中引用它。

  2. 创建环境

    配置智能体运行位置：云容器，或您自己基础设施上的自托管沙箱。

  3. 启动会话

    启动引用您的智能体和环境配置的会话。

  4. 发送事件和流式响应

    将用户消息作为事件发送。Claude 自主执行工具并通过服务器发送事件（SSE）流式返回结果。事件历史记录在服务器端持久化，可以完整获取。

  5. 引导或中断

    发送额外的用户事件在执行过程中引导智能体，或中断它以改变方向。

何时使用 Claude 托管智能体

Claude 托管智能体最适合需要以下功能的工作负载：

  • 长时间运行的执行： 运行数分钟或数小时并包含多次工具调用的任务
  • 云基础设施： 具有预安装包和网络访问的安全容器
  • 自托管执行： 在您控制的基础设施上运行沙箱，以满足合规性或数据驻留要求
  • 最少基础设施： 无需构建自己的智能体循环、沙箱或工具执行层
  • 有状态会话： 跨多次交互的持久文件系统和对话历史记录

支持的工具

Claude 托管智能体让 Claude 可以访问一组内置工具：

  • Bash： 在容器中运行 shell 命令
  • 文件操作： 读取、写入、编辑、glob 和 grep 容器中的文件
  • 网络搜索和获取： 搜索网络并从 URL 检索内容
  • MCP 服务器： 连接到外部工具提供商

有关完整列表和配置选项，请参阅工具。

Beta 访问

Note

Claude 托管智能体目前处于 beta 阶段。所有托管智能体端点都需要 managed-agents-2026-04-01 beta 头。SDK 会自动设置 beta 头。行为可能会在版本之间进行改进以提高输出质量。

要开始使用，您需要：

  1. 一个 Claude API 密钥
  2. 所有请求上的 managed-agents-2026-04-01 beta 头
  3. 访问 Claude 托管智能体（所有 API 账户默认启用）

某些功能（MCP 隧道和做梦）处于研究预览阶段。请求访问以试用。

Claude 托管智能体在设计上是有状态的：会话是长时间运行的，可以在暂停后干净恢复，并在服务器端存储对话历史记录、容器状态和输出。因此，托管智能体目前不符合零数据保留或 HIPAA 商业伙伴协议（BAA）覆盖条件。您保留对此数据的控制权：您可以随时通过 API 删除会话，并单独删除您上传的任何文件。有关所有功能的资格，请参阅 API 和数据保留。

速率限制

托管智能体端点按组织进行速率限制：

操作限制
创建端点（智能体、会话、环境等）每分钟 300 个请求
读取端点（检索、列表、流等）每分钟 600 个请求

组织级别的支出限制和基于层级的速率限制也适用。

品牌指南

对于集成 Claude 托管智能体的合作伙伴，使用 Claude 品牌是可选的。在您的产品中引用 Claude 时：

允许：

  • "Claude Agent"（下拉菜单首选）
  • "Claude"（当在已标记为"Agents"的菜单中时）
  • "{YourAgentName} Powered by Claude"（如果您已有智能体名称）

不允许：

  • "Claude Code" 或 "Claude Code Agent"
  • "Claude Cowork" 或 "Claude Cowork Agent"
  • Claude Code 品牌的 ASCII 艺术或模仿 Claude Code 的视觉元素

您的产品应保持自己的品牌，不应看起来像 Claude Code、Claude Cowork 或任何其他 Anthropic 产品。有关品牌合规性的问题，请联系 Anthropic 销售团队。