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で構築された実際のエージェントを探索してください:
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ファイルに示されている別のライセンスでカバーされている場合を除きます。
メールアシスタント、リサーチエージェント、その他
Claude Codeをインストールする
SDKをインストールする
APIキーを設定する
export ANTHROPIC_API_KEY=your-api-keyコンソールからキーを取得します。
SDKはサードパーティAPIプロバイダー経由の認証もサポートしています:
CLAUDE_CODE_USE_BEDROCK=1環境変数を設定し、AWSの認証情報を構成しますCLAUDE_CODE_USE_VERTEX=1環境変数を設定し、Google Cloudの認証情報を構成しますCLAUDE_CODE_USE_FOUNDRY=1環境変数を設定し、Azureの認証情報を構成します以前に承認されていない限り、当社はサードパーティ開発者が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"])
):
print(message)
asyncio.run(main())メールアシスタント、リサーチエージェント、その他