• 分组：一、官方文档
• 原始链接：https://docs.anthropic.com/en/docs/claude-code/sdk/sdk-overview
• 抓取来源：http://docs.anthropic.com/en/docs/claude-code/sdk/sdk-overview
• 原始文件：/Users/yuanruiqin/Desktop/知识库/ClaudeCode-系统化知识库/01-官方文档/21-claude-code-sdk-overview.md
• 精读版生成时间：2026-04-05 13:50:44

中文精读版（去噪）

Agent SDK 概述 - Claude API 文档

代理SDK概述

Claude Code SDK 已重命名为 Claude Agent SDK。如果您要从旧版 SDK 迁移，请参阅迁移指南。

蟒蛇

导入异步 从 claude_agent_sdk 导入查询，ClaudeAgentOptions

异步 def main(): 查询中的消息异步（ 提示=“查找并修复auth.py中的错误”， options=ClaudeAgentOptions(allowed_tools=["阅读", "编辑", "Bash"]), ）： print(message) # Claude 读取文件，找到 bug，编辑它

asyncio.run（主（））

Agent SDK 包含用于读取文件、运行命令和编辑代码的内置工具，因此您的代理可以立即开始工作，而无需您执行工具。深入了解快速入门或探索使用 SDK 构建的真实代理：

快速入门 在几分钟内构建错误修复代理示例代理电子邮件助理、研究代理等

开始吧

1.1 安装 SDK TypeScript TypeScript Python npm install @anthropic-ai/claude-agent-sdk 2.2 设置您的 API 密钥

从控制台获取API密钥，然后将其设置为环境变量：

导出 ANTHROPIC_API_KEY=您的 api 密钥 SDK还支持通过第三方API提供商进行身份验证：

Amazon Bedrock：设置 CLAUDE_CODE_USE_BEDROCK=1 环境变量并配置 AWS 凭证 Google Vertex AI：设置 CLAUDE_CODE_USE_VERTEX=1 环境变量并配置 Google Cloud 凭据 Microsoft Azure：设置 CLAUDE_CODE_USE_FOUNDRY=1 环境变量并配置 Azure 凭据

有关详细信息，请参阅 Bedrock、Vertex AI 或 Azure AI Foundry 的设置指南。

3.3 运行您的第一个代理 此示例创建一个代理，该代理使用内置工具列出当前目录中的文件。

蟒蛇``` 导入异步 从 claude_agent_sdk 导入查询，ClaudeAgentOptions

异步 def main(): 查询中的消息异步（ Prompt="该目录下有哪些文件？", 选项=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"]), ）： if hasattr(消息,“结果”): 打印（消息.结果）

asyncio.run（主（））

准备好构建了吗？ 按照快速入门 创建一个可以在几分钟内找到并修复错误的代理。

能力

使克劳德·代码强大的一切