ClaudeManaged AgentsSelf-hostingArchitecture
更新于

Claude Managed Agents 可以自托管了,模型仍在另一端

11 月 12 日开放的自托管方案把 Agent 服务和会话存储搬到自己的基础设施。分清它与自托管沙箱、模型权重部署的边界,再判断团队是否值得迁移。

查看接入文档
Claude Managed Agents 可以自托管了,模型仍在另一端

团队想把 Agent 的文件操作留在内网,也想自己保存会话记录,现在有了更完整的选择。Anthropic 在 11 月 12 日宣布提供自托管 Claude Managed Agents:除了工具运行的沙箱,负责调度、API 和会话存储的服务也可以由自己运行。

这项变化解决的是服务部署位置。模型推理仍由所选供应商执行,默认是 Anthropic。 把 Agent 服务搬进机房,不会顺带拿到 Claude 权重,也不自动让请求内容留在内网。

本文于 2026 年 11 月 16 日重读官方更新记录和自托管说明。当前获取方式是联系 Anthropic 客户团队申请访问。下面是架构与迁移判断,没有下载受限安装包、启动服务器或验证 Nbility 对接。

先确定要搬走哪一层

Managed Agents 把 Agent 循环、会话事件与工具运行组合起来,但这些部分可以由不同一方负责:

方案工具沙箱Agent 服务与会话存储模型推理
默认云端方案AnthropicAnthropicAnthropic
自托管沙箱自己AnthropicAnthropic
自托管 Managed Agents自己自己Anthropic 或配置的供应商

只要求“命令在自己的机器执行”,通常先看自托管沙箱即可。要求“会话历史也由自己保存”,才进一步涉及整套服务。如果要求模型也在自己的基础设施运行,还要另外解决权重、推理引擎与许可;开放权重的部署工作讨论的是那一层。

三种部署方式分别标出工具、服务与推理的托管方

这种拆分也解释了为什么一个模型 API 地址不能替代完整 Agent 服务。LLM 网关的职责主要是模型接入与请求处理;会话推进、工具执行和工作文件需要其他组件承担。

数据库在自己手里,发给模型的内容仍要盘点

官方架构里,cma-server 负责 API、Agent 循环和存储;worker 领取工作,在沙箱中运行 shell 与文件工具。服务器本身不执行这些工具。持久数据库要求 PostgreSQL 16 或更高版本;不配置数据库时只在内存保存,重启会丢失数据。

每次模型调用,服务器会把当前对话,包括工具输入和结果,发给推理供应商。默认调用 Claude API 时,还会携带会话、Agent 和环境 ID。因此,数据审查至少应覆盖这几条路径:

  • 应用向自托管服务发送的用户消息与附件。
  • worker 读到的文件,以及回传给服务的工具结果。
  • 服务发往模型供应商的完整调用内容。
  • 工具自己访问的外部网站、仓库和业务系统。

应用与工具数据进入自有服务后,模型请求仍可能离开内网

“历史存在自己的数据库”只能回答保存位置的一部分问题。模型供应商的处理政策、工具外发路径和备份仍需分别核对。调试时可以沿最小求助日志的方法记录时间、状态和标识,避免顺手复制全部正文。

API 一样,不代表原有应用直接搬家

与托管版的差异清单值得在申请机器之前读完。当前自托管服务不提供普通 Messages、Models 或 Files API;把 SDK 的地址改过去后,/v1/messages 和 /v1/models 会返回 404。模型调用应由另一个指向推理供应商的客户端完成。

托管版的会话历史不会自动复制过来。Agent、Skills、凭据与记忆存储都需要在新服务重新建立。预置文档 Skills、计划任务、Dreams、Webhooks 也存在缺失或替代要求,不能只验收“创建会话成功”就宣布迁移完成。

可以先做一张很短的搬迁表:

原应用依赖自托管前要决定
托管版历史与资源哪些导出、哪些重建,如何核对完整性
云端工具环境worker 在哪里常驻,任务如何被领取
Webhook 唤醒改用事件流或查询后,谁负责持续运行
计划任务用自己的调度器,另记重入与失败处理
模型调用供应商、完整协议、模型映射和访问资格

自己运行 worker,也接过了隔离责任

官方特别提醒:worker 的 bash 是真实 shell,拥有 worker 进程的权限和网络访问能力。worker 本身不会替 shell 建立隔离;隔离来自外面的容器、Pod 或虚拟机。自己手动启动时,应放在可丢弃、没有重要资料的环境里。

因此,先用公开演示仓库验证一轮:提交一个只读任务,确认 worker 领取、工具结果回传、模型继续回答和重启后的历史恢复;再检查失败任务有没有越过目录或网络范围。本文没有执行这一轮,不给隔离成功率或运维成本估计。工具权限设计可作为检查思路,但不能代替实际运行环境的限制。

访问资格、依赖迁移、隔离与恢复分别通过后,再切换业务

官方允许把推理请求交给自己的模型网关,并提供 anthropic-messages 等格式配置。是否能经过 Nbility,要按Claude 原生兼容文档核对完整会话、工具和特殊字段;本文没有完成该组合验证。若目前只缺统一模型入口,可以先解决网关需求;确实需要自己管理服务与历史时,再承担整套服务的升级、备份和故障处理。

如果客户只希望把模型账单付到自己的组织,可另看 Claude Linked billing 的付款与数据边界。它改变费用归属,请求仍运行在应用组织,不能代替自托管或客户自己的数据安排。

相关文章

用 Nbility 跑通你的 Agent 工作流

获取 API Key,统一接入 OpenAI 兼容模型和开发工具。

获取 API Key