前提条件

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

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

セットアップ

1. モデルアクセスを有効にする

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

  1. Amazon Bedrockコンソールに移動
  2. 左側のナビゲーションでModel accessに移動
  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

オプションD: Bedrock APIキー

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Bedrock APIキーは、完全なAWS認証情報を必要とせずに、よりシンプルな認証方法を提供します。Bedrock APIキーについて詳しく学ぶ

3. Claude Codeを設定する

Bedrockを有効にするために以下の環境変数を設定してください:

# Bedrock統合を有効にする
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # または希望するリージョン

# オプション: 小型/高速モデル(Haiku)のリージョンを上書き
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

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

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

# 推論プロファイル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'

# オプション: 必要に応じてプロンプトキャッシュを無効にする
export DISABLE_PROMPT_CACHING=1

プロンプトキャッシュはすべてのリージョンで利用できない場合があります

IAM設定

Claude Codeに必要な権限を持つIAMポリシーを作成してください:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*"
      ]
    }
  ]
}

より制限的な権限については、Resourceを特定の推論プロファイルARNに制限できます。

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

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

トラブルシューティング

リージョンの問題が発生した場合:

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

「on-demand throughputはサポートされていません」というエラーが表示される場合:

追加リソース