Agent SDK 概览

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

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

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

Agent SDK、CLI、Client SDK 和 Managed Agents 在谁运行代理、内置功能以及如何访问方面有所不同。找到与您想要构建和运行的方式相匹配的行。

您想要	使用	您获得
在您自己操作的 Python 或 TypeScript 应用程序中嵌入 Claude Code 的代理	Agent SDK	一个运行 Claude Code 二进制文件的库，具有 Claude Code 的功能，例如内置工具、权限、会话和 hooks。
进行交互式开发或从终端运行一次性任务	Claude Code CLI	终端界面，为日常交互使用而构建。
直接从您自己的代码调用 Claude API	Client SDK	从任何客户端 SDK 语言直接访问 Claude API。您自己编写工具循环，或让客户端 SDK 的测试版工具运行器驱动它。
让 Anthropic 托管代理，通过 Claude API 配置	Managed Agents	一个托管代理工具，运行代理循环，会话在 Anthropic 管理的云沙箱或您自己的基础设施上的自托管沙箱中。从您语言的 SDK、`ant` CLI 或 REST API 使用它。

要从 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 构建的更深层次的技术细节和示例项目。