如何使用Claude托管代理？

如果您曾尝试将AI代理部署到生产环境，您会知道困难的部分通常不在于模型本身，而是围绕它的一切：沙箱化、状态管理、凭证处理、工具执行、错误恢复，以及将原型转化为可靠系统所需的所有基础设施。Anthropic的Claude托管代理通过提供一个完全托管的平台，让您无需管理复杂的操作层，从而简化了这一过程。本文是一份面向开发者的实用指南，将介绍其核心概念、最新更新，并逐步构建一个可工作的代理。

什么是Claude托管代理？

Claude托管代理是Anthropic用于运行Claude作为自主代理的托管基础设施层。它于2026年4月8日公开发布测试版，标志着代理开发的一次重大转变，将大部分执行负担从开发者转移到Anthropic的托管环境。您只需定义代理、设置权限，然后让Anthropic处理运行时。Claude获得一个安全的管理空间，用于读取文件、运行shell命令、浏览网页和执行代码，而无需您配置服务器或编写隔离逻辑。

底层架构围绕四个核心概念组织：

• 代理：代理的定义，包括模型、系统提示、工具、MCP服务器连接和技能。
• 环境：会话运行的位置，可以是Anthropic管理的云沙箱或您自己基础设施上的自托管沙箱。
• 会话：代理在环境中的一个运行实例，执行一项特定任务。每个会话都有自己的文件系统、上下文窗口和事件流。
• 事件：应用程序与代理之间流动的消息，包括用户输入、工具结果和状态更新。

主要功能

Claude托管代理提供以下现成的功能：

• 安全沙箱：代理在隔离的沙箱环境中运行。身份验证、工具执行和秘密管理由Anthropic的基础设施处理。
• 长时间运行的自主会话：代理可以运行数分钟或数小时，跨越多个工具调用。会话在网络断开时仍可持久保存。
• 有状态设计：会话可以在暂停后干净地恢复，并存储服务器端的对话历史、沙箱状态和输出。
• 内置工具：每个代理均可访问bash（shell命令）、文件操作（读、写、编辑、glob、grep）、网络搜索和获取，以及MCP服务器以连接外部工具提供商。
• 治理和追踪：作用域权限允许您精确定义代理可以访问的工具和数据源。还提供身份管理和完整执行追踪。

最新更新：梦境、成果和多代理编排

Anthropic推出了三个显著的功能，推动平台从运行代理转向运行能学习和验证工作的代理：

• 梦境：在代理会话之间运行的计划进程，用于回顾过去的工作、识别模式并整理记忆，使代理随时间改进。
• 成果：定义一个“好”的标准，代理朝此标准努力。独立的评分器在自身的上下文窗口中评估输出，标记问题并提示代理修改。
• 多代理编排：当单个代理不足时，主代理将任务分解为更小的部分，并委派给具有各自模型、提示和工具的专业子代理。这些代理并行工作、共享文件、向主代理报告，并在控制台中留下可追踪的工作流。

例如，Netflix的平台团队使用此功能并行分析数百个流水线的构建日志，只突出显示值得采取行动的模式。

实践：构建您的第一个代理

以下步骤演示如何创建代理、为其提供环境、启动会话并观察其工作。

前提条件：拥有Anthropic控制台账户和API密钥。设置环境变量ANTHROPIC_API_KEY，并安装CLI和SDK。

步骤1：创建代理

ant beta:agents create \
--name "Coding Assistant" \
--model '{"id":"claude-haiku-4-5"}' \
--system "You are a helpful coding assistant. Write clean, well-documented code." \
--tool '{"type":"agent_toolset_20260401"}'

保存返回的agent.id。

步骤2：创建环境

ant beta:environments create \
--name "quickstart-env" \
--config '{"type":"cloud","networking":{"type":"unrestricted"}}'

步骤3：运行会话 以下Python脚本创建一个会话，分配任务并流式传输事件：

import os
from anthropic import Anthropic

client = Anthropic(api_key=os.environ["ANTHROPIC_API_KEY"].strip())
AGENT_ID = "YOUR_AGENT_ID"
ENVIRONMENT_ID = "YOUR_ENV_ID"

session = client.beta.sessions.create(
    agent=AGENT_ID,
    environment_id=ENVIRONMENT_ID,
    title="Quickstart session",
)

with client.beta.sessions.events.stream(session.id) as stream:
    client.beta.sessions.events.send(
        session.id,
        events=[{"type": "user.message", "content": [{"type": "text", "text": "Create a Python script that finds the first 50 prime numbers..."}]}]
    )
    for event in stream:
        # process events

代理将编写脚本、执行并验证输出。

何时使用Claude托管代理？

托管代理并非适用于所有场景。当您的任务需要长时间执行、最小化基础设施、有状态的会话、治理和可审计性，或合规性敏感执行时，它可以发挥价值。如果您只需要直接模型提示或完全控制运行时，则应使用其他选项。

总之，Claude托管代理在处理大规模运行代理的基础设施负担时最为有用。