§01 Claude Agent SDK 是什么，为什么你需要它
01.1 一个真实的时间点
2026 年 6 月 15 日。Anthropic 给 Agent SDK 算了独立的月度额度。
这件事说明一个问题：用 SDK 把 Claude 嵌进自己产品的人，已经多到值得单独计费了。我读这条公告时，第一反应是——这个东西真的成熟了。
先给结论：Claude Agent SDK 就是把 Claude Code 的"自动驾驶"能力，打包成一个你能 import 的库。
你写几行代码。Claude 就能自己读文件、跑命令、搜网页、改代码。你不用自己写工具循环。
01.2 三个东西，别搞混
很多人分不清这三个。我用一张表说清楚。
| 维度 | Anthropic Client SDK | Claude Agent SDK | Claude Code CLI |
|---|---|---|---|
| 你做什么 | 手写工具循环 | 调一个函数 | 敲命令 |
| 谁跑工具 | 你 | Claude 自己 | Claude 自己 |
| 上手难度 | 高 | 低 | 最低 |
| 标叔的结论 | 想完全控盘才用 | 做个 Agent 首选 | 个人写代码用 |
重点看：第二行"谁跑工具"。
Client SDK 要你自己写
while stop_reason == "tool_use"的循环。Agent SDK 把这件事替你做了。差距就在这一行。
01.3 类比级联：手动挡、辅助驾驶、自动驾驶
我习惯这么理解这三者的关系。
Client SDK 是你的手动挡。离合、换挡全自己来。 Claude Code CLI 是你的辅助驾驶。你坐主驾，它帮你打方向。 Claude Agent SDK 是你的自动驾驶。你给个目的地，它自己开。
关键区别在最后一句：Agent SDK 跑在一个子进程里。你的程序发一句 prompt，它自己推理、自己调工具，再把结果流回来给你。你只在两端接管。
标叔的经验：Agent SDK 不用先装 Claude Code。
TypeScript 包会把对应平台的 Claude Code 二进制一起打包。我第一次看到这点时挺意外——以前用 CLI 工具总得先装客户端。这里直接省了一步。
01.4 适合谁，不适合谁
如果你是下面这种人，这本书就是给你写的：
- 你想在 Web 应用里接一个能自己干活的 AI 助手。
- 你想批量跑代码审查、研究、报告生成。
- 你不想从零造一个工具调度系统。
如果你只想在网页里发一句"写首诗"，用 Client SDK 就够了。Agent SDK 是给"要让 AI 动手做事"的场景准备的。
装好环境，我们马上跑第一条查询。