Agent SDK の概要
Claude Code をライブラリとして使用して、本番環境対応の AI エージェントを構築します
エージェントは、独自のステップを計画し、ファイルを読み取る、コマンドを実行する、またはコードを編集するツールを呼び出すことでタスクを完了するアプリケーションです。Agent SDK は、Claude Code を強化する同じツール、エージェントループ、およびコンテキスト管理を提供し、Python と TypeScript でプログラム可能です。
Agent SDK と他の Claude ツールの比較
Agent SDK、CLI、Client SDK、および Managed Agents はそれぞれ異なるニーズに対応しています。構築しているものに合致するツールを見つけるために、表を使用してください。
| 対象 | 使用するツール | 理由 |
|---|---|---|
| ツールループを自分で実装せずにエージェントを構築している | Agent SDK | エージェントループを実行する Python または TypeScript ライブラリです。 |
| ターミナルからの対話的な開発またはワンオフタスクの実行 | Claude Code CLI | 日常的な対話的使用のために構築されたターミナルインターフェース。 |
| API を直接呼び出し、ツールループを自分で実装している | Client SDK | Claude Code ではなく Anthropic API への直接アクセス。ツールループを自分で実装します。 |
| 独自のサンドボックスまたはセッションインフラストラクチャを管理せずに、長時間実行または非同期エージェントを実行している | Managed Agents | ホストされた REST API で、Agent SDK とは別の製品です。Anthropic がエージェントとサンドボックスを実行します。 |
SDK は Python と TypeScript のライブラリとしてのみ利用可能です。別の言語から同じエージェントループを駆動するには、-p フラグと --output-format json を使用して CLI をサブプロセスとして実行してください。
機能
これらの 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 の更新、バグ修正、および新機能の完全な変更ログを表示します。
- 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 製品のように見えるべきではありません。ブランドコンプライアンスに関する質問については、Anthropic 営業チームに連絡してください。
ライセンスと利用規約
Claude Agent SDK の使用は、Anthropic の商用利用規約によって管理されます。これは、Claude Agent SDK を使用して、独自のカスタマーおよびエンドユーザーに利用可能にする製品およびサービスを強化する場合を含みます。ただし、特定のコンポーネントまたは依存関係が、そのコンポーネントの LICENSE ファイルに示されているように異なるライセンスの対象である場合を除きます。
次のステップ
これらのリソースは、Agent SDK を使用して構築するための、より深い技術的詳細とサンプルプロジェクトをカバーしています。
- クイックスタート：バグを見つけて修正する最初のエージェントを構築します
- マイグレーションガイド：Claude Code SDK パッケージから Agent SDK へマイグレーションします
- エージェントループ：Claude がどのように計画を立て、ツールを呼び出し、タスクが完了したかを判断するか
- エージェントの例：ローカル開発用のデモアプリ
- TypeScript SDK：完全な TypeScript API リファレンスと例
- Python SDK：完全な Python API リファレンスと例
- エージェントハーネス設計：Claude Code チームが多くのサブエージェントを一度にオーケストレーションするために動的ワークフローをどのように使用するか