Agent SDK 概览

构建能够自主读取文件、运行命令、搜索网络、编辑代码等的 AI 代理。Agent SDK 为您提供了与 Claude Code 相同的工具、代理循环和上下文管理，可在 Python 和 TypeScript 中编程。

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions

async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(allowed_tools=["Read", "Edit", "Bash"])
    ):
        print(message)  # Claude reads the file, finds the bug, edits it

asyncio.run(main())

Agent SDK 包含用于读取文件、运行命令和编辑代码的内置工具，因此您的代理可以立即开始工作，无需您实现工具执行。深入了解快速入门或探索使用 SDK 构建的真实代理：

功能

Claude Code 强大的一切功能都可在 SDK 中使用：

Claude Code 功能

SDK 还支持 Claude Code 的基于文件系统的配置。要使用这些功能，请在您的选项中设置 setting_sources=["project"]（Python）或 settingSources: ['project']（TypeScript）。

开始使用

准备好构建了吗？ 按照快速入门在几分钟内创建一个查找和修复 bug 的代理。

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

Claude 平台提供了多种使用 Claude 构建的方式。以下是 Agent SDK 的适用场景：

更新日志

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

• TypeScript SDK：查看 CHANGELOG.md
• Python SDK：查看 CHANGELOG.md

报告 bug

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

• TypeScript SDK：在 GitHub 上报告问题
• Python SDK：在 GitHub 上报告问题

品牌指南

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

允许：

• "Claude Agent"（下拉菜单首选）
• "Claude"（当已在标记为"Agents"的菜单中时）
• "{YourAgentName} Powered by Claude"（如果您有现有的代理名称）

不允许：

• "Claude Code" 或 "Claude Code Agent"
• Claude Code 品牌的 ASCII 艺术或模仿 Claude Code 的视觉元素

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

许可证和条款

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

后续步骤