Agent SDK 概要

インストール

npm install @anthropic-ai/claude-agent-sdk

pip install claude-agent-sdk

SDK オプション

Claude Agent SDK は、さまざまなユースケースに対応するために複数の形式で利用できます:

• TypeScript SDK - Node.js および Web アプリケーション向け
• Python SDK - Python アプリケーションおよびデータサイエンス向け
• ストリーミング vs シングルモード - 入力モードとベストプラクティスの理解

Claude Agent SDK を使用する理由

Claude Code を支える エージェント ハーネスの上に構築された Claude Agent SDK は、本番対応のエージェントを構築するために必要なすべての構成要素を提供します。

Claude Code で実施した作業を活用して:

• コンテキスト管理: 自動的なコンパクション とコンテキスト管理により、エージェントがコンテキストを使い切らないようにします。
• 豊富なツールエコシステム: ファイル操作、コード実行、Web 検索、および MCP 拡張性
• 高度な権限: エージェント機能に対する細粒度の制御
• 本番環境の必須機能: 組み込みのエラーハンドリング、セッション管理、および監視
• 最適化された Claude 統合: 自動プロンプトキャッシングとパフォーマンス最適化

SDK で何を構築できますか?

以下は、作成できるエージェントタイプの例です:

コーディングエージェント:

• 本番環境の問題を診断して修正する SRE エージェント
• コードの脆弱性を監査するセキュリティレビュー ボット
• インシデントをトリアージするオンコール エンジニアリング アシスタント
• スタイルとベストプラクティスを強制するコードレビュー エージェント

ビジネスエージェント:

• 契約とコンプライアンスをレビューする法務アシスタント
• レポートと予測を分析する財務アドバイザー
• 技術的な問題を解決するカスタマーサポート エージェント
• マーケティングチーム向けのコンテンツ作成アシスタント

コアコンセプト

認証

基本的な認証の場合、Claude コンソールから Claude API キーを取得し、ANTHROPIC_API_KEY 環境変数を設定します。

SDK は、サードパーティ API プロバイダーを介した認証もサポートしています:

• Amazon Bedrock: CLAUDE_CODE_USE_BEDROCK=1 環境変数を設定し、AWS 認証情報を構成します
• Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1 環境変数を設定し、Google Cloud 認証情報を構成します

サードパーティプロバイダーの詳細な構成手順については、Amazon Bedrock および Google Vertex AI のドキュメントを参照してください。

Claude Code 機能の完全サポート

SDK は Claude Code で利用可能なすべてのデフォルト機能へのアクセスを提供し、同じファイルシステムベースの構成を活用します:

• サブエージェント: ./.claude/agents/ に Markdown ファイルとして保存された特化したエージェントを起動します
• エージェント スキル: ./.claude/skills/ に SKILL.md ファイルとして保存された特化した機能で Claude を拡張します
• フック: ./.claude/settings.json で構成されたカスタムコマンドを実行し、ツールイベントに応答します
• スラッシュコマンド: ./.claude/commands/ に Markdown ファイルとして定義されたカスタムコマンドを使用します
• プラグイン: plugins オプションを使用してカスタムプラグインをプログラムで読み込み、カスタムコマンド、エージェント、スキル、フック、および MCP サーバーで Claude Code を拡張します。詳細については プラグイン を参照してください。
• メモリ (CLAUDE.md): プロジェクトディレクトリの CLAUDE.md または .claude/CLAUDE.md ファイル、またはユーザーレベルの指示用の ~/.claude/CLAUDE.md を通じてプロジェクトコンテキストを維持します。これらのファイルを読み込むには、オプションで settingSources: ['project'] (TypeScript) または setting_sources=["project"] (Python) を明示的に設定する必要があります。詳細については システムプロンプトの変更 を参照してください。

これらの機能は、同じファイルシステムの場所から読み取ることで、Claude Code の対応する機能と同じように機能します。

システムプロンプト

システムプロンプトは、エージェントの役割、専門知識、および動作を定義します。これは、構築しているエージェントの種類を指定する場所です。

ツール権限

細粒度の権限でエージェントが使用できるツールを制御します:

• allowedTools - 特定のツールを明示的に許可します
• disallowedTools - 特定のツールをブロックします
• permissionMode - 全体的な権限戦略を設定します

モデルコンテキストプロトコル (MCP)

MCP サーバーを通じてカスタムツールと統合でエージェントを拡張します。これにより、データベース、API、およびその他の外部サービスに接続できます。

バグの報告

Agent SDK でバグまたは問題が発生した場合:

• TypeScript SDK: GitHub で問題を報告
• Python SDK: GitHub で問題を報告

変更ログ

SDK の更新、バグ修正、および新機能の完全な変更ログを表示します:

• TypeScript SDK: CHANGELOG.md を表示
• Python SDK: CHANGELOG.md を表示

関連リソース

• CLI リファレンス - 完全な CLI ドキュメント
• GitHub Actions 統合 - GitHub ワークフローを自動化します
• MCP ドキュメント - カスタムツールで Claude を拡張します
• 一般的なワークフロー - ステップバイステップガイド
• トラブルシューティング - 一般的な問題と解決策