Claude CodeをAmazon Bedrockで使う方法｜設定手順・必要な権限・モデル固定・注意点【2026年版】

関連記事Claude Code（クロードコード）とは？できること・料金・使い方を初心者にもやさしく解説【2026年版】 ／ Claude Code 使用量を完全制御する実装ガイド【2026年版】 ／ Claude Code ログイン方法・できない時の対処法｜2026年版ガイド

Claude CodeをAmazon Bedrockで使うには（結論と手順の全体像）

Claude Codeは、Anthropicと直接契約しなくても、AWSのAmazon Bedrockを経由して使えます。認証と課金はAWS側で行われるため、Claudeの有料プラン（Pro・Max）は不要で、料金はBedrockの従量課金になります。すでにAWSで権限やログ、費用を管理している会社に向いた使い方です。

いちばん簡単な始め方は、次の3ステップです（公式ドキュメント「Claude Code on Amazon Bedrock」・2026年10月10日確認）。

1. AWS側でモデルを使えるようにする：Bedrockコンソールのモデルカタログで Anthropic のモデルを選び、利用目的のフォームを送信する（AWSアカウントごとに1回。送信するとすぐに使えるようになる）。
2. Claude Codeを起動してBedrockを選ぶ：claude を起動し、ログイン画面で「3rd-party platform」→「Amazon Bedrock」を選ぶ。すでにログイン済みなら /setup-bedrock を実行する。
3. ウィザードの質問に答える：AWSの認証方法（AWSプロファイル・BedrockのAPIキー・アクセスキーなど）とリージョンを選ぶと、使えるモデルの確認とモデルの固定まで案内される。

CIや、チーム全員に同じ設定を配る場合は、ウィザードの代わりに環境変数で設定します。最小の設定は次の2行です。

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

設定できたら、Claude Codeの中で /status を実行して、接続先とリージョン、モデルが意図どおりかを確認します。以下、Bedrockを選ぶ理由と制約、環境変数での設定、必要なIAM権限、モデルの固定、トラブル対処の順に説明します。

Claude Code × Amazon Bedrockを選ぶ理由とトレードオフ

Claude Codeをチームで使いたい。しかしAnthropicへの直接API接続では、APIキーの管理・コスト按分・プロンプトの監査ログが別途必要になる。こうした運用上の課題を、既存のAWSインフラで解決できるのがAmazon Bedrock経由の接続だ。

Bedrock経由を選ぶ最大の利点は、AWS SDK標準の認証チェーンとIAMロールがそのまま利用できることにある。CloudTrailによる呼び出しログ、SCPによる操作制限、AWS Organizationsと連携したコスト管理など、エンタープライズが既に構築したAWSガバナンスがClaude Codeにそのまま適用される。総務省AIセキュリティ分科会にAWSジャパンが提出した資料「AWSの生成AIサービスとセキュリティ対策」（soumu.go.jp掲載）でも、Bedrockの推論では顧客データが一切記録されないこと、VPC・AWS PrivateLink経由の閉域利用構成が示されており、セキュリティポリシーが厳しい組織での採用理由になりやすい（出典：soumu.go.jp）。

ただし制限も明確だ。公式ドキュメントが明記する主な制約を先に把握しておく。

• /logoutコマンドは使用不可（認証はAWS側が管理）
• WebSearchツールは利用不可
• Converse APIは非対応（Invoke APIを使用）
• プロンプトキャッシュは一部リージョンで非対応

これらを踏まえた上で設定に進む。Claude Codeそのものの概要や料金体系については Claude Codeとは および Claude Code APIの料金体系 を参照のこと。

環境変数による手動設定（CI・チーム展開向け）

最も汎用性が高く、CI/CDパイプラインへの組み込みにも向いた設定方法が環境変数による手動設定だ。公式ドキュメント（code.claude.com/docs/en/amazon-bedrock）が示す最小構成は次の2行である。

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

リージョンの解決順序にはバージョン依存がある。v2.1.172以降では、AWS_REGION環境変数 → AWS_DEFAULT_REGION → AWSプロファイル → デフォルト（us-east-1）の順で解決される。AWSプロファイルにリージョンを設定済みであればAWS_REGIONの明示は不要だ。現在の接続状態は/statusコマンドで確認できる。

認証はAWS SDKの標準チェーンをそのまま利用する。aws configureで設定した長期クレデンシャル、環境変数（AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY）、SSOプロファイル（aws sso login）、Bedrock専用APIキー（AWS_BEARER_TOKEN_BEDROCK）のいずれも動作する。

SSOを使う環境でセッション切れが問題になる場合は、設定ファイルに以下を追加することで自動更新の挙動を制御できる。

• awsAuthRefresh：期限切れ時のみ再認証を実行
• awsCredentialExport：セッション開始のたびにクレデンシャルをエクスポート

GUIによるセットアップを好む場合は、claudeを起動して表示されるログインウィザードで「3rd-party platform」→「Amazon Bedrock」を選択する経路もある。設定内容はuser settingsの環境変数に自動保存され、再設定が必要になった際は/setup-bedrockスラッシュコマンドから呼び出せる。スラッシュコマンドの詳細は Claude Code スラッシュコマンド解説 を参照のこと。

IAM権限設定と運用上の注意点

Bedrock経由でClaude Codeを動かすIAMには最低限以下のアクションが必要だ。

• bedrock:InvokeModel
• bedrock:InvokeModelWithResponseStream
• bedrock:ListInferenceProfiles
• bedrock:GetInferenceProfile
• Mantleを使う場合は別に bedrock-mantle:CreateInference（推論）と bedrock-mantle:CountTokens（トークン数の計算）。上の bedrock: の権限ではMantleは使えない
• AWS Marketplaceサブスクリプション（条件付きで必要）

初回利用時はBedrockのモデルカタログからuse case formの提出が必要で、通常は即時許可される。AWS Organizationsを使う組織では、管理アカウントからPutUseCaseForModelAccess APIで一括許可が可能だ。

コスト管理については、公式ドキュメントがClaude Code専用のAWSアカウントを用意することを推奨している。これはコスト可視化・予算アラート・SCPによる操作制限を明確にするためであり、既存の本番アカウントに混在させるとコスト配賦が難しくなる。料金はAWS Bedrock側の従量課金が適用され、AnthropicのサブスクリプションとBedrock利用料は完全に独立している（詳細：aws.amazon.com/bedrock/pricing/）。

Guardrails（入出力フィルタリング）を適用する場合はANTHROPIC_CUSTOM_HEADERSにGuardrail IDとバージョンを設定する。サービス階層はANTHROPIC_BEDROCK_SERVICE_TIERでdefault / flex / priorityから選択できる。

以下の比較表はAnthropicダイレクト・Bedrock・Mantleの主要な差異をまとめたものだ。接続方式の選定に活用してほしい。

項目	Anthropic直接API	Bedrock（Invoke API）	Bedrock + Mantle
認証方式	Anthropic APIキー	AWS SDK標準チェーン	AWS SDK標準チェーン
WebSearch	利用可	利用不可	利用不可
1Mコンテキスト	モデル依存	Fable・Sonnet 5以降・Opus 4.7以降は標準で1M／Opus 4.6・Sonnet 4.6は[1m]を指定	Sonnet 5で常時1M
Guardrails	なし	対応	対応
プロンプトキャッシュ	対応	リージョン依存	リージョン依存
コスト管理	Anthropicコンソール	AWS Cost Explorer	AWS Cost Explorer
必要な環境変数	ANTHROPIC_API_KEY	CLAUDE_CODE_USE_BEDROCK=1	CLAUDE_CODE_USE_BEDROCK=1 + CLAUDE_CODE_USE_MANTLE=1

モデルピンとMantle：チーム展開で見落としやすい設定

個人開発環境では動くのにチームに展開すると挙動が変わる、という問題の大半はモデルピン（モデル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'

プレフィックスのus.はクロスリージョン推論プロファイルを指す。AWSのGovCloud環境ではus-gov.に置き換える。モデルピンを行わない場合、現在の公式ドキュメント（2026年10月7日確認）ではBedrock上の既定のprimaryモデルはOpus 5.5（us-*リージョンならus.anthropic.claude-opus-5-5）、セッション名の生成などのバックグラウンド処理に使う小型モデルはSonnet 4.5（us.anthropic.claude-sonnet-4-5-20250929-v1:0）である。公式は「primaryモデルをピンしていない展開は、v2.1.207以降に更新した時点からOpusの単価で課金される」と警告しており、Sonnet 4.5を主に使い続けたい場合はANTHROPIC_MODELにそのモデルIDを明示する必要がある。既定値はClaude Codeの更新で変わるため（v2.1.280より前はOpus 5、v2.1.207〜218はOpus 4.8が既定だった）、プロダクション利用では必ずピンを打つべきだ。

リージョン別の推論プロファイル接頭辞（東京リージョンはapac.）

Claude Codeは、ピンしていない既定のモデルを、使っているAWSリージョンに応じたクロスリージョン推論プロファイルIDに変換して呼び出す。公式ドキュメントが示す対応は次のとおり。

AWSリージョン	優先される接頭辞
us-gov-*（GovCloud）	us-gov.
us-*	us.
eu-*	eu.
ap-*（東京ap-northeast-1を含む）	apac.
その他	global.

既定のモデルはそのままで接頭辞だけを変えたい場合は、環境変数ANTHROPIC_BEDROCK_REGION_PREFIXを使う（v2.1.224以降）。指定できる値はus・eu・apac・jp・au・globalで、たとえばjpを指定するとjp.で始まる推論プロファイルを優先して探す。アカウントの推論プロファイルを一覧できる権限（bedrock:ListInferenceProfiles）がある場合、該当する接頭辞のプロファイルが無いモデルは別の一致するプロファイルへ自動で切り替わるが、一覧できない場合は指定した接頭辞をそのまま使うため、そのプロファイルが有効になっていないと400エラーになる。

起動時のモデルチェックと自動フォールバック

Bedrock設定で起動すると、Claude Codeは使う予定のモデルがアカウントで呼び出せるかを確認する。ピンしていない既定モデルが使えない場合は、そのセッションに限り旧バージョン（OpusのどのバージョンもなければSonnet）へ切り替えて通知を出す。この切り替えは保存されないため、恒久的に固定したい場合はモデルを有効化するかピンを打つ。逆に、ピンしたモデルより新しい既定モデルがアカウントで使える場合は、ピンの更新を提案される。

1Mトークンのコンテキストについては、公式ドキュメント（2026年10月10日確認）によると、Fable・Sonnet 5以降・Opus 4.7以降のモデルはBedrock上で最初から1Mで動く。Opus 4.6とSonnet 4.6は、モデルIDの末尾に[1m]を付けた指定（またはセットアップウィザードの1Mの選択肢）で1Mになる。v2.1.287より前は、FableとOpus 4.7以降もInvoke APIでは既定が200Kだった。

Mantleはv2.1.94から利用可能なBedrockのネイティブAnthropic API形状エンドポイントだ。有効化はCLAUDE_CODE_USE_MANTLE=1の1行で済み、接続確認は/statusで「Amazon Bedrock (Mantle)」と表示されることで判別できる。MantleではモデルIDがバージョンサフィックスなしの形式（例：anthropic.claude-sonnet-5）になる点に注意が必要で、通常のInvoke APIと同時に設定することも可能だ。Sonnet 5はMantle経由で常時1Mコンテキストが利用できる。

セットアップ後のトラブルシューティングと展開チェックリスト

Claude Code Bedrockの設定が完了したら、/statusで接続状態を確認する。ここでモデルIDとリージョンが意図通りに表示されていれば設定は正常だ。

よくある問題とその原因を整理する。

モデルアクセスエラー：Bedrockのモデルカタログからuse case formを提出していない場合に発生する。AWS Organizationsを使う環境では管理アカウントの一括許可を確認する。

リージョン不一致：v2.1.172未満のバージョンではリージョン解決の優先順序が異なる場合がある。claude --versionでバージョンを確認し、必要に応じてアップデートする。インストール手順は Claude Code インストールガイド を参照のこと。

SSOセッション切れ：awsAuthRefreshの設定漏れが原因であることが多い。CIではAWS_BEARER_TOKEN_BEDROCKによる明示的なBedrockAPIキー認証が安定する。

「on-demand throughput isn’t supported」エラー：モデルをオンデマンドのモデルIDで指定しているのが原因。公式は推論プロファイルID（例：us.anthropic.claude-sonnet-4-6）で指定するよう案内している。利用できるプロファイルはaws bedrock list-inference-profiles --region リージョン名で確認できる。

SSOのブラウザタブが何度も開く：社内VPNやTLSを検査するプロキシがSSOのブラウザ認証を途中で切ると、Claude Codeが認証失敗とみなしてawsAuthRefreshを繰り返し実行する。公式の対処は、設定ファイルからawsAuthRefreshを外し、Claude Code起動前にaws sso loginを手動で実行すること。

認証情報の取得が止まる：AWSの認証チェーンの解決は1回60秒でタイムアウトし、AWS default-chain credential resolve timed outになる。MFA付きのブラウザSSOなど正当に時間がかかる場合は、CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS（ミリ秒）で上限を延ばす。

社内プロキシ環境での証明書エラー：v2.1.261より前は、TLS検査プロキシの社内ルート証明書がOSの証明書ストアにしか無い環境でunable to get local issuer certificateが出たり、セットアップウィザードでモデルがunreachableと表示されたりする場合があった。v2.1.261以降へ更新する。

プロンプトキャッシュのトークン数が0のまま：リージョンによってはBedrockのプロンプトキャッシュが使えない。AWSのドキュメントで対応モデル・リージョンを確認する。なお、既定5分のキャッシュ寿命を1時間にしたい場合はENABLE_PROMPT_CACHING_1H=1を設定する（1時間キャッシュは5分より高い単価で課金される）。

チーム展開前の最終チェックリスト：

• [ ] CLAUDE_CODE_USE_BEDROCK=1が全メンバーの環境または共有設定ファイルに存在する
• [ ] モデルピン（ANTHROPIC_DEFAULT_*_MODEL）がチームの設定リポジトリで管理されている
• [ ] 専用AWSアカウントでCost Explorerの予算アラートが設定されている
• [ ] IAMにbedrock:InvokeModelとbedrock:InvokeModelWithResponseStreamが付与されている
• [ ] /statusで期待するモデルIDとリージョンが表示されることを確認済み
• [ ] Guardrailsが必要な場合はANTHROPIC_CUSTOM_HEADERS設定済み

より高度なエンタープライズ展開やコスト最適化については、Bedrock以外のモデル・プロバイダとの比較を扱う記事も参考になる。Claude Codeの基本的な使い方は Claude Code の使い方ガイド に、他モデル・プロバイダとの接続は Claude Codeを他モデルで使う解説 に、チーム展開の運用は Claude Code Teamの解説 にまとめてある。Claude CodeとCursorなど他ツールとの選定比較を検討する場合は Claude Code vs Cursor 比較 も参照されたい。

---

Bedrockを選ぶべきか：他の統制ルートとの見極めと「導入前に確認すべき落とし穴」

本記事の設定手順どおりに進める前に、そもそもAmazon Bedrockが自組織にとって最適な接続経路かを一度立ち止まって判断したい。Bedrock経由は「既存のAWSガバナンスをそのまま流用したい組織」で効果が最大化されるが、前提条件が異なると別ルートのほうが運用コストは下がる。判断軸は次の3点で整理できる。

• 既存のクラウド基盤で切り分ける。 IAM・CloudTrail・SCPをすでにAWSで運用しているならBedrockが素直だが、監査ログやコスト配賦の基盤がGoogle Cloud側にある組織は、同等の統制をVertex AI経由（CLAUDE_CODE_USE_VERTEX=1）で得られる。「AWSだから」ではなく「監査・課金の主戦場がどこか」で選ぶのが実務的だ。
• 必要な機能から逆算する。 本記事の制約整理のとおりBedrock経由ではWebSearchツールが使えない。コードエージェントに外部検索を常用させたいワークフローでは、この一点で直接APIやゲートウェイ構成を再検討する価値がある。
• 「専用AWSアカウント推奨」を軽視しない。 コスト可視化のためだけでなく、SCPでbedrock:InvokeModelの実行境界を明確に切れることが、後からの監査対応を大幅に楽にする。既存本番アカウントへの相乗りは短期的には速いが、コスト配賦と権限分離の負債になりやすい。

加えて、設定完了後に見落とされがちな運用上の時間差リスクを挙げておく。新しいClaudeモデルは、Anthropic直接APIで先行提供され、Bedrockの各リージョンに載るまでにタイムラグが生じることがある。「直接APIでは使えるのにBedrockのモデルカタログに出てこない」という差分は障害ではなく提供順序の問題であることが多く、モデルピンを打っているチームほど、利用したいモデルIDが対象リージョンのクロスリージョン推論プロファイルに含まれているかを事前確認しておくと、展開当日の混乱を避けられる。導入判断の段階でこの2軸（機能制約・提供時間差）を確認しておくことが、Bedrock採用を成功させる分岐点になる。

よくある質問

Q. Claude CodeをAmazon Bedrockで使うには、何から始めればいいですか？
A. AWSのBedrockコンソールのモデルカタログでAnthropicのモデルを選び、利用目的のフォームを送信します（アカウントごとに1回）。そのあと claude を起動し、ログイン画面で「3rd-party platform」→「Amazon Bedrock」を選ぶと、ウィザードが認証方法・リージョン・使えるモデルの確認まで案内します。

Q. Amazon Bedrock経由でClaude Codeを使う最大の利点は何ですか？
A. AWS SDK標準の認証チェーンとIAMロールがそのまま利用できることです。CloudTrailによる呼び出しログ、SCPによる操作制限、AWS Organizationsと連携したコスト管理など、エンタープライズが既に構築したAWSガバナンスがClaude Codeにそのまま適用されます。

Q. Bedrock経由の主な制約はありますか？
A. あります。/logoutコマンドは使用不可（認証はAWS側が管理）、WebSearchツールは利用不可、Converse APIは非対応（Invoke APIを使用）、プロンプトキャッシュは一部リージョンで非対応です。

Q. 環境変数による最小構成はどうなりますか？
A. export CLAUDE_CODE_USE_BEDROCK=1とexport AWS_REGION=us-east-1の2行です。v2.1.172以降では、AWS_REGION環境変数→AWS_DEFAULT_REGION→AWSプロファイル→デフォルト（us-east-1）の順でリージョンが解決されます。

Q. 認証方式にはどんな選択肢がありますか？
A. aws configureで設定した長期クレデンシャル、環境変数（AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY）、SSOプロファイル（aws sso login）、Bedrock専用APIキー（AWS_BEARER_TOKEN_BEDROCK）のいずれもAWS SDK標準チェーンとして動作します。

Q. チーム展開でモデルピンが必須とされるのはなぜですか？
A. 個人開発環境では動くのにチームに展開すると挙動が変わる問題の大半は、モデルピン（モデルIDの固定）の欠如に起因するためです。モデルピンを行わない場合、Anthropicがモデルデフォルトを更新したタイミングで意図しない切り替えが発生しうるため、本番で使う場合は必ずモデルを固定（ピン）します。

Q. Mantleとは何ですか？
A. v2.1.94から利用可能な、Bedrockのネイティブ Anthropic API形状エンドポイントです。有効化はCLAUDE_CODE_USE_MANTLE=1の1行で済み、接続確認は/statusで「Amazon Bedrock (Mantle)」と表示されることで判別できます。Sonnet 5はMantle経由で常時1Mコンテキストが利用できます。

Q. Bedrock経由で必要なIAM権限は何ですか？
A. 最低限bedrock:InvokeModel、bedrock:InvokeModelWithResponseStream、bedrock:ListInferenceProfiles、bedrock:GetInferenceProfileが必要です。加えてAWS Marketplaceサブスクリプションが条件付きで必要な場合があります。

Q. コスト管理で推奨されている運用はありますか？
A. 公式ドキュメントはClaude Code専用のAWSアカウントを用意することを推奨しています。コスト可視化・予算アラート・SCPによる操作制限を明確にするためで、既存の本番アカウントに混在させると、費用の振り分けが難しくなります。

Q. Bedrock経由の場合、Claudeの有料プラン（Pro・Max）は必要ですか？
A. 必要ありません。Bedrock経由では認証と課金がAWS側で行われ、料金はAmazon Bedrockの従量課金になります。Claudeのサブスクリプションとは別の料金です。

Q. 東京リージョンで使えますか？
A. Claude Codeは、ap-northeast-1（東京）を含む ap-* のリージョンでは apac. で始まる推論プロファイルを優先して使います。環境変数 ANTHROPIC_BEDROCK_REGION_PREFIX に jp を指定すると、jp. で始まるプロファイルを優先できます。使いたいモデルの推論プロファイルが自分のアカウントで有効になっているかは、aws bedrock list-inference-profiles で確認します。

---

参考文献

• Claude Code on Amazon Bedrock（公式ドキュメント）: https://code.claude.com/docs/en/amazon-bedrock
• Amazon Bedrock 上の Claude Code（公式ドキュメント日本語版）: https://code.claude.com/docs/ja/amazon-bedrock
• AWSの生成AIサービスとセキュリティ対策（AWSジャパン提出資料・総務省AIセキュリティ分科会掲載）: https://www.soumu.go.jp/main_content/001039083.pdf
• Amazon Bedrock Pricing（AWS公式）: https://aws.amazon.com/bedrock/pricing/
• Claude Code on Amazon Bedrockのデプロイパターンとベストプラクティス（AWS Japan Blog）: https://aws.amazon.com/jp/blogs/news/claude-code-deployment-patterns-and-best-practices-with-amazon-bedrock/
• Claude Sonnet 4.6 が Amazon Bedrock で利用可能になりました（Classmethod）: https://dev.classmethod.jp/articles/amazon-bedrock-claude-sonnet-4-6/

関連記事

• Claude Codeとは
• Claude CodeでSEOに取り組む（初心者向け）
• Claude Codeの使い方
• Claude Codeの料金
• Claude Codeのインストール方法
• Claude Codeの始め方
• Claude Codeのコマンド一覧