agentic

Claude Managed Agents:它是什么、如何工作、定价和限制4 min read

Reading Time: 3 minutesClaude Managed Agents 指南:大脑和双手设计、自发布以来发布的功能、会话定价、限制以及何时使用它代替消息 API。

Claude Managed Agents cover: a brain connected to hands and a session log

Claude Managed Agents:它是什么、如何工作、定价和限制4 min read

Reading Time: 3 minutes

每个构建代理的团队在第二周左右都会遇到同样的困难。原型可以在你的笔记本电脑上运行,然后有人要求它在没有你的情况下运行一个小时,将数据库密码放在模型无法触及的地方,在崩溃的容器中幸存下来,并在明天从停止的地方继续运行。这些都与提示无关。它是管道,它是管道 Anthropic 决定为您运行。

Claude Managed Agents于2026年4月8日推出公开测试版,是Claude平台上的托管服务。您定义一个代理,为其提供一个云沙箱,然后启动 Anthropic 为您运行的会话,其中包含内置工具集、流式事件、内存、计划运行和一长串控件。自推出以来,Anthropic 几乎每个月都会推出新产品,并且在 10 月下旬,关于其工作原理的免费 90 分钟研讨会开始广泛流传。

本指南供开发人员和技术主管决定是否在此基础上进行构建。我们将介绍它是什么、会话如何运行、重要的功能、成本、停止位置以及它与运行您自己的循环的比较。

关于结果去向的注释。托管会话可以将报告、电子表格和应用程序写入其沙箱,并且这些文件可通过 API 检索。之后他们需要的是一个让您的团队和其他助手可以打开、查看和继续编辑它们的地方。AgentGrid.io是一个共享工作空间,人们和人工智能代理可以在其中创建、编辑和共享文档、应用程序和文件,并有一个实时版本和谁更改了什么的历史记录。我们将在最后几节中讨论这一点。

Claude Managed Agents是什么?

Claude Managed Agents 是 Anthropic 的托管代理运行时。您无需编写调用模型、运行工具并反馈结果的循环,而是描述代理并让服务运行它。它处于测试阶段,您可以使用managed-agents-2026-04-01beta 标头,它可在 Claude API、AWS 上的 Claude 平台以及 Google Cloud 上的 Claude 模型上使用,其中 Anthropic 在 Google Cloud 上对其进行管理。

该文档将其简化为四个概念:

概念 它是什么
代理 型号、系统提示、工具、MCP服务器及技能
环境 会话运行位置:Anthropic 管理的云沙箱,或您自己的基础设施上的自托管沙箱
会议 环境中正在运行的代理实例,执行一项任务并生成输出
活动 应用程序和代理之间交换的消息:用户轮次、工具结果和状态更新

这与消息 API 有什么不同?消息 API 只为您提供型号,仅此而已。您编写循环、工具和沙箱,这正是您需要细粒度控制时所需要的。托管代理针对的是长时间运行的异步工作,您宁愿移交任务并观察事件。

消息 API 托管代理
谁运行循环 你的代码 Anthropic
工具 你实施它们 内置:bash、读取、写入、编辑、glob、grep、网络获取、网络搜索以及 MCP
代码运行的地方 无论您在何处设置 每个会话一个新的 Linux 容器,或者您自己的自托管沙箱
最适合 自定义循环和细粒度控制 长时间运行的异步工作

内置的云沙箱附带 Python、Node、Go、Rust、Java、Ruby、PHP 和 C/C++,以及 Postgres、Redis 和 SQLite。网络可以设置为limited,因此您的代理编写的代码可以到达包注册表,仅此而已。 Claude 控制台还具有可视代理构建器和测试会话运行器,这是在编写代码之前感受其行为的最快方法。

为什么Anthropic将大脑与双手分开?

产品文档中没有对该设计的最佳解释。这是一个名为 Anthropic 的工程帖子“扩展托管代理:将大脑与双手分离”,在发布当天发布。这要从一个熟悉的故事开始。第一个版本将会话、调用 Claude 的工具和沙箱放在一个容器中。从古老的宠物与牛的意义上来说,这使得服务器成为宠物:如果容器发生故障,会话就会丢失,并且必须护理反应迟钝的容器使其恢复健康。

解决方法是将代理分为三个部分,这些部分分别失败并独立扩展:

  • 会议是发生的所有事情的仅附加日志。
  • 大脑是安全带加上 Claude。它读取日志并决定下一步做什么。
  • 双手是沙箱和工具,通过一个狭窄的界面到达,execute(name, input) → string。
Claude Managed Agents 的示意图:会话日志、由 Harness 和 Claude 组成的大脑、沙箱作为手,通过执行调用连接
Anthropic 的工程帖子中描述了大脑和手部分裂的原始图。

有两个后果很突出。首先,安全性:凭证永远不必到达 Claude 生成的代码运行的沙箱。克隆存储库时会连接 Git 令牌,并且 MCP 调用会通过保管库代理。其次,速度:因为大脑现在仅在需要时才通过工具调用来请求容器,因此不需要立即使用沙箱的会话不会等待沙箱,Anthropic 报告称,第一个令牌的中值时间下降了约 60%,第 95 个百分位数下降了 90% 以上。这篇文章的结束语是“多脑多手”,一个大脑可以驱动多个沙箱。

同样的配对也出现在其他代理设计中。 DeepSeek 的超级代理文章在主张将代理的计算、状态和环境分开时引用了这篇文章。如果您想进行比较,我们的指南DeepSeek Super-Agent涵盖了该故事的路由器和工作人员方面。

自推出以来已经发货了什么?

四月份之后,托管代理迅速行动。这个时间线来自Anthropic自己的公告。

日期 (2026) 运送了什么 状态
4月8日 托管代理推出 公开测试版
4月23日 内存 公开测试版
5月6日 结果、多代理编排和网络钩子。做梦 公开测试版。研究预览中的梦想
6月11日 计划的部署和环境变量凭证 由Anthropic公布
6月30日 事件增量和可观察性选项卡 由Anthropic公布
8月7日 从存储库加载的技能 由Anthropic公布
8月19日 三项更新,包括带有自托管沙箱的内存 由Anthropic公布
9 月 10 日 ant beta:sessions connect会话查看器 由Anthropic公布

会话实际上是如何运行的?

流量很短。您创建一个代理,创建一个环境,启动一个指向两者的会话,然后交换事件。的快速入门通过几个命令即可完成此操作。代理是一个小文件,有前面的内容和提示,环境是几行 YAML:

快速入门,来自 Anthropic 的文档
# coding-assistant.md
---
name: Coding Assistant
model: claude-opus-5-5
tools:
  - type: agent_toolset_20260401
---

You are a helpful coding assistant. Write clean, well-documented code.

# environment.yaml
name: quickstart-env
config:
  type: cloud
  networking:
    type: limited
    allow_package_managers: true

# Create both, then start a session
ant apply coding-assistant.md environment.yaml
ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID" \
  --title "Quickstart session"

之后,您发送用户事件并读取流。代理写入的文件/mnt/session/outputs/通过文件 API 可用,范围仅限于该会话。ant beta:sessions connect打开实时会话的查看器。

工具的使用受权限策略的约束。代理工具集默认为always_allow, MCP 工具默认为always_ask,并与auto服务器评估每个调用并运行它、拒绝它或暂停以供您批准。第三方凭证位于保管库中,可以是 MCP OAuth 或不记名凭证,也可以是代理仅将其视为不透明占位符的环境变量凭证,当请求离开沙箱时,会交换为真实值。

除了一个循环之外,代理还能做什么?

子代理、工作流程和顾问

多代理设置允许代理进行委托。委派深度为一层,最多有 25 个子线程。对于更大的工作,动态工作流程允许代理编写一个在后台运行多个代理的程序,并且会话可以在中间咨询顾问模型以获取指导,例如规划方法或审查工作,同时继续自行完成工作。

结果

结果将模糊的“做好”变成了一个循环。您给出一个评分标准,然后在单独的环境中工作的评分者会对结果进行评分,并将代理返回以进行改进。max_iterations默认为 3,最多可达 20。

预算

会话可以带有硬性支出上限,以美分字符串表示。它是在模型请求之间强制执行的,因此单个长请求仍然可以在上限生效之前完成。当达到限制时,会话将进入空闲状态budget_reached正在等你。

记忆与梦想

内存存储安装到沙箱中/mnt/memory/。每个内存的上限为 100 kB,一个存储最多可容纳 10,000 个内存,并且每次更改都会创建一个不可变的版本。 Dreaming 仍然是一项研究预览,它读取了 1 到 100 个过去的会话,并提出了一种经过重复数据删除、重组的内存存储。它从不编辑输入存储,因此您可以在采用之前进行比较。

预定部署

计划部署在 IANA 时区的 cron 表达式上运行代理。 Anthropic 添加了高达 15% 的时间间隔抖动,最短时间为 5 秒,最长为 9 分钟,因此数千个计划不会同时触发。一个组织最多可以进行 1,000 次部署,并且每次运行都会有预算。

沙箱应该在云端还是在您自己的机器上?

默认是 Anthropic 托管的云沙箱。如果您的代码、数据或网络无法离开您的基础设施,您可以运行自托管沙箱:您身边的工作人员执行 bash 和文件工具调用。大脑仍然在 Anthropic 一侧运行,因此对话历史记录和工具结果仍然到达服务。

云沙箱 自托管沙箱
工具执行的位置 由 Anthropic 管理的全新 Linux 容器 您的基础设施上的工作人员
Claude 运行的地方 Anthropic Anthropic
什么会留在你身边 无论您选择发送什么 文件和执行。历史记录和工具结果仍然到达服务
很合身 大多数代理、快速启动、不受信任的代码 私人存储库、内部网络、您必须保留的数据

自 8 月 19 日起,在自托管沙箱中完成的工作也可以保存到内存中。

Claude Managed Agents 的价格是多少?

您按照模型的正常费率支付代币,再加上每会话小时 0.08 美元,仅在会话处于running状态。闲置等待您的时间不会被计费。网络搜索费用为每 1,000 次搜索 10 美元。仅美国推论将代币价格乘以1.1,并且没有批量折扣。

Anthropic 的定价页面通过一个示例进行工作:Opus 5.5 上的一小时会话,定价为每百万个输入代币 4 美元,每百万个输出代币 20 美元,有 50,000 个输入代币和 15,000 个输出代币。

行项目 计算 成本
输入令牌 50,000,每百万 4 美元 0.20 美元
输出代币 15,000,每百万 20 美元 0.30 美元
会话运行时间 1 小时 0.08 美元 $0.08
合计 0.58 美元

使用提示缓存,在文档示例中,同一会话的成本为 0.428 美元。这个例子的重点是账单的形状:对于一个短的、令牌量小的会话,运行时间是一小部分,而对于大部分闲置的长会话来说,它更小。支出以代币为主,这就是会话预算很重要的原因。

有哪些限制和风险?

  • 这是一个测试版。功能集变化很快,MCP 隧道和梦想仍处于研究预览阶段。
  • 合规性差距。托管代理不符合零数据保留或 HIPAA 条件,并且记录会一直保留,直到您将其删除。
  • 硬顶。委派深度为一层,最多有 25 个子线程,一个组织可以容纳 1,000 个计划部署。
  • 无批量折扣,并且仅限美国的推理在代币上的成本要高出 10%。
  • 安全仍然是你的工作。Anthropic 的部署指南是为每个代理提供最小的可用工具集、使用有限的网络、将凭证保存在保管库中、设置always_ask使用不可逆转的工具,并且永远不要组合always_allow使用读取不可信输入的代理编写或执行工具。

免费研讨会值得您花时间吗?

Anthropic 在 2026 年旧金山人工智能工程师世界博览会上举办了一个由四部分组成、时长约 90 分钟的托管代理研讨会。它由托管代理工程团队的 Priyanka Phatak 和 Gabe Cemaj 领导,录音正在进行人工智能工程师网站。该书于 10 月 30 日在 X 上疯传,章节列表如下:

  1. 为什么大脑和手应该分开 (00:00)
  2. Claude Managed Agents 背后的架构 (07:45)
  3. 逐步构建研究代理 (23:40)
  4. 在任务之间做梦的预定代理 (54:00)
  5. 为许多客户进行评估、CI/CD 和运行代理 (1:10:23)

以“替换每 500 美元教程”为热情。有用的部分是具体的:第一部分与工程岗位的架构相同,研究代理构建显示了端到端的真实会话,最后一部分回答了团队接下来提出的问题,即评估、CI/CD 和多租户。

什么时候应该使用托管代理、消息 API 或自运行的东西?

  • 使用托管代理当工作长时间运行或异步时,需要一个具有真实工具的沙箱,并且您宁愿不维护循环、容器生命周期和凭证管道。
  • 使用消息 API当您需要自定义循环、严格控制每个步骤或简短的请求-响应交互时。
  • 使用自托管沙箱当文件和执行必须保留在您的基础设施上时,您可以接受历史记录和工具结果仍然通过 Anthropic 传递。

它还有助于将其与解决不同问题的代理系统分开。托管代理是一个代理运行位置及其可触及内容的基础设施。诸如 DeepSeek 的 dsh-superagent 之类的路由器是关于代理侦听谁以及何时采取行动的。您可以想象同时使用两者。

托管代理的输出应该去哪里?

预定的代理编写周一的竞争对手摘要,或构建比较电子表格的研究会议,以文件结束/mnt/session/outputs/。文件 API 使其可检索,但仅限于该会话,并且该文件仍然只是一个文件。必须有人打开它,要求更改,将其交给另一位助手并记住当前版本。

AgentGrid.io是为那个阶段而建造的。人们和人工智能代理处理相同的实时文档、应用程序和文件,具有稳定的地址、受控访问以及记录谁更改了什么(人或代理)的历史记录。代理通过运行从支持命令的环境进行连接npx @animaapp/cli@latest login,并且有人批准代理的名称、团队以及其读取、写入、共享和发布的权限。托管代理没有内置的 AgentGrid.io 集成,因此简单的模式是您自己的代码或管道中的一个步骤,它从文件 API 中获取完成的文件并将其放置在共享工作区中。我们的指南Claude 和 ChatGPT 之间共享上下文对于对话也表现出同样的想法。

常见问题

Claude Managed Agents是什么?

Claude Managed Agents 是 Anthropic 的长期运行代理的托管运行时,自 2026 年 4 月 8 日起公开测试版。您定义代理和环境,启动会话,Anthropic 运行循环、工具和云沙箱,将事件流式传输回您的应用程序。

Claude Managed Agents 的价格是多少?

您需要为模型支付标准代币费率,再加上会话运行时每个会话小时 0.08 美元。空闲时间不计费。网络搜索每 1,000 次搜索为 10 美元,仅限美国的推理会将代币价格乘以 1.1。 Anthropic 的一小时 Opus 5.5 示例具有 50,000 个输入和 15,000 个输出代币,价格为 0.58 美元。

Claude Managed Agents 是否普遍可用?

还没有。它处于测试阶段,您选择加入managed-agents-2026-04-01beta 标头和一些功能(包括梦想和 MCP 隧道)是研究预览。

托管代理与消息 API 有何不同?

使用消息 API,您可以自己编写代理循环、工具和沙箱,这适合自定义循环和细粒度控制。托管代理为您运行循环和沙箱,适合长时间运行的异步工作。

Claude Managed Agents 可以在我自己的基础设施上运行吗?

部分。自托管沙箱允许基础设施上的工作人员执行 bash 和文件工具,但 Claude 本身仍然在 Anthropic 一侧运行,因此对话历史记录和工具结果仍然会到达服务。

托管代理可以处理敏感数据吗?

小心点。该服务不符合零数据保留或 HIPAA 要求,记录会一直保留,直到您将其删除,并且 Anthropic 建议对不可逆转的工具进行有限的网络、保管库凭据和批准提示。