Agent SDK 概览

Claude Agent SDK 是将 Claude Code 的自主 Agent 循环封装为可编程库的工具，支持 Python 和 TypeScript，让开发者能在自己的应用中嵌入具备读文件、执行命令、搜索网络、编辑代码等能力的 AI Agent。SDK 内置了与 Claude Code 相同的工具集，无需自行实现工具执行逻辑即可快速上手。

核心机制

与 Client SDK 的本质区别：Client SDK 需要开发者自己实现工具循环（while stop_reason == “tool_use”），Agent SDK 则由 Claude 自主处理工具调用，开发者只需消费消息流。

内置工具集：Read、Write、Edit、Bash、Glob、Grep、WebSearch、WebFetch、AskUserQuestion、Monitor 等，覆盖文件操作、代码搜索、命令执行、网络访问全场景。

扩展能力：

• MCP 服务器集成（数据库、浏览器、API 等外部系统）
• 自定义工具（in-process MCP server）
• Hooks 机制（工具调用前后注入逻辑）
• Subagents（派生专项子 Agent）
• Sessions（跨调用保持上下文）

认证方式：支持 Anthropic API Key、Amazon Bedrock、Google Vertex AI、Microsoft Azure Foundry。

关键细节

安装：

# TypeScript
npm install @anthropic-ai/claude-agent-sdk
 
# Python
pip install claude-agent-sdk

最简示例：

from claude_agent_sdk import query, ClaudeAgentOptions
 
async for message in query(
    prompt="Find and fix the bug in auth.py",
    options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"]),
):
    print(message)

Claude Code features 集成：SDK 默认加载 .claude/ 目录下的 CLAUDE.md、Skills、Hooks、Slash Commands，通过 settingSources 控制加载范围。

与其他概念的关联

• quickstart - 快速上手指南
• agent-loop - Agent 循环机制详解
• permissions - 权限控制
• sessions - 会话管理
• mcp - MCP 服务器集成
• subagents - 子 Agent

实践要点

• Agent SDK 运行在你自己的进程和基础设施中，与 Managed Agents（Anthropic 托管）不同
• 适合本地原型开发和需要直接访问文件系统的场景
• 生产环境建议在沙箱容器中运行，参考 hosting 和 secure-deployment
• 从 2026-06-15 起，订阅计划用户使用 Agent SDK 将从独立的月度额度扣费