Claude Code SDK は Claude Agent SDK に名前が変更されました。古い SDK から移行する場合は、移行ガイドを参照してください。

​
インストール

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

​
SDK オプション

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

​
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 Agent SDK で構築されたエージェントを含む製品に対して Claude.ai レート制限を適用することは許可されていません。代わりに、このドキュメントで説明されている API キー認証方法を使用してください。

​
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 でバグまたは問題が発生した場合:

​
変更ログ

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

​
関連リソース