Claude Agent SDK：把 Claude Code 的内核开放成通用 Agent 框架

从 Claude Code 到 Agent SDK：内核的开放

Claude Code（本库专篇）的成功证明了一个架构假设：一个以「代码与终端工具面 + 循环 + 上下文管理」为核心的单智能体，能覆盖远超编码的任务域。2025 年，Anthropic 把这个经过实战打磨的内核开放出来——Claude Agent SDK（原 Claude Code SDK）：开发者可以用它构建「具备 Claude Code 全部能力的自定义 Agent」——文件操作、代码执行、子智能体、MCP 工具、权限管理——换个 system prompt，编码智能体就变成你的领域智能体（财务分析 Agent、运维 Agent、研究 Agent——工具面换成领域的）。

这个开放的行业意义值得单独强调：Agent 框架市场此前是「通用框架」（LangGraph 类——什么都能搭但要自己拼）与「产品」（Claude Code/Cursor——能用但不可改造）的两极，Agent SDK 补上中间层——「经过生产验证的智能体内核 + 完全的自定义自由」。类比：它像「把 Chrome 的内核开放给你造浏览器」——内核的循环、工具、安全已经打磨好，你只造外壳与领域工具。

设计拆解：内建的循环、工具与安全

Agent SDK 的设计可拆四块。内建的 Agent 循环与基础工具：读/写/编辑文件、bash 执行、代码搜索（grep/glob）——Claude Code 验证过的工具面原样继承（本库工具设计篇的原则：这套工具的「描述工程」与反馈闭环是打磨过的）。子智能体（subagents）：主 Agent 可以派生专责子 Agent（各自的上下文与工具面——上下文隔离防止主对话被污染，本库 Claude Code 实战篇的实践在 SDK 层的一等公民化）。Hooks 与权限体系：工具执行前后的钩子（拦截、校验、审计）、权限的精细配置（哪些工具自动放行、哪些要确认）——企业把 Agent 接进生产的安全需求在此有框架级答案（本库执行隔离篇的权限模型直接可用）。MCP 一等支持：任何 MCP server 即插即用（工具面无限扩展）。

设计上的克制值得注意：Agent SDK 没有做图编排、没有做可视化——它给的是「一个强单体 + 组合原语」的路线（subagent 组合复杂任务，而非图编排控制流程）——与 LangGraph 的哲学分歧（本库 LangGraph 篇）在 SDK 层延续：Anthropic 押注的是「模型自主性 + 工具面质量」而非「代码编排的确定性」——两个路线的正确性随模型能力每年重估。

Claude Code 与 Agent SDK 的关系：产品与平台的分工

Claude Code（产品）与 Agent SDK（平台）的分工清晰：Claude Code 是「开箱即用的编码智能体」（面向开发者个人）、Agent SDK 是「造你自己的 Claude Code」（面向要构建领域 Agent 的团队）。共享的内核资产：Agent 循环、工具面、上下文管理、权限体系——Claude Code 的每次进化（新工具、新安全机制）同步惠及 SDK 用户（内核复用的飞轮：产品养内核、内核惠生态）。典型的 SDK 用法：领域知识库问答 Agent（挂 RAG 的 MCP + 定制的 system prompt）、运维自动化 Agent（终端工具 + 受限权限 + 审批钩子）、企业流程 Agent（子智能体分工 + 人工确认点）。与 OpenAI Agents SDK 的定位对照（本库专篇）：两者都是厂商官方框架、都是「极简原语」路线、都深度绑定自家模型；差异在内核来源（OpenAI 从 API 上长、Anthropic 从产品里抽）与工具面的起点（OpenAI 靠平台内建工具、Anthropic 靠 Claude Code 的本地工具面）——两条路线验证了同一个趋势：厂商官方框架正在成为 Agent 开发的默认起点（第三方通用框架退守复杂编排场景）。

Claude Agent SDK 实战：构建一个领域知识助手

Claude Agent SDK（正文设计）的实战：构建一个「领域知识助手」的最小路径。场景：企业内部的合规问答助手（回答员工的合规问题、引用内部制度文档）。步骤一：定义 Agent 的工具面——SDK 的基础工具（文件读取）+ MCP 挂载内部知识库（RAG server——本库 MCP 生态的即插即用）。步骤二：system prompt 的领域化——合规助手的角色、回答的边界（「不确定就指向法务」——拒答边界是合规 Agent 的第一设计项）、引用的要求。步骤三：权限的配置——工具的白名单（只读权限——合规助手不需要写任何东西，最小权限从工具面开始）、Hooks 的审计（每次工具调用的日志——本库安全篇的审计原则）。步骤四：评测与迭代。测试集（20 个真实合规问题 + 期望要点——本库评测篇的自建评测集）、promptfoo 的 CI 接入、上线后的 bad case 入库。步骤五：交互的前端——CopilotKit/assistant-ui 的对话层（本库前端篇）或 Slack 集成。这个最小路径的元意义：Agent SDK 的「内核复用」让领域 Agent 的构建从「搭框架」变成「配工具面 + 写 prompt + 建评测」——三件事都不是工程难题，是领域知识的工程化——领域 Agent 的门槛，正在从工程能力迁移到领域知识的整理能力。

Agent SDK 的对比定位：厂商框架时代的选型地图

Claude Agent SDK 放进厂商框架时代的选型地图（本库 OpenAI SDK/ADK 篇的延伸），三者的对照收束。三厂商框架的对照表。Anthropic Agent SDK：Claude Code 内核（本地工具面强：文件/终端/子智能体）、MCP 一等、强单体路线。OpenAI Agents SDK：handoffs 原语（多智能体移交）、平台内建工具（搜索/检索/代码执行在云端）、tracing 开箱。Google ADK：树状多智能体 + A2A 双向、Vertex 托管、评测内建。三者的共同趋势：厂商官方框架成为 Agent 开发的默认起点（第三方通用框架退守复杂编排）、内核的产品验证（三家都从自家产品抽内核或对标自家产品）、锁定与中立的平衡（SDK 开放多模型但深度能力绑自家——本库 OpenAI SDK 篇的判断在三家的对照下成立）。选型地图的最终版：部署生态（Google Cloud → ADK、多模型中立 → LangGraph/CrewAI）、交互形态（编码与本地任务 → Claude Agent SDK、平台工具密集 → OpenAI SDK）、以及「内核信任」的偏好（信产品验证的内核 vs 信为框架重写的内核——本库专篇的收束问题）。厂商框架时代的行业判断：框架层的创新放缓（原语趋同）、差异化转移到「内核质量、工具生态、托管体验」——Agent 框架的战争从「范式之争」进入了「基建之争」。

Claude Agent SDK 实战进阶：子智能体与 Hooks 的深度使用

Claude Agent SDK（正文设计）的进阶：子智能体与 Hooks 的深度使用。子智能体的设计模式。模式一：上下文隔离的探索者——主 Agent 派子 Agent 去读大量文件（读 50 个文件找答案——探索的上下文爆炸在子 Agent 里消化，只回传结论——上下文保护的核心模式）。模式二：视角独立的评审者——子 Agent 以不同视角审主 Agent 的产出（批判者、安全审查者——本库多智能体形态篇协作派的正用）。模式三：并行的工人——多个子 Agent 并行执行独立子任务（worktree 篇的并行思想在 SDK 层）。Hooks 的深度使用。PreToolUse 钩子（工具执行前的拦截——危险命令的审计与阻断、敏感数据的脱敏）、PostToolUse 钩子（执行后的处理——结果的后处理、审计日志）、以及钩子链的组合（多个钩子的编排——安全策略的分层实施）。进阶的实战场景：一个「运维巡检 Agent」——主 Agent 读巡检清单 → 子 Agent 并行巡检各服务 → 发现异常的升级决策（Hooks 拦截危险修复操作 → 人工审批 → 恢复执行）→ 报告汇总。进阶的收束：子智能体管「上下文的分形」（每个子任务一个干净的上下文），Hooks 管「安全的边界」（每一次操作都过闸门）——这两件事做好，Agent SDK 就从「能跑」变成「能上生产」。

Claude Agent SDK 与 MCP 的组合实战：领域工具的编排

Claude Agent SDK（正文四块）与 MCP 的组合实战：领域工具的编排案例。场景：一个「发布助手」Agent——帮技术团队把文档发布到多渠道（内部 wiki、对外博客、邮件简报）。工具面的编排。MCP server 1：内部 wiki 的工具（创建/更新页面——读和写是分开的工具，写的权限要审）。MCP server 2：博客平台工具（发布草稿）。MCP server 3：邮件工具（发送简报）。Agent 的编排逻辑：文档解析（内置工具读文档）→ 内容的改写与适配（各渠道的格式）→ 发布前的确认（Hooks 拦截写操作 → 人工审批 → 执行——写操作过闸门，读操作直通——本库权限分级的原则）。这个案例的工程要点：MCP server 的权限声明（本库安全篇的声明原则——每个 server 声明它的凭证与数据流向）、发布 Agent 的幂等（重复执行不重复发布——本库幂等性篇）、以及失败的恢复（发布到一半失败的断点与续传）。组合实战的收束：Agent SDK + MCP 的组合拳，让「跨系统的领域 Agent」的构建从「集成地狱」变成「工具面配置」——三个 MCP server + 一个权限策略 + 一个确认钩子，一个跨渠道的发布助手就绪；MCP 的价值，在编排型 Agent 里兑现得最快。

小结

Claude Agent SDK 把 Claude Code 验证过的内核（循环、工具面、子智能体、Hooks 权限、MCP）开放为通用 Agent 框架，补上「通用框架」与「产品」之间的中间层——生产验证的内核 + 完全自定义。它的路线哲学是「强单体 + 组合原语」而非图编排，与 OpenAI Agents SDK 分别代表「从产品抽内核」与「从 API 长框架」两条厂商官方路径。内核复用的飞轮——产品养内核、内核惠生态——是这条路线的长期看点；选型时问一句：你信一个跑在生产产品里的内核，还是一个为框架重写的内核？