Agent SDK
Agent SDK 概览
Claude Agent SDK 的完整介绍 — 使用 TypeScript 或 Python 构建自定义 AI Agent
什么是 Claude Agent SDK？
Claude Agent SDK 让开发者基于 Claude Code 的架构构建自定义 AI Agent。它提供了与 Claude Code 相同的工具系统、会话管理和 MCP 集成能力，让你可以创建针对特定场景优化的 Agent。
何时使用
| 场景 | 推荐方案 |
|---|---|
| 日常编程任务 | 直接使用 Claude Code CLI |
| 自定义开发工作流 | Agent SDK |
| CI/CD 自动化 | Agent SDK |
| 批量代码处理 | Agent SDK |
| 特定领域 Agent | Agent SDK |
核心架构
┌─────────────────────┐
│ Your Application │
├─────────────────────┤
│ Claude Agent SDK │
│ ┌───────────────┐ │
│ │ Tool System │ │ ← 内置 + 自定义工具
│ │ Sessions │ │ ← 会话管理
│ │ MCP Client │ │ ← MCP 服务器连接
│ └───────────────┘ │
├─────────────────────┤
│ Claude API │ ← 模型调用
└─────────────────────┘支持的语言
- TypeScript/Node.js — 主要支持语言
- Python — 社区支持
安装
npm install @anthropic-ai/claude-code-sdk最简示例
import { ClaudeCode } from "@anthropic-ai/claude-code-sdk";
const claude = new ClaudeCode();
const result = await claude.sendMessage("解释 package.json 的作用");
for await (const event of result) {
if (event.type === "text") {
process.stdout.write(event.text);
}
}核心功能
- 工具系统 — 内置文件操作、命令执行、代码搜索等工具，支持自定义扩展
- 会话管理 — 创建、暂停、恢复对话会话
- MCP 集成 — 连接 MCP 服务器获取外部工具能力
- 流式输出 — 实时获取 Agent 的思考和执行过程
- 权限控制 — 细粒度的工具执行权限管理