​
Claude Code SDKを使用する理由

Claude Codeを支えるエージェントハーネスの上に構築されたClaude Code SDKは、本番環境対応のエージェントを構築するために必要なすべてのビルディングブロックを提供します：

  • 最適化されたClaude統合: 自動プロンプトキャッシュとパフォーマンス最適化
  • 豊富なツールエコシステム: ファイル操作、コード実行、ウェブ検索、MCP拡張性
  • 高度な権限管理: エージェント機能の細かい制御
  • 本番環境必須機能: 組み込みエラーハンドリング、セッション管理、監視

​
SDKで何を構築できますか？

作成できるエージェントタイプの例をいくつか紹介します：

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

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

ビジネスエージェント:

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

​
SDKオプション

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

​
コア概念

​
認証

基本認証の場合、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のドキュメントを参照してください。

​
システムプロンプト

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

​
ツール権限

細かい権限でエージェントが使用できるツールを制御します：

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

​
Model Context Protocol (MCP)

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

​
一般的なユースケース

​
自動テストとCI/CD

CI/CDパイプラインでテストを実行し、結果を分析し、問題を自動的に修正するエージェントを作成します。

​
コードレビューとセキュリティ監査

セキュリティ脆弱性、コード品質、コンプライアンスについてプルリクエストをレビューするエージェントを構築します。

​
インシデント対応

本番環境の問題を診断し、ログを分析し、修正を提案するSREエージェントを展開します。

​
ドキュメント生成

コードベースに基づいてドキュメントを生成・維持するエージェントを作成します。

​
データ分析

データを分析し、レポートを生成し、可視化を作成するエージェントを構築します。

​
ベストプラクティス

  • JSON出力形式を使用 - レスポンスのプログラム的解析のため
  • エラーを適切に処理 - 終了コードをチェックし、リトライロジックを実装
  • セッション管理を使用 - マルチターン会話でコンテキストを維持
  • タイムアウトを実装 - 長時間実行される操作のため
  • レート制限を尊重 - 複数のリクエストを行う際
  • 本番環境にデプロイする前に十分にテスト

​
関連リソース