【簡単】Claude Code を Claude Platform on AWS に接続する完全ガイド

セットアップに入る前に登場人物を整理する。

• 接続先（バックエンド）: Claude Platform on AWS。Anthropic 運営の Claude API を AWS の認証・課金で使えるようにしたもの
• クライアント: Claude Code（CLI）または Anthropic SDK / Agent SDK
• 認証: AWS IAM の SigV4、またはワークスペース API キー
• 課金: AWS Marketplace 経由、単一インボイス
• 監査: CloudTrail にリクエストが記録される

つまり「Claude Code を AWS 経由で動かす」とは、Claude Code が裏で叩く Claude API のエンドポイントを、Anthropic 直接（api.anthropic.com）から Claude Platform on AWS（aws-external-anthropic.{region}.api.aws）に向け替えること。Claude Code の機能自体は変わらず、認証と課金の経路だけが AWS に乗る。

「何ができるか」を先に知りたい場合は ClaudeとAWSが連携、一体何ができるのか？ を参照。

Claude Code を Claude Platform on AWS に接続する前に、以下が揃っている必要がある。

• AWS Marketplace 経由で有効な Claude Platform on AWS のサブスクリプション
• AWS にリンクされた Anthropic 組織のワークスペース（ワークスペース ID 付き）
• Anthropic サービスを呼び出す権限を持つ IAM プリンシパル、またはワークスペースにスコープされた API キー
• 環境内・~/.aws/credentials・接続された IAM ロールのいずれかから取得可能な AWS 認証情報

組織のセットアップとワークスペース作成は AWS コンソールから利用申込を行って Anthropic 側のセットアップフローへ進むことで完了する。詳細手順は時期によって変動するため、必ず Anthropic の公式ガイドの最新版を確認すること。なお AWS Marketplace 経由で作成される Anthropic 組織は既存の Claude 有料組織とは別扱いで、API キーやワークスペース設定は引き継がれない。

2 つの認証方式があり、目的に応じて選ぶ。

A. AWS IAM + SigV4（本番・チーム運用の推奨）

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

CI/自動化では IAM ロールをランナーに付与すれば、認証情報チェーンが自動で取得する。AWS のアクセス制御がそのまま効く点が利点。

B. ワークスペース API キー（個人検証・素早く始めたい時）

AWS Console の Claude Platform on AWS → API keys でキーを生成し、環境変数にセットする。

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

このキーは x-api-key として送信され、設定されていれば SigV4 より優先される。個人開発で素早く動かす場合は API キーが最短だが、長期運用ではアクセス制御の効く IAM への移行を推奨する。

Claude Code から Claude Platform on AWS に向けるには、以下 3 つの環境変数を設定する。

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

ANTHROPIC_AWS_WORKSPACE_ID は必須で、すべてのリクエストに anthropic-workspace-id ヘッダーとして付与される。ベース URL は AWS_REGION から https://aws-external-anthropic.{region}.api.aws の形式で自動計算される。

注意点として、Bedrock や Foundry を使う環境変数（CLAUDE_CODE_USE_BEDROCK / CLAUDE_CODE_USE_FOUNDRY）が設定されているとそちらが優先されるため、必ずアンセットする。Anthropic SDK・Agent SDK も同じ環境変数を読むので、SDK 側で追加の設定は不要だ。

モデルの新バージョンが意図せず適用されるのを防ぐなら、ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-7 のようにモデル ID をピン留めできる。プロンプトキャッシングは自動で有効化される（デフォルト TTL 5分、ENABLE_PROMPT_CACHING_1H=1 で 1時間に延長可）。

何かおかしいと思ったら、まず /status コマンドで解決されたプロバイダー・ワークスペース ID・リージョンを確認する。これが切り分けの最速ルート。

• 403 Forbidden / AccessDenied: IAM 権限不足。AWS プロファイルのロールまたは API キーが、Anthropic サービスを呼び出す権限（aws-external-anthropic アクション）を持っているか確認する。古い API キーが残っていると SigV4 より優先されて同じエラーが出るので、ANTHROPIC_AWS_API_KEY をアンセットして AWS 認証情報にフォールバックさせる手もある。
• ワークスペース不足エラー: ANTHROPIC_AWS_WORKSPACE_ID が未設定。AWS Console の Workspaces で ID を確認して再エクスポートする。
• リクエストが api.anthropic.com に飛んでしまう: CLAUDE_CODE_USE_ANTHROPIC_AWS=1 が設定されていないか、Bedrock/Foundry の環境変数が同時にセットされている。アンセットしてから再実行する。

プロキシ経由や Agent SDK 利用、SSO 認証情報の自動更新（awsAuthRefresh）など、より詳細な設定は公式ドキュメントを参照。

本記事と合わせて読むと理解が深まる、Claude Platform on AWS シリーズの他の記事。

• Claude Platform on AWS が正式リリース
• ClaudeとAWSが連携、一体何ができるのか？

本記事の事実情報は以下の公式発表に基づいている。料金・対応リージョン・機能の最新情報は必ず一次情報を確認すること。

• Anthropic 公式ブログ: Claude Platform on AWS
• AWS 公式: Claude Platform on AWS
• Claude Code ドキュメント（日本語版）