Claude Managed Agents 概述

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

Claude Managed Agents 提供了将 Claude 作为自主智能体运行所需的框架和基础设施。您无需自行构建智能体循环、工具执行和运行时，即可获得一个完全托管的环境，Claude 可以在其中安全地读取文件、运行命令、浏览网页和运行代码。该框架支持内置的 "prompt caching"（提示缓存）、"compaction"（压缩）以及其他性能优化，以实现高质量、高效率的智能体输出。如果您希望通过直接访问模型来构建自己的智能体循环，请参阅使用 Messages API。



核心概念

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



工作原理



何时使用 Claude Managed Agents

Claude Managed Agents 最适合具有以下需求的工作负载：

• 长时间运行的执行： 运行数分钟或数小时、涉及多次工具调用的任务
• 云基础设施： 预装软件包并具备网络访问能力的安全沙箱
• 自托管执行： 在您控制的基础设施上运行沙箱，以满足合规性或数据驻留要求
• 最少的基础设施： 无需自行构建智能体循环、沙箱或工具执行层
• 有状态会话： 跨多次交互持久保存的文件系统和对话历史
• 定时执行： 通过定时部署按 cron 计划定期运行智能体



支持的工具

Claude Managed Agents 为 Claude 提供了一组内置工具：

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

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



Beta 访问

要开始使用，您需要：

1. 一个 Claude API 密钥
2. 在所有请求中添加 managed-agents-2026-04-01 beta 标头
3. Claude Managed Agents 的访问权限（默认为所有 API 账户启用）

在 beta 阶段内，MCP 隧道和 dreaming（梦境）处于更为有限的研究预览阶段。请申请访问权限以启用它们。

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

请参阅参考文档中的速率限制和品牌指南。