Agent SDK 概览

使用 Claude Code 作为库构建生产级 AI 代理

代理是一个应用程序，它通过规划自己的步骤并调用读取文件、运行命令或编辑代码的工具来完成任务。Agent SDK 为您提供了与 Claude Code 相同的工具、代理循环和上下文管理，可在 Python 和 TypeScript 中编程。

将 Agent SDK 与其他 Claude 工具进行比较

Agent SDK、CLI、Client SDK 和 Managed Agents 各自满足不同的需求。使用该表格找到与您正在构建的内容相匹配的工具。

如果您...	使用	原因
构建代理而不自己实现工具循环	Agent SDK	一个为您运行代理循环的 Python 或 TypeScript 库。
进行交互式开发或从终端运行一次性任务	Claude Code CLI	终端界面，为日常交互使用而构建。
直接调用 API 并自己实现工具循环	Client SDK	直接访问 Anthropic API 而不是 Claude Code。您自己实现工具循环。
运行长期运行或异步代理，无需管理您自己的沙箱或会话基础设施	Managed Agents	托管 REST API，是 Agent SDK 的独立产品。Anthropic 运行代理和沙箱。

该 SDK 仅作为 Python 和 TypeScript 的库提供。要从另一种语言驱动相同的代理循环，请以子进程的形式运行 CLI，使用 -p 标志和 --output-format json。

这些 Claude Code 功能在 SDK 中可用：

功能	功能说明	了解更多
内置工具	读取、写入、编辑文件，运行命令，搜索网络	工具参考
Hooks	在代理生命周期的关键点运行自定义代码	Hooks
Subagents	生成专门的代理来处理专注的子任务	Subagents
MCP	通过 Model Context Protocol 连接外部工具和数据源	MCP
权限	控制哪些工具自动运行，哪些需要批准	权限
会话	在多次交换中保持上下文，稍后恢复或分叉	会话
Skills、命令和内存	从您的项目的 `.claude/` 和 `~/.claude/` 自动加载，与 Claude Code 相同	Skills、命令、内存、配置加载
Plugins	打包 skills、代理、hooks 和 MCP 服务器，并按本地路径加载它们	Plugins

按照快速入门安装 SDK、设置您的 API 密钥，并构建您的第一个代理，该代理可以查找并修复现有代码中的错误。

查看完整的更新日志以了解 SDK 更新、bug 修复和新功能：

如果您在 Agent SDK 中遇到 bug 或问题：

对于集成 Claude Agent SDK 的合作伙伴，使用 Claude 品牌是可选的。在您的产品中引用 Claude 时：

允许：

不允许：

您的产品应保持自己的品牌，不应显示为 Claude Code 或任何 Anthropic 产品。如有关于品牌合规性的问题，请联系 Anthropic 销售团队。

Claude Agent SDK 的使用受 Anthropic 商业服务条款管制，包括当您使用它为您自己的客户和最终用户提供的产品和服务时，除非特定组件或依赖项由该组件的 LICENSE 文件中指示的不同许可证覆盖。

这些资源涵盖了使用 Agent SDK 构建的更深层次的技术细节和示例项目。