Anthropic
OpenAI
xAI
Gemini
A
amazon-bedrock.md
2026-06-29 23:02 UTC to 2026-06-30 23:02 UTC
16 added, 8 removed.
Page
Diff
2026
2026
2025
Jan
Feb
Mar
Apr
May
Jun
Jul
Aug
Sep
Oct
Nov
Dec
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 を Bedrock で設定する前に、以下を確認してください。
Bedrock アクセスが有効になっている AWS アカウント
Bedrock で目的の Claude モデル(例:Claude Sonnet 4.6)へのアクセス
AWS CLI がインストールされ、設定されていること(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)
適切な IAM 権限
Bedrock 認証情報を使用してサインインするには、以下の Bedrock でサインイン に従ってください。チーム全体に Claude Code をデプロイするには、手動でセットアップ の手順を使用し、ロールアウト前にモデルバージョンをピン留め してください。
Bedrock でサインイン
AWS 認証情報を持っていて、Bedrock を通じて Claude Code の使用を開始したい場合、ログインウィザードがそれをガイドします。AWS 側の前提条件はアカウントごとに 1 回完了します。ウィザードは Claude Code 側を処理します。
2
Claude Code を開始して Bedrock を選択する
claude を実行します。ログインプロンプトで、3rd-party platform 、次に Amazon Bedrock を選択します。
3
ウィザードプロンプトに従う
AWS に認証する方法を選択します。~/.aws ディレクトリから検出された AWS プロファイル、Bedrock API キー、アクセスキーとシークレット、または環境内に既にある認証情報です。ウィザードはリージョンを取得し、アカウントが呼び出せる Claude モデルを確認し、それらをピン留めできます。結果は user settings file の env ブロックに保存されるため、環境変数を自分でエクスポートする必要はありません。
サインイン後、いつでも /setup-bedrock を実行してウィザードを再度開き、認証情報、リージョン、またはモデルピンを変更できます。
手動でセットアップ
ウィザードの代わりに環境変数を通じて Bedrock を設定するには、例えば CI またはスクリプト化されたエンタープライズロールアウトで、以下の手順に従ってください。
1. ユースケースの詳細を送信
Anthropic モデルの初回ユーザーは、モデルを呼び出す前にユースケースの詳細を送信する必要があります。これは AWS アカウントごとに 1 回行われます。
以下で説明する適切な IAM 権限があることを確認してください
Amazon Bedrock コンソール に移動します
モデルカタログ から Anthropic モデルを選択します
ユースケースフォームを完成させます。送信直後にアクセスが付与されます。
AWS Organizations を使用する場合、PutUseCaseForModelAccess API を使用して管理アカウントからフォームを 1 回送信できます。この呼び出しには bedrock:PutUseCaseForModelAccess IAM 権限が必要です。承認は子アカウントに自動的に拡張されます。
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:AWS Management Console 認証情報
aws login
aws login について詳しく学習 してください。
オプション E:Bedrock API キー
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key
Bedrock API キーは、完全な AWS 認証情報を必要としない、より簡単な認証方法を提供します。Bedrock API キーについて詳しく学習 してください。
高度な認証情報設定
Claude Code は、AWS SSO および企業 ID プロバイダーの自動認証情報更新をサポートしています。これらの設定を Claude Code 設定ファイルに追加してください(ファイルの場所については Settings を参照)。
これら 2 つの設定には異なるトリガー条件があります。
awsAuthRefresh :Claude Code がローカルのタイムスタンプに基づくか、Bedrock が認証情報エラーを返した場合に AWS 認証情報の有効期限が切れていることを検出した場合にのみ実行され、更新された認証情報でリクエストを再試行します。
awsCredentialExport :セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用します。
設定例
{
"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 時間キャッシュされます。
Bedrock を有効にするために、以下の環境変数を設定します。
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1
export ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION=us-west-2
Claude Code で Bedrock を有効にする場合は、以下に注意してください。
{/* min-version: 2.1.172 */}v2.1.172 以降では、AWS プロファイルのリージョンをオーバーライドする場合、またはプロファイルにリージョンがない場合にのみ AWS_REGION を設定する必要があります。Claude Code はこの順序でリージョンを解決します。
AWS_REGION
AWS_DEFAULT_REGION
AWS 共有認証情報ファイルから最初に読み込まれ、次に共有設定ファイルから読み込まれた、アクティブな AWS プロファイルに設定されたリージョン(AWS SDK の優先順位と一致)
us-east-1
アクティブなプロファイルは、設定されている場合は AWS_PROFILE、そうでない場合は default です。AWS_SHARED_CREDENTIALS_FILE または AWS_CONFIG_FILE を設定して、デフォルト以外のファイルパスを指定します。/status を実行して、解決されたリージョンを確認します。リージョンが AWS 設定ファイルまたはデフォルトフォールバックから取得された場合、/status はソースも記載します。v2.1.171 以前では、Claude Code は AWS 設定ファイルを読み込まないため、AWS_REGION を明示的に設定してください。
Bedrock を使用する場合、/logout コマンドは無効になります。認証は AWS 認証情報を通じて処理されるためです。
WebSearch ツールは Bedrock では利用できません。WebSearch ツールの動作 を参照してください。
他のプロセスに漏らしたくない AWS_PROFILE などの環境変数に設定ファイルを使用できます。詳細については Settings を参照してください。
4. モデルバージョンをピン留め
これらの環境変数を特定の Bedrock モデル ID に設定します。
ANTHROPIC_DEFAULT_OPUS_MODEL なしでは、Bedrock の opus エイリアスは Opus 4.6 に解決されます。最新モデルを使用するには、Opus 4.8 ID に設定します。
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-sonnet-4-5-20250929-v1:0
小型/高速モデル
プライマリモデルと同じ
セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル(通常は Haiku クラスモデル)を使用します。Bedrock では、すべてのアカウントまたはリージョンで Haiku が有効になっていない可能性があるため、Claude Code はこれをプライマリモデルにデフォルト設定します。バックグラウンドタスクに Haiku を使用するには、ANTHROPIC_DEFAULT_HAIKU_MODEL をアカウントで利用可能なモデル ID に設定してください。
モデルをさらにカスタマイズするには、以下のいずれかの方法を使用します。
export ANTHROPIC_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'
export DISABLE_PROMPT_CACHING=1
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 で Bedrock を呼び出します。オーバーライドのないバージョンは、組み込みの Bedrock モデル ID またはスタートアップで検出された一致する推論プロファイルにフォールバックします。オーバーライドが availableModels および他のモデル設定とどのように相互作用するかについては、Override model IDs per version を参照してください。
スタートアップモデルチェック
Claude Code が Bedrock で設定されて起動すると、使用するモデルがアカウントでアクセス可能であることを確認します。このチェックには Claude Code v2.1.94 以降が必要です。
現在の Claude Code デフォルトより古いモデルバージョンをピン留めしていて、アカウントが新しいバージョンを呼び出せる場合、Claude Code はピンを更新するよう促します。受け入れると、新しいモデル ID が user settings file に書き込まれ、Claude Code が再起動されます。拒否すると、次のデフォルトバージョン変更まで記憶されます。アプリケーション推論プロファイル ARN を指す PIN は、管理者によって管理されるため、スキップされます。
モデルをピン留めしていなくて、現在のデフォルトがアカウントで利用できない場合、Claude Code は現在のセッションで前のバージョンにフォールバックし、通知を表示します。フォールバックは永続化されません。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 ロールよりも狭くなります。
詳細については、Bedrock IAM documentation を参照してください。
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 以降では、リージョンは 上記の 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 は 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 を使用してください。
リージョンの問題
リージョンの問題が発生した場合:
モデルの可用性を確認:aws bedrock list-inference-profiles --region your-region
サポートされているリージョンに切り替え:export AWS_REGION=us-east-1
クロスリージョンアクセスに推論プロファイルの使用を検討
「on-demand throughput isn't supported」エラーが表示される場合:
Claude Code は Bedrock Invoke API を使用し、Converse API はサポートしていません。
/context でのゼロトークンカウント
/context コマンドは、ツールスキーマを Bedrock count-tokens API に送信することで、各ツールグループのトークンをカウントします。{/* min-version: 2.1.196 */}Claude Code v2.1.196 より前のバージョンでは、スキーマが count-tokens API が受け入れないフィールドを含んでいたため、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 は標準 Bedrock カタログとは別の独自のモデルラインアップを持っているため、us.anthropic.claude-sonnet-4-6 などの推論プロファイル ID は機能しません。Mantle 形式の ID を使用するか、両方のエンドポイントを有効にして 、Claude Code が各リクエストをモデルが利用可能なエンドポイントにルーティングするようにしてください。
追加リソース
397 1M トークンコンテキストウィンドウ397 1M トークンコンテキストウィンドウ
398 </h2>398 </h2>
399 399
400 Claude Opus 4.6 以降および Sonnet 4.6 は、Amazon Bedrock で [1M トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Claude Code は、 1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。400 Claude Sonnet 5、 Opus 4.6 以降、および Sonnet 4.6 は、Amazon Bedrock で [1M トークンコンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows#1m-token-context-window)をサポートしています。Sonnet 5 は [Mantle エンドポイント](#use-the-mantle-endpoint)を通じて提供され、常に 1M ウィンドウで実行されます。選択する `[1m]` バリアントはありません。その他のモデルについては、 Claude Code は 1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。
401 401
402 [セットアップウィザード](#sign-in-with-bedrock)は、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[Pin models for third-party deployments ](/ja/model-config#pin-models-for-third-party-deployments) を参照してください。402 [セットアップウィザード](#sign-in-with-bedrock)は、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に `[1m]` を追加します。詳細については、[サードパーティデプロイメント用のモデルをピン留めする ](/ja/model-config#pin-models-for-third-party-deployments)を参照してください。
403 403
404 <h2 id="service-tiers">404 <h2 id="service-tiers">
405 サービスティア405 サービスティア
430 ```430 ```
431 431
432 <h2 id="use-the-mantle-endpoint">432 <h2 id="use-the-mantle-endpoint">
433 Mantle エンドポイントを使用 433 Mantle エンドポイントを使用する
434 </h2>434 </h2>
435 435
436 Mantle は、Bedrock Invoke API ではなく、ネイティブ Anthropic API シェイプを通じて Claude モデルを提供する Amazon Bedrock エンドポイントです。同じ AWS 認証情報、IAM 権限、および `awsAuthRefresh` 設定を使用します。このページで前述したものです。436 Mantle は、Bedrock Invoke API ではなく、ネイティブ Anthropic API シェイプを通じて Claude モデルを提供する Amazon Bedrock エンドポイントです。同じ AWS 認証情報、IAM 権限、および `awsAuthRefresh` 設定を使用します。このページで前述したものです。
455 Claude Code 内で `/status` を実行して確認します。Mantle がアクティブな場合、プロバイダー行は `Amazon Bedrock (Mantle)` を表示します。455 Claude Code 内で `/status` を実行して確認します。Mantle がアクティブな場合、プロバイダー行は `Amazon Bedrock (Mantle)` を表示します。
456 456
457 <h3 id="select-a-mantle-model">457 <h3 id="select-a-mantle-model">
458 Mantle モデルを選択 458 Mantle モデルを選択する
459 </h3>459 </h3>
460 460
461 Mantle は `anthropic.` で始まり、バージョンサフィックスのないモデル ID を使用します。例えば `anthropic.claude-haiku-4-5`。アカウントで利用可能なモデルは、組織に付与されたものに依存します。追加のモデル ID は AWS からのオンボーディング資料に記載されています。AWS アカウントチームに連絡して、許可リストされたモデルへのアクセスをリクエストしてください。461 Mantle は `anthropic.` で始まり、バージョンサフィックスのないモデル ID を使用します。例えば `anthropic.claude-sonnet-5` または `anthropic.claude- haiku-4-5` です 。アカウントで利用可能なモデルは、組織に付与されたものに依存します。追加のモデル ID は AWS からのオンボーディング資料に記載されています。AWS アカウントチームに連絡して、許可リストされたモデルへのアクセスをリクエストしてください。
462 462
463 `--model` フラグまたは Claude Code 内の `/model` でモデルを設定します。463 `--model` フラグまたは Claude Code 内の `/model` でモデルを設定します。
464 464
467 ```467 ```
468 468
469 <h3 id="run-mantle-alongside-the-invoke-api">469 <h3 id="run-mantle-alongside-the-invoke-api">
470 Mantle を Invoke API と並行して実行 470 Mantle を Invoke API と並行して実行する
471 </h3>471 </h3>
472 472
473 Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。`CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_MANTLE` の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Bedrock Invoke API に移動します。473 Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。`CLAUDE_CODE_USE_BEDROCK` と `CLAUDE_CODE_USE_MANTLE` の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Bedrock Invoke API に移動します。
477 export CLAUDE_CODE_USE_MANTLE=1477 export CLAUDE_CODE_USE_MANTLE=1
478 ```478 ```
479 479
480 Mantle モデルを `/model` ピッカーに表示するには、[settings file](/ja/settings) の `availableModels` にその ID をリストします。この設定はピッカーをリストされたエントリに制限するため、保持したいバージョンのバージョンプレフィックスまたは完全な ID もリストします。Mantle ID と `haiku` エイリアスは同じモデルファミリーに解決されるため、マージは より具体的なエントリのみを保持します 。[Merge behavior](/ja/model-config#merge-behavior) を参照してください。480 Mantle モデルを `/model` ピッカーに表示するには、[settings file](/ja/settings) の `availableModels` にその ID をリストします。この設定はピッカーをリストされたエントリに制限するため、保持したいバージョンのバージョンプレフィックスまたは完全な ID もリストします。Mantle ID と `haiku` エイリアスは同じモデルファミリーに解決されるため、マージはより具体的なエントリのみを保持します 。[Merge behavior](/ja/model-config#merge-behavior) を参照してください。
481 481
482 ```json theme={null}482 ```json theme={null}
483 {483 {
490 両方のプロバイダーがアクティブな場合、`/status` は `Amazon Bedrock + Amazon Bedrock (Mantle)` を表示します。490 両方のプロバイダーがアクティブな場合、`/status` は `Amazon Bedrock + Amazon Bedrock (Mantle)` を表示します。
491 491
492 <h3 id="route-mantle-through-a-gateway">492 <h3 id="route-mantle-through-a-gateway">
493 Mantle をゲートウェイ経由でルーティング 493 Mantle をゲートウェイ経由でルーティングする
494 </h3>494 </h3>
495 495
496 組織がモデルトラフィックを集中化された [LLM gateway](/ja/llm-gateway) を通じてルーティングし、AWS 認証情報をサーバー側に注入する場合、クライアント側認証を無効にして、Claude Code が SigV4 署名または `x-api-key` ヘッダーなしでリクエストを送信するようにします。496 組織がモデルトラフィックを集中化された [LLM gateway](/ja/llm-gateway) を通じてルーティングし、AWS 認証情報をサーバー側に注入する場合、クライアント側認証を無効にして、Claude Code が SigV4 署名または `x-api-key` ヘッダーなしでリクエストを送信するようにします。
542 542
543 Claude Code は Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を使用し、Converse API はサポートしていません。543 Claude Code は Bedrock [Invoke API](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html) を使用し、Converse API はサポートしていません。
544 544
545 <h3 id="zero-token-counts-in-/context">
546 /context でのゼロトークンカウント
547 </h3>
548
549 `/context` コマンドは、ツールスキーマを Bedrock count-tokens API に送信することで、各ツールグループのトークンをカウントします。{/* min-version: 2.1.196 */}Claude Code v2.1.196 より前のバージョンでは、スキーマが count-tokens API が受け入れないフィールドを含んでいたため、Bedrock がそのリクエストを拒否し、すべてのツールグループが 0 トークンを表示していました。メッセージやメモリファイルなど、内訳の他の行は影響を受けません。
550
551 v2.1.196 以降に更新してください。
552
545 <h3 id="mantle-endpoint-errors">553 <h3 id="mantle-endpoint-errors">
546 Mantle エンドポイントエラー554 Mantle エンドポイントエラー
547 </h3>555 </h3>