​
SDKオプション

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

​
なぜClaude Code SDKを使用するのか？

Claude Codeを支えるエージェントハーネスの上に構築されたClaude Code SDKは、本番環境対応のエージェントを構築するために必要なすべての構成要素を提供します。 Claude Codeで行った作業を活用し、以下を含みます：
  • コンテキスト管理: エージェントがコンテキスト不足にならないよう、自動圧縮とコンテキスト管理
  • 豊富なツールエコシステム: ファイル操作、コード実行、Web検索、MCP拡張性
  • 高度な権限: エージェント機能の細かい制御
  • 本番環境必須機能: 組み込みエラーハンドリング、セッション管理、監視
  • 最適化されたClaude統合: 自動プロンプトキャッシュとパフォーマンス最適化

​
SDKで何を構築できるか？

作成できるエージェントタイプの例をいくつか紹介します： コーディングエージェント:
  • 本番環境の問題を診断・修正するSREエージェント
  • 脆弱性についてコードを監査するセキュリティレビューボット
  • インシデントをトリアージするオンコールエンジニアリングアシスタント
  • スタイルとベストプラクティスを強制するコードレビューエージェント
ビジネスエージェント:
  • 契約とコンプライアンスをレビューする法務アシスタント
  • レポートと予測を分析する財務アドバイザー
  • 技術的問題を解決するカスタマーサポートエージェント
  • マーケティングチーム向けのコンテンツ作成アシスタント

​
核となる概念

​
認証

基本認証の場合、Anthropic ConsoleからAnthropic 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/settings.jsonで設定されたカスタムコマンドを実行
  • スラッシュコマンド: ./.claude/commands/にMarkdownファイルとして定義されたカスタムコマンドを使用
  • メモリ（CLAUDE.md）: 永続的な指示とコンテキストを提供するCLAUDE.mdファイルを通じてプロジェクトコンテキストを維持
これらの機能は、同じファイルシステムの場所から読み取ることで、Claude Codeの対応機能と同じように動作します。

​
システムプロンプト

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

​
ツール権限

細かい権限でエージェントが使用できるツールを制御します：
  • allowedTools - 特定のツールを明示的に許可
  • disallowedTools - 特定のツールをブロック
  • permissionMode - 全体的な権限戦略を設定

​
Model Context Protocol（MCP）

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

​
関連リソース