45 · Claude Agent SDK 教程：把代理能力接入程序

Agent SDK 的核心概念、安装、调用、工具、会话与权限控制，帮开发者把代理循环嵌入自己的应用。

Agent SDK 是最高阶的玩法：把 Claude 的「代理能力」嵌入到你自己的程序里，让你的应用也拥有「会干活的 AI 代理」。

「核心概念」：SDK 把 Claude 的代理循环——理解任务、调用工具、执行、反馈——封装成可编程的接口，你可以在自己的代码里驱动它。

「安装」：作为依赖引入到你的项目里。

「调用」：在你的代码里发起一个代理任务，它会去执行并返回结果。

「工具」：你可以给它定义自定义工具，让它调用你的程序里的能力。

「会话」：管理代理的对话状态，支持多轮、连续的任务。

「权限控制」：在你的应用里，控制代理能干什么、不能干什么，把安全边界握在自己手里。

「适用场景」：你要做一个「内置 AI 编程助手」的产品、或者一个「能自动执行任务的智能体」应用时，SDK 就是你的引擎。

这一篇是给「开发者」看的。如果你只是想用 Claude Code 写代码，这篇了解即可；如果你要做产品、把 AI 代理能力嵌进去，这篇就是入门钥匙。

用 SDK 的本质，是「把 Claude 的能力，变成你自己的产品能力」。这是从「用户」到「创造者」的跨越。

一个自查清单：当你读完这一篇时，可以问自己三个问题——它解决的是什么具体问题？我当前的工作/学习里有没有这个场景？下一步我该学哪一篇？把这三个问题答清楚，你就知道自己有没有真正吃透。

五分钟练习：① 找一个一分钟能完成的代码任务 ② 用这一篇的方法描述给 Codex ③ 看它执行时有没有触发你刚学的那个机制 ④ 验证结果是否符合预期。这一轮做下来，你对这一篇的理解会深 3 倍。

延伸阅读：学完这一篇，你可以看本组里的下一篇，把相邻的概念连起来读；也可以跳到更后面的组学 MCP、子代理、Skills 这些更深的能力。知识是网状的，多跳几篇会理解更深。

一页速览：如果只能记三件事，① {一}。② {二}。③ {三}。其他细节以后需要再翻这一篇查。