デプロイ
Amazon BedrockでのClaude Code
Amazon Bedrockを通じたClaude Codeの設定について、セットアップ、IAM設定、トラブルシューティングを含めて学習します。
前提条件
BedrockでClaude Codeを設定する前に、以下を確認してください:
- Bedrockアクセスが有効化されたAWSアカウント
- Bedrockで希望するClaudeモデル(例:Claude Sonnet 4)へのアクセス
- AWS CLIがインストールされ設定済み(オプション - 認証情報を取得する他の仕組みがない場合のみ必要)
- 適切なIAM権限
セットアップ
1. モデルアクセスを有効化
まず、AWSアカウントで必要なClaudeモデルへのアクセスがあることを確認します:
- Amazon Bedrockコンソールに移動
- 左側のナビゲーションでモデルアクセスに移動
- 希望するClaudeモデル(例:Claude Sonnet 4)へのアクセスをリクエスト
- 承認を待つ(ほとんどの地域で通常は即座)
2. AWS認証情報を設定
Claude Codeはデフォルトのaws SDK認証情報チェーンを使用します。以下のいずれかの方法で認証情報を設定してください:
Claude Codeは現在、動的認証情報管理(aws sts assume-role
の自動呼び出しなど)をサポートしていません。aws configure
、aws sso login
を実行するか、AWS_
環境変数を自分で設定する必要があります。
オプションA: AWS CLI設定
オプションB: 環境変数(アクセスキー)
オプションC: 環境変数(SSOプロファイル)
3. Claude Codeを設定
Bedrockを有効化するために以下の環境変数を設定します:
AWS_REGION
は必須の環境変数です。Claude Codeはこの設定について.aws
設定ファイルから読み取りません。
4. モデル設定
Claude CodeはBedrockに対してこれらのデフォルトモデルを使用します:
モデルタイプ | デフォルト値 |
---|---|
プライマリモデル | us.anthropic.claude-3-7-sonnet-20250219-v1:0 |
小型/高速モデル | us.anthropic.claude-3-5-haiku-20241022-v1:0 |
モデルをカスタマイズするには、以下のいずれかの方法を使用します:
IAM設定
Claude Codeに必要な権限を持つIAMポリシーを作成します。
詳細については、Bedrock IAMドキュメントを参照してください。
コスト追跡とアクセス制御を簡素化するために、Claude Code専用のAWSアカウントを作成することをお勧めします。
トラブルシューティング
地域の問題が発生した場合:
- モデルの可用性を確認:
aws bedrock list-inference-profiles --region your-region
- サポートされている地域に切り替え:
export AWS_REGION=us-east-1
- クロスリージョンアクセスのために推論プロファイルの使用を検討
「オンデマンドスループットはサポートされていません」というエラーを受け取った場合:
- モデルを推論プロファイル IDとして指定