Amazon BedrockでのClaude Code
セットアップ、IAM設定、トラブルシューティングを含む、Amazon BedrockでのClaude Codeの設定について学びます。
前提条件
BedrockでClaude Codeを設定する前に、以下を確認してください:
- Bedrockアクセスが有効になっているAWSアカウント
- Bedrockで希望するClaudeモデル(例:Claude Sonnet 4)へのアクセス
- AWS CLIがインストールされ設定されている(オプション - 認証情報を取得する他の仕組みがない場合のみ必要)
- 適切なIAM権限
セットアップ
1. モデルアクセスを有効にする
まず、AWSアカウントで必要なClaudeモデルへのアクセスがあることを確認してください:
- Amazon Bedrockコンソールに移動
- 左側のナビゲーションでModel accessに移動
- 希望する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プロファイル)
オプションD: Bedrock APIキー
Bedrock APIキーは、完全なAWS認証情報を必要とせずに、よりシンプルな認証方法を提供します。Bedrock APIキーについて詳しく学ぶ。
3. Claude Codeを設定する
Bedrockを有効にするために以下の環境変数を設定してください:
AWS_REGION
は必須の環境変数です。Claude Codeはこの設定について.aws
設定ファイルから読み取りません。
Bedrockを使用する場合、認証はAWS認証情報を通じて処理されるため、/login
と/logout
コマンドは無効になります。
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ポリシーを作成してください:
より制限的な権限については、Resourceを特定の推論プロファイルARNに制限できます。
詳細については、Bedrock IAMドキュメントを参照してください。
コスト追跡とアクセス制御を簡素化するために、Claude Code専用のAWSアカウントを作成することをお勧めします。
トラブルシューティング
リージョンの問題が発生した場合:
- モデルの可用性を確認:
aws bedrock list-inference-profiles --region your-region
- サポートされているリージョンに切り替え:
export AWS_REGION=us-east-1
- クロスリージョンアクセスのために推論プロファイルの使用を検討
「on-demand throughputはサポートされていません」というエラーが表示される場合:
- モデルを推論プロファイル IDとして指定してください