Claude CodeをBedrockで使う設定方法｜認証・リージョン・料金

「会社ではAWSで契約や請求をまとめているので、Claude Codeも同じ仕組みで使いたい」「情報システム部門から、Amazon Bedrock経由で使えないかと聞かれた」という場面は、少なくありません。

Claude Codeは、ふつうはClaudeのアカウントにログインして使います。一方で、AWSのAmazon Bedrock（アマゾン ベッドロック）を通して、AWSの認証と請求のまま使うこともできます。ただし、設定の項目が多く、Claudeのアカウントで使うときとは使えない機能もあります。始める前に、違いを知っておくことが大切です。

この記事では、Bedrockで使う仕組み、AWS側の準備、設定の手順、認証・リージョン・モデルの指定、料金の見方、会社で使うときの設定、エラーの対処までを順に解説します。内容は2026年10月時点の公式情報をもとにしています。モデルの提供状況や料金は変わるので、設定の前に公式ページもあわせて確認してください。

Amazon Bedrockで使うとは

Amazon Bedrockは、AWS（アマゾン ウェブ サービス）が提供する、生成AIのモデルを使うためのサービスです。Anthropic社のClaudeも、このサービスの中で提供されています。

どんな仕組みか

Claude Codeには、Claudeのアカウントでログインする使い方のほかに、AWSの認証情報でBedrockのClaudeを呼び出す使い方があります。Claude Code本体は、これまでどおり自分のパソコンで動きます。変わるのは、AIの処理を頼む先と、ログインや請求のしかたです。

この方法では、利用料金はAWSの請求にまとまります。誰がどのモデルを使えるかも、AWSの権限管理（IAM）で決められます。公式ドキュメントでは、Claude Codeを組織に導入する選択肢のひとつとして案内されています。

設定の入口は、Claude Codeを起動したときのログイン画面にあります。claude と入力して起動し、3rd-party platformを選び、Amazon Bedrockを選ぶと、設定を手助けしてくれる画面（ウィザード）が始まります。

ほかの導入方法との違い

公式ドキュメントでは、ほとんどの組織にとって、ClaudeのTeamsまたはEnterpriseプランがもっとも手軽だと案内されています。Bedrockは、すでにAWSを中心に運用している会社向けの選択肢です。

表のとおり、Teams・Enterpriseには、Webのチャットも含まれます。Bedrockでは、Claude Codeなどのモデルを呼び出す部分だけをAWS経由で使う形です。社員にチャットも使わせたい場合は、別にClaudeのプランが必要になります。

Bedrockでは使えない機能

Claudeのアカウントでログインしないため、そのアカウントが前提の機能は、Bedrockでは使えません。導入してから気づかないよう、先に確認しておきましょう。公式の機能一覧の内容をまとめました。

一方で、ターミナルで使うClaude Code本体、VS CodeやJetBrainsの拡張、サブエージェント、フック、スキル、CLAUDE.md、プラグイン、MCPサーバーは、どのログイン方法でも使えます。日々のプログラミングの作業は、Claudeのアカウントで使う場合と同じように進められます。

向いている会社・向いていない会社

始める前の準備

Bedrockで使うには、Claude Code側の設定の前に、AWS側で用意しておくことがあります。ここでは、必要なものと、AWSでの手順を説明します。

必要なもの

公式ドキュメントでは、AWS CLIは「ほかに認証情報を得る方法がない場合に必要」とされています。ただし、後で説明するSSOでのログインや aws login を使うなら、AWS CLIがあると便利です。

モデルを使えるようにする（利用申請）

BedrockでAnthropicのモデルを初めて呼び出す前に、利用目的を記入するフォーム（ユースケースの申請）を、AWSアカウントごとに一度だけ提出します。

1. 必要な権限を確認する操作するIAMのユーザーやロールに、次の項目で説明する権限があることを確かめます。
2. Bedrockのコンソールを開くAWSのマネジメントコンソールから、Amazon Bedrockの画面に入ります。
3. モデルを選ぶ「Model catalog（モデルカタログ）」から、Anthropicのモデルを選びます。
4. フォームを送る利用目的のフォームに記入して送信します。公式ドキュメントでは、送信するとすぐにアクセスが許可されると説明されています。

AWS Organizations（複数のAWSアカウントをまとめて管理する仕組み）を使っている場合は、管理アカウントから、PutUseCaseForModelAccess というAPIで一度だけ申請できます。承認は、配下のアカウントにも自動で及びます。このAPIを呼ぶには、bedrock:PutUseCaseForModelAccess の権限が必要です。

IAMで許可する権限

Claude Codeを使う人のIAMユーザーやロールには、Bedrockのモデルを呼び出す権限が必要です。公式ドキュメントに載っているポリシーの例は、次のとおりです。

{
  "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"
        }
      }
    }
  ]
}

ポリシーの意味は、次のとおりです。InvokeModel と InvokeModelWithResponseStream は、モデルに依頼を送る権限です。ListInferenceProfiles と GetInferenceProfile は、使えるモデルの「入口」（推論プロファイル）を調べる権限です。2つめのブロックは、モデルを使うときに必要になることがあるAWS Marketplaceの購読を許可するものです。

より厳しくしたい場合は、Resource を特定の推論プロファイルのARN（AWSでの住所）に絞れます。bedrock:GetInferenceProfile は、アプリケーション推論プロファイルのARNから元のモデルを調べるための権限です。この権限がなくても、Claude Codeが自動でやり直すため動きますが、新しいモデルごとに余分なやりとりが1回増えます。許可しておくほうが無駄がありません。

Claude Codeを入れる

Claude Code本体のインストールは、Bedrockで使う場合も同じです。公式の推奨は、ターミナルに1行貼り付けるインストーラーです。

動作環境は、macOS 13以降、Windows 10（1809以降）かWindows Server 2019以降、Ubuntu 20.04以降、Debian 10以降などです。メモリは4GB以上が必要です。インストール後は、新しいターミナルを開いて claude --version を実行し、バージョンが表示されれば成功です。

BedrockでClaudeの新しいモデルを使うには、Claude Code自体も新しくしておく必要があります。公式ドキュメントでも、最新版を使うよう案内されています。更新は claude update で行えます。インストールの詳しい手順や、つまずいたときの対処は、別の記事でまとめています。

設定の手順

設定の方法は2つあります。ひとつは、画面の案内に従って進めるウィザードです。もうひとつは、設定ファイルや環境変数に自分で書く方法で、複数人への配布や自動化に向いています。

ウィザードで設定する

自分のAWSの認証情報で使い始めるなら、ウィザードがいちばん簡単です。AWS側の準備（前の章）を終えてから、次のように進めます。

1. Claude Codeを起動するターミナルで claude と入力します。
2. ログイン方法を選ぶログインの画面で、3rd-party platform を選び、続けて Amazon Bedrock を選びます。
3. AWSへの認証の方法を選ぶ次の4つから選びます。「~/.aws フォルダから検出されたAWSプロファイル」「Amazon Bedrock APIキー」「アクセスキーとシークレット」「環境にすでにある認証情報」です。
4. リージョンを入れるBedrockを使うAWSのリージョンを選びます。ウィザードは、そのリージョンで、あなたのアカウントが呼び出せるClaudeのモデルを確かめてくれます。
5. モデルを固定する使うモデルのバージョンを選んで固定します。固定しておくと、新しいモデルが出ても、意図しないタイミングで切り替わりません。

設定した内容は、ユーザー設定ファイル（~/.claude/settings.json）の env という欄に保存されます。環境変数を自分で設定する必要はありません。すでにログインしていてチャットの画面が出ている場合は、/setup-bedrock と入力すると、同じウィザードを開けます。CLAUDE_CODE_USE_BEDROCK=1 を設定するまで、このコマンドはメニューに表示されないので、最後まで自分で入力します。

ログインしたあとも、/setup-bedrock でいつでも設定を変えられます。認証方法、リージョン、固定するモデルを変えたいときに使います。

設定ファイルに書く（手動の設定）

CIや、会社全体への配布のように、画面の操作を省きたい場合は、環境変数で設定します。Bedrockを有効にする最小限の設定は、次の2つです。

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

Windowsで一時的に設定する場合は、PowerShellで $env:CLAUDE_CODE_USE_BEDROCK = "1" のように書きます。ただし、ターミナルを閉じると消えます。繰り返し使うなら、次のように設定ファイルの env に書いておくほうが確実です。OSの違いも気にしなくてすみます。

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_REGION": "us-east-1",
    "AWS_PROFILE": "myprofile"
  }
}

設定ファイルに書く環境変数のうち、よく使うものをまとめました。

環境変数を、パソコン全体の設定に書くのではなく、Claude Codeの設定ファイルに書く利点もあります。公式ドキュメントでは、AWS_PROFILE のように、ほかのプログラムに渡したくない値には、設定ファイルを使えると案内されています。

動作を確かめる

設定が終わったら、Claude Codeを起動して、次の順で確かめます。

1. 状態を確認するClaude Code内で /status と入力します。使っているプロバイダー（Amazon Bedrock と表示されます）と、決まったリージョンを確かめられます。リージョンが設定ファイルの値やデフォルトから決まった場合は、その由来も表示されます。
2. モデルを確認する/model と入力して、使うモデルが意図したものか確かめます。
3. 簡単な依頼を送る「このフォルダのファイルの一覧を教えて」のように、害のない依頼を送り、返事が来ることを確かめます。

返事が来れば、設定は完了です。エラーが出た場合は、後半の「うまくいかないときの対処」を参照してください。

認証・リージョン・モデルの指定

Bedrockで使うときに、いちばん迷いやすい3つの項目です。ここを理解しておくと、エラーが出たときも原因を絞れます。

AWSの認証方法を選ぶ

Claude Codeは、AWSのSDKが使う標準的な認証情報の探し方（デフォルトの認証チェーン）を使います。パソコンの外で動かす場合に、EC2のインスタンスプロファイルやECSのタスクの認証情報があれば、そのまま使われます。手元のパソコンで使うなら、次の方法から選びます。

会社で使うなら、SSOか aws login のように、一時的な認証情報を使う方法が基本です。長く有効なアクセスキーをパソコンに置くと、漏れたときの影響が大きくなります。AWSのBedrock APIキーには短期と長期があり、AWSは本番には短期を、長期は試す用途に限ることを勧めています。

なお、AWS_BEARER_TOKEN_BEDROCK を設定すると、ほかのAWSの認証情報があっても、Claude CodeはこのAPIキーだけで認証します。複数の認証情報が混ざるときの原因になるので、覚えておいてください。

認証の期限切れに備える

SSOなどの一時的な認証情報は、時間が経つと期限が切れます。Claude Codeは、認証情報を一度取得すると、期限の5分前まで使い回します。期限がない場合は1時間です。そのため、作業の途中で突然「認証に失敗しました」と出ることがあります。

これを減らすには、設定ファイルに awsAuthRefresh を書きます。認証情報の期限切れを検出したときに、指定したコマンドを自動で実行し、更新後にやり直してくれます。

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

ブラウザでのSSOのログインが、会社のVPNやプロキシで中断される環境では、ログイン画面が何度も開く場合があります。その場合は、awsAuthRefresh を外し、Claude Codeを起動する前に自分で aws sso login を実行する運用にしてください。

認証情報を自分で書き出す仕組みが必要な会社向けには、awsCredentialExport という設定もあります。AWSの設定ファイル（.aws）を変更できず、認証情報を直接返したいときだけ使います。通常は awsAuthRefresh で足ります。

リージョンはどう決まるか

リージョンとは、AWSのデータセンターがある地域のことです（東京、バージニア北部など）。Claude Codeは、次の順番でリージョンを決めます。

1. AWS_REGION を見る設定されていれば、これを使います。
2. AWS_DEFAULT_REGION を見るなければ、これを使います。
3. AWSプロファイルのリージョンを見る使っているプロファイルに書かれたリージョンを使います。
4. us-east-1 を使うどれもなければ、バージニア北部になります。

意図しないリージョンで動かないよう、/status で確かめておくのがおすすめです。

Claude Codeは、モデルを呼び出すときに、リージョンをまたいで処理を振り分ける「クロスリージョン推論プロファイル」のIDを使います。IDの先頭に付く接頭辞は、リージョンから次のように決まります。

接頭辞を変えたいときは、ANTHROPIC_BEDROCK_REGION_PREFIX に us・eu・apac・jp・au・global のどれかを入れます（Claude Code v2.1.224以降）。たとえば、日本のリージョンを使うのに、日本の地域内で処理を振り分ける jp を選ぶことができます。

ただし、この指定は「希望」です。そのモデルに、その接頭辞のプロファイルがあなたのアカウントで有効でなければ、別のプロファイルが選ばれるか、リクエストが失敗します。指定する前に、AWSコンソールで有効になっているか確かめてください。

モデルを固定する

Claude Codeには、opus・sonnet・haiku という名前（エイリアス）があり、それぞれが指すモデルは、プロバイダーごとの既定値で決まります。Bedrockでの既定は、公式ドキュメントでは次のように案内されています。

公式ドキュメントは、複数人で使うなら、モデルのバージョンを固定することを強く勧めています。固定しないと、名前が指すモデルがClaude Codeの既定に従って変わります。また、その既定がアカウントでまだ有効になっていないこともあります（その場合、Claude Codeは起動時に前のモデルや下位のモデルに切り替えます）。

固定は、環境変数でBedrockのモデル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. は推論プロファイルの接頭辞で、リージョンに合わせて変えます。固定するときは、そのとき有効なモデルのIDを、公式のモデル一覧と、自分のAWSのコンソールで確かめて書いてください。

さらに、組織としてモデルを制限したい場合は、設定ファイルの availableModels に、使ってよいモデルのIDを並べます。enforceAvailableModels を true にすると、起動時の確認も、この一覧の中だけで行われます（Claude Code v2.1.287以降）。

バックグラウンドの処理（会話のタイトル作成など）に使うモデルにも、決まりがあります。Bedrockでは、Haikuがアカウントで有効とは限らないため、既定ではSonnetが使われます。Haikuを使いたいときは、ANTHROPIC_DEFAULT_HAIKU_MODEL に、アカウントで使えるモデルのIDを入れます。

コンテキストの長さ・サービスティア

公式ドキュメントによると、Bedrockでは、Fableモデル、Sonnet 5以降、Opus 4.7以降が、標準で100万トークンのコンテキストで動きます。「コンテキスト」とは、AIが一度に読める文章の量のことです。以前は200Kでしたが、Claude Code v2.1.287以降で変わりました。200Kのままにしたい場合は、CLAUDE_CODE_DISABLE_1M_CONTEXT=1 を設定します。

ANTHROPIC_BEDROCK_SERVICE_TIER では、Bedrockのサービスティア（default・flex・priority）を選べます。費用と待ち時間のバランスを変える仕組みです。提供状況はモデルとリージョンによって違います。

Mantleエンドポイントについて

Claude Codeは、通常のBedrockのほかに、「Mantle」というエンドポイントにも対応しています。AnthropicのAPIと同じ形式でClaudeを呼び出せる、Bedrockの入口です。CLAUDE_CODE_USE_MANTLE=1 を設定すると使えます。ただし、権限の名前が bedrock-mantle:CreateInference のように別系統で、使えるモデルも通常のBedrockとは別の一覧です。モデルのIDは anthropic.claude-sonnet-5 のように、anthropic. から始まります。

使えるモデルは、組織に許可されたものに限られ、追加のモデルはAWSの担当者に依頼する必要があります。通常のBedrockの設定がうまくいかないときに、いきなり試すものではありません。AWSの担当者から案内があったときに検討してください。

料金・費用の管理

Bedrock経由では、Claude Codeの利用料金は、AWSの請求書にまとまります。Claudeのアカウントの月額プランのように「定額」ではなく、使った分だけかかる従量課金です。

請求の仕組み

公式ドキュメントでは、Bedrockでの請求は「AWSを通した従量課金」で、費用の確認は「AWS Cost Explorer」と案内されています。Claude CodeはBedrock経由の利用の指標をAnthropicに送らないため、Anthropicの分析ダッシュボードやClaude Code Analytics APIには、この利用が含まれません。

料金の計算は、モデルが読み書きした文字の量（トークン）で決まります。長い会話や大きなプロジェクトを読み込ませるほど、料金が増えます。

単価の目安

BedrockでのClaudeの1トークンあたりの正式な単価は、AWSの料金ページ（Amazon Bedrock pricing）で確認します。ここでは、比較の目安として、Anthropic自身のAPIの定価を載せます。

これはAnthropicのAPIの定価です。Bedrockの単価が同じ金額であるとは、公式ドキュメントには書かれていません。モデル間の高い・安いの違いを見るための目安として使い、実際の見積もりは、AWSの料金ページかAWSの計算ツールで確かめてください。

確かめられている点が、もうひとつあります。公式の料金の案内では、Bedrockにはグローバルエンドポイント（世界中のリージョンに自動で振り分けて、可用性を高める）と、リージョン指定のエンドポイント（指定した地域で処理する）があり、リージョン指定のエンドポイントは、グローバルより10%高いとされています。データの所在を指定する代わりに、費用が1割増えると考えてください。

どのくらいかかるか

公式ドキュメントでは、企業での導入の平均として、開発者1人あたり、稼働した日で約13ドル、1か月で150〜250ドル、利用者の90%は1日30ドル未満と紹介されています。これはClaude Code全体の平均で、Bedrock専用の数字ではありません。モデルの選び方、プロジェクトの大きさ、複数の作業を同時に動かすかなどで大きく変わります。

人数が多い場合は、先に数人の試験運用で、実際の使用量を測ってから全体に広げるよう、公式ドキュメントも勧めています。

使いすぎを防ぐ

費用を抑える基本は、モデルと会話の使い方です。公式ドキュメントで紹介されている方法を、Bedrockの運用に合わせてまとめました。

今回のセッションでどれだけ使ったかは、Claude Code内の /usage で見られます。表示される金額は、Claude Codeが手元でトークン数から計算した推定値で、定価で計算されます。請求額そのものではありません。実際の請求は、AWSの請求画面で確認します。契約で割引がある場合は、管理者が modelPricing という設定に単価を書いておくと、画面の金額を契約に合わせられます。

プロンプトキャッシュ（同じ内容の再利用で料金を抑える仕組み）は、Bedrockでも既定で有効です。ただし、公式ドキュメントでは、リージョンによっては使えないことがあると案内されています。キャッシュに関する数字がゼロのままなら、AWSのドキュメントで対応リージョンを確かめてください。無効にしたいときは DISABLE_PROMPT_CACHING=1 を設定します。

利用者ごとの集計

Bedrock経由の利用は、Anthropicの分析ダッシュボードに出てきません。利用者ごとの費用を知りたいときは、次の3つの方法があります。

公式ドキュメントでは、LiteLLMは、Anthropicとは無関係のオープンソースのツールで、セキュリティの監査もされていないと断り書きがあります。導入するなら、自社で確認してください。

会社で使うときの設定

個人で試す段階から、会社で使う段階に進むときに、決めておくことをまとめます。AWSの管理者と、Claude Codeを使う開発者の両方に関わる内容です。

IAMの権限を絞る

前の章で紹介したポリシーは、動作確認用に広く許可する書き方でした。本番では、Resource を、使ってよい推論プロファイルのARNだけに絞ります。ARNに書かれていないモデルは呼び出せなくなるので、利用者が高価なモデルを選ぶのを防げます。

認証を、IAMの役割（ロール）の一時的な認証情報にすると、さらに安全です。公式の「Claude in Amazon Bedrock」のページ（こちらはMessages API向けの説明です）では、Bedrockのサービスロールが最も安全で、続いてIAMの役割の引き受け（最大12時間のセッション）、最も勧められないのがベアラートークンと案内されています。長期のキーを禁止したい場合は、bedrock:CallWithBearerToken を、短期のトークンの条件でしか許可しないポリシーを管理者が付けます。

ガードレールで出力を制御する

Amazon Bedrockには、内容のフィルタリングを行う「ガードレール」があります。Bedrockのコンソールでガードレールを作成し、バージョンを公開してから、設定ファイルにヘッダーを追加します。

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

クロスリージョンの推論プロファイルを使っている場合は、ガードレール側でもクロスリージョン推論を有効にします。ガードレールが回答の途中でブロックした場合は、それまでに出力された文章が残り、最後にガードレールに設定したブロック用のメッセージが表示されます。

データの扱い

入力した内容がどう扱われるかは、導入の判断で重要な点です。公式ドキュメントで確かめられる範囲をまとめました。

また、公式ドキュメントには、Bedrockを使う場合の初期設定として、利用状況の指標（テレメトリ）、エラーレポート、/feedback の送信が、はじめから無効と書かれています。/feedback は、Anthropicには送られず、手元のフォルダ（~/.claude/feedback-bundles/）に書き出されます。

一方、2つの動作は、プロバイダーに関係なく、既定で動きます。ひとつは、セッションの品質アンケートです。もうひとつは、WebFetchの安全確認で、取得するページのホスト名（URL全体ではありません）を、Anthropicのサーバーに問い合わせます。アンケートは CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1 で止められます。CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC を設定すると、必須ではない通信をまとめて止められます。ただし、WebFetchの確認は止まりません。止めたいときは、設定の skipWebFetchPreflight を使います。

管理者が固定する設定

全員に同じ設定を配りたいときは、管理者向けの設定ファイル（managed settings）を使います。サーバーから配る「サーバー管理の設定」はBedrockでは使えませんが、ファイルで配る方法は、どのプロバイダーでも使えます。次のような設定を固定できます。

自動モードは、Bedrockでも既定で使えます。ただし、使えるモデルは、Sonnet 5以降、Opus 4.7以降、Haiku 5.5、Fableモデルに限られ、それ以外のモデルでは、確認を挟む通常のモードで始まります。

通信の経路を、会社のプロキシやゲートウェイに通す場合の環境変数も用意されています。Bedrockには ANTHROPIC_BEDROCK_BASE_URL を使います。ゲートウェイを通す場合は、Bedrockのストリーミング応答のヘッダー（Content-Type）を書き換えないように構成する必要があります。

展開の進め方

会社で使うときは、全員に一度に配るより、段階的に進めると失敗が少なくなります。

1. 専用のAWSアカウントと権限を用意するClaude Code用のAWSアカウントを作り、使ってよいモデルだけを許可するIAMポリシーを付けます。
2. 2〜3人で試す設定の手順書を作りながら、認証の方法と、モデルの固定を決めます。この間に、使用量を測ります。
3. 設定ファイルを配るモデルの固定、許可する接続先、テレメトリの扱いを、管理者向けの設定ファイルにまとめて配ります。
4. 費用の見える化をするAWSの請求画面か、OpenTelemetryで、利用者ごと・月ごとの費用を見られるようにします。
5. 使い方をそろえて広げるCLAUDE.mdで、プロジェクトの決まりをClaude Codeに伝える運用を整えてから、ほかの部署に広げます。

うまくいかないときの対処

Bedrockでのエラーは、「AWSの認証」「モデルの利用許可」「リージョン」のどれかが原因のことがほとんどです。公式のエラー一覧にある内容を、症状ごとにまとめました。

最初に確かめる3つ

どのエラーでも、次の3つを順に確かめると、原因を絞れます。

1. AWSの認証を確かめる同じターミナルで aws sts get-caller-identity を実行します。自分のアカウントとロールが表示されれば、AWS側の認証は通っています。
2. Claude Codeが見ている設定を確かめるClaude Code内で /status を実行し、プロバイダーとリージョンが意図どおりか見ます。
3. モデルが使えるか確かめるaws bedrock list-inference-profiles --region リージョン名 で、使いたいモデルのプロファイルが出てくるか確かめます。

なお、Claude CodeはBedrockの「Invoke API」を使い、「Converse API」には対応していません。

VS CodeやJetBrainsから使うとき

ターミナルでは動くのに、VS CodeやJetBrainsの拡張では認証が通らないことがあります。IDEのプロセスが、シェルで設定した環境変数を引き継いでいないのが原因です。その場合は、IDE自身の設定にAWS関連の環境変数を書くか、環境変数をすでに設定したターミナルからIDEを起動してください。

会社のプロキシで証明書のエラーが出るとき

通信の内容を検査するプロキシがある環境では、unable to get local issuer certificate のような証明書のエラーが出ることがあります。Claude Code v2.1.261以降では、会社のルート証明書がOSの証明書ストアか NODE_EXTRA_CA_CERTS にあれば、AWSへの通信にも適用されます。古いバージョンなら、まず更新してください。

よくある質問

まとめ

Bedrockでの導入は、AWS側の権限、費用の管理、モデルの固定、社内のルールづくりと、決めることが多くなります。最初は専用のAWSアカウントで、少人数から試すのが確実です。

INTERCREATE JAPANでは、Claude Codeの導入から、権限や費用の設計、社内で使い続けられる仕組みづくりまでをお手伝いしています。AWSでの導入を検討している場合も、お気軽にご相談ください。