第20章｜登堂入室：通过 Agent SDK 掌控 Claude Code

第20章｜登堂入室：通过 Agent SDK 掌控 Claude Code

学习目标：掌握 Claude Code Agent SDK 的核心概念和使用方法，学会通过编程方式控制 Claude Code，构建自定义的 AI 驱动工作流。

20.1 什么是 Agent SDK？

从 CLI 到 SDK

CLI 方式（命令行）： claude -p "任务描述" --auto → 适合：手动触发、简单脚本 → 局限：难以编程控制、无法动态调整任务 Agent SDK 方式（编程接口）： from claude_code_sdk import ClaudeCode agent = ClaudeCode() result = await agent.run("任务描述") → 适合：复杂工作流、动态任务、与其他系统集成 → 优势：完全编程控制、可以处理中间结果、支持复杂逻辑

Agent SDK 的核心价值

1. 编程控制 可以用代码动态生成任务描述 可以根据中间结果调整后续任务 可以实现复杂的条件逻辑 2. 深度集成 与现有 Python/TypeScript 代码无缝集成 可以在 Web 应用、数据管道、自动化