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

この記事の要点
- 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 AWS | Amazon Bedrock |
|---|---|---|
| 運営 | Anthropic | AWS |
| 認証 | AWS の資格情報 または ワークスペースのAPIキー | AWS の資格情報 |
| 請求 | AWS Marketplace | AWS |
| Claude Code の切り替え変数 | CLAUDE_CODE_USE_ANTHROPIC_AWS | CLAUDE_CODE_USE_BEDROCK |
注意点が1つあります。AWS Marketplace で申し込むと、AWS のアカウントにひもづいた新しい Anthropic の組織 が作られます。すでに持っている Claude の管理画面(Console)の組織とは別で、APIキーやワークスペースIDは使い回せません。
始める前にそろえる物
- AWS Marketplace での Claude Platform on AWS の契約
- AWS 側の組織の中の ワークスペース と、その ワークスペースID(wrkspc_ で始まる)
- Anthropic のサービスを呼べる IAM の権限、またはワークスペース用の APIキー
- AWS の資格情報(SSO でログインする場合は AWS CLI)
手順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・AccessDenied | IAM の権限が足りない。APIキーを入れている場合は、古いキーが優先されている |
| ワークスペースが無いというエラー | ANTHROPIC_AWS_WORKSPACE_ID が空 |
| 依頼が api.anthropic.com に行ってしまう | CLAUDE_CODE_USE_ANTHROPIC_AWS が 1 になっていない。Bedrock・Foundry の変数が残っている |
まず /status で、どの経路に向いているかを確かめるのが近道です。使える機能の違いは Claude Code の機能はどれで使える? にまとめています。
まとめ
- Claude Platform on AWS は、Anthropic の API を AWS の認証と請求で使う 形
- 認証は AWS の資格情報 か ワークスペースのAPIキー。ワークスペースIDは必須
- Bedrock・Foundry の変数が残っていると負ける。/status で確かめる
- チームでは モデルの版を固定 して、一斉の切り替わりを防ぐ
出典
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


