Claude Platform on AWSでClaude Codeを使う設定

公開 更新 著者 永上裕之導入とルール
クラウドの請求書と鍵を手に、パソコンのAIとクラウドをつなぐ橋をかけているイメージ

この記事の要点

  • Claude Platform on AWS は、Anthropic が運営する Claude API を、AWS の認証と AWS Marketplace の請求で使う形。Bedrock とは別物
  • 認証は AWS の資格情報(SigV4)か、ワークスペースのAPIキーの2択。どちらでも ANTHROPIC_AWS_WORKSPACE_ID は必須
  • Bedrock・Foundry の切り替え変数が残っていると、そちらが優先される。/status で経路を確かめる

活用例:会社の AWS 契約の中で、開発チームに AI の開発ツールを使わせる

部署
情報システム・開発
使うもの
Claude Code と Claude Platform on AWS
AIに任せる
コードの読み書き・調べもの・テストの実行
人が決める
誰に権限を付けるか・認証の方式・使うモデルの版・費用の上限

AWS と契約している会社では、「AI の利用も AWS の請求と権限管理にまとめたい」という要望がよく出ます。そのための選択肢として、Claude Platform on AWS が用意されています。

この記事では、公式ドキュメント「Claude Code on Claude Platform on AWS」(2026年11月15日確認)にもとづいて、Claude Code をこの経路につなぐ手順を、つまずきやすい点と一緒にまとめます。

結論:Anthropic の API を AWS の認証と請求で使う形

Claude Platform on AWS は、Anthropic が運営する Claude API そのものです。 入口と支払いが AWS になります。そのため、モデルや API の機能は通常の Claude API と同じで、新しい機能も同じ時期に届きます。

よく比べられる Amazon Bedrock との違いを整理します。

項目Claude Platform on AWSAmazon Bedrock
運営AnthropicAWS
認証AWS の資格情報 または ワークスペースのAPIキーAWS の資格情報
請求AWS MarketplaceAWS
Claude Code の切り替え変数CLAUDE_CODE_USE_ANTHROPIC_AWSCLAUDE_CODE_USE_BEDROCK

注意点が1つあります。AWS Marketplace で申し込むと、AWS のアカウントにひもづいた新しい Anthropic の組織 が作られます。すでに持っている Claude の管理画面(Console)の組織とは別で、APIキーやワークスペースIDは使い回せません。

始める前にそろえる物

手順1:認証の方法を選ぶ

認証は2つから選びます。 チームのアクセス管理のやり方に合わせます。

AWS の資格情報(SigV4)を使う

AWS の標準の仕組み(環境変数・資格情報ファイル・IAM ロール・SSO など)から読み込みます。手元では、起動前に SSO でログインしておきます。

aws sso login --profile my-profile
export AWS_PROFILE=my-profile

作業中に SSO の期限が切れて止まるのを防ぐには、設定ファイルに awsAuthRefresh を書きます。期限切れのときに、このログイン操作を自動でやり直してくれます。

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

自動実行(CI)では、実行環境に IAM ロールを付け、AWS_REGION を設定します。

ワークスペースのAPIキーを使う

AWS コンソールの「Claude Platform on AWS → API keys」で発行したキーを、ANTHROPIC_AWS_API_KEY に入れます。キーを入れると AWS の資格情報より優先 されます。長く使える秘密の値なので、ほかの本番用の鍵と同じように扱います。

手順2:Claude Code の変数を設定する

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export AWS_REGION=us-east-1

ANTHROPIC_AWS_WORKSPACE_ID は必須です。 AWS の資格情報からは自動で決まりません。接続先の住所は、リージョンから自動で組み立てられます。

AWS の資格情報があっても、この経路は 自分でオンにしない限り使われません。逆に、CLAUDE_CODE_USE_BEDROCK や CLAUDE_CODE_USE_FOUNDRY が残っていると、そちらが優先されます。切り替えるときは消しておきます。

手順3:モデルの版を固定する

チームで使うなら、ANTHROPIC_DEFAULT_OPUS_MODEL などでモデルの版を固定します。固定しないと、Claude Code の更新に合わせて、全員が新しいモデルへ一斉に移ります。opus などの短い呼び名は、この経路での既定のモデルを指し、最新の版より遅れることがあります。

読み込みの使い回し(プロンプトキャッシュ)は自動でオンです。保持時間を1時間にする設定もありますが、書き込みの料金が上がる点に注意します。仕組みは Claude Codeのプロンプトキャッシュとは? で解説しています。

手順4:起動して確かめる

claude を起動すると、最初の表示に Claude Platform on AWS と出ます。/status では、API provider・ワークスペースID・リージョンを確認できます。

なお /login は、この経路では claude.ai へのログインには使いません。認証は AWS の資格情報かワークスペースのキーで行います。

社内の中継を通すとき

社内の中継(プロキシや LLM ゲートウェイ)を通すときは、ANTHROPIC_AWS_BASE_URL に中継の住所を入れます。中継の側で AWS の署名を付ける場合は、CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH を 1 にして、Claude Code からは署名なしで送ります。中継の考え方は Claude Codeのプロキシ設定 も参考になります。

うまくいかないとき

症状よくある原因
すべての依頼が 403・AccessDeniedIAM の権限が足りない。APIキーを入れている場合は、古いキーが優先されている
ワークスペースが無いというエラーANTHROPIC_AWS_WORKSPACE_ID が空
依頼が api.anthropic.com に行ってしまうCLAUDE_CODE_USE_ANTHROPIC_AWS が 1 になっていない。Bedrock・Foundry の変数が残っている

まず /status で、どの経路に向いているかを確かめるのが近道です。使える機能の違いは Claude Code の機能はどれで使える? にまとめています。

まとめ

出典

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事