中文 | English

Anthropic 提供了两种构建 Claude 应用的方式，分别适合不同用例：

	Messages API	Claude Managed Agents
它是什么	直接进行模型提示调用	运行在托管基础设施中的预构建、可配置 agent harness
最适合	自定义 agent loop 和细粒度控制	长时间运行任务与异步工作
进一步了解	Messages API 文档	Claude Managed Agents 文档

Claude Managed Agents 提供了把 Claude 当作自主 agent 运行所需的 harness 与基础设施。你不必自己构建 agent loop、工具执行层和运行时，而是获得一个完全托管的环境，其中 Claude 可以读取文件、运行命令、浏览网页，并安全地执行代码。这个 harness 支持内建的 prompt caching、compaction 以及其他性能优化，以获得高质量且高效率的 agent 输出。

核心概念

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

概念	描述
Agent	模型、system prompt、tools、MCP servers 与 skills 的组合
Environment	已配置好的容器模板，包含软件包和网络访问等设置
Session	在某个 environment 中运行的 agent 实例，执行具体任务并生成输出
Events	应用与你的 agent 之间交换的消息，例如用户轮次、工具结果和状态更新

工作方式

1. 创建 agent
   定义模型、system prompt、tools、MCP servers 和 skills。agent 创建一次后，可在多个 session 中通过 ID 复用。
2. 创建 environment
   配置云端容器，预装软件包（Python、Node.js、Go 等）、网络访问规则和挂载文件。
3. 启动 session
   启动一个引用该 agent 和 environment 配置的 session。
4. 以 events 形式发送用户消息
   Claude 会自主执行工具，并通过 server-sent events（SSE）流式返回结果。事件历史会持久保存在服务端，并可完整拉取。
5. 引导或中断
   在执行过程中继续发送用户 events 来调整方向，或通过中断来改变任务走向。

何时使用 Claude Managed Agents

Claude Managed Agents 最适合以下工作负载：

• 长时间运行执行：需要运行数分钟到数小时，并伴随多次工具调用的任务
• 云端基础设施：需要安全容器、预装软件包和网络访问能力
• 最小化基础设施负担：不想自己构建 agent loop、sandbox 或工具执行层
• 有状态 session：需要在多轮交互之间保留文件系统和对话历史

支持的工具

Claude Managed Agents 为 Claude 提供了一整套内建工具：

• Bash：在容器中运行 shell 命令
• 文件操作：读取、写入、编辑、glob 和 grep 容器内文件
• Web 搜索与抓取：搜索网页并获取 URL 内容
• MCP servers：连接外部工具提供方

完整列表与配置选项见 Tools。

Beta 访问

Claude Managed Agents 目前处于 beta。所有 Managed Agents 端点都需要 managed-agents-2026-04-01 beta header。SDK 会自动设置该 beta header。不同版本之间的行为仍可能继续调整，以改进输出质量。

开始使用需要：

1. 一个 Claude API key
2. 在所有请求上带上上述 beta header
3. 访问 Claude Managed Agents 的权限（默认对所有 API 账户开放）

某些功能（outcomes、multiagent 和 memory）仍处于 research preview。若想试用，可申请访问。

速率限制

Managed Agents 端点按组织限流：

操作	限额
创建类端点（agents、sessions、environments 等）	每分钟 60 次请求
读取类端点（retrieve、list、stream 等）	每分钟 600 次请求

组织级 spend limit 与分层 rate limit 也同样适用。

品牌使用规范

对于集成 Claude Managed Agents 的合作伙伴，是否使用 Claude 品牌是可选的。若你在产品中提及 Claude：

允许：

• “Claude Agent”（下拉菜单里优先推荐）
• “Claude”（前提是菜单本身已经标记为 “Agents”）
• “{YourAgentName} Powered by Claude”（如果你已有自己的 agent 名称）

不允许：

• “Claude Code” 或 “Claude Code Agent”
• “Claude Cowork” 或 “Claude Cowork Agent”
• 带有 Claude Code 风格的 ASCII art 或模仿 Claude Code 的视觉元素

你的产品应保持自身品牌，不应让用户误以为它是 Claude Code、Claude Cowork 或任何其他 Anthropic 产品。若对品牌合规性有疑问，请联系 Anthropic sales team。

这个页面是否有帮助？