概要
Claude Codeのサンドボックス機能「mask」とプロキシによるSigV4再署名を利用し、AIエージェントに実物のAWSクレデンシャルを露出させずにAWS操作を行わせる安全な設定方法の解説。
詳細内容
Claude Codeのサンドボックス環境において、AIエージェントにAWS認証情報を直接渡さずにAWS CLI等の操作を許可する「第三の選択肢」としての設定手法を詳説しています。
### 主な内容
- **mask機能の仕組み**: サンドボックス内では「sentinel（偽の鍵）」を見せ、外部への通信時にプロキシが本物の鍵へ差し替えることで、ログやメモリからの漏洩を防ぎます。
- **AWS SigV4への対応**: AWSの署名プロセス（SigV4）は単純な文字列置換では壊れるため、プロキシがリクエストを検出し、本物の鍵で署名を計算し直す高度な仕組みが導入されています。
- **設定の要件**: 署名を再計算するために、プロキシでのTLS終端（`tlsTerminate`）の有効化と、アクセスキー・シークレットキーのペアでの設定が必須となります。
- **制限事項**: ストリーミングアップロードや署名付きURLなど、プロキシ側で再署名が困難な一部の形態については注意が必要です。
「鍵をエージェントの外側（中継点）で管理する」という設計思想は、AIエージェントの安全な運用のための重要なプラクティスとなります。