Claude Code SDKはClaude Agent SDKに名称変更されました。旧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で構築された実際のエージェントを探索してください:
SDKをインストール
APIキーを設定
ConsoleからAPIキーを取得し、環境変数として設定します:
export ANTHROPIC_API_KEY=your-api-keySDKはサードパーティAPIプロバイダーを介した認証もサポートしています:
CLAUDE_CODE_USE_BEDROCK=1環境変数を設定し、AWS認証情報を構成CLAUDE_CODE_USE_VERTEX=1環境変数を設定し、Google Cloud認証情報を構成CLAUDE_CODE_USE_FOUNDRY=1環境変数を設定し、Azure認証情報を構成詳細については、Bedrock、Vertex AI、またはAzure AI Foundryのセットアップガイドを参照してください。
事前に承認されていない限り、Anthropicはサードパーティの開発者がclaude.aiのログインやレート制限を自社製品(Claude Agent SDKで構築されたエージェントを含む)に提供することを許可していません。代わりに、このドキュメントに記載されているAPIキー認証方法を使用してください。
最初のエージェントを実行
この例では、組み込みツールを使用して現在のディレクトリ内のファイルを一覧表示するエージェントを作成します。
import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions
async def main():
async for message in query(
prompt="What files are in this directory?",
options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"])
):
if hasattr(message, "result"):
print(message.result)
asyncio.run(main())構築する準備はできましたか? クイックスタートに従って、数分でバグを見つけて修正するエージェントを作成しましょう。
Claude Codeを強力にするすべての機能がSDKで利用可能です:
SDKはClaude Codeのファイルシステムベースの設定もサポートしています。これらの機能を使用するには、オプションでsetting_sources=["project"](Python)またはsettingSources: ['project'](TypeScript)を設定してください。
| 機能 | 説明 | 場所 |
|---|---|---|
| スキル | Markdownで定義された専門的な機能 | .claude/skills/SKILL.md |
| スラッシュコマンド | 一般的なタスク用のカスタムコマンド | .claude/commands/*.md |
| メモリ | プロジェクトのコンテキストと指示 | CLAUDE.mdまたは.claude/CLAUDE.md |
| プラグイン | カスタムコマンド、エージェント、MCPサーバーで拡張 | pluginsオプションによるプログラム的設定 |
Claudeプラットフォームは、Claudeで構築するための複数の方法を提供しています。Agent SDKがどのように位置づけられるかを以下に示します:
SDKの更新、バグ修正、新機能の完全な変更履歴を確認できます:
Agent SDKでバグや問題が発生した場合:
Claude Agent SDKを統合するパートナーの場合、Claudeブランディングの使用は任意です。製品でClaudeに言及する場合:
許可されるもの:
許可されないもの:
製品は独自のブランディングを維持し、Claude Codeやその他のAnthropic製品に見えないようにする必要があります。ブランディングコンプライアンスに関する質問は、営業チームにお問い合わせください。
Claude Agent SDKの使用は、Anthropicの商用利用規約に準拠します。これには、自社の顧客やエンドユーザーに提供する製品やサービスを支えるために使用する場合も含まれます。ただし、特定のコンポーネントや依存関係がそのコンポーネントのLICENSEファイルに示されている別のライセンスでカバーされている場合を除きます。
数分でバグを見つけて修正するエージェントを構築
メールアシスタント、リサーチエージェントなど
完全なTypeScript APIリファレンスと例
完全なPython APIリファレンスと例
Was this page helpful?