Agent SDK の概要
Claude Code をライブラリとして使用して、本番環境対応の AI エージェントを構築します
エージェントは、独自のステップを計画し、ファイルを読み取る、コマンドを実行する、またはコードを編集するツールを呼び出すことでタスクを完了するアプリケーションです。Agent SDK は、Claude Code を強化する同じツール、エージェントループ、およびコンテキスト管理を提供し、Python と TypeScript でプログラム可能です。
Agent SDK と他の Claude ツールの比較
Agent SDK、CLI、Client SDK、および Managed Agents は、エージェントを実行するのは誰か、何が組み込まれているか、どのようにアクセスするかが異なります。構築して実行する方法に合致する行を見つけてください。
| 対象 | 使用するツール | 取得内容 |
|---|---|---|
| Claude Code のエージェントを自分で操作するプロセスで、独自の Python または TypeScript アプリケーションに埋め込む | Agent SDK | Claude Code バイナリを実行するライブラリで、組み込みツール、権限、セッション、hooks などの Claude Code の機能を備えています。 |
| ターミナルから対話的な開発またはワンオフタスクを実行する | Claude Code CLI | 日常的な対話的使用のために構築されたターミナルインターフェース。 |
| 独自のコードから Claude API を直接呼び出す | Client SDK | クライアント SDK 言語のいずれからでも Claude API に直接アクセスできます。ツールループを自分で記述するか、クライアント SDK のベータ版ツールランナーに駆動させることができます。 |
| Anthropic がエージェントをホストし、Claude API を通じて構成する | Managed Agents | エージェントループを実行するホストされたエージェントハーネスで、Anthropic が管理するクラウドサンドボックスまたは独自のインフラストラクチャ上のセルフホストサンドボックスのセッションを備えています。言語用の SDK、ant CLI、または REST API から使用できます。 |
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 チームが多くのサブエージェントを一度にオーケストレーションするために動的ワークフローをどのように使用するか