前提条件
Claude Code を Amazon Bedrock で設定する前に、以下を確認してください。- Amazon Bedrock アクセスが有効になっている AWS アカウント
- Amazon Bedrock で目的の Claude モデル(例:Claude Sonnet 4.6)へのアクセス
- AWS CLI がインストールされ、設定されていること(オプション - 認証情報を取得する別のメカニズムがない場合のみ必要)
- 適切な IAM 権限
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 を選択します。既にサインインしていてチャットプロンプトが表示されている場合は、/setup-bedrock を実行してウィザードを開きます。CLAUDE_CODE_USE_BEDROCK=1 が設定されるまで、Claude Code はコマンドメニューからコマンドを非表示にします。完全に入力してください。3
ウィザードプロンプトに従う
AWS への認証方法を選択します。
~/.aws ディレクトリから検出された AWS プロファイル、Amazon Bedrock API キー、アクセスキーとシークレット、または環境に既に存在する認証情報です。ウィザードはリージョンを要求し、アカウントが呼び出せる Claude モデルを確認し、それらをピン留めできます。結果はユーザー設定ファイルの env ブロックに保存されるため、環境変数を自分でエクスポートする必要はありません。/setup-bedrock を実行してウィザードを再度開き、認証情報、リージョン、またはモデルピンを変更できます。モデルピンステップは、現在ピン留めされているモデルから開始します。ウィザードは ~/.claude/settings.json に書き込むか、CLAUDE_CONFIG_DIR が設定されている場合は $CLAUDE_CONFIG_DIR/settings.json に書き込みます。
手動でセットアップする
ウィザードの代わりに環境変数を使用して Amazon Bedrock を設定する場合(例えば CI やスクリプト化されたエンタープライズロールアウト)、以下の手順に従ってください。
- ユースケースの詳細を送信する
Anthropic モデルを初めて呼び出す前に、ユースケースの詳細を送信してください。これは AWS アカウントごとに 1 回行います。
- 以下に説明する適切な IAM 権限があることを確認してください
- Amazon Bedrock コンソールに移動します
- Model catalog から Anthropic モデルを選択します
- ユースケースフォームを完成させます。アクセスは送信直後に付与されます。
PutUseCaseForModelAccess API を使用して管理アカウントからフォームを 1 回送信できます。この呼び出しには bedrock:PutUseCaseForModelAccess IAM 権限が必要です。承認は自動的に子アカウントに拡張されます。
- AWS 認証情報を設定する
Claude Code は AWS SDK のデフォルト認証情報チェーンを使用します。以下のいずれかの方法を使用して認証情報を設定してください。
オプション A: AWS CLI 設定
your-profile-name を AWS プロファイルの名前に置き換えてください。
sso_region で指定された IAM Identity Center リージョンからロール認証情報をリクエストします。これは Amazon Bedrock を実行するリージョンと一致する必要はありません。v2.1.207 では、Amazon Bedrock リージョンが sso_region をオーバーライドしていたため、IAM Identity Center インスタンスが別のリージョンにあるプロファイルは Session token not found or invalid エラーで認証に失敗しました。
オプション D: AWS Management Console 認証情報
aws login について詳しく学ぶ。
オプション E: Amazon Bedrock API キー
認証情報キャッシングと解決タイムアウト
Claude Code は AWS デフォルト認証情報プロバイダーチェーンを 1 回解決し、解決された認証情報をメモリに保持します。認証情報の有効期限の 5 分前まで、または有効期限がない場合は 1 時間の間、それらを再利用するため、SSO でサポートされたプロファイルは認証情報の有効期間ごとに約 1 回 IAM Identity Center から認証情報をリクエストします。API からの認証情報エラーはキャッシュをクリアし、再試行は新しい認証情報を解決します。Claude Code v2.1.207 以降が必要です。 キャッシュは上記のすべての認証情報オプションをカバーしていますが、Amazon Bedrock API キーはプロバイダーチェーンを使用しないため除外されます。代わりにすべてのリクエストでチェーンを解決するには、CLAUDE_CODE_SKIP_AWS_CRED_CACHE=1 を設定してください。
チェーンの各解決は 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: Claude Code がタイムスタンプに基づいてローカルで AWS 認証情報が期限切れであることを検出した場合、または API が認証情報エラーを返した場合にのみ実行され、更新された認証情報でリクエストを再試行します。awsCredentialExport: セッション開始時および各認証情報リロード時に実行されます。AWS デフォルト認証情報プロバイダーチェーン内の認証情報がまだ有効な場合でも実行されます。Amazon Bedrock アカウントがデフォルトプロバイダーチェーンが解決するものと異なるクロスアカウント認証情報を必要とする場合に使用してください。
awsAuthRefresh コマンドを実行する前に、Claude Code は STS GetCallerIdentity 呼び出しを行って、認証情報が実際に期限切れであることを確認し、認証情報がまだ機能している場合はコマンドをスキップします。Claude Code はこのチェックを プロキシ設定 を通じて送信し、HTTPS_PROXY と NO_PROXY を尊重します。v2.1.239 より前では、Claude Code はこのチェックを直接送信し、プロキシを通じてのみエグレスを許可するネットワークでスタートアップでハングしていました。
awsAuthRefresh: .aws ディレクトリを変更するコマンド(認証情報、SSO キャッシュ、または設定ファイルの更新など)に使用してください。コマンドの出力はユーザーに表示されますが、インタラクティブ入力はサポートされていません。これは CLI が URL またはコードを表示し、ブラウザで認証を完了するブラウザベースの SSO フローに適しています。
awsCredentialExport: .aws を変更できず、認証情報を直接返す必要がある場合にのみ使用してください。出力はサイレントにキャプチャされ、ユーザーに表示されません。コマンドは次の形式で JSON を出力する必要があります。
aws configure export-credentials --format process からのフラット出力も受け入れられます。同じキーが Credentials の下にネストされるのではなく、トップレベルにあります。
Expiration はオプションです。Claude Code v2.1.176 以降、コマンドが有効な ISO 8601 Expiration を返すと、Claude Code はその時刻の 5 分前まで認証情報をキャッシュします。それがない場合、または以前のバージョンでは、認証情報は 1 時間キャッシュされます。
awsCredentialExport を awsAuthRefresh なしで設定する場合、Claude Code はエクスポートされた認証情報を直接使用し、スタートアップで AWS デフォルト認証情報プロバイダーチェーンを再解決しません。Claude Code v2.1.206 以降が必要です。
- Claude Code を設定する
Amazon Bedrock を有効にするには、以下の環境変数を設定してください。
-
v2.1.172 以降、AWS プロファイルのリージョンをオーバーライドする場合、またはプロファイルにリージョンがない場合にのみ
AWS_REGIONを設定する必要があります。Claude Code はこの順序でリージョンを解決します。AWS_REGIONAWS_DEFAULT_REGION- AWS 共有認証情報ファイルから最初に読み込まれ、次に共有設定ファイルから読み込まれるアクティブな AWS プロファイルに設定された
region(AWS SDK の優先順位と一致) us-east-1
AWS_PROFILE、そうでない場合はdefaultです。AWS_SHARED_CREDENTIALS_FILEまたはAWS_CONFIG_FILEを設定して、デフォルト以外のファイルパスを指定してください。/statusを実行して、解決されたリージョンを確認してください。リージョンが AWS 設定ファイルまたはデフォルトフォールバックから来た場合、Claude Code は/status出力でソースも記載します。v2.1.171 以前では、Claude Code は AWS 設定ファイルを読み込まないため、AWS_REGIONを明示的に設定してください。 -
Amazon Bedrock を使用する場合、認証は AWS 認証情報を通じて処理されるため、
/logoutコマンドは利用できません。 - WebSearch ツールは Amazon Bedrock では利用できません。WebSearch ツールの動作を参照してください。
-
AWS_PROFILEのような他のプロセスにリークしたくない環境変数に設定ファイルを使用できます。詳細については Settings を参照してください。
- モデルバージョンをピンする
これらの環境変数を特定の Amazon Bedrock モデル ID に設定してください。
ANTHROPIC_DEFAULT_OPUS_MODEL がない場合、Amazon Bedrock の opus エイリアスは Opus 5 に解決され、ANTHROPIC_DEFAULT_SONNET_MODEL がない場合、sonnet エイリアスは Sonnet 4.5 に解決されます。この例では各エイリアスを特定のバージョンにピンしています。
us. クロスリージョン推論プロファイルプレフィックスを使用しています。別のリージョンプレフィックスまたはアプリケーション推論プロファイルを使用する場合は、それに応じて調整してください。AWS GovCloud リージョンでは、us-gov. プレフィックスを使用してください。
組み込みデフォルトモデルを保持し、優先プレフィックスのみを変更するには、ピンの代わりに ANTHROPIC_BEDROCK_REGION_PREFIX を設定してください。opus エイリアスが解決する内容の違いを示します。
現在および従来のモデル ID については、Models overview を参照してください。ピン環境変数の完全なリストについては、Model configuration を参照してください。
ピン変数が設定されていない場合、Claude Code はこれらのデフォルトモデルを使用します。
セッションタイトル生成などのバックグラウンドタスクは、小型/高速モデル(通常は Haiku クラスモデル)を使用します。Amazon Bedrock では、すべてのアカウントまたはリージョンで Haiku が有効になっていない可能性があるため、Claude Code はバックグラウンドタスクにデフォルト Sonnet モデルを使用します。2 つの選択がどのモデルがそれらを実行するかを変更します。
--model、ANTHROPIC_MODEL、またはmodel設定でプライマリモデルを選択する場合、バックグラウンドタスクはそのモデルを使用します。Claude Code がANTHROPIC_DEFAULT_MODELで設定したモデルでセッションを開始する場合、バックグラウンドタスクもそのモデルを使用します。ANTHROPIC_DEFAULT_SONNET_MODELなしでANTHROPIC_DEFAULT_OPUS_MODELを設定することも、組み込み Sonnet モデルが独自の Opus を操舵するアカウントで有効になっていない可能性があるため、選択としてカウントされます。- バックグラウンドタスクに Haiku を使用するには、
ANTHROPIC_DEFAULT_HAIKU_MODELをアカウントで利用可能なモデル ID に設定してください。
opus エイリアスは Opus 4.8 に解決されました。v2.1.207 より前では、プライマリモデルは Sonnet 4.5 にデフォルト設定され、opus エイリアスは Opus 4.6 に解決され、バックグラウンドタスクは常にプライマリモデルを使用していました。
モデルをさらにカスタマイズするには、以下のいずれかの方法を使用してください。
プロンプトキャッシングはすべての Amazon Bedrock リージョンで利用できない場合があります。キャッシュトークンカウントがゼロのままの場合、Amazon Bedrock ドキュメントの サポートされているモデル、リージョン、および制限を確認してください。
各モデルバージョンを推論プロファイルにマップする
ANTHROPIC_DEFAULT_*_MODEL 環境変数は、モデルファミリーごとに 1 つの推論プロファイルを設定します。組織が同じファミリーの複数のバージョンを /model ピッカーで公開し、それぞれを独自のアプリケーション推論プロファイル ARN にルーティングする必要がある場合は、設定ファイルの modelOverrides 設定を使用してください。
この例は 4 つの Opus バージョンを異なる ARN にマップするため、ユーザーは組織の推論プロファイルをバイパスすることなくそれらを切り替えることができます。
/model でこれらのバージョンのいずれかを選択すると、Claude Code はマップされた ARN で Amazon Bedrock を呼び出します。同じマッピングは --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 がユーザー設定ファイルに書き込まれ、Claude Code が再起動します。拒否すると、次のデフォルトバージョン変更まで記憶されます。アプリケーション推論プロファイル ARN を指す pin は、管理者によって管理されるため、スキップされます。 モデルをピン留めしておらず、現在のデフォルトがアカウントで利用できない場合、Claude Code は現在のセッションにフォールバックし、通知を表示します。デフォルトモデルの以前のバージョンを最初に試し、デフォルトが Opus モデルで Opus バージョンが利用できない場合、デフォルト Sonnet モデルにフォールバックします。フォールバックは保持されません。Amazon Bedrock アカウントで新しいモデルを有効にするか、バージョンをピン留めして選択を永続的にしてください。 特定の Sonnet または Opus バージョンでセッションを開始する場合(例えば--model、ANTHROPIC_MODEL、またはmodel 設定を使用)、そのバージョンは一致する sonnet または opus エイリアスのセッションのピン留めされたデフォルトとして機能します。Claude Code は、設定したモデルが置き換える組み込みデフォルトの可用性チェックをスキップし、設定したモデルで起動し、フォールバック通知はありません。
opus などのモデルエイリアスはピンとして機能せず、Claude Code が認識しないモデル ID(アプリケーション推論プロファイル ARN など)も同様です。
クロスリージョン推論プロファイルプレフィックス
Amazon Bedrock の Invoke API では、Claude Code は組み込みのデフォルトモデルを クロスリージョン推論プロファイル ID に解決します。独自の推論プロファイルを通じてモデルバージョンをルーティングするには、各モデルバージョンを推論プロファイルにマップする を参照してください。このテーブルは、解決された各 AWS リージョンに対して Claude Code が優先するプレフィックスを示しています。ANTHROPIC_BEDROCK_REGION_PREFIX を設定して、Claude Code が最初に試すプレフィックスを選択します。Claude Code がプロファイルの可用性を確認でき、モデルに一致するプロファイルが見つからない場合、以下の解決順序に従ってフォールバックします。有効な値は us、eu、apac、jp、au、および global です。たとえば、アカウントに global. プロファイルが有効になっているが、Claude Code が AWS リージョンから地理的に固有のプロファイルを導出する場合は、global に設定します。Claude Code v2.1.224 以降が必要です。
この例は、デフォルトモデルを global. プロファイルを通じてルーティングします。
- Claude Code がアカウント内の 推論プロファイルをリストできる 場合、各モデルを次の順序で解決します。
- 優先プレフィックスを持つプロファイル。
- そのプレフィックスを持つプロファイルがないモデルの場合、一致するプロファイル。
- 一致するプロファイルがないモデルの場合、優先プレフィックスを持つ組み込みモデル ID。Claude Code はこのステップで可用性を確認せずにこの ID を適用します。スタートアップモデルチェック はセッションのデフォルトモデルをカバーします。
- プロファイル検出が利用できない場合、Claude Code は可用性を確認せずにプレフィックスを適用します。アカウントにそのプレフィックスを持つ推論プロファイルが有効になっていない場合、リクエストは 400 エラーで失敗します。
modelOverrides 値を書き直しません。Anthropic 形式のモデル ID は /model ピッカーと同じマッピング を通じて解決されます。Claude Code は 2 つのケースで変数を無視します。
- AWS GovCloud リージョンでは、Claude Code は常に
us-gov.を使用します。これは GovCloud パーティション内でルーティングする唯一のプレフィックスです。 - 有効な値の 1 つではない値を設定した場合、Claude Code はリージョン導出の優先プレフィックスにフォールバックします。
IAM 設定
Claude Code に必要な権限を持つ IAM ポリシーを作成します。bedrock:GetInferenceProfile により、Claude Code はアプリケーション推論プロファイル ARNをそのバッキング基盤モデルに解決でき、そのモデルに対して正しいリクエスト形状を選択するために使用されます。
トークンにこの権限がない場合、Claude Code は代替形状で 1 回再試行することで自動的に復旧するため、リクエストは成功しますが、新しいモデルが追加されるたびに追加のラウンドトリップが発生します。権限を付与することで再試行を回避できます。これは AWS_BEARER_TOKEN_BEDROCK デプロイメントに最も頻繁に適用され、トークンのポリシーは通常、完全な IAM ロールよりも狭くなります。
詳細については、Amazon Bedrock IAM ドキュメントを参照してください。
コスト追跡とアクセス制御を簡素化するために、Claude Code 用の専用 AWS アカウントを作成してください。
1M トークンコンテキストウィンドウ
Claude Sonnet 5、Opus 4.6 以降、および Sonnet 4.6 は、Amazon Bedrock で 1M トークンコンテキストウィンドウをサポートしています。Sonnet 5 は Invoke API と Mantle エンドポイントの両方で常に 1M ウィンドウで実行され、選択する[1m] バリアントはありません。Invoke API 上の他のモデルについては、Claude Code は 1M モデルバリアントを選択すると、拡張コンテキストウィンドウを自動的に有効にします。
セットアップウィザードは、モデルをピン留めするときに 1M コンテキストオプションを提供します。手動でピン留めされたモデルの代わりに有効にするには、モデル ID に [1m] を追加します。詳細については、サードパーティデプロイメント用のモデルをピン留めするを参照してください。
サービスティア
Amazon Bedrock サービスティアを使用すると、コストとレイテンシーのトレードオフを行うことができます。ANTHROPIC_BEDROCK_SERVICE_TIER を default、flex、または priority に設定します。
X-Amzn-Bedrock-Service-Tier ヘッダーとしてこれを送信します。ティアの可用性はモデルとリージョンによって異なります。予約容量は、この設定の代わりにプロビジョニングされたスループット ARN をモデル ID として使用します。
AWS Guardrails
Amazon Bedrock Guardrailsを使用すると、Claude Code のコンテンツフィルタリングを実装できます。Amazon Bedrock コンソールで Guardrail を作成し、バージョンを公開してから、Guardrail ヘッダーを settings file に追加します。クロスリージョン推論プロファイルを使用している場合は、Guardrail でクロスリージョン推論を有効にしてください。 設定例:Mantle エンドポイントを使用する
Mantle は、Bedrock Invoke API ではなく、ネイティブ Anthropic API シェイプを通じて Claude モデルを提供する Amazon Bedrock エンドポイントです。同じ AWS 認証情報、IAM 権限、およびawsAuthRefresh 設定を使用します。このページで前述したものです。
Mantle を有効にする
AWS 認証情報が既に設定されている場合、CLAUDE_CODE_USE_MANTLE を設定して、リクエストを Mantle エンドポイントにルーティングします。
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 でモデルを設定します。
Mantle を Invoke API と並行して実行する
Mantle で利用可能なモデルは、今日使用するすべてのモデルを含まない場合があります。CLAUDE_CODE_USE_BEDROCK と CLAUDE_CODE_USE_MANTLE の両方を設定すると、Claude Code は同じセッションから両方のエンドポイントを呼び出せます。Mantle 形式に一致するモデル ID は Mantle にルーティングされ、他のすべてのモデル ID は Amazon Bedrock Invoke API に移動します。
/model ピッカーに表示するには、settings file の availableModels にその ID をリストします。この設定はピッカーをリストされたエントリに制限するため、保持したいバージョンのバージョンプレフィックスまたは完全な ID もリストします。Mantle ID と haiku エイリアスは同じモデルファミリーに解決されるため、マージはより具体的なエントリのみを保持します。Merge behavior を参照してください。
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 ヘッダーなしでリクエストを送信するようにします。
Mantle 環境変数
これらの変数は Mantle エンドポイントに固有です。完全なリストについては、Environment variables を参照してください。トラブルシューティング
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 - クロスリージョンアクセスに推論プロファイルの使用を検討
- モデルを inference profile ID として指定します
ゲートウェイまたはプロキシの背後でのストリーミングエラー
Amazon Bedrock はInvokeModelWithResponseStream レスポンスをバイナリイベントストリーム形式でストリーミングし、ヘッダー Content-Type: application/vnd.amazon.eventstream を含みます。Claude Code と Amazon Bedrock の間のゲートウェイまたはプロキシは、Amazon Bedrock が送信したレスポンスボディとそのヘッダー(Content-Type を含む)を変更されずに転送する必要があります。
ゲートウェイが Content-Type を別の値に書き換える場合、Claude Code は Bedrock streaming response has content-type で始まるエラーでレスポンスを拒否し、受け取った値を名前付けます。一般的な書き換えは text/event-stream で、ストリームをサーバー送信イベントとして再発行する統合からのものです。
ゲートウェイがヘッダーをドロップまたは空白にする代わりに、Claude Code は本体が Amazon Bedrock のイベントストリームであると仮定してデコードするため、ゲートウェイが変更されずに通した本体はストリーミングを続けます。
ヘッダーをドロップするゲートウェイがストリームをサーバー送信イベントとして再発行する場合、Claude Code は本体をデコードできず、すべてのターンで遅いノンストリーミングパスにフォールバックします。各レスポンスはストリーミングされるのではなく、完全になった後にのみ表示されます。その場合、CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_DEFAULT=1 を設定して、Claude Code が本体をサーバー送信イベントとして読み取るようにしてください。
エラーまたはフォールバックを修正するには、ゲートウェイを設定して InvokeModelWithResponseStream レスポンスボディとその Content-Type ヘッダーを変更されずに転送するようにしてください。
ストリームをサーバー送信イベントに変換するゲートウェイは、Amazon Bedrock API を提供していません。Anthropic Messages API リクエストも受け入れる場合は、CLAUDE_CODE_USE_BEDROCK の代わりに ANTHROPIC_BASE_URL を使用して LLM gateway として接続してください。
/context でのゼロトークンカウント
/context コマンドは、ツールスキーマを Amazon Bedrock count-tokens API に送信することで、各ツールグループのトークンをカウントします。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 が各リクエストをモデルが利用可能なエンドポイントにルーティングするようにしてください。