章节导航

本章总览：Agent SDK、Messages API、Managed Agents。

前面六章讲的都是"你怎么用 Claude Code 这个终端工具"。到这一章视角要切一下：你不再是终端用户，而是想把 Claude 的智能嵌到自己写的服务、脚本、后端产品里。这种时候不再是敲 claude 打开交互界面，而是在代码里调 API 或者 SDK。

Anthropic 官方给出的三层入口，粗略地对应三种不同的抽象程度。

本章 3 个小节

01 Agent SDK：Claude Agent SDK 是 Anthropic 官方发布的包，直接把 Claude Code 那套内核（工具循环、上下文管理、hook、subagent、MCP、权限）暴露给你的程序调。你在 Node 或 Python 里 import 一个 query，喂一段 prompt，SDK 就替你跑完整个 agent loop，中间可以插自己的 hook 和 MCP server。这一节讲怎么安装、最小示例、常用配置项，以及一个日志分析定时任务的完整例子。

02 Messages API：Anthropic 最底层的 HTTP 接口，POST /v1/messages。所有官方 SDK 和 Agent SDK 底下都是这个 API。这一节讲请求头、请求体、模型 ID、流式返回、tool use 循环、prompt caching。适合那些不想要 agent 循环、只想拿到一次模型输出的场景，也是任何自研 agent 框架的底座。

03 Managed Agents：Anthropic 自己托管的 agent 沙箱。你不用管容器、不用管沙箱、不用管长时间任务的持久化，直接把任务丢过去等结果。这一节讲它跟自己跑 Agent SDK 的取舍，什么场景用它更合适。

三层怎么选

一个非常粗略的判断标准：只做一次问答用 API，本地跑循环用 SDK，云端跑长任务用 Managed。三层不是互斥的，而是叠加关系：Managed Agents 底下跑的是 Agent SDK，Agent SDK 底下调的是 Messages API。理解这条链能让你在架构选型时不纠结。

学完这章你能做什么

写一段 Python 脚本每天自动跑一遍 CI 日志分析并把发现的问题登记到 issue；用 Messages API 给自己的 SaaS 加一个 AI 助手模块；或者把一个批处理任务交给 Managed Agents 后台跑几十分钟不用管。实际项目里经常混用——SDK 起底、API 处理特殊调用、Managed 兜住长任务。读完这三节，你会知道每个场景该用哪一层。