选择智能体环境
决定 Claude Managed Agents 的工具和代码是在 Anthropic 托管的云环境中运行，还是在自托管沙箱中运行，并了解切换后会发生哪些变化。
环境决定了您的智能体的工具和代码在何处运行。它们在 "sandbox"（沙箱）中运行。沙箱是一个隔离的工作空间，例如容器，智能体在其中运行命令并处理文件。您有两个选项：
- 云环境： Anthropic 为您运行沙箱。每个会话都会在 Anthropic 托管的基础设施上获得一个全新的独立 Linux 容器，其中已预装常用的语言、数据库和实用工具。您可以选择其网络规则以及要安装的任何额外软件包。
- 自托管沙箱： 您在自己的基础设施上运行沙箱。Claude 仍在 Anthropic 一侧运行，并决定接下来调用哪个工具。一个由您运行的程序，称为 "worker"（工作进程），会在您的机器上执行智能体的 bash 和文件工具调用，并将每个结果发送回去。它还可以提供自定义工具。
无论您选择哪种方式，智能体定义都是相同的。您在智能体上设置模型、提示和工具，而不是在环境上设置。
从云环境开始
如果您不确定该选择哪种方式，或者您是 Claude Managed Agents 的新用户，请像快速入门那样，从云环境开始。Anthropic 会为每个会话运行一个隔离的容器，其中已预装常用的语言和工具，因此您无需托管任何内容。仅当工具必须在您控制的基础设施上运行时，才选择自托管沙箱。
比较选项
下表比较了这两个选项。
| 云环境（默认） | 自托管沙箱 | |
|---|---|---|
| 工具和代码的运行位置 | Anthropic 托管的沙箱 | 您的 worker，位于您的基础设施上 |
| 哪些内容会到达 Anthropic | 对话历史、工具结果、沙箱的文件和状态、技能以及记忆存储 | 对话历史、工具结果、技能以及记忆存储。沙箱的文件和进程保留在您的 worker 上。 |
| 您需要运维的内容 | 无 | worker 主机、其安全加固、其网络限制，以及您的 worker 用于身份验证的环境密钥 |
| 网络访问范围 | 您在环境上设置的网络规则 | 您自己的网络策略 |
| 文件和 GitHub 仓库挂载 | 由 Anthropic 管理 | 由您管理 |
| 记忆存储 | 由 Anthropic 挂载到 /mnt/memory/ | 下载到 /mnt/memory/ 并由 worker 同步 |
| 沙箱生命周期 | 由 Anthropic 管理 | 由您管理 |
| 何时选择 | 默认选项。您不需要工具在您自己的基础设施上运行。 | 工具必须在您控制的基础设施上运行。 |
何时选择自托管沙箱
当智能体需要执行以下任一操作时，自托管沙箱是合适的选择：
- 处理不能离开您网络的数据： 智能体的文件和进程保留在您的 worker 上。工具返回给模型的内容仍会到达 Managed Agents 服务。
- 访问无法公开路由的内部服务： 智能体的 bash 和文件工具，以及您的 worker 提供的任何自定义工具，都在您的网络内运行。连接智能体 MCP 服务器的是 Anthropic，而不是您的 worker。私有 MCP 服务器的背后可能是您的内部工单系统或公司 wiki。要访问它，您可以在任一选项下使用 MCP 隧道。MCP 隧道目前处于研究预览阶段，需要申请访问权限。请参阅自托管沙箱与 MCP 隧道。
- 在您组织自己的合规和审计控制下运行： 工具在您配置、记录日志和审计的主机上运行。
自托管沙箱不会改变的内容
无论选择哪个选项，对话历史和工具结果都会发送到由 Anthropic 运营的 Managed Agents 服务。模型正是通过这种方式接收每次工具调用的结果。网页搜索和网页抓取工具也在 Anthropic 一侧运行，而不是在沙箱中运行。请参阅限制网页搜索和网页抓取的域名。两个选项都不会改变 Managed Agents 的合规覆盖范围，也不会改变其保留对话历史的时长。请参阅 API 与数据保留。
使用自托管沙箱时您需要承担和放弃的内容
自托管沙箱使您成为 worker 主机的运维者。您需要加固沙箱镜像、控制网络出站流量、存储和轮换环境密钥，并将各个会话相互隔离。安全模型页面提供了详细信息。
您还将放弃以下云环境功能：
file和github_repository会话资源。您需要自行暂存输入文件，并且还需要负责挂载您自己的 GitHub 仓库。- 仓库技能发现。
- 保管库中的环境变量凭据。
- 云沙箱的预装运行时和软件包。自托管沙箱中包含的是您的 worker 所提供的内容。
Claude Platform on AWS 上的差异
如果您通过 Claude Platform on AWS 使用 Claude Managed Agents，服务仍由 Anthropic 运营。在该平台上，自托管沙箱无法使用记忆存储，worker 不使用环境密钥，并且 MCP 隧道不可用。请参阅 Claude Platform on AWS 上的 Claude Managed Agents 和不支持的功能。
从云环境切换到自托管沙箱
要切换到自托管沙箱，您需要保留智能体，创建一个 self_hosted 环境，并在新的会话和部署中引用其 ID。
- 保留的内容： 智能体定义、您的应用程序使用的 API 密钥或 AWS 凭据、您的技能、您的 MCP 服务器，以及您的记忆存储。
- 新增的内容： 一个
self_hosted环境、一个您在 Claude Console 中生成的环境密钥，以及一个由您运行的 worker。自托管沙箱快速入门涵盖了这三项内容。 - 停止工作的内容： 使用自托管沙箱时您需要承担和放弃的内容中列出的功能。
在 Claude Platform on AWS 上，记忆存储不会延续到自托管沙箱，并且 worker 不使用环境密钥。请参阅 Claude Platform on AWS 上的差异。
Was this page helpful?