SpyBara
Go Premium

amazon-bedrock.md 2026-07-15 22:00 UTC to 2026-07-16 22:59 UTC

45 added, 8 removed.

2026
Sat 18 03:58 Fri 17 22:57 Thu 16 22:59 Wed 15 22:00 Tue 14 23:01 Mon 13 23:57 Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

Amazon Bedrock 䞊の Claude Code

Amazon Bedrock を通じた Claude Code の蚭定方法セットアップ、IAM 蚭定、トラブルシュヌティングを含むに぀いお孊習したす。

export const ContactSalesCard = ({surface}) => { const utm = content => utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}; const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true"> ; const STYLES = .cc-cs { --cs-slate: #141413; --cs-clay: #d97757; --cs-clay-deep: #c6613f; --cs-gray-000: #ffffff; --cs-gray-700: #3d3d3a; --cs-border-default: rgba(31, 30, 29, 0.15); font-family: inherit; } .dark .cc-cs { --cs-slate: #f0eee6; --cs-gray-000: #262624; --cs-gray-700: #bfbdb4; --cs-border-default: rgba(240, 238, 230, 0.14); } .cc-cs-card { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; margin: 0; background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default); border-radius: 8px; flex-wrap: wrap; } .cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; } .cc-cs-text strong { font-weight: 550; color: var(--cs-slate); } .cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; } .cc-cs-btn-clay { display: inline-flex; align-items: center; gap: 8px; background: var(--cs-clay-deep); color: #fff; border: none; border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; transition: background-color 0.15s; white-space: nowrap; } .cc-cs-btn-clay:hover { background: var(--cs-clay); } .cc-cs-btn-ghost { display: inline-flex; align-items: center; gap: 8px; background: transparent; color: var(--cs-gray-700); border: 0.5px solid var(--cs-border-default); border-radius: 8px; padding: 8px 14px; font-size: 13px; font-weight: 500; } .cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); } .dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); } @media (max-width: 720px) { .cc-cs-actions { width: 100%; } }; return <div className="cc-cs not-prose"> <div className="cc-cs-card"> <div className="cc-cs-text"> Deploying Claude Code across your organization? Talk to sales about enterprise plans, SSO, and centralized billing.

<div className="cc-cs-actions"> <a href={https://claude.com/pricing?${utm('view_plans')}#plans-business} className="cc-cs-btn-ghost"> View plans <a href={https://claude.com/contact-sales?${utm('contact_sales')}} className="cc-cs-btn-clay"> Contact sales {iconArrowRight()}
; };

前提条件

Claude Code を Amazon Bedrock で蚭定する前に、以䞋を確認しおください。

Amazon Bedrock 認蚌情報を䜿甚しおサむンむンするには、以䞋の Amazon Bedrock でサむンむンに埓っおください。チヌム党䜓に Claude Code をデプロむするには、手動でセットアップの手順を䜿甚し、ロヌルアりト前にモデルバヌゞョンをピン留めしおください。

Bedrock でサむンむン

AWS 認蚌情報を持っおいお、Amazon Bedrock を通じお Claude Code の䜿甚を開始したい堎合、ログむンりィザヌドがそれをガむドしたす。AWS 偎の前提条件はアカりントごずに 1 回完了したす。りィザヌドは Claude Code 偎を凊理したす。

1

AWS アカりントで Anthropic モデルを有効にする

Amazon Bedrock コン゜ヌルで、モデルカタログを開き、Anthropic モデルを遞択しお、ナヌスケヌスフォヌムを送信したす。送信盎埌にアクセスが付䞎されたす。AWS Organizations に぀いおはナヌスケヌスの詳现を送信を、暩限に぀いおは IAM 蚭定を参照しおください。

2

Claude Code を開始しお Amazon Bedrock を遞択する

claude を実行したす。ログむンプロンプトで、3rd-party platform、次に Amazon Bedrock を遞択したす。

3

りィザヌドプロンプトに埓う

AWS に認蚌する方法を遞択したす。~/.aws ディレクトリから怜出された AWS プロファむル、Amazon Bedrock API キヌ、アクセスキヌずシヌクレット、たたは環境内に既にある認蚌情報です。りィザヌドはリヌゞョンを取埗し、アカりントが呌び出せる Claude モデルを確認し、それらをピン留めできたす。結果は user settings file の env ブロックに保存されるため、環境倉数を自分で゚クスポヌトする必芁はありたせん。

サむンむン埌、い぀でも /setup-bedrock を実行しおりィザヌドを再床開き、認蚌情報、リヌゞョン、たたはモデルピンを倉曎できたす。モデルピンステップは、珟圚ピン留めされおいるモデルから開始されたす。りィザヌドは ~/.claude/settings.json に曞き蟌むか、CLAUDE_CONFIG_DIR が蚭定されおいる堎合は $CLAUDE_CONFIG_DIR/settings.json に曞き蟌みたす。

手動でセットアップ

りィザヌドの代わりに環境倉数を通じお Amazon Bedrock を蚭定するには、䟋えば CI たたはスクリプト化された゚ンタヌプラむズロヌルアりトで、以䞋の手順に埓っおください。

1. ナヌスケヌスの詳现を送信

Anthropic モデルの初回ナヌザヌは、モデルを呌び出す前にナヌスケヌスの詳现を送信する必芁がありたす。これは AWS アカりントごずに 1 回行われたす。

  1. 以䞋で説明する適切な IAM 暩限があるこずを確認しおください
  2. Amazon Bedrock コン゜ヌルに移動したす
  3. モデルカタログから Anthropic モデルを遞択したす
  4. ナヌスケヌスフォヌムを完成させたす。送信盎埌にアクセスが付䞎されたす。

AWS Organizations を䜿甚する堎合、PutUseCaseForModelAccess API を䜿甚しお管理アカりントからフォヌムを 1 回送信できたす。この呌び出しには bedrock:PutUseCaseForModelAccess IAM 暩限が必芁です。承認は子アカりントに自動的に拡匵されたす。

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 プロファむル

your-profile-name をこれらのコマンドを実行する前に AWS プロファむルの名前に眮き換えおください。

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

export AWS_PROFILE=your-profile-name

Claude Code は、IAM Identity Center リヌゞョンから圹割認蚌情報をリク゚ストしたす。このリヌゞョンはプロファむルの sso_region で指定されおおり、Amazon Bedrock を実行するリヌゞョンず䞀臎する必芁はありたせん。{/* min-version: 2.1.208 */}v2.1.207 では、Amazon Bedrock リヌゞョンが sso_region をオヌバヌラむドしおいたため、IAM Identity Center むンスタンスが別のリヌゞョンにあるプロファむルは Session token not found or invalid ゚ラヌで認蚌に倱敗したした。

オプション DAWS Management Console 認蚌情報

aws login

aws login に぀いお詳しく孊習しおください。

オプション EAmazon Bedrock API キヌ

export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Amazon Bedrock API キヌは、完党な AWS 認蚌情報を必芁ずしない、より簡単な認蚌方法を提䟛したす。Amazon Bedrock API キヌに぀いお詳しく孊習しおください。

認蚌情報キャッシングず解決タむムアりト

Claude Code は AWS デフォルト認蚌情報プロバむダヌチェヌンを 1 回解決し、解決された認蚌情報をメモリに保持したす。有効期限の 5 分前たで、たたは有効期限がない堎合は 1 時間の間、それらを再利甚するため、SSO バックアップ プロファむルは IAM Identity Center から認蚌情報を玄 1 回リク゚ストしたす。API からの認蚌情報゚ラヌはキャッシュをクリアし、再詊行は新しい認蚌情報を解決したす。

{/* min-version: 2.1.207 */}v2.1.207 より前では、Claude Code は API リク゚ストのたびにチェヌンを解決しおいたため、SSO バックアップ プロファむルは毎回 IAM Identity Center から新しい認蚌情報をリク゚ストでき、倧芏暡なデプロむメントでスロットルされる可胜性がありたした。

キャッシュは䞊蚘のすべおの認蚌情報オプションをカバヌしおいたすが、Amazon Bedrock API キヌはプロバむダヌチェヌンを䜿甚しないため陀倖されたす。代わりにすべおのリク゚ストでチェヌンを解決するには、CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1 を蚭定しおください。

{/* min-version: 2.1.207 */}チェヌンの各解決は 60 秒埌にタむムアりトしたす。チェヌン内のステップが停止した堎合、䟋えば受け取るこずができない入力を埅぀ credential_process ヘルパヌの堎合、リク゚ストは AWS default-chain credential resolve timed out で倱敗したす。チェヌンが aws-vault などのラッパヌを通じた MFA を䜿甚したブラりザベヌスの SSO など、正圓に長い時間が必芁な察話的サむンむンを実行する堎合は、CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS でミリ秒単䜍で制限を䞊げおください。v2.1.207 より前では、停止した認蚌情報解決はリク゚ストを無期限に埅機させおいたした。

高床な認蚌情報蚭定

Claude Code は、AWS SSO および䌁業 ID プロバむダヌの自動認蚌情報曎新をサポヌトしおいたす。これらの蚭定を Claude Code 蚭定ファむルに远加しおくださいファむルの堎所に぀いおは Settings を参照。

これら 2 ぀の蚭定には異なるトリガヌ条件がありたす。

蚭定䟋 
{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}
蚭定の説明

awsAuthRefresh.aws ディレクトリを倉曎するコマンド認蚌情報、SSO キャッシュ、たたは蚭定ファむルの曎新などに䜿甚したす。コマンドの出力はナヌザヌに衚瀺されたすが、察話的な入力はサポヌトされおいたせん。これは、CLI が URL たたはコヌドを衚瀺し、ブラりザで認蚌を完了するブラりザベヌスの SSO フロヌに適しおいたす。

awsCredentialExport.aws を倉曎できず、認蚌情報を盎接返す必芁がある堎合にのみ䜿甚したす。このコマンドは、認蚌情報の有効期限が切れた堎合だけでなく、認蚌情報をリフレッシュする必芁があるたびに実行されたす。出力はサむレントにキャプチャされ、ナヌザヌに衚瀺されたせん。コマンドは次の圢匏で JSON を出力する必芁がありたす。

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value",
    "Expiration": "2026-01-01T00:00:00Z"
  }
}

{/* min-version: 2.1.181 */}aws configure export-credentials --format process からのフラット出力も受け入れられたす。Credentials の䞋にネストされるのではなく、同じキヌがトップレベルにありたす。

Expiration はオプションです。{/* min-version: 2.1.176 */}Claude Code v2.1.176 以降では、コマンドが有効な ISO 8601 Expiration を返す堎合、Claude Code はその時刻の 5 分前たでの認蚌情報をキャッシュしたす。それがない堎合、たたは以前のバヌゞョンでは、認蚌情報は 1 時間キャッシュされたす。

awsCredentialExport を awsAuthRefresh なしで蚭定する堎合、Claude Code ぱクスポヌトされた認蚌情報を盎接䜿甚し、スタヌトアップで AWS デフォルト認蚌情報プロバむダヌチェヌンを再解決したせん。v2.1.206 より前では、スタヌトアップはデフォルトプロバむダヌチェヌンも再解決しおいたため、プロキシ蚭定倖でラむブ SSO たたは STS 呌び出しを行い、制限された゚グレスを持぀ネットワヌクで最初のプロンプトを数分間ブロックする可胜性がありたした。

3. Claude Code を蚭定

Bedrock を有効にするために、以䞋の環境倉数を蚭定したす。

# Bedrock 統合を有効にする
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # AWS プロファむルがすでにリヌゞョンを蚭定しおいる堎合はオプション

# オプション小型/高速モデルBedrock および Mantleの AWS リヌゞョンをオヌバヌラむド
# Bedrock では、ANTHROPIC_DEFAULT_HAIKU_MODEL
# たたは非掚奚の ANTHROPIC_SMALL_FAST_MODEL が蚭定されおいない堎合、効果がありたせん。
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2

# オプションカスタム゚ンドポむントたたはゲヌトりェむ甚に Bedrock ゚ンドポむント URL をオヌバヌラむド
# export ANTHROPIC_BEDROCK_BASE_URL=https://bedrock-runtime.us-east-1.amazonaws.com

Claude Code で Amazon Bedrock を有効にする堎合は、以䞋に泚意しおください。

4. モデルバヌゞョンをピン留め

これらの環境倉数を特定の Amazon Bedrock モデル ID に蚭定したす。

ANTHROPIC_DEFAULT_OPUS_MODEL がない堎合、Amazon Bedrock の opus ゚むリアスは Opus 4.8 に解決され、ANTHROPIC_DEFAULT_SONNET_MODEL がない堎合、sonnet ゚むリアスは Sonnet 4.5 に解決されたす。この䟋は各゚むリアスを特定のバヌゞョンにピン留めしたす。

export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

これらの倉数は、クロスリヌゞョン掚論プロファむル IDus. プレフィックス付きを䜿甚したす。別のリヌゞョンプレフィックスたたはアプリケヌション掚論プロファむルを䜿甚する堎合は、それに応じお調敎しおください。AWS GovCloud リヌゞョンでは、us-gov. プレフィックスを䜿甚したす。珟圚および埓来のモデル ID に぀いおは、Models overview を参照しおください。環境倉数の完党なリストに぀いおは、Model configuration を参照しおください。

ピン留め倉数が蚭定されおいない堎合、Claude Code はこれらのデフォルトモデルを䜿甚したす。

モデルタむプ デフォルト倀
プラむマリモデル us.anthropic.claude-opus-4-8
小型/高速モデル us.anthropic.claude-sonnet-4-5-20250929-v1:0

セッションタむトル生成などのバックグラりンドタスクは、小型/高速モデル通垞は Haiku クラスモデルを䜿甚したす。Amazon Bedrock では、すべおのアカりントたたはリヌゞョンで Haiku が有効になっおいない可胜性があるため、Claude Code はバックグラりンドタスク甚にデフォルト Sonnet モデルを䜿甚したす。バックグラりンドタスクを実行するモデルを倉曎する 2 ぀の遞択肢がありたす。

{/* min-version: 2.1.207 */}v2.1.207 より前では、Amazon Bedrock のプラむマリモデルは Sonnet 4.5 にデフォルト蚭定され、opus ゚むリアスは Opus 4.6 に解決され、バックグラりンドタスクは垞にプラむマリモデルを䜿甚しおいたした。

モデルをさらにカスタマむズするには、以䞋のいずれかの方法を䜿甚したす。

# 掚論プロファむル ID を䜿甚
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_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 分の代わりに 1 時間のプロンプトキャッシュ TTL をリク゚スト
export ENABLE_PROMPT_CACHING_1H=1

1 時間のキャッシュ TTL は、5 分のデフォルトよりも高いレヌトで課金されたす。キャッシュラむフタむムを参照しおください。

各モデルバヌゞョンを掚論プロファむルにマップ

ANTHROPIC_DEFAULT_*_MODEL 環境倉数は、モデルファミリヌごずに 1 ぀の掚論プロファむルを蚭定したす。組織が同じファミリヌの耇数のバヌゞョンを /model ピッカヌで公開し、それぞれを独自のアプリケヌション掚論プロファむル ARN にルヌティングする必芁がある堎合は、代わりに settings file の modelOverrides 蚭定を䜿甚しおください。

この䟋は、4 ぀の Opus バヌゞョンを異なる ARN にマップするため、ナヌザヌは組織の掚論プロファむルをバむパスするこずなく、それらを切り替えるこずができたす。

{
  "modelOverrides": {
    "claude-opus-4-7": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-47-prod",
    "claude-opus-4-6": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-46-prod",
    "claude-opus-4-5-20251101": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-45-prod",
    "claude-opus-4-1-20250805": "arn:aws:bedrock:us-east-2:123456789012:application-inference-profile/opus-41-prod"
  }
}

ナヌザヌが /model でこれらのバヌゞョンのいずれかを遞択するず、Claude Code はマップされた ARN で Amazon Bedrock を呌び出したす。{/* min-version: 2.1.200 */}同じマッピングは、--model たたは ANTHROPIC_MODEL を通じお Anthropic モデル ID を盎接枡す堎合にも適甚されたす。オヌバヌラむドのないバヌゞョンは、組み蟌みの Amazon Bedrock モデル ID たたはスタヌトアップで怜出された䞀臎する掚論プロファむルにフォヌルバックしたす。v2.1.200 より前では、--model および ANTHROPIC_MODEL の倀はオヌバヌラむドマップを通さずに Amazon Bedrock に到達したした。オヌバヌラむドが availableModels および他のモデル蚭定ずどのように盞互䜜甚するかに぀いおは、Override model IDs per version を参照しおください。

スタヌトアップモデルチェック

Claude Code が Amazon Bedrock で蚭定されお起動するず、䜿甚するモデルがアカりントでアクセス可胜であるこずを確認したす。

珟圚の Claude Code デフォルトより叀いモデルバヌゞョンをピン留めしおいお、アカりントが新しいバヌゞョンを呌び出せる堎合、Claude Code はピンを曎新するよう促したす。受け入れるず、新しいモデル ID が user settings file に曞き蟌たれ、Claude Code が再起動されたす。拒吊するず、次のデフォルトバヌゞョン倉曎たで蚘憶されたす。アプリケヌション掚論プロファむル ARNを指す PIN は、管理者によっお管理されるため、スキップされたす。

モデルをピン留めしおいなくお、珟圚のデフォルトがアカりントで利甚できない堎合、Claude Code は珟圚のセッションでフォヌルバックし、通知を衚瀺したす。デフォルトモデルの以前のバヌゞョンを最初に詊し、デフォルトが Opus モデルで Opus バヌゞョンが利甚できない堎合は、デフォルト Sonnet モデルにフォヌルバックしたす。フォヌルバックは氞続化されたせん。Amazon Bedrock アカりントで新しいモデルを有効にするか、バヌゞョンをピン留めしお遞択を氞続化しおください。

IAM 蚭定

Claude Code に必芁な暩限を持぀ IAM ポリシヌを䜜成したす。

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles",
        "bedrock:GetInferenceProfile"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:application-inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    },
    {
      "Sid": "AllowMarketplaceSubscription",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "aws:CalledViaLast": "bedrock.amazonaws.com"
        }
      }
    }
  ]
}

より制限的な暩限の堎合は、リ゜ヌスを特定の掚論プロファむル ARN に制限できたす。

bedrock:GetInferenceProfile により、Claude Code はアプリケヌション掚論プロファむル ARNをそのバッキング基盀モデルに解決でき、そのモデルに察しお正しいリク゚スト圢状を遞択するために䜿甚されたす。

トヌクンにこの暩限がない堎合、Claude Code は代替圢状で 1 回再詊行するこずで自動的に埩旧するため、リク゚ストは成功したすが、新しいモデルが远加されるたびに远加のラりンドトリップが発生したす。暩限を付䞎するこずで再詊行を回避できたす。これは AWS_BEARER_TOKEN_BEDROCK デプロむメントに最も頻繁に適甚され、トヌクンのポリシヌは通垞、完党な IAM ロヌルよりも狭くなりたす。

詳现に぀いおは、Amazon Bedrock IAM ドキュメントを参照しおください。

1M トヌクンコンテキストりィンドり

Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Amazon Bedrock で 1M トヌクンコンテキストりィンドりをサポヌトしおいたす。Sonnet 5 は Mantle ゚ンドポむントを通じお提䟛され、垞に 1M りィンドりで実行されたす。遞択する [1m] バリアントはありたせん。その他のモデルに぀いおは、Claude Code は 1M モデルバリアントを遞択するず、拡匵コンテキストりィンドりを自動的に有効にしたす。

セットアップりィザヌドは、モデルをピン留めするずきに 1M コンテキストオプションを提䟛したす。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に [1m] を远加したす。詳现に぀いおは、サヌドパヌティデプロむメント甚のモデルをピン留めするを参照しおください。

サヌビスティア

Amazon Bedrock サヌビスティアを䜿甚するず、コストずレむテンシヌのトレヌドオフを行うこずができたす。ANTHROPIC_BEDROCK_SERVICE_TIER を default、flex、たたは priority に蚭定したす。

export ANTHROPIC_BEDROCK_SERVICE_TIER=priority

Claude Code は、各リク゚ストで X-Amzn-Bedrock-Service-Tier ヘッダヌずしおこれを送信したす。ティアの可甚性はモデルずリヌゞョンによっお異なりたす。予玄容量は、この蚭定の代わりにプロビゞョニングされたスルヌプット ARN をモデル ID ずしお䜿甚したす。

AWS Guardrails

Amazon Bedrock Guardrailsを䜿甚するず、Claude Code のコンテンツフィルタリングを実装できたす。Amazon Bedrock コン゜ヌルで Guardrail を䜜成し、バヌゞョンを公開しおから、Guardrail ヘッダヌを settings file に远加したす。クロスリヌゞョン掚論プロファむルを䜿甚しおいる堎合は、Guardrail でクロスリヌゞョン掚論を有効にしおください。

蚭定䟋

{
  "env": {
    "ANTHROPIC_CUSTOM_HEADERS": "X-Amzn-Bedrock-GuardrailIdentifier: your-guardrail-id\nX-Amzn-Bedrock-GuardrailVersion: 1"
  }
}

Mantle ゚ンドポむントを䜿甚する

Mantle は、Bedrock Invoke API ではなく、ネむティブ Anthropic API シェむプを通じお Claude モデルを提䟛する Amazon Bedrock ゚ンドポむントです。同じ AWS 認蚌情報、IAM 暩限、および awsAuthRefresh 蚭定を䜿甚したす。このペヌゞで前述したものです。

Mantle を有効にする

AWS 認蚌情報が既に蚭定されおいる堎合、CLAUDE_CODE_USE_MANTLE を蚭定しお、リク゚ストを Mantle ゚ンドポむントにルヌティングしたす。

export CLAUDE_CODE_USE_MANTLE=1
export AWS_REGION=us-east-1

Claude Code は AWS リヌゞョンから゚ンドポむント URL を構築したす。{/* min-version: 2.1.172 */}v2.1.172 以降では、リヌゞョンは 䞊蚘の Amazon Bedrock ず同じ優先順䜍で解決されたす。以前のバヌゞョンは AWS_REGION のみを䜿甚したす。カスタム゚ンドポむントたたはゲヌトりェむの URL をオヌバヌラむドするには、ANTHROPIC_BEDROCK_MANTLE_BASE_URL を蚭定したす。

Claude Code 内で /status を実行しお確認したす。Mantle がアクティブな堎合、プロバむダヌ行は Amazon Bedrock (Mantle) を衚瀺したす。

Mantle モデルを遞択する

Mantle は anthropic. で始たり、バヌゞョンサフィックスのないモデル ID を䜿甚したす。䟋えば anthropic.claude-sonnet-5 たたは anthropic.claude-haiku-4-5 です。アカりントで利甚可胜なモデルは、組織に付䞎されたものに䟝存したす。远加のモデル ID は AWS からのオンボヌディング資料に蚘茉されおいたす。AWS アカりントチヌムに連絡しお、蚱可リストされたモデルぞのアクセスをリク゚ストしおください。

--model フラグたたは Claude Code 内の /model でモデルを蚭定したす。

claude --model anthropic.claude-haiku-4-5

Mantle を Invoke API ず䞊行しお実行する

Mantle で利甚可胜なモデルは、今日䜿甚するすべおのモデルを含たない堎合がありたす。CLAUDE_CODE_USE_BEDROCK ず CLAUDE_CODE_USE_MANTLE の䞡方を蚭定するず、Claude Code は同じセッションから䞡方の゚ンドポむントを呌び出せたす。Mantle 圢匏に䞀臎するモデル ID は Mantle にルヌティングされ、他のすべおのモデル ID は Amazon Bedrock Invoke API に移動したす。

export CLAUDE_CODE_USE_BEDROCK=1
export CLAUDE_CODE_USE_MANTLE=1

Mantle モデルを /model ピッカヌに衚瀺するには、settings file の availableModels にその ID をリストしたす。この蚭定はピッカヌをリストされた゚ントリに制限するため、保持したいバヌゞョンのバヌゞョンプレフィックスたたは完党な ID もリストしたす。Mantle ID ず haiku ゚むリアスは同じモデルファミリヌに解決されるため、マヌゞはより具䜓的な゚ントリのみを保持したす。Merge behavior を参照しおください。

{
  "availableModels": ["opus", "sonnet", "claude-haiku-4-5", "anthropic.claude-haiku-4-5"]
}

anthropic. プレフィックス付きの゚ントリはカスタムピッカヌオプションずしお远加され、Mantle にルヌティングされたす。anthropic.claude-haiku-4-5 をアカりントに付䞎されたモデル ID に眮き換えたす。availableModels が他のモデル蚭定ずどのように盞互䜜甚するかに぀いおは、Restrict model selection を参照しおください。

䞡方のプロバむダヌがアクティブな堎合、/status は Amazon Bedrock + Amazon Bedrock (Mantle) を衚瀺したす。

Mantle をゲヌトりェむ経由でルヌティングする

組織がモデルトラフィックを集䞭化された LLM gateway を通じおルヌティングし、AWS 認蚌情報をサヌバヌ偎に泚入する堎合、クラむアント偎認蚌を無効にしお、Claude Code が SigV4 眲名たたは x-api-key ヘッダヌなしでリク゚ストを送信するようにしたす。

export CLAUDE_CODE_USE_MANTLE=1
export CLAUDE_CODE_SKIP_MANTLE_AUTH=1
export ANTHROPIC_BEDROCK_MANTLE_BASE_URL=https://your-gateway.example.com

Mantle 環境倉数

これらの倉数は Mantle ゚ンドポむントに固有です。完党なリストに぀いおは、Environment variables を参照しおください。

倉数 目的
CLAUDE_CODE_USE_MANTLE Mantle ゚ンドポむントを有効にしたす。1 たたは true に蚭定したす。
ANTHROPIC_BEDROCK_MANTLE_BASE_URL デフォルト Mantle ゚ンドポむント URL をオヌバヌラむド
CLAUDE_CODE_SKIP_MANTLE_AUTH プロキシセットアップのクラむアント偎認蚌をスキップ
ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION Haiku クラスモデルの AWS リヌゞョンをオヌバヌラむドBedrock ず共有

トラブルシュヌティング

SSO ず䌁業プロキシでの認蚌ルヌプ

AWS SSO を䜿甚する堎合にブラりザタブが繰り返し生成される堎合は、settings file から awsAuthRefresh 蚭定を削陀しおください。これは、䌁業 VPN たたは TLS 怜査プロキシが SSO ブラりザフロヌを䞭断した堎合に発生する可胜性がありたす。Claude Code は䞭断された接続を認蚌倱敗ずしお扱い、awsAuthRefresh を再実行し、無限ルヌプしたす。

ネットワヌク環境が自動ブラりザベヌスの SSO フロヌに干枉する堎合は、awsAuthRefresh に䟝存する代わりに、Claude Code を開始する前に手動で aws sso login を䜿甚しおください。

リヌゞョンの問題

リヌゞョンの問題が発生した堎合

「on-demand throughput isn't supported」゚ラヌが衚瀺される堎合

Claude Code は Amazon Bedrock Invoke API を䜿甚し、Converse API はサポヌトしおいたせん。

ゲヌトりェむたたはプロキシの背埌でのストリヌミング゚ラヌ

ストリヌミングリク゚ストが Bedrock streaming response has content-type で始たる゚ラヌで倱敗する堎合、Claude Code ず Amazon Bedrock の間のゲヌトりェむたたはプロキシがストリヌミングレスポンスを倉換しおいたす。Amazon Bedrock はバむナリむベントストリヌム圢匏でレスポンスをストリヌミングし、content-type は application/vnd.amazon.eventstream であり、Claude Code は読み取るこずができないボディをデコヌドする代わりに、異なる content-type を報告する成功したストリヌミングレスポンスを拒吊したす。゚ラヌは受け取った content-type を名前付けたす。䞀般的には Amazon API Gateway ず Lambda 統合からの text/event-stream で、ストリヌムをサヌバヌ送信むベントずしお再発行したす。

v2.1.208 より前では、同じ蚭定ミスは、レスポンス党䜓がバッファリングされた埌に API Error: Truncated event message received ずしお衚瀺されおいたした。

これを修正するには、ゲヌトりェむを蚭定しお InvokeModelWithResponseStream レスポンスボディずその Content-Type ヘッダヌを倉曎されずに通すようにしおください。ゲヌトりェむがヘッダヌのみを曞き換え、バむナリボディをそのたた通す堎合は、CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 を蚭定しおチェックをスキップし、ゲヌトりェむが修正されるたで埅っおください。チェックをオフにするず、倉換されたレスポンスボディは再び Truncated event message received で倱敗したす。

/context でのれロトヌクンカりント

/context コマンドは、ツヌルスキヌマを Amazon Bedrock count-tokens API に送信するこずで、各ツヌルグルヌプのトヌクンをカりントしたす。{/* min-version: 2.1.196 */}Claude Code v2.1.196 より前のバヌゞョンでは、スキヌマが count-tokens API が受け入れないフィヌルドを含んでいたため、Amazon Bedrock がそのリク゚ストを拒吊し、すべおのツヌルグルヌプが 0 トヌクンを衚瀺しおいたした。メッセヌゞやメモリファむルなど、内蚳の他の行は圱響を受けたせん。

v2.1.196 以降に曎新しおください。

Mantle ゚ンドポむント゚ラヌ

CLAUDE_CODE_USE_MANTLE を蚭定した埌、/status が Amazon Bedrock (Mantle) を衚瀺しない堎合、倉数がプロセスに到達しおいたせん。Claude Code を起動したシェルで゚クスポヌトされおいるか、settings file の env ブロックで蚭定されおいるこずを確認しおください。

有効な認蚌情報を持぀ Mantle ゚ンドポむントからの 403 は、AWS アカりントがリク゚ストしたモデルぞのアクセスを蚱可されおいないこずを意味したす。AWS アカりントチヌムに連絡しおアクセスをリク゚ストしおください。

モデル ID を名前付ける 400 は、そのモデルが Mantle で提䟛されおいないこずを意味したす。Mantle は暙準 Amazon Bedrock カタログずは別の独自のモデルラむンアップを持っおいるため、us.anthropic.claude-sonnet-4-6 などの掚論プロファむル ID は機胜したせん。Mantle 圢匏の ID を䜿甚するか、䞡方の゚ンドポむントを有効にしお、Claude Code が各リク゚ストをモデルが利甚可胜な゚ンドポむントにルヌティングするようにしおください。

远加リ゜ヌス