导语:Claude Agent SDK 把 Claude Code 这个已经证明能干活的智能体,打包成一个可编程的库:官方自用的工具集、agent 循环与上下文管理,配上 Python 或 TypeScript 就能组装自己的智能体。它原名 Claude Code SDK,2025 年 9 月 29 日更名,定位从「给编码工具用」扩到「给所有智能体用」。
核心要点
- 形态:Python / TypeScript 库,2025 年 9 月 29 日由 Claude Code SDK 更名而来
- 自带工具:文件读写与编辑、Shell 命令执行、网页搜索,开箱即用
- 子智能体:独立上下文窗口,只把结论回传主智能体,兼顾并行与省上下文
- Hooks:生命周期关键节点插入自定义代码,做权限拦截、日志与审计
- MCP:通过 Model Context Protocol 接入外部工具与企业内部系统
- 安装:pip install claude-agent-sdk 或 npm install @anthropic-ai/claude-agent-sdk
一、什么是 Claude Agent SDK?
导语:Claude Agent SDK 做了一件很直接的事:把 Claude Code 这个”已经证明能干活”的智能体,打包成一个可编程的库。你拿到的不是一段提示词模板,而是官方自己用来驱动 Claude Code 的那套工具集、agent 循环与上下文管理——读写文件、执行命令、搜索网页,配上 Python 或 TypeScript 就能组装成自己的智能体。它原名 Claude Code SDK,2025 年 9 月 29 日正式更名为 Claude Agent SDK,定位也从”给编码工具用”扩展成”给所有智能体用”。
发布:2025 年 9 月 29 日(由 Claude Code SDK 更名而来)|形态:Python / TypeScript 库|官方文档:code.claude.com/docs/en/agent-sdk
直接调模型,你得到的是”一次生成”。而要让它真的干活,还缺三样东西:能动手的工具、知道何时停的循环、不会把上下文撑爆的管理策略。Agent SDK 把这三样打包好了,你写的是”任务与约束”,而不是”第几步该调什么”。
二、核心优势
官方在工程博客里解释了两个用处:一是并行,多个子智能体同时处理不同子任务;二是省上下文——子智能体在自己的窗口里翻大量资料,只把筛出来的结论交回去,主智能体不会被原始材料淹没。这正好对应长任务最常见的两个死法:太慢、以及上下文塞满后开始胡言乱语。
三、应用场景
做编程类与运维类智能体的团队最合适:代码库问答、自动修 bug、批量重构、CI 里跑自动化排查。也适合想快速验证”智能体能不能接管某段流程”的产品团队——因为它把工具与循环都给了,验证成本主要在业务规则上。
四、怎么上手
# Python
pip install claude-agent-sdk
# TypeScript / Node
npm install @anthropic-ai/claude-agent-sdk
# 最小调用:发起一次带工具能力的任务
python -c "from claude_agent_sdk import query; print(query('统计当前目录下所有 .py 文件的行数,并按行数排序'))"
实际使用时把权限模式、允许的工具、工作目录、MCP 服务器配置显式写清,尤其是涉及写入与执行命令时,建议先用只读模式验证行为。
五、下载与使用入口
- Python 包(PyPI):pypi.org/project/claude-agent-sdk
- 官方总览文档:code.claude.com/docs · Agent SDK
- 官方工程博客:Anthropic · Building agents with the Claude Agent SDK
- 子智能体文档:code.claude.com/docs · Subagents
说明:SDK 开源可用,但运行时依赖 Anthropic 账号与 API 额度;接入前请确认计费与数据使用条款。
六、边界与注意事项
权限是这里最需要小心的地方:涉及写入文件、执行命令的智能体,建议先用只读模式跑一遍,确认行为符合预期再放开权限。
它是「把成熟智能体借来用」的路线,工具链与循环都由官方维护,好处是省事,代价是可定制空间小于自建框架——需要深度改造时,往往要在 Hooks 与 MCP 这一层做文章。
总结
Agent SDK 的价值在于把「一次生成」变成「一次交付」:工具、循环、上下文管理三样都给你,你写的是任务与约束,而不是第几步调什么。做编程类、运维类智能体,它是最短的路径。
信息来源
- Anthropic 工程博客:Building agents with the Claude Agent SDK(2025-09-29)
- 官方总览:Agent SDK overview
- 子智能体文档:Subagents in the SDK
注:包名与调用方式随版本演进,安装与鉴权请以官方文档当前页面为准;SDK 会实际读写文件与执行命令,上线前务必配置权限边界。