Claude Agent SDK 从 0 到 1 快速上手教程

Claude Agent SDK 从 0 到 1 快速上手教程什么是 Claude Agent SDK？Claude Agent SDK 是 Anthropic 官方推出的用于构建 AI 智能体的开发工具包。它基于 Claude Code 构建，让开发者能够以编程方式创建、扩展和定制由 Claude 驱动的应用程序。与简单的聊天机器人不同，基于该 SDK 构建的 Agent 可以推理多步骤问题、调用工具、处理错误，并持续执行直到任务完成。SDK 内置了丰富的功能，包括读写文件、执行命令、理解代码，甚至可以搜索和获取网页内容。你可以通过自定义函数扩展其能力，也可以将 Agent 直接连接到 MCP（Model Context Protocol）服务器。文章目录Claude Agent SDK 从 0 到 1 快速上手教程什么是 Claude Agent SDK？第 1 步：环境准备与安装前置条件安装 Claude Code CLI安装 SDK设置 API 密钥第 2 步：Hello World——验证安装Python 版本TypeScript 版本理解 `query` 函数第 3 步：理解核心概念第 4 步：注册和使用工具限制工具范围注册自定义函数工具第 5 步：权限与安全治理权限模式工具规则与钩子canUseTool 回调第 6 步：会话管理与流式交互流式 vs 一次性调用管理上下文与记忆第 7 步：流式输入与输出第 8 步：集成 MCP（Model Context Protocol）MCP 集成基本模式第 9 步：从旧版本迁移常见问题与调试1. 安装时出现 `CLINotFoundError`2. API 密钥无法识别3. 工具调用没有生效4. 项目级配置文件（CLAUDE.md）未生效5. 如何控制成本进阶学习资源总结第 1 步：环境准备与安装前置条件Python：3.10 或更高版本Node.js：18+（Claude Code CLI 需要）Anthropic API 密钥：在 Claude 开发者控制台 创建并获取安装 Claude Code CLIClaude Agent SDK 依赖本地安装的 Claude Code CLI。在终端中执行以下命令安装：Windows（PowerShell）：irm https://claude.ai/install.ps1|iex然后将C:\Users\用户名\.local\bin添加到系统环境变量 PATH 中，重启 PowerShell 后验证：claude