在生产环境中运行一个智能体,意味着智能体循环、工具执行、沙箱以及状态持久化——全部都要自己搭建。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 · MANAGED AGENTS

Anthropic 接管整个“运行侧”

—— 循环、沙箱、状态与记忆,全部托管在托管基础设施上

☁ 托管环境(由 Anthropic 运行)
智能体循环 + 工具执行
沙箱 文件/bash/网页/代码
状态 持久化、压缩、缓存
Memory store /mnt/memory
⟳ 一次 dream 会重组记忆(合并重复项 / 更新过时的值)

你只需专注于定义智能体。定价为 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 来运行”这条轴线构成一对。

Agent SDK
= 你来运行(自托管)
  • 用 Python / TypeScript 搭建你自己的框架
  • 由你来运营循环、工具与运行时
  • 基础设施与扩展由你负责
  • 对细节拥有完全的掌控
Managed Agents
= Anthropic 来运行(托管)
  • 循环、沙箱与状态都在托管侧
  • 持久化记忆与 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 的资格
记忆 / dreamdreaming 是研究预览(需申请访问权限)

7. 上手步骤

官方快速入门分为 4 步。所有请求都需要带上测试版请求头 managed-agents-2026-04-01(SDK 会自动添加)。

  1. 创建 Agent:定义模型、系统提示词、工具、MCP 服务器和技能。内置工具集(bash、文件操作、网页搜索等)通过 agent_toolset_20260401 启用。创建一次后即可凭 ID 反复使用。
  2. 创建 Environment:决定在哪里运行。云端沙箱需指定预装的软件包,以及对外通信是全部放开(unrestricted)还是只允许指定主机(limited)。通过 API 创建时若省略该设置,则为 unrestricted;而 Console 的创建界面默认从 limited 开始。官方要求明确指定。自 2026 年 10 月 7 日起,limited 的允许主机也适用于网页搜索和网页抓取工具,这些工具要用的网站需加入 allowed_hosts(加入的主机沙箱也能访问)。
  3. 启动 Session:指定 Agent 和 Environment 后启动。花费上限(budget)也在这里设置。
  4. 发送事件并接收结果:把用户消息作为事件发送后,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 BAAManaged 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 是一项研究预览,需申请访问权限(请查阅官方文档获取最新信息)。