Claude Code SDK
概要
Claude Code SDKでカスタムAIエージェントを構築する
SDKオプション
Claude Code SDKは、さまざまなユースケースに対応するため、複数の形式で利用できます:
- ヘッドレスモード - CLIスクリプトと自動化用
- TypeScript SDK - Node.jsとWebアプリケーション用
- Python SDK - Pythonアプリケーションとデータサイエンス用
Claude Code SDKを使用する理由は?
Claude Codeを支えるエージェントハーネスの上に構築されたClaude Code SDKは、本番環境対応のエージェントを構築するために必要なすべての構成要素を提供します:
- 最適化されたClaude統合: 自動プロンプトキャッシングとパフォーマンス最適化
- 豊富なツールエコシステム: ファイル操作、コード実行、Web検索、およびMCP拡張性
- 高度な権限管理: エージェント機能の細かい制御
- 本番環境必須機能: 組み込みエラーハンドリング、セッション管理、監視
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、その他の外部サービスに接続できます。
関連リソース
- CLIリファレンス - 完全なCLIドキュメント
- GitHub Actions統合 - GitHubワークフローの自動化
- MCPドキュメント - カスタムツールでClaudeを拡張
- 一般的なワークフロー - ステップバイステップガイド
- トラブルシューティング - よくある問題と解決策