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）。

開始使用

準備好構建了嗎？ 按照快速入門在幾分鐘內建立一個尋找並修復錯誤的代理。

將 Agent SDK 與其他 Claude 工具進行比較

Claude 平台提供了多種方式來使用 Claude 進行構建。以下是 Agent SDK 的適用情況：

變更日誌

查看完整的變更日誌以了解 SDK 更新、錯誤修復和新功能：

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

報告錯誤

如果您在 Agent SDK 中遇到錯誤或問題：

• 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 檔案中指示的不同許可證的約束。

後續步驟