Agent SDK 是构建自定义 Claude 代理的框架——完全控制代理的行为、工具和流程。
什么是 Agent SDK
Agent SDK 是 Anthropic 提供的开发工具包,让你能以编程方式构建和运行 Claude 代理。与 Claude Code 不同,Agent SDK 给你完整的控制权:
- 定义自定义工具
- 控制代理循环
- 管理会话和上下文
- 集成外部服务
- 构建 CLI 或 Web 应用
安装
# Python
pip install anthropic
# Node.js
npm install @anthropic-ai/sdk
基本用法
Python 示例
from anthropic import Anthropic
client = Anthropic()
message = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
system="你是一个编码助手",
messages=[
{"role": "user", "content": "解释这段代码的功能"}
]
)
print(message.content[0].text)
Node.js 示例
import Anthropic from "@anthropic-ai/sdk";
const anthropic = new Anthropic();
const message = await anthropic.messages.create({
model: "claude-sonnet-4-20250514",
max_tokens: 1024,
system: "你是一个编码助手",
messages: [
{ role: "user", content: "解释这段代码的功能" }
]
});
console.log(message.content[0].text);
Agent SDK 与 Claude Code 的区别
| 特性 | Claude Code | Agent SDK |
|---|---|---|
| 文件系统访问 | 内置 | 需自行实现 |
| 命令执行 | 内置 | 需自行实现 |
| 自定义工具 | 通过 MCP | 直接定义 |
| UI | 终端/桌面应用 | 完全自定义 |
| 控制力 | 有限 | 完全控制 |
| 集成复杂度 | 低 | 中到高 |
适用场景
- 构建内部编码工具
- 集成到现有的开发工作流
- 创建面向特定领域的代理
- 嵌入到更大的应用中
下一步
- Agent SDK 快速入门:开始构建第一个代理
- Agent SDK 自定义工具:扩展代理能力
- Agent SDK Agent 循环:实现智能代理循环