前提条件

BedrockでClaude Codeを設定する前に、以下を確認してください:

  • Bedrockアクセスが有効化されたAWSアカウント
  • Bedrockで希望するClaudeモデル(例:Claude Sonnet 4)へのアクセス
  • AWS CLIがインストールされ設定済み(オプション - 認証情報を取得する他の仕組みがない場合のみ必要)
  • 適切なIAM権限

セットアップ

1. モデルアクセスを有効化

まず、AWSアカウントで必要なClaudeモデルへのアクセスがあることを確認します:

  1. Amazon Bedrockコンソールに移動
  2. 左側のナビゲーションでモデルアクセスに移動
  3. 希望するClaudeモデル(例:Claude Sonnet 4)へのアクセスをリクエスト
  4. 承認を待つ(ほとんどの地域で通常は即座)

2. AWS認証情報を設定

Claude Codeはデフォルトのaws SDK認証情報チェーンを使用します。以下のいずれかの方法で認証情報を設定してください:

Claude Codeは現在、動的認証情報管理(aws sts assume-roleの自動呼び出しなど)をサポートしていません。aws configureaws sso loginを実行するか、AWS_環境変数を自分で設定する必要があります。

オプションA: AWS CLI設定

aws configure

オプションB: 環境変数(アクセスキー)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

オプションC: 環境変数(SSOプロファイル)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

3. Claude Codeを設定

Bedrockを有効化するために以下の環境変数を設定します:

# Bedrock統合を有効化
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # または希望する地域

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

モデルをカスタマイズするには、以下のいずれかの方法を使用します:

# 推論プロファイルIDを使用
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# アプリケーション推論プロファイルARNを使用
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

IAM設定

Claude Codeに必要な権限を持つIAMポリシーを作成します。

詳細については、Bedrock IAMドキュメントを参照してください。

コスト追跡とアクセス制御を簡素化するために、Claude Code専用のAWSアカウントを作成することをお勧めします。

トラブルシューティング

地域の問題が発生した場合:

  • モデルの可用性を確認:aws bedrock list-inference-profiles --region your-region
  • サポートされている地域に切り替え:export AWS_REGION=us-east-1
  • クロスリージョンアクセスのために推論プロファイルの使用を検討

「オンデマンドスループットはサポートされていません」というエラーを受け取った場合:

追加リソース