目录
在生产环境中运行一个智能体,意味着智能体循环、工具执行、沙箱以及状态持久化——全部都要自己搭建。Claude Managed Agents 把这整副担子从你手中卸下:由 Anthropic 替你运行。它在 2026 年 4 月 8 日作为公测(public beta)发布,是一套用于大规模构建和部署云托管智能体的可组合 API。
本文基于官方信息,介绍 Managed Agents 是什么、它与自托管的 Agent SDK 有何不同、持久化记忆与“dreaming”、基于结果的评分与多智能体,以及定价。先把要点放在前面。① 你不再需要“自己搭建智能体循环”,而是获得一个全托管环境,Claude 可以在其中安全地读取文件、运行命令、浏览网页并执行代码。 ② 它具备工作区范围的持久化记忆(挂载在 /mnt/memory),并可由一次“dream”对其进行重组与整合。 ③ 定价为 tokens + 每个 session-hour $0.08。
Anthropic 接管整个“运行侧”
—— 循环、沙箱、状态与记忆,全部托管在托管基础设施上
/mnt/memory你只需专注于定义智能体。定价为 tokens + 每个 session-hour $0.08(仅在 running 时计费,精确到毫秒计量)。
1. 什么是 Managed Agents?
用 Anthropic 自己的话说,Managed Agents 是“一套用于大规模构建和部署云托管智能体的可组合 API”,文档则将它描述为“运行在托管基础设施上的预构建、可配置的智能体框架(agent harness)”。其核心在于:“你不必再自己搭建智能体循环、工具执行和运行时,而是获得一个全托管环境,Claude 可以在其中安全地读取文件、运行命令、浏览网页并执行代码。”提示缓存、上下文压缩、沙箱化以及状态持久化都从一开始就内置其中。
它围绕四个概念组织——Agent(定义)/ Environment(运行的地方)/ Session / Events。Environment 可以是 Anthropic 托管的云沙箱,也可以是运行在你自己基础设施上的自托管沙箱。
Agent 可以挂载 Anthropic 提供的技能(pptx、xlsx、docx、pdf),也可以挂载你自己编写并上传的技能(每个 session 最多 500 个)。工具方面,除了内置工具集和 MCP 服务器,还可以定义由你自己的代码执行的“自定义工具”。
这里说的“缰绳”(harness),指智能体中除模型以外的一整套机制(循环、工具、记忆、安全措施等)。这个思路本身在什么是缰绳工程一文中有详细解说。
2. 与 Agent SDK 的区别(自托管 vs 托管)
容易混淆的,是它与 Claude Agent SDK 的差别。这两者沿着“你来运行” vs “Anthropic 来运行”这条轴线构成一对。
- 用 Python / TypeScript 搭建你自己的框架
- 由你来运营循环、工具与运行时
- 基础设施与扩展由你负责
- 对细节拥有完全的掌控
- 循环、沙箱与状态都在托管侧
- 持久化记忆与 dreaming 内置其中
- 按运行时计费($0.08/小时)
- 专注于定义,把运营交出去
简而言之:“想自己造引擎?用 Agent SDK。想租用引擎、专注于内容?用 Managed Agents。”它们并非竞争对手——而是关于你自己掌握多少运营的一种选择。关于智能体的概念,参见 什么是多智能体;关于如何构建,参见 如何构建多智能体系统。
3. 持久化记忆与“dreaming”
Managed Agents 的一项标志性功能是持久化记忆(memory store)。它是“一组工作区范围的文本文档”,以目录形式(/mnt/memory/)挂载在 session 的沙箱内。智能体用普通的文件操作来读写它,其内容会跨 session 持久保留。每一次变更都会创建一个不可变的记忆版本以供审计。过去的版本自写入起保留 30 天,但仍在使用的记忆,其最近的版本无论多久都会保留(很少改动的记忆可能留有超过 30 天的历史)。如需更长时间保留历史,可通过 API 导出。限制为:每条记忆 100 kB、每个 store 10,000 条记忆、每个 session 8 个 store。
开发者需要注意:操作 memory store 的 API 使用专用的 beta header agent-memory-2026-07-22。如果与 managed-agents-2026-04-01 同时发送,会返回 400 错误(把 memory store 挂到 session 上的操作仍使用原来的 header)。在自托管沙箱中,记忆不是一直连通的挂载,而是由工作进程持有一份副本并进行同步(memory 文档)。
更不寻常的是“dreaming”。按官方描述:“一次 dream 会读取现有的 memory store 以及过往的 session 文字记录,然后产出一个全新的、经过重组的 memory store:合并重复项,用最新值替换过时或被推翻的条目,并浮现出新的洞见。”它是一个异步任务(输入 1–100 个 session,可附带可选的指令),需要专用的 beta header dreaming-2026-04-21(仅有 managed-agents-2026-04-01 无法调用 dream 的端点)。
运行 dream 的模型在创建时指定。dreams 文档列出研究预览期间支持的 9 个模型:Claude Opus 5.5、Claude Fable 5.1、Claude Opus 5、Claude Fable 5、Claude Opus 4.8、Claude Opus 4.7、Claude Sonnet 5.5、Claude Sonnet 5、Claude Sonnet 4.6(2026 年 10 月 12 日确认)。不在列表中的 Haiku 系列模型无法运行 dream。dream 的费用按所指定模型的标准 token 单价计算。
⚠️ 准确性说明:dreaming 是一项需要申请访问权限的研究预览(research preview)。Anthropic 的发布博客(2026 年 5 月 19 日)称它为“按计划运行的流程”,并说可以让它自动更新记忆,也可以先审阅变更再应用。而 API 文档则把它描述为由你创建并查询状态的异步任务:它从不修改输入的 memory store,而是另外写出一个输出 store,结果不满意可以直接丢弃。本文不断言“Anthropic 总会自动运行它”。
4. 结果评分与多智能体
一项较新的功能是基于结果的评分(outcomes-based grading)。按 Anthropic 的说法:“你编写一份描述成功标准的评分量表(rubric),智能体朝着它努力。一个独立的评分器(grader)在它自己的上下文窗口中,依据你的标准对输出进行评估。”Anthropic 报告称它“相较标准的提示循环,将任务成功率最多提升了 10 个百分点”(docx +8.4%、pptx +10.1%)。这些是 Anthropic 自己测得的数值——发布博客称之为“our internal benchmarks”——并非第三方测量。处于公测阶段。
多智能体编排同样内置其中:“一个主导智能体(lead agent)把任务拆分成若干部分,并把每一部分委派给一个拥有各自模型、提示与工具的专家智能体”,它们在共享文件系统上并行运行。这种编排智能体的设计理念,与 如何构建多智能体系统 相呼应。
目前分派工作的方式有三种(多智能体文档)。① 委派给子智能体(subagent)(委派只能有一层,子线程最多同时 25 个)。② dynamic workflows:由智能体自己编写一个“运行多个智能体并汇总结果的程序”,由服务器执行(一次执行最多可启动 1,000 个智能体,每个 session 默认最多同时打开 10 个执行)。③ advisor:自己继续工作,在制定计划或检查收尾等环节向更高级的模型寻求建议(建议部分按该模型的单价计费)。无论哪种方式,所有运行过的智能体的 tokens 都会计费,因此官方建议为 session 设置金额上限。
5. 发布后新增的功能
自 2026 年 4 月 8 日发布以来,Managed Agents 每隔几周就会增加功能。日期来自 Anthropic 的发布博客(2026 年 10 月的条目来自 Claude Platform 的发行说明)。
- 2026 年 4 月 23 日——记忆:memory store 以公开测试版发布。
- 2026 年 5 月 19 日——outcomes、多智能体编排、webhooks、dreaming:前三项为公开测试版,dreaming 为研究预览。工作完成时可以通过 webhook 收到通知。
- 2026 年 5 月 19 日——自托管沙箱与 MCP 隧道:可以只把工具执行移到自己的基础设施上(或 Cloudflare、Daytona、Modal、Vercel 等沙箱提供商),循环、上下文管理和错误恢复仍留在 Anthropic 一侧。MCP 隧道可在不公开的前提下连接内网中的 MCP 服务器,目前为研究预览。
- 2026 年 6 月 9 日——定时部署(scheduled deployments)与 vault:可以按 cron 表达式和时区定时启动智能体(最小粒度为 1 分钟)。存进 vault 的 API 密钥,在沙箱里只有一个占位值;真正的密钥在网络边界处、且只在发往你允许的域名的请求上才会附加,智能体本身看不到密钥。
- 2026 年 10 月 7 日——网络限制扩展到网页搜索与网页抓取:云端环境的网络设为
limited时,允许的主机(allowed_hosts)现在也适用于web_search和web_fetch工具。用web_fetch抓取未被允许的主机上的 URL 会返回错误,web_search会略去这些主机的结果。allowed_hosts为空时,两个工具都不会返回任何页面或搜索结果。allow_package_managers和allow_mcp_servers不会为这两个工具增加可访问的主机。unrestricted网络和自托管沙箱不受影响。此外,若已启用的网页工具的allowed_domains中有allowed_hosts之外的主机,创建会话会以 400 错误失败(添加此类条目的会话更新也一样)。allowed_hosts的条目除非以*.开头,否则只匹配一个确切的主机,因此docs.example.com不在["example.com"]之内。 - 2026 年 10 月 7 日——网页抓取只限会话中出现过的 URL:
web_fetch现在只抓取此前已在会话中出现过的 URL,例如用户消息正文、web_search的结果,或之前用web_fetch抓取过的页面。这是为了降低数据外泄的风险。只出现在 Claude 自身输出、系统提示词、附加文档,或bash、MCP 工具输出中的 URL 不算,抓取它会返回url_not_in_prior_context错误。想让智能体抓取某个 URL,就在user.message事件的正文中发送它。 - 2026 年 10 月 9 日——dynamic workflows(beta):第 4 节方式②中提到的 dynamic workflows 开始可以使用。智能体编写一个“分阶段运行多个智能体并汇总结果的程序”,服务器在后台把它作为 workflow run 执行。启用方法是把智能体的
multiagent字段设为multiagent_20261001类型并开启 workflows,再在系统提示词里说明何时启动。运行进度可通过事件流中的workflow_run.*事件跟踪。 - 2026 年 10 月 14 日——定时部署现在也可用于 Claude Platform on AWS:6 月发布的定时部署,现在也可用于 Claude Platform on AWS(2026 年 10 月 18 日确认)。在 AWS 上,每次运行都会以你自己 AWS 账户中的 IAM 角色创建一个 session。需要先把智能体的
execution_identity设为aws_role;未设置就创建部署会返回 400 错误。定时部署文档目前仍标注为测试版。 - 2026 年 10 月 14 日——OpenTelemetry 导出(测试版):Messages API 的请求和 Managed Agents 的 session 现在可以通过 OpenTelemetry 接入你现有的监控体系进行追踪(2026 年 10 月 18 日确认)。Claude 的 SDK 支持用 Python、TypeScript、C#、Go、Java、PHP 和 Ruby 输出 span;若需要 API 一侧的 span,可在 Claude Console 中添加导出目标(官方文档)。
此外还可以设置每个会话的花费上限(session budget):按公开价格累计用量,达到上限后停止发起新的模型请求。
6. 定价与可用性
定价有两个维度:① tokens(标准模型费率,并应用提示缓存)+ ② 会话运行时间,每个 session-hour $0.08。运行时间精确到毫秒计量,且仅在状态为 running 时计费(闲置或重新调度时免费)。Anthropic 的算例:一次消耗 5 万输入 tokens、1.5 万输出 tokens 的 1 小时编码 session 约为 $0.705。这个算例使用的是 Claude Opus 5 的单价(每百万 tokens 输入 $5/输出 $25,依据 2026 年 9 月时的定价页面)。
按 2026 年 10 月 12 日定价页面的单价,把同样的条件按模型重新计算如下。右列对应 Anthropic 的第二个算例,即输入中有 4 万 tokens 为缓存读取(缓存读取通常为输入单价的 0.1 倍;Opus 5.5 和 Sonnet 5.5 为 0.05 倍)。
| 模型(每百万 tokens 输入/输出) | 输入 5 万、输出 1.5 万、运行 1 小时 | 其中 4 万为缓存读取 |
|---|---|---|
| Claude Opus 5($5/$25)(Anthropic 的算例) | $0.705 | $0.525 |
| Claude Opus 5.5($4/$20) | $0.58 | $0.428 |
| Claude Sonnet 5.5($2/$10) | $0.33 | $0.254 |
| Claude Haiku 4.5($1/$5) | $0.205 | $0.169 |
| Claude Haiku 5.5($0.10/$0.50)(单次输入不超过 10 万 tokens) | $0.0925 | $0.0889 |
各行的运行时间费用都是 $0.08,差距来自 tokens。模型越便宜,运行时间在账单中的占比越大(Haiku 4.5 约占四成,Haiku 5.5 约占九成)。另外,Haiku 5.5 在单次请求的输入超过 10 万 tokens 时会适用更高的单价(输入 $0.50、输出 $2.50)。在上下文不断累积的智能体 session 中,很容易越过这条界线。
仅运行时间的月费可按“每天运行小时数 × 30 天 × $0.08”算出。只计算状态为 running 的时间,等待你下一条消息的 idle 时间不计。即使整天开着 session,也只按实际工作的时间计费。
| 每天运行时长 | 每月运行时间费用(30 天) | 参考:每小时消耗同样的 tokens(Sonnet 5.5) | 同上(Opus 5.5) |
|---|---|---|---|
| 1 小时 | $2.40 | $9.90 | $17.40 |
| 4 小时 | $9.60 | $39.60 | $69.60 |
| 8 小时 | $19.20 | $79.20 | $139.20 |
| 24 小时 | $57.60 | $237.60 | $417.60 |
右边两列假设每小时消耗的 tokens 与上面的算例相同(输入 5 万、输出 1.5 万、无缓存)。实际的 tokens 用量因任务不同会相差几个数量级,因此请把运行时间一列当作下限,并用session 金额上限来控制 tokens 费用。
| 项目 | 详情 |
|---|---|
| 发布 | 2026 年 4 月 8 日 · 公测(对所有 API 账户默认启用) |
| 访问方式 | 通过 Claude Console / Platform CLI / Claude Code |
| 定价 | Tokens + 每个 session-hour $0.08(仅在 running 时,精确到毫秒计量) |
| 网页搜索 | 会话内的搜索按标准价格计费(每 1,000 次 $10) |
| 折扣 | Batch API 的折扣不适用(会话有状态、需交互,没有批处理模式) |
| 加价 | 将智能体的 model.inference_geo 固定为 "us" 时,tokens 按 1.1 倍计费;将 model.speed 设为 "fast" 时适用 fast 模式的加价单价 |
| 注意事项 | 设计上是有状态的,因此不符合 Zero Data Retention(ZDR)或 HIPAA BAA 的资格 |
| 记忆 / dream | dreaming 是研究预览(需申请访问权限) |
7. 上手步骤
官方快速入门分为 4 步。所有请求都需要带上测试版请求头 managed-agents-2026-04-01(SDK 会自动添加)。
- 创建 Agent:定义模型、系统提示词、工具、MCP 服务器和技能。内置工具集(bash、文件操作、网页搜索等)通过
agent_toolset_20260401启用。创建一次后即可凭 ID 反复使用。 - 创建 Environment:决定在哪里运行。云端沙箱需指定预装的软件包,以及对外通信是全部放开(
unrestricted)还是只允许指定主机(limited)。通过 API 创建时若省略该设置,则为unrestricted;而 Console 的创建界面默认从limited开始。官方要求明确指定。自 2026 年 10 月 7 日起,limited的允许主机也适用于网页搜索和网页抓取工具,这些工具要用的网站需加入allowed_hosts(加入的主机沙箱也能访问)。 - 启动 Session:指定 Agent 和 Environment 后启动。花费上限(budget)也在这里设置。
- 发送事件并接收结果:把用户消息作为事件发送后,Claude 会自主调用工具,并通过 server-sent events(SSE)流式返回结果。中途可以追加指示,也可以中断。
Agent 和 Environment 也可以写成文件,用 CLI 的 ant apply 创建。如果想从 Claude Code 开始,在最新版中运行 /claude-api managed-agents-onboard,就会开始一边对话一边完成设置的引导(官方快速入门)。
8. 适合与不适合的场景
根据官方文档的“适用场景”和定价页面的条件,整理如下。
| 如果你…… | 应选择 |
|---|---|
| 想把耗时几分钟到几小时、需多次调用工具的工作异步交出去 | Managed Agents |
| 想按固定周期运行,比如每周报告 | Managed Agents 的定时部署 |
| 不能把代码或机密文件交给外部沙箱 | Managed Agents 的自托管沙箱 |
| 想亲手逐步控制循环 | 用 Messages API 自建循环,或使用 Agent SDK |
| 必须满足零数据保留(ZDR)或 HIPAA BAA | Managed Agents 不在适用范围内,需自建循环 |
| 想用 Batch API 折扣低价处理大量任务 | Managed Agents 不支持,请用 Messages API 的 Batch |
| 想通过 Amazon Bedrock 或 Google Cloud 使用 | Bedrock 以及 Google 运营的版本(原 Vertex AI)中未提供 Anthropic 运营的 Claude Platform on AWS 可用 Anthropic 运营的 Google Cloud 版本(2026 年 10 月 22 日正式发布)也可用,但不支持 MCP 隧道 两种 Google Cloud 版本的区别见“在 Vertex AI 上使用 Claude” |
总结
Claude Managed Agents 是一个全托管环境,Anthropic 替你运营智能体循环、工具执行、沙箱以及状态持久化。自托管的 Agent SDK 意味着“你来运行引擎”,而 Managed Agents 意味着“Anthropic 来运行,你专注于定义”——这是一对在运营责任归属上有所不同的选择。
它的标志性特征是工作区范围的持久化记忆(挂载在 /mnt/memory,跨 session 持久保留),以及用于重组与整合它的“dreaming”(研究预览),此外还有基于结果的评分与多智能体编排。定价为 tokens + 每个 session-hour $0.08,作为 2026 年 4 月的公测面向所有 API 账户开放(有状态,因此不符合 ZDR / HIPAA BAA 资格)。相关:Agent SDK 指南、什么是多智能体、如何构建多智能体系统。
FAQ
Q. 什么是 Managed Agents?
A. Anthropic 的一套用于构建和部署云托管智能体的 API。你不必再自己搭建智能体循环、工具执行和运行时,而是获得一个全托管环境,Claude 可以在其中安全地读取文件、运行命令、浏览网页并执行代码。提示缓存、压缩、沙箱化以及状态持久化都内置其中。它在 2026 年 4 月 8 日作为公测发布。
Q. 它与 Agent SDK 有何不同?
A. 区别在于谁来掌握运营。Agent SDK 是一个你用 Python / TypeScript 自己运行的自托管框架,由你来运营循环、工具与基础设施。Managed Agents 则由 Anthropic 在托管基础设施上提供循环、沙箱、状态与记忆,你专注于定义智能体。它们不是竞争对手——而是关于你自己保留多少运营的一种选择。
Q. 什么是持久化记忆和“dreaming”?
A. 持久化记忆(memory store)是一组工作区范围的文本文档,以 /mnt/memory/ 挂载在沙箱中;智能体用普通的文件操作来读写它,并且它会跨 session 持久保留。“Dreaming” 是一个异步任务,它读取现有记忆和过往的 session 文字记录,以产出一个经过重组的 memory store——合并重复项、更新过时的值,并浮现出新的洞见。dreaming 目前是一项研究预览(需申请访问权限)。
Q. 它的费用是多少?
A. 两个维度:token 费用 + 会话运行时间,每个 session-hour $0.08。运行时间精确到毫秒计量,且仅在状态为 running 时计费(闲置 / 重新调度时免费)。Anthropic 的估算是一次消耗 5 万输入 tokens、1.5 万输出 tokens 的 1 小时 session 约为 $0.705(按 Claude Opus 5 的单价:tokens 费用 $0.625+运行时长 $0.08)。按 2026 年 10 月 12 日的单价,同样条件下 Opus 5.5 为 $0.58、Sonnet 5.5 为 $0.33、Haiku 4.5 为 $0.205、Haiku 5.5 约为 $0.09。仅运行时间一项,每天 running 8 小时,每月为 $19.20(8 × 30 × $0.08)。tokens 采用标准模型费率并应用提示缓存。
Q. 任何人都能使用吗?
A. 它是自 2026 年 4 月 8 日起的公测,对所有 API 账户默认启用,可通过 Claude Console / Platform CLI / Claude Code 访问。但由于它在设计上是有状态的,因此不符合 Zero Data Retention(ZDR)或 HIPAA BAA 的资格。另请注意,各功能因阶段而异——dreaming 是一项研究预览,需申请访问权限(请查阅官方文档获取最新信息)。