Bedrock ClaudeをVSCodeで使う設定手順｜AWS認証とエラー対策
社内ルールで生成AIの通信先をAWSに統一したいものの、VSCodeのClaude Code拡張をBedrockへ接続する方法が分からない方も多いでしょう。本記事では、必要なIAM権限、認証、拡張側の設定、モデル指定、代表的なエラーの切り分けまでを実作業の順に整理します。
VSCodeのClaude Code拡張は、AWS認証を用意してBedrock用セットアップを実行し、ログイン表示を無効化すれば利用できる。設定はCLIと共有されるため、モデルやリージョンも一元管理できる。
Contents (11)
Bedrock ClaudeをVSCodeで使う仕組み
Anthropic公式の「Claude Code」拡張は、推論先をAmazon Bedrockへ切り替えられます。差分表示、ファイル参照、ターミナル連携など、VSCode上の基本操作はそのままです。
認証と請求はAWS側に集約されます。VSCode拡張ドキュメントはログイン表示を無効化し、共通設定で接続先を構成する方式を案内しています。AWS Builder Centerも、ターミナルのBedrock接続をVSCodeへ引き継ぐ流れを解説しています。
事前に必要なもの
- AWSアカウント：Amazon Bedrockを利用できるアカウントを用意します。
- Claudeモデルへのアクセス：Bedrockのモデルカタログで、利用するAnthropicモデルのユースケース情報を提出します。
- IAM権限：少なくともモデル呼び出しとストリーミング応答に必要な権限を付与します。
- 有効なAWS認証情報：AWS CLIのプロファイル、IAM Identity Center、アクセスキー、Bedrock APIキーのいずれかを準備します。
- VSCodeと公式拡張：対応バージョンのVSCodeへ「Claude Code」拡張をインストールします。
Bedrock設定の公式資料では、bedrock:InvokeModel、bedrock:InvokeModelWithResponseStream、bedrock:ListInferenceProfiles、bedrock:GetInferenceProfileが主な権限です。組織では対象を承認済みARNへ絞ります。
AWS CLIのプロファイルを使う場合は、VSCodeの統合ターミナルで次のコマンドを実行し、認証が通ることを先に確かめます。
aws sts get-caller-identity --profile bedrock-dev
アカウントIDとIAMプリンシパルが表示されればAWS認証は正常です。失敗する場合は先にプロファイルやSSOセッションを直します。
VSCodeへ設定する手順
セットアップウィザードなら、認証、リージョン、モデルを選んだ結果が~/.claude/settings.jsonへ保存されます。
- VSCodeの拡張パネルを開き、「Claude Code」を検索してAnthropic公式拡張をインストールします。
- VSCodeの統合ターミナルを開き、
claudeを実行します。 - 初回画面で「3rd-party platform」を選び、続けて「Amazon Bedrock」を選択します。すでにClaude Codeへログイン済みなら、
/setup-bedrockを入力します。 - AWSプロファイル、Bedrock APIキー、環境内の認証情報など、利用する認証方法を選びます。
- Bedrockを実行するリージョンを選び、アカウントから呼び出せるClaudeモデルを指定します。
- VSCodeの設定を開き、「Claude Code login」を検索して「Disable Login Prompt」を有効にします。
- VSCodeを再読み込みし、Claude Codeパネルを開きます。
- Claude Code内で
/statusを実行し、APIプロバイダーがAmazon Bedrock、リージョンが意図した値になっていることを確認します。
拡張とCLIは同じ接続先を使います。検索上位のVSCode向け解説ページも、CLAUDE_CODE_USE_BEDROCK、AWS_REGION、AWS_PROFILEを拡張へ渡す構成を紹介しています。
settings.jsonで手動設定する方法
複数端末へ配布する場合は、~/.claude/settings.jsonのenvへ明示します。
{
"env": {
"CLAUDE_CODE_USE_BEDROCK": "1",
"AWS_PROFILE": "bedrock-dev",
"AWS_REGION": "us-east-1",
"ANTHROPIC_MODEL": "us.anthropic.claude-sonnet-4-6"
}
}
CLAUDE_CODE_USE_BEDROCKは接続先を切り替え、AWS_PROFILEは認証に使うプロファイルを選びます。端末差をなくすならAWS_REGIONも明記します。
ANTHROPIC_MODELには利用可能なモデルIDを指定します。us.付きは米国系クロスリージョン推論の例です。東京でも文字列を推測せず、Bedrockコンソールからコピーします。提供地域やID体系はBedrock上のClaude公式資料で確認できます。
アクセスキーをsettings.jsonへ直接保存せず、AWSプロファイルやIAM Identity Centerを使いましょう。
モデルとリージョンを固定する考え方
sonnetやopusのような別名は更新時期を制御しにくく、既定モデルが未許可なら一時的に別モデルへ切り替わる場合があります。
再現性を優先するチームでは、次の順序で固定します。
- Bedrockコンソールで、対象リージョンから呼び出せるモデルと推論プロファイルを確認します。
- 小規模な検証環境で品質、速度、料金を確認します。
ANTHROPIC_DEFAULT_SONNET_MODELなどの設定値へ承認済みIDを指定します。- IAMポリシーの対象リソースも、同じ推論プロファイルへ絞ります。
- 更新時は先に検証用プロファイルを変更し、問題がなければ本番用設定へ反映します。
Bedrock利用時はWebSearch機能を利用できません。外部情報が必要なら、社内で許可された検索手段を併用します。
つながらないときのエラー対策
サインイン画面が繰り返し出る
「Disable Login Prompt」を確認し、/statusで接続先を見ます。ターミナルだけつながる場合はVSCodeを再読み込みします。
Could not load credentialsと表示される
統合ターミナルでaws sts get-caller-identity --profile プロファイル名を実行します。IAM Identity Centerならaws sso login --profile プロファイル名でセッションを更新します。
403またはmodel not availableになる
指定モデルがそのリージョンで有効でなければ403になります。モデルカタログ、ユースケース情報、IAMのResource制限、推論プロファイルIDを順に確認します。Anthropicの認証トラブルシュートも、対象リージョンでモデルを有効にし、/modelから選ぶ方法を案内しています。
リージョンやモデルが意図と違う
/statusで解決されたリージョンを確認します。AWS_REGION、AWS_DEFAULT_REGION、AWSプロファイルのregion設定が競合していないかを見直し、モデルIDをコンソール表示と照合します。
導入前に押さえたい料金と運用
Bedrockでは入出力トークン量に応じてAWSへ課金され、ProやMaxの利用枠は消費しません。Cost Explorerやタグで追跡します。
チーム利用では、モデルID、リージョン、IAM権限、更新手順を統一します。認証情報を配るのではなく、IAM Identity Centerやロールで短期権限を渡す構成が適しています。
まず1台で/setup-bedrockから接続し、/statusと簡単な修正で確認します。その設定を基準に展開すれば、VSCodeの操作性を保ちながら認証・請求・モデル利用をAWS側へまとめられます。