开始使用 Claude Managed Agents
创建您的第一个自主智能体。
本指南将引导您完成创建智能体、设置环境、启动会话以及流式传输智能体响应的过程。
Claude Code
让 Claude Code 为您设置智能体
/claude-api managed-agents-onboard核心概念
| 概念 | 描述 |
|---|---|
| Agent(智能体) | 模型、系统提示、工具、MCP 服务器和技能 |
| Environment(环境) | 会话运行位置的配置:Anthropic 托管的云沙箱,或在您自己的基础设施上自托管的沙箱 |
| Session(会话) | 在环境中运行的智能体实例,执行特定任务并生成输出 |
| Events(事件) | 您的应用程序与智能体之间交换的消息(用户轮次、工具结果、状态更新) |
开始之前
创建 Claude Console 账户
注册 Claude Console 账户,或登录您已有的账户。
选择身份验证方式
对于本地开发,建议使用 CLI 登录。
CLIAPI 密钥
安装 CLI
brew install anthropics/tap/ant对于 Linux 环境,请直接下载发布版二进制文件。
VERSION=2.12.1 OS=$(uname -s | tr '[:upper:]' '[:lower:]') case $(uname -m) in x86_64) ARCH=amd64 ;; aarch64) ARCH=arm64 ;; esac curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \ | sudo tar -xz -C /usr/local/bin ant您可以在 GitHub 发布页面上找到所有发布版本。
您也可以使用
go install从源代码安装 CLI,这需要 Go 1.26.10 或更高版本。go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install会将二进制文件放置在$(go env GOPATH)/bin中。如果该目录尚未添加到您的PATH中,请将其添加进去:export PATH="$PATH:$(go env GOPATH)/bin"登录
ant auth login登录完成后,SDK 和 CLI 将自动获取您的凭据。
创建 API 密钥
在 Claude Console 中创建 API 密钥。
设置环境变量
SDK 和 CLI 从
ANTHROPIC_API_KEY读取您的密钥:export ANTHROPIC_API_KEY="your-api-key-here"
要运行 CLI 示例,请安装 CLI:
brew install anthropics/tap/ant对于 Linux 环境,请直接下载发布版二进制文件。
VERSION=2.12.1
OS=$(uname -s | tr '[:upper:]' '[:lower:]')
case $(uname -m) in
x86_64) ARCH=amd64 ;;
aarch64) ARCH=arm64 ;;
esac
curl -fsSL "https://github.com/anthropics/anthropic-cli/releases/download/v${VERSION}/ant_${VERSION}_${OS}_${ARCH}.tar.gz" \
| sudo tar -xz -C /usr/local/bin ant您可以在 GitHub 发布页面上找到所有发布版本。
您也可以使用 go install 从源代码安装 CLI,这需要 Go 1.26.10 或更高版本。
go install github.com/anthropics/anthropic-cli/v2/cmd/ant@latestgo install 会将二进制文件放置在 $(go env GOPATH)/bin 中。如果该目录尚未添加到您的 PATH 中,请将其添加进去:
export PATH="$PATH:$(go env GOPATH)/bin"安装 SDK
pip install anthropic创建您的第一个会话
创建智能体
创建一个智能体,用于定义模型、系统提示和可用工具。
CLIant apply coding-assistant.mdcoding-assistant.md--- name: Coding Assistant model: claude-opus-5-5 tools: - type: agent_toolset_20260401 configs: - name: web_search enabled: false - name: web_fetch enabled: false --- You are a helpful coding assistant. Write clean, well-documented code.ant apply会打印智能体的 ID 并将其记录在claude-lock.json中。您创建的每个会话都会引用它。agent_toolset_20260401工具类型会启用预构建的智能体工具(bash、文件操作、网络搜索等)。此示例禁用了网络搜索和网页获取,因为本指南中的任务(编写一个简短的 Python 脚本)不会用到网页。请只为智能体提供它所需的工具。有关完整列表和各工具的配置选项,请参阅工具。创建环境
环境定义了智能体运行所在的沙箱。此环境使用
limited网络并允许包管理器,因此在沙箱中运行的代码可以访问公共包注册表和代码托管平台。在limited网络下,allowed_hosts列表同样适用于网络搜索和网页获取,尽管它们在沙箱外运行。如果未列出任何主机(此环境正是如此),这些工具不会返回任何页面或搜索结果。如果您自己的智能体使用这些工具,请将它所需的主机添加到该列表中。CLIant apply environment.yamlenvironment.yaml# yaml-language-server: $schema=https://platform.claude.com/schemas/ant/beta/environment.json name: quickstart-env config: type: cloud networking: type: limited allow_package_managers: trueant apply同样会将环境的 ID 记录在claude-lock.json中。要用一条命令同时创建智能体和环境,请传入两个文件:ant apply coding-assistant.md environment.yaml。启动会话
创建一个引用您的智能体和环境的会话。
Pythonsession = client.beta.sessions.create( agent=agent.id, environment_id=environment.id, title="Quickstart session", ) print(f"Session ID: {session.id}")发送消息并流式传输响应
打开一个流,发送用户事件,然后在事件到达时进行处理:
Pythonwith 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 generates the first 20 Fibonacci numbers and saves them to fibonacci.txt", }, ], }, ], ) # 处理流式传输事件 for event in stream: match event.type: case "agent.message": for block in event.content: if block.type == "text": print(block.text, end="") case "agent.tool_use": print(f"\n[Using tool: {event.name}]") case "session.status_idle": print("\n\nAgent finished.") break智能体会编写一个 Python 脚本,在沙箱中运行它,并验证输出文件已创建。您的输出类似如下:
I'll create a Python script that generates the first 20 Fibonacci numbers and saves them to a file. [Using tool: write] [Using tool: bash] The script ran successfully. Let me verify the output file. [Using tool: bash] fibonacci.txt contains the first 20 Fibonacci numbers (0 through 4181). Agent finished.
运行过程
当您发送用户事件时,Claude Managed Agents 会:
- 配置沙箱:您的环境配置决定沙箱的构建方式。
- 运行智能体循环:Claude 根据您的消息决定使用哪些工具。
- 运行工具:文件写入、bash 命令和其他工具调用都在沙箱内运行。
- 流式传输事件:在智能体工作时,您会收到实时更新。
- 进入空闲状态:当智能体没有更多工作要做时,会发出
session.status_idle事件。
构建完整应用
以下每个快速入门都将 Claude Managed Agents 与一个流行的聊天框架结合,构建出完整、可运行的应用程序。在每个示例中,框架负责渲染聊天界面,而托管会话在服务器端运行智能体循环:会话保存对话记录、在沙箱中运行工具,并流式传输由前端渲染的事件。
一个使用 Vercel 的 Chat SDK 构建的浏览器聊天研究分析师。每个对话都是一个持久会话,在流式传输回复的同时,实时信息流会显示工具调用。更换 Chat SDK 适配器即可将同一处理程序迁移到 Slack、Teams、Discord 或 WhatsApp。
一个使用 assistant-ui 基础组件构建的聊天式电子表格分析师。会话即线程列表,一个 reducer 将会话事件日志转换为消息和工具卡片,每条 bash 命令在运行前都会渲染一个内联的允许/拒绝关卡。
一个 CopilotKit 聊天中的个人理财助手。适用于 Claude Managed Agents 的 AG-UI 适配器将每个聊天线程映射到一个托管会话,并逐令牌流式传输回复,自定义工具会在对话中内联渲染交互式图表。
后续步骤
此页面对您有帮助吗?