​
前提条件

BedrockでClaude Codeを設定する前に、以下を確認してください：
  • Bedrockアクセスが有効になっているAWSアカウント
  • Bedrockで希望するClaudeモデル（例：Claude Sonnet 4.5）へのアクセス
  • AWS CLIがインストールされ設定されている（オプション - 認証情報を取得する他の仕組みがない場合のみ必要）
  • 適切なIAM権限

​
セットアップ

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

まず、AWSアカウントで必要なClaudeモデルへのアクセスがあることを確認します：
  1. Amazon Bedrockコンソールに移動
  2. 左側のナビゲーションでModel accessに移動
  3. 希望するClaudeモデル（例：Claude Sonnet 4.5）へのアクセスをリクエスト
  4. 承認を待つ（ほとんどの地域で通常は即座）

​
2. AWS認証情報を設定する

Claude Codeはデフォルトのaws SDK認証情報チェーンを使用します。以下のいずれかの方法で認証情報を設定してください： オプション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キーについて詳しく学ぶ。

​
高度な認証情報設定

Claude CodeはAWS SSOと企業アイデンティティプロバイダーの自動認証情報更新をサポートしています。これらの設定をClaude Code設定ファイルに追加してください（ファイルの場所についてはSettingsを参照）。 Claude CodeがAWS認証情報が期限切れであることを検出した場合（タイムスタンプに基づいてローカルで、またはBedrockが認証情報エラーを返した場合）、リクエストを再試行する前に設定されたawsAuthRefreshおよび/またはawsCredentialExportコマンドを自動的に実行して新しい認証情報を取得します。
設定例
{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}
設定項目の説明
awsAuthRefresh: .awsディレクトリを変更するコマンド（例：認証情報、SSOキャッシュ、または設定ファイルの更新）に使用します。出力はユーザーに表示されます（ただしユーザー入力はサポートされていません）。これにより、CLIがブラウザで入力するコードを表示するブラウザベースの認証フローに適しています。 awsCredentialExport: .awsを変更できず、認証情報を直接返す必要がある場合のみ使用します。出力は静かにキャプチャされます（ユーザーには表示されません）。コマンドは以下の形式でJSONを出力する必要があります： 
{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value"
  }
}

​
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
Claude CodeでBedrockを有効にする際は、以下を念頭に置いてください：
  • AWS_REGIONは必須の環境変数です。Claude Codeはこの設定について.aws設定ファイルから読み取りません。
  • Bedrockを使用する場合、認証はAWS認証情報を通じて処理されるため、/loginおよび/logoutコマンドは無効になります。
  • 他のプロセスに漏洩させたくないAWS_PROFILEなどの環境変数には設定ファイルを使用できます。詳細についてはSettingsを参照してください。

​
4. モデル設定

Claude CodeはBedrockに対してこれらのデフォルトモデルを使用します：
モデルタイプデフォルト値
プライマリモデルglobal.anthropic.claude-sonnet-4-5-20250929-v1:0
小型/高速モデルus.anthropic.claude-haiku-4-5-20251001-v1:0
Bedrockユーザーの場合、Claude CodeはHaiku 3.5からHaiku 4.5に自動的にアップグレードしません。新しいHaikuモデルに手動で切り替えるには、ANTHROPIC_DEFAULT_HAIKU_MODEL環境変数を完全なモデル名（例：us.anthropic.claude-haiku-4-5-20251001-v1:0）に設定してください。
モデルをカスタマイズするには、以下のいずれかの方法を使用します： 
# 推論プロファイルIDを使用
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-haiku-4-5-20251001-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
プロンプトキャッシュはすべての地域で利用できない場合があります

​
5. 出力トークン設定

Amazon BedrockでClaude Codeを使用する場合、以下のトークン設定を推奨します： 
# Bedrockに推奨される出力トークン設定
export CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096
export MAX_THINKING_TOKENS=1024
これらの値の理由：
  • CLAUDE_CODE_MAX_OUTPUT_TOKENS=4096: Bedrockのバーンダウンスロットリングロジックは、max_tokenペナルティとして最低4096トークンを設定します。これより低く設定してもコストは削減されませんが、長いツール使用が切り捨てられ、Claude Codeエージェントループが持続的に失敗する可能性があります。Claude Codeは通常、拡張思考なしでは4096出力トークン未満を使用しますが、大幅なファイル作成やWriteツール使用を含むタスクにはこの余裕が必要な場合があります。
  • MAX_THINKING_TOKENS=1024: これにより、ツール使用応答を切り捨てることなく拡張思考のためのスペースを提供し、集中した推論チェーンを維持します。このバランスは、コーディングタスクに特に常に役立つとは限らない軌道変更を防ぐのに役立ちます。

​
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
  • クロスリージョンアクセスには推論プロファイルの使用を検討
「オンデマンドスループットはサポートされていません」エラーを受信した場合： Claude CodeはBedrock Invoke APIを使用し、Converse APIはサポートしていません。

​
追加リソース