Claude Code / 参考
Claude Code Agent SDK
Agent SDK 适合把 Claude Code 的代理能力嵌入自己的产品、内部平台或自动化管道。
Agent SDK 是什么
Claude Agent SDK 把 Claude Code 的代理循环作为库使用，用于构建生产级 AI agent。它支持工具调用、会话、流式输出、权限、Hooks、MCP、Skills、Subagents 和结构化输出。
如果 CLI/IDE 是开发者直接使用 Claude Code，Agent SDK 则是把这套能力嵌入自己的产品、内部平台或自动化系统。
核心能力
SDK 文档覆盖快速开始、自定义工具、MCP、会话存储、成本追踪、文件 checkpoint、用户输入、结构化输出、观测和安全部署。
会话和状态
持久化 transcript，支持继续、恢复和 fork。
工具和 MCP
让 agent 调用你的函数、API 和外部系统。
权限和用户输入
把审批请求和澄清问题交给应用层处理。
生产部署
处理隔离、凭证、观测、成本和多租户边界。
和其他 Claude 工具的区别
Agent SDK 更适合开发产品和内部系统；Claude Code CLI/IDE 更适合开发者个人或团队直接工作；普通 Claude Chat 更适合对话和分析。
| 工具 | 适合 |
|---|---|
| Claude Code CLI/IDE | 人在环的代码库任务。 |
| Claude Code Web/Desktop | 云端和多会话任务管理。 |
| Agent SDK | 把代理能力嵌入应用或自动化平台。 |
完整使用要点
补充官方文档中容易被压缩遗漏的核心概念、操作顺序、权限边界和验证要求，方便中文学习者按页面完整学习。
Agent SDK 补充
Claude Agent SDK 把 Claude Code 的代理循环作为库使用，适合构建自己的 AI agent、内部开发者平台、自动修复系统、代码审查服务或工单处理管道。
SDK 能力包括工具调用、MCP、会话、流式输出、权限、Hooks、Skills、Subagents、结构化输出、成本追踪、checkpoint、用户输入和观测。它比 CLI 更适合产品化，但也要求你自己承担平台责任。
生产化必须处理：多租户隔离、凭证管理、权限审批、工具审计、超时、重试、取消、回滚、成本控制和人工接管。不要把 SDK 流程设计成不可观察的黑箱。
学习检查清单
把本页内容落到真实任务中，用入口、上下文、权限、验证和团队规则五个维度检查是否真正掌握。
学习检查清单
读完本页后，不要只记住概念名。你应该能把“Claude Code Agent SDK”放回 Claude Code 的真实工程流程里：任务从哪里发起，系统会加载什么上下文，哪些动作需要审批，结果如何验证，失败时如何回退。
如果这是配置或参考页面，要特别确认配置放在哪里、是否会被提交、是否包含敏感信息、是否会扩大默认权限，以及如何在失败时排查实际生效的设置。
- 能用自己的话说明本页解决的具体问题，而不是只复述标题。
- 能写出一个最小示例任务，并标明目标、范围、禁止事项和验收标准。
- 能判断哪些信息应该放进当前提示，哪些应该沉淀到项目规则或配置里。
- 能说明哪些长期规则应该写进 CLAUDE.md，哪些运行行为应该交给 settings、permissions、Hooks、Skills 和 MCP。
- 能在任务完成后检查 diff、命令输出、测试结果、截图或 PR 说明，而不是只相信自然语言总结。
如果要把本页用于团队培训，可以让学员用 Claude Code 完成一个小任务：先只读解释，再提交计划，再执行最小改动，最后用真实验证命令和人工 diff 审查收尾。