概览

构建入门步骤

Claude Managed Agents 概览

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

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

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

快速开始

创建您的第一个代理会话

API 参考

完整的端点文档

核心概念

Claude Managed Agents 围绕四个概念构建：

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

工作原理

创建代理
定义模型、系统提示、工具、MCP 服务器和技能。创建一次代理并通过 ID 在会话中引用它。
创建环境
配置一个云容器，预装包（Python、Node.js、Go 等）、网络访问规则和挂载的文件。
启动会话
启动一个引用您的代理和环境配置的会话。
发送事件并流式传输响应
将用户消息作为事件发送。Claude 自主执行工具并通过服务器发送事件 (SSE) 流式传输结果。事件历史记录在服务器端持久化，可以完整获取。
引导或中断
发送额外的用户事件来在执行过程中引导代理，或中断它以改变方向。

何时使用 Claude Managed Agents

Claude Managed Agents 最适合需要以下功能的工作负载：

长时间运行执行 - 运行数分钟或数小时且包含多个工具调用的任务
云基础设施 - 具有预装包和网络访问的安全容器
最小基础设施 - 无需构建自己的代理循环、沙箱或工具执行层
有状态会话 - 跨多个交互的持久文件系统和对话历史记录

支持的工具

Claude Managed Agents 为 Claude 提供了一套全面的内置工具：

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

请参阅工具了解完整列表和配置选项。

Beta 访问

Claude Managed Agents 目前处于 beta 阶段。所有 Managed Agents 端点都需要 managed-agents-2026-04-01 beta 标头。SDK 会自动设置 beta 标头。行为可能会在版本之间进行调整以改进输出。

要开始使用，您需要：

一个 Claude API 密钥
上述 beta 标头在所有请求上
访问 Claude Managed Agents（默认为所有 API 账户启用）

某些功能（结果、多代理和内存）处于研究预览阶段。请求访问以尝试它们。

速率限制

Managed Agents 端点按组织进行速率限制：

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

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

品牌指南

对于集成 Claude Managed Agents 的合作伙伴，使用 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 销售团队。

Was this page helpful?

构建入门步骤

Claude Managed Agents 概览

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

Anthropic offers two ways to build with Claude, each suited to different use cases:

	Messages API	Claude Managed Agents
What it is	Direct model prompting access	Pre-built, configurable agent harness that runs in managed infrastructure
Best for	Custom agent loops and fine-grained control	Long-running tasks and asynchronous work
Learn more	Messages API docs	Claude Managed Agents docs

快速开始

创建您的第一个代理会话

API 参考

完整的端点文档

核心概念

Claude Managed Agents 围绕四个概念构建：

Concept	Description
Agent	The model, system prompt, tools, MCP servers, and skills
Environment	Configuration for where sessions run: an Anthropic-managed cloud container, or a self-hosted sandbox on your own infrastructure
Session	A running agent instance within an environment, performing a specific task and generating outputs
Events	Messages exchanged between your application and the agent (user turns, tool results, status updates)

工作原理

创建代理
定义模型、系统提示、工具、MCP 服务器和技能。创建一次代理并通过 ID 在会话中引用它。
创建环境
配置一个云容器，预装包（Python、Node.js、Go 等）、网络访问规则和挂载的文件。
启动会话
启动一个引用您的代理和环境配置的会话。
发送事件并流式传输响应
将用户消息作为事件发送。Claude 自主执行工具并通过服务器发送事件 (SSE) 流式传输结果。事件历史记录在服务器端持久化，可以完整获取。
引导或中断
发送额外的用户事件来在执行过程中引导代理，或中断它以改变方向。

何时使用 Claude Managed Agents

Claude Managed Agents 最适合需要以下功能的工作负载：

长时间运行执行 - 运行数分钟或数小时且包含多个工具调用的任务
云基础设施 - 具有预装包和网络访问的安全容器
最小基础设施 - 无需构建自己的代理循环、沙箱或工具执行层
有状态会话 - 跨多个交互的持久文件系统和对话历史记录

支持的工具

Claude Managed Agents 为 Claude 提供了一套全面的内置工具：

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

请参阅工具了解完整列表和配置选项。

Beta 访问

要开始使用，您需要：

一个 Claude API 密钥
上述 beta 标头在所有请求上
访问 Claude Managed Agents（默认为所有 API 账户启用）

某些功能（结果、多代理和内存）处于研究预览阶段。请求访问以尝试它们。

速率限制

Managed Agents 端点按组织进行速率限制：

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

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

品牌指南

对于集成 Claude Managed Agents 的合作伙伴，使用 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 销售团队。

Was this page helpful?