# Claude 托管智能体概览

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

---

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

| | Messages API | Claude 托管智能体 |
|---|---|---|
| **是什么** | 直接的模型提示访问 | 预构建、可配置的智能体框架，在托管基础设施中运行 |
| **最适合** | 自定义智能体循环和细粒度控制 | 长时间运行的任务和异步工作 |
| **了解更多** | [Messages API 文档](/docs/en/build-with-claude/working-with-messages) | [Claude 托管智能体文档](/docs/en/managed-agents/overview) |

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

<Note>
Claude 托管智能体也可在 Claude Platform on AWS 上使用，但在功能可用性和会话行为方面存在一些差异。请参阅 Claude Platform on AWS 指南中的 [Claude 托管智能体](/docs/en/build-with-claude/claude-platform-on-aws#claude-managed-agents)。
</Note>

<CardGroup cols={2}>
  <Card title="快速入门" icon="play" href="/docs/en/managed-agents/quickstart">
    创建您的第一个智能体会话
  </Card>
  <Card title="API 参考" icon="code-brackets" href="/docs/en/managed-agents/sessions">
    完整的端点文档
  </Card>
</CardGroup>

## 核心概念

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

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

## 工作原理

<Steps>
  <Step title="创建智能体">
    定义模型、系统提示、工具、MCP 服务器和技能。创建智能体一次，然后通过 ID 在会话中引用它。
  </Step>
  <Step title="创建环境">
    配置智能体运行位置：云容器，或您自己基础设施上的[自托管沙箱](/docs/en/managed-agents/self-hosted-sandboxes)。
  </Step>
  <Step title="启动会话">
    启动引用您的智能体和环境配置的会话。
  </Step>
  <Step title="发送事件和流式响应">
    将用户消息作为事件发送。Claude 自主执行工具并通过服务器发送事件（SSE）流式返回结果。事件历史记录在服务器端持久化，可以完整获取。
  </Step>
  <Step title="引导或中断">
    发送额外的用户事件在执行过程中引导智能体，或中断它以改变方向。
  </Step>
</Steps>

## 何时使用 Claude 托管智能体

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

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

## 支持的工具

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

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

有关完整列表和配置选项，请参阅[工具](/docs/en/managed-agents/tools)。

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

要开始使用，您需要：

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

某些功能（[MCP 隧道](/docs/en/agents-and-tools/mcp-tunnels/overview)和[做梦](/docs/en/managed-agents/dreams)）处于研究预览阶段。[请求访问](https://claude.com/form/claude-managed-agents)以试用。

Claude 托管智能体在设计上是有状态的：会话是长时间运行的，可以在暂停后干净恢复，并在服务器端存储对话历史记录、容器状态和输出。因此，托管智能体目前不符合[零数据保留](/docs/en/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope)或 HIPAA 商业伙伴协议（BAA）覆盖条件。您保留对此数据的控制权：您可以随时通过 API [删除会话](/docs/en/managed-agents/sessions#deleting-a-session)，并单独删除您上传的任何[文件](/docs/en/build-with-claude/files#delete-a-file)。有关所有功能的资格，请参阅 [API 和数据保留](/docs/en/manage-claude/api-and-data-retention#feature-eligibility)。

## 速率限制

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

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

组织级别的[支出限制和基于层级的速率限制](/docs/en/api/rate-limits)也适用。

## 品牌指南

对于集成 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 [销售团队](https://www.anthropic.com/contact-sales)。