6.1 Agent SDK 概述
什么是 Agent SDK
Agent SDK 是 Anthropic 官方提供的软件开发工具包，用于使用 TypeScript 或 Python 构建 AI 代理应用程序。它是 Claude Code 的底层引擎，允许开发者创建自己的 AI Agent 应用。
与 Claude Code 的区别
| 特性 | Claude Code | Agent SDK |
|---|---|---|
| 用途 | 命令行开发工具 | 构建自定义AI代理 |
| 接口 | 交互式CLI | API/SDK |
| 定制性 | 有限定制 | 完全可定制 |
| 目标用户 | 开发者个人 | 需要构建AI应用的团队 |
核心功能
- Agent 循环：内置的代理循环机制，自动处理多轮对话
- 工具调用：轻松注册自定义工具，扩展代理能力
- 会话管理：支持多会话、上下文管理和状态持久化
- 流式处理：支持流式输入输出，实时响应
- 权限控制：细粒度的权限配置，控制代理行为
- 可观测性：内置 OpenTelemetry 支持，监控和追踪
支持的编程语言
- TypeScript：官方主推，支持最新特性
- Python：完整的 SDK 支持
- TypeScript V2 (预览)：下一代 SDK
安装
TypeScript SDK
npm install @anthropic-ai/claude-code-sdk
# 或
yarn add @anthropic-ai/claude-code-sdkPython SDK
pip install anthropic-agent-sdk
# 或
uv add anthropic-agent-sdk基本架构
+------------------+
| Your App |
+------------------+
|
v
+------------------+
| Agent SDK |
| - Agent Loop |
| - Tool Registry|
| - Session Mgmt |
+------------------+
|
v
+------------------+
| Claude API |
+------------------+适用场景
- 构建企业级 AI 助手
- 开发特定领域的 AI 代理
- 将 AI 能力集成到现有产品
- 创建需要精细控制的 AI 应用
- 多代理系统和工作流编排