---
title: Claude Platform on AWS
url: https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws
description: Anthropicが管理するインフラストラクチャを使用して、AWS経由でClaudeのプラットフォーム機能すべてにアクセスできます。
---
Claude Platform on AWSは、Messages API、Agent Skills、コード実行、ベータ機能を含むAnthropicプラットフォームの完全な体験を、お使いのAWSアカウントを通じて利用できるようにします。AWSが推論スタックを運用する[Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)とは異なり、Claude Platform on AWSはAnthropicが運用します。AWSは認証レイヤー（SigV4またはAPIキー）、IAMベースのアクセス制御、およびAWS Marketplaceを通じた請求統合を提供します。
Anthropic SDKはClaude Platform on AWSをサポートしています。
## プラットフォーム統合の仕組み
Claudeモデルは、Anthropicが管理するインフラストラクチャ上で実行されます。これは、AWSを通じた請求とアクセスのための商用統合です。Anthropicは、推論の入力と出力のデータ処理者です。AWSは、マーケットプレイスモデルに基づいて請求およびIDのメタデータを処理します。Claude Platform on AWSを通じてClaudeを使用するお客様には、Anthropicの[データ使用条件](https://www.anthropic.com/legal)が適用されます。
Anthropicは、AWSインフラストラクチャを使用してAPIリクエストを処理し、モデル推論を実行し、ワークスペースのコンテンツ（プロンプト、出力、ファイル、Skills、バッチなど）を保存します。2026年9月18日00:00 UTCより前に作成されたワークスペースについては、AnthropicがAWSの外部でリクエストを処理し、データを保存し、推論を実行する場合があります。いずれの場合も、サブサービスは予告なく変更される場合があります。推論を特定の地域に固定するには、リクエストごとに[`inference_geo`](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#data-residency)パラメータを設定してください。
Claude Platform on AWSは、ファーストパーティのClaude APIと同じデータ保持ポリシーに従います。「Zero Data Retention」（ゼロデータ保持）、すなわちZDRはリクエストに応じて利用できます。組織で有効にするには、Anthropicのアカウント担当者にお問い合わせください。
## Claude Platform on AWSとAmazon Bedrockの比較
どちらのサービスでもAWSを通じてClaudeを使用できますが、アーキテクチャ、APIサーフェス、機能の利用可能性が異なります。
| 項目 | Claude Platform on AWS | [Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock) | [Amazon Bedrock（Opus 4.6以前）](https://platform.claude.com/docs/ja/build-with-claude/claude-on-amazon-bedrock-legacy) |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **スタックの運用者** | Anthropic | AWS | AWS |
| **APIサーフェス** | Claude API（`/v1/{endpoint}`） | `/anthropic/v1/messages`のMessages API | Bedrock Converse / InvokeModel |
| **機能の利用可能性** | 通常はClaude APIと同日（[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照） | Amazon Bedrockのリリーススケジュールに準拠 | Amazon Bedrockのリリーススケジュールに準拠 |
| **Agent Skills** | 利用可能 | 利用不可（コード実行が必要） | 利用不可 |
| **ベータ機能** | `anthropic-beta`ヘッダーでパススルー（[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照） | Amazon Bedrockがサポートするベータ機能を`anthropic-beta`ヘッダー経由で利用 | Amazon Bedrockがサポートするベータ機能をInvokeModelリクエストボディの`anthropic_beta`フィールド経由で利用 |
| **認証** | AWS IAM / SigV4またはAPIキー | AWS IAM / SigV4 | AWS IAM / SigV4またはベアラートークン |
| **請求** | AWS Marketplace | AWS（ネイティブサービス） | AWS（ネイティブサービス） |
| **ベースURL** | `aws-external-anthropic.{region}.api.aws` | `bedrock-mantle.{region}.api.aws` | `bedrock-runtime.{region}.amazonaws.com` |
| **SDKクライアント** | `AnthropicAWS` (typescript: `AnthropicAws`; csharp: `AnthropicAwsClient`; go: `anthropicaws.NewClient`; java: `AwsBackend`; php: `Anthropic\Aws\Client`; ruby: `Anthropic::AWSClient`)（ベータ版） | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK |
| **コンソール** | Claude Console（`platform.claude.com`、AWS Console経由でアクセス） | Bedrockコンソール | Bedrockコンソール |
| **レート制限とクォータ** | Anthropicが管理 | AWSが管理 | AWSが管理 |
| **推論データの処理者** | Anthropic | AWS | AWS |
AWSが運用するClaudeが必要な場合は、[Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)を参照してください。Claude Platform on AWSは、ファーストパーティのClaude APIおよびAmazon Bedrockのいずれとも別のキャパシティプールを使用します。複数のプラットフォームでワークロードを実行し、それらの間でフェイルオーバーすることができます。
VPCをClaude Platform on AWSのエンドポイントに接続するために、[AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/what-is-privatelink.html)がサポートされています。
**Bedrockを選択すべき場合：** FedRAMP High、IL4、IL5、またはHIPAA対応のコンプライアンスが必要な規制業界の組織や、AWSを唯一のデータ処理者とする必要がある組織は、[Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)を使用してください。Bedrockは、AWSを運用者として、完全にAWSが管理するインフラストラクチャ上で実行されます。
**どのサービスを使用していますか？** Claudeは、いくつかの異なる製品を通じて利用できます。
* **Claude Platform on AWS**（このページ）：AWS Marketplaceを通じて請求されるClaude APIプラットフォームです。[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#using-the-claude-console)とAWS Consoleで管理します。
* **[Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)：** AWSネイティブのサービスです。Amazon Bedrockコンソールで管理し、AWSサービスの使用量として請求されます。
* **AWS Marketplaceを通じて調達したClaude Enterprise：** APIプラットフォームではなく、[claude.ai](https://claude.ai)のプラン（Claudeのチャット製品）です。claude.aiで管理し、そのアカウントと移行の動作はこのページで説明する内容とは異なります。[Claudeヘルプセンター](https://support.claude.com)を参照してください。
* **Anthropicの直接アカウント：** Anthropicが請求するファーストパーティのClaude APIおよびclaude.aiのプランです。Claude Consoleおよびclaude.aiで管理します。
## アカウントのセットアップ
Claude Platform on AWSのセットアップは4つのフェーズで行われます：AWS Consoleのサービスページでサインアップし、Anthropic組織のセットアップを完了し、ワークスペースIDを控え、Claude Consoleにサインインします。
AWS Consoleを通じてサインアップすると、AWSアカウントに紐付けられた新しいAnthropic組織がプロビジョニングされます。この組織は、AWS Marketplaceを通じて調達したClaude Enterprise組織を含め、貴社がAnthropicとの間で持つ既存の組織とは別のものです。ファーストパーティのAnthropic組織のAPIキー、ワークスペース、Claude Consoleの設定は引き継がれません。
既存のAmazon Bedrockプライベートオファーをお持ちの場合は、最初のリクエストから割引が適用されるよう、サインアップする前にAnthropicまたはAWSのアカウント担当者にお問い合わせください。プライベートオファーが承諾される前に発生した使用量に対して、割引を遡って適用することはできません。[プライベートオファー](https://platform.claude.com/docs/ja/about-claude/pricing#private-offers)を参照してください。
1. [AWS Console](https://console.aws.amazon.com/)を開き、**Claude Platform on AWS**サービスページに移動します。
2. **Sign up**を選択します。
3. サインアップページで、規約（AnthropicのEnd User License Agreement、AWS Privacy Notice、AWS Customer Agreement）を確認し、同意のチェックボックスを選択します。
4. **Continue**を選択します。
ページに**Sign-up in progress**バナーが表示されます。ページから移動しないでください。AWSがAWS Marketplaceのサブスクリプションを代わりに処理する間、サインアップには数分かかり、その後自動的にリダイレクトされます。
組織がAnthropicからのプライベートオファーを持っている場合、Consoleがそれを検索し、AWS Marketplaceで承諾するよう求めます。詳細については、[プライベートオファー](https://platform.claude.com/docs/ja/about-claude/pricing#private-offers)を参照してください。
Claude Platform on AWSを使用する場合、Anthropicはコンテンツ（プロンプトや出力など）をAWSインフラストラクチャ上で処理および保存します。2026年9月18日00:00 UTCより前に作成されたワークスペースについては、AnthropicがそのコンテンツをAWSの外部で処理および保存する場合があります。Anthropicの[データ使用ポリシー](https://www.anthropic.com/legal)では、コンテンツとメタデータがどのように処理および保存されるかを説明しています。
サインアップが完了すると、`platform.claude.com/partner-signup`にリダイレクトされます。
1. 組織のオーナーのメールアドレスを入力し、**Get started**を選択します。
2. そのメールの受信トレイでセットアップリンクを確認し、リンクをたどります。ブラウザに**Signed in as a different account**ページが表示された場合は、**Log out and continue**を選択します。
3. 組織の詳細フォーム（組織名、事業体の種類、国、使用目的）に入力し、**Complete setup**を選択します。
セットアップを完了すると、Anthropic組織が作成され、Anthropicの商用利用規約と利用ポリシーに同意したことになります。AWS Consoleのサービスページには、**Home**、**API keys**、**Quickstart**、**Workspaces**を含む左側のナビゲーションが表示されるようになります。
セットアップを完了すると、AWS Consoleからワークスペースの作成を求められます。リージョンのバインド、IAMリソースのスコープ設定、追加のワークスペースの作成の詳細については、[ワークスペース](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#workspaces)を参照してください。
ワークスペースIDは、AWS Consoleの**Claude Platform on AWS**サービスページの**Workspaces**の下、または[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#using-the-claude-console)で確認できます。ワークスペースIDは、`wrkspc_`の後に英数字の識別子が続く形式です。
Claude Consoleへのアクセスは、AWS IAMを通じてフェデレーションされます：
1. `aws-external-anthropic:AssumeConsole`権限を持つIAMロールを引き受けます。[Claude Platform on AWSのIAMアクション](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#console-access)を参照してください。
2. **Claude Platform on AWS**サービスページから、**Open Claude Console**を選択します。AWS ConsoleがJWTを発行し、`platform.claude.com`にリダイレクトします。
3. 初回サインイン時に、メールアドレスの入力を求められます。仕事用のメールアドレスを入力してください。プラットフォームがClaude Consoleユーザーをジャストインタイムでプロビジョニングします。
AWS Consoleを通じてサインインすると、Claude ConsoleはClaude Platform on AWS組織にスコープされます。Claude Consoleのサイドバーの左下に**Account managed by AWS**インジケーターが表示されます。
### 既存のAnthropic組織からの移行
Claude Platform on AWSにサインアップすると、常にAWSアカウントに紐付けられた新しいAnthropic組織がプロビジョニングされます。インプレースでの変換はありません：ファーストパーティのClaude API組織などの既存の組織を、Claude Platform on AWS組織にすることはできません。
既存の組織からの移行は、新しい組織への切り替えとして計画してください：
* **最初に新しい組織を作成します。** AWS Consoleを通じてサインアップします（[アカウントのセットアップ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#set-up-your-account)を参照）。移行にプライベートオファーが関係する場合は、オファーが承諾される前にサインアップを完了してください：割引は承諾時点から適用され、遡って適用されることはありません。[プライベートオファー](https://platform.claude.com/docs/ja/about-claude/pricing#private-offers)を参照してください。
* **アクセスと設定を再作成します。** APIキー、ワークスペース、Claude Consoleの設定は、既存の組織から引き継がれません。新しい組織でワークスペースを作成し、アプリケーションを[Claude Platform on AWSの認証](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#authentication)に切り替えてください。
* **統合を更新します。** Claude Platform on AWSはClaude API（`/v1/{endpoint}`）を提供するため、リクエストとレスポンスの形式はファーストパーティのClaude APIから変わりません。変わるのは、ベースURL、認証方法、および推論リクエストとリソースリクエストの`anthropic-workspace-id`ヘッダーです。[リクエストの送信](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#making-requests)を参照してください。一部のプラットフォーム機能は異なります。[サポートされていない機能](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照してください。
* **独自のスケジュールで切り替えます。** 新しい組織は既存の組織から独立しており、両方が並行してトラフィックを処理できます。一度に完全に切り替える必要はありません：すべてのトラフィックが新しい組織に移るまで、ワークロードを段階的に移行してください。
新しい組織が稼働すると、違いは請求と認証に集中し、これらはAWSを通じて処理されます：
* **請求**はAWS Marketplaceに移行します：使用量はプリペイドクレジットではなくClaude Consumption Unitsで請求され（[請求](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#billing)を参照）、支出制限はBillingページで設定します（[支出制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#spend-limits)を参照）。移行期間中、請求は別々のままです：既存の組織は現在と同様に引き続き請求されます。
* **認証とアクセス**はAWSに移行します：リクエストは、AWS認証情報、またはClaude ConsoleではなくAWS Consoleで生成されたAPIキーで認証されます（[認証](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#authentication)を参照）。組織のメンバーシップはClaude ConsoleではなくAWS IAMを通じて管理され（[利用可能なページ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#available-pages)を参照）、AnthropicのクライアントSDKはプラットフォーム固有のクライアントクラスを提供します（[SDKのインストール](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#install-an-sdk)を参照）。
* **日常的なAPIの使用**は、[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)に記載されている場合を除き、ファーストパーティのClaude APIと同じように動作します。本番トラフィックを移行する前に、「rate limit」（レート制限）を確認してください：新しい組織はStartティアに配置され、制限の引き上げはAnthropicのアカウント担当者を通じて行われます（[レート制限とクォータ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)を参照）。
動作が異なるClaude Enterprise（claude.ai）組織については、[サービスの比較](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#claude-platform-on-aws-vs-amazon-bedrock)を参照してください。
### アカウントセットアップのトラブルシューティング
* **「Sign-up failed: Failed to enable OutboundWebIdentityFederation」：** 最初の送信時にこのバナーが表示された場合は、もう一度**Continue**を選択してください。IAMの有効化が反映されるまで少し時間がかかることがあります。
* **サインアップ中に進行状況インジケーターが表示されない：** サインアップには数分かかります。AWSがアカウントをプロビジョニングしている間、ページにはプログレスバーのない静的な**Sign-up in progress**バナーが表示されます。
* **セットアップリンクに従った後に「Signed in as a different account」と表示される：** **Log out and continue**を選択してください。ページは入力したメールアドレスで再認証します。
* **サインイン中に「Not found」メッセージが表示される：** このメッセージはリダイレクト中に一時的に表示されることがあります。無視して構いません。
* **最初のAPI呼び出し後にUsageページにデータが表示されない：** 使用量データがClaude Consoleに表示されるまで数分かかることがあります。
* **最初のAPI呼び出しで「Outbound web identity federation is disabled」と表示される：** アカウントごとに一度フェデレーションを有効にしてください。[アウトバウンドWeb IDフェデレーションの有効化](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)を参照してください。
## API呼び出しを行う前に
以下を確認してください。
1. Claude Platform on AWSのサブスクリプションを持つ有効なAWSアカウント（[アカウントのセットアップ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#set-up-your-account)を参照）
2. [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)がインストールおよび設定されていること
3. AWSアカウントで**アウトバウンドWeb IDフェデレーションが有効**になっていること。一度だけのセットアップ手順です（[アウトバウンドWeb IDフェデレーションの有効化](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)を参照）
4. ワークスペースID（[ワークスペースIDの取得](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#obtain-your-workspace-id)を参照）
5. APIを呼び出すためのIAM権限：ワークスペースに対する`aws-external-anthropic:CreateInference`アクション、およびAPIキーで認証する場合は`aws-external-anthropic:CallWithBearerToken`（[IAMポリシー](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#iam-policies)を参照）
### アウトバウンドWeb IDフェデレーションの有効化
Claude Platform on AWSゲートウェイは、サーバー側で`sts:GetWebIdentityToken`を呼び出してJWTを発行し、それをAnthropicに転送します。このSTS機能は、すべてのAWSアカウントで**デフォルトで無効**になっています。アカウントごとに一度有効にしてください。
```bash CLI
aws iam enable-outbound-web-identity-federation
```
レスポンスが`[ERROR] (FeatureEnabled) ... already enabled`の場合、この設定はアカウントですでに有効になっているため、次に進んで構いません。アカウントの発行者URLを確認して取得します。
```bash CLI
aws iam get-outbound-web-identity-federation-info
```
この手順を行わないと、すべてのリクエストが`"Outbound web identity federation is disabled for your account"`を返します。これは最も一般的なセットアップエラーです。
### ワークスペースIDの取得
ワークスペースは、アカウント設定の完了後にAWS Consoleから作成します（[アカウントのセットアップ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#set-up-your-account)を参照）。ワークスペースは単一のAWSリージョンにバインドされます。ワークスペースIDは、[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#using-the-claude-console)の**Workspaces**、またはAWS Consoleのサービスページの**Workspaces**セクションで確認できます。
SDKクライアントが自動的に読み取れるように、`ANTHROPIC_AWS_WORKSPACE_ID`および`AWS_REGION`環境変数を設定します。
```bash CLI
export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2' # Your workspace's AWS region
```
リージョンは必須です。リージョンが設定されていない場合、SDKクライアントはエラーを発生させます。クライアントの作成時に`aws_region` (typescript, php: `awsRegion`; go: `AWSRegion`; java: `.region()`; csharp: `AwsClientOptions.AwsRegion`)を渡すか、`AWS_REGION`（または`AWS_DEFAULT_REGION`）を設定してください。すべてのAWS商用リージョンがサポートされています。
## 認証
Claude Platform on AWSは2つの認証方法をサポートしています。Signature Version 4（SigV4）リクエスト署名を使用するAWS IAM（主要）と、APIキー認証です。どちらも同じベースURLとリクエスト形式を使用します。
### SigV4認証
SigV4はエンタープライズネイティブな方法であり、既存のAWS IAMポリシー、ロール、監査と統合されます。[AWSデフォルト認証情報プロバイダーチェーン](https://docs.aws.amazon.com/sdkref/latest/guide/standardized-credentials.html)でサポートされている任意の方法でAWS認証情報を設定してください。
* 環境変数（`AWS_ACCESS_KEY_ID`、`AWS_SECRET_ACCESS_KEY`、`AWS_SESSION_TOKEN`）
* 共有認証情報ファイル（`~/.aws/credentials`）
* SSOおよび`credential_process`を含む共有設定ファイル（`~/.aws/config`）
* IRSAおよびGitHub Actions向けのWeb ID（`AWS_WEB_IDENTITY_TOKEN_FILE`および`AWS_ROLE_ARN`）
* ECSコンテナ認証情報
* EC2インスタンスメタデータサービス（IMDS）
認証情報が機能していることを確認します。
```bash CLI
aws sts get-caller-identity
```
### APIキー認証
よりシンプルな統合方法（ローカル開発やスクリプト）では、SigV4の代わりにAPIキーで認証できます。`ANTHROPIC_AWS_API_KEY`環境変数を設定するか、クライアントの作成時に`api_key` (typescript, php: `apiKey`; go: `APIKey`; java: `.apiKey()`; csharp: `AwsClientOptions.ApiKey`)を渡してください。
APIキーは、**AWS Console**の**Claude Platform on AWS → API keys**で生成します。**Generate a key**を選択し、キーの値をコピーします。APIキー認証の使用を許可するプリンシパルに、`aws-external-anthropic:CallWithBearerToken` IAMアクションを付与してください。
Claude Platform on AWSのAPIキーは、Claude ConsoleではなくAWS Consoleで管理されます。標準の[Claude Console](https://platform.claude.com/)で作成したキー（ファーストパーティのAPIアクセス用）は、Claude Platform on AWSのエンドポイントでは機能しません。
#### 短期APIキー
別のプロセス（LLMゲートウェイ、サーバーレス関数、またはベアラートークン認証はサポートするがSigV4はサポートしないツールなど）に認証情報を渡す必要があるワークロードでは、AWS Consoleで長期間有効なキーをプロビジョニングする代わりに、AWS認証情報から短期APIキーを生成してください。
AWSは[JavaScript](https://github.com/aws/token-generator-for-aws-external-anthropic-js)、[Python](https://github.com/aws/token-generator-for-aws-external-anthropic-python)、[Java](https://github.com/aws/token-generator-for-aws-external-anthropic-java)向けのトークンジェネレーターライブラリを公開しています。各ライブラリは標準のプロバイダーチェーンを通じてAWS認証情報を読み取り、`x-api-key`ヘッダーで機能する期限付きトークンを返します。トークンの有効期間はデフォルトで12時間で、リクエストした期間、AWS認証情報の有効期限、12時間のうち最も短いものが上限となります。インストールと完全な設定オプションについては、リンク先のリポジトリのREADMEを参照してください。
生成したトークンは、AWS Consoleで生成したAPIキーを渡すのと同じ方法でSDKに渡します。
```python Python
from token_generator_for_aws_external_anthropic import TokenGenerator
from anthropic import AnthropicAWS
token = TokenGenerator(region="us-west-2").get_token()
client = AnthropicAWS(api_key=token, aws_region="us-west-2")
```
```typescript TypeScript
import { getTokenProvider } from "@aws/token-generator-for-aws-external-anthropic";
import AnthropicAws from "@anthropic-ai/aws-sdk";
const tokenProvider = getTokenProvider({ region: "us-west-2" });
const token = await tokenProvider();
const client = new AnthropicAws({ apiKey: token, awsRegion: "us-west-2" });
```
```java Java
import software.amazon.awsexternalanthropic.TokenGenerator;
import software.amazon.awssdk.regions.Region;
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
void main() {
String token = TokenGenerator.builder().region(Region.US_WEST_2).build().getToken();
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.builder()
.apiKey(token)
.region(Region.US_WEST_2)
.workspaceId(System.getenv("ANTHROPIC_AWS_WORKSPACE_ID"))
.build())
.build();
}
```
トークンをローカルで生成できるのであれば、そのプロセスはすでにSigV4認証情報を持っているため、通常はSigV4認証の方がシンプルな選択です。短期キーは、API呼び出しを行うプロセスがAWS認証情報を保持するプロセスと別である場合に使用してください。
SDKは短期キーを自動的に更新しません。トークンの有効期限が切れたら、新しいトークンを生成して新しいクライアントを構築してください。トークンを使用するプリンシパルには、引き続き`aws-external-anthropic:CallWithBearerToken` IAMアクションが必要です。
### 認証情報の優先順位
プラットフォーム固有のクライアントは、作成時に渡された内容から始めて、次の順序で認証を解決します。
1. `api_key` (typescript, php: `apiKey`; go: `APIKey`; java: `.apiKey()`; csharp: `AwsClientOptions.ApiKey`) → `x-api-key`ヘッダー
2. `aws_access_key` (typescript, php: `awsAccessKey`; go: `AWSAccessKey`; java: `.awsAccessKey()`; csharp: `AwsClientOptions.AwsAccessKey`) + `aws_secret_key` (ruby: `aws_secret_access_key`; typescript, php: `awsSecretAccessKey`; go: `AWSSecretAccessKey`; java: `.awsSecretAccessKey()`; csharp: `AwsClientOptions.AwsSecretAccessKey`) → AWS SigV4
3. `aws_profile` (typescript, php: `awsProfile`; go: `AWSProfile`; java: `.awsProfile()`; csharp: `AwsClientOptions.AwsProfile`) → 名前付きプロファイルを使用したAWS SigV4
4. `ANTHROPIC_AWS_API_KEY`環境変数 → `x-api-key`ヘッダー
5. デフォルトのAWS認証情報プロバイダーチェーン → AWS SigV4
### リージョンの解決
`aws_region` (typescript, php: `awsRegion`; go: `AWSRegion`; java: `.region()`; csharp: `AwsClientOptions.AwsRegion`)を設定しない場合、クライアントは環境から`AWS_REGION`を読み取り、標準のAWS SDKとの互換性のために`AWS_DEFAULT_REGION`にフォールバックします。リージョンは必須であり、デフォルト値はありません。コンストラクタ引数と環境変数のいずれも設定されていない場合、`AnthropicAWS` (typescript: `AnthropicAws`; csharp: `AnthropicAwsClient`; go: `anthropicaws.NewClient`; java: `AwsBackend`; php: `Anthropic\Aws\Client`; ruby: `Anthropic::AWSClient`)はエラーを発生させます。
## SDKのインストール
Anthropicの[クライアントSDK](https://platform.claude.com/docs/ja/cli-sdks-libraries/overview)はClaude Platform on AWSをサポートしています。SDKは`AnthropicAWS` (typescript: `AnthropicAws`; csharp: `AnthropicAwsClient`; go: `anthropicaws.NewClient`; java: `AwsBackend`; php: `Anthropic\Aws\Client`; ruby: `Anthropic::AWSClient`)を提供し、SigV4署名、リージョンに基づくベースURLの構築、および`anthropic-workspace-id`ヘッダーを処理します。
```bash
pip install -U "anthropic[aws]"
```
macOSでHomebrewのPythonやその他の外部管理されたPython環境を使用している場合、`pip install`がPEP 668の`externally-managed-environment`エラーで失敗することがあります。まず仮想環境を作成して有効化してください：`python3 -m venv .venv && source .venv/bin/activate`。
```bash
npm install @anthropic-ai/aws-sdk
```
```bash
dotnet add package Anthropic.Aws
```
```bash
go get github.com/anthropics/anthropic-sdk-go
```
```kotlin Gradle
implementation("com.anthropic:anthropic-java:2.73.0")
implementation("com.anthropic:anthropic-java-aws:2.73.0")
```
```xml Maven
com.anthropic
anthropic-java
2.73.0
com.anthropic
anthropic-java-aws
2.73.0
```
```bash
composer require anthropic-ai/sdk aws/aws-sdk-php
```
```bash
gem install anthropic aws-sdk-core
```
Claude Platform on AWS向けのSDKクライアントはベータ版です。
## 利用可能なモデル
Claude Platform on AWSでは、次のモデルを利用できます：
| Model | Model ID |
| :---------------------------------------------------------------------------------------------------- | :------------------ |
| Claude Fable 5.1 | `claude-fable-5-1` |
| Claude Fable 5 | `claude-fable-5` |
| Claude Opus 5.5 | `claude-opus-5-5` |
| Claude Opus 5 | `claude-opus-5` |
| Claude Opus 4.8 | `claude-opus-4-8` |
| Claude Opus 4.7 | `claude-opus-4-7` |
| Claude Opus 4.6 | `claude-opus-4-6` |
| Claude Opus 4.5 | `claude-opus-4-5` |
| Claude Sonnet 5.5 | `claude-sonnet-5-5` |
| Claude Sonnet 5 | `claude-sonnet-5` |
| Claude Sonnet 4.6 | `claude-sonnet-4-6` |
| Claude Sonnet 4.5 ([deprecated](https://platform.claude.com/docs/ja/about-claude/model-deprecations)) | `claude-sonnet-4-5` |
| Claude Haiku 5.5 | `claude-haiku-5-5` |
| Claude Haiku 4.5 | `claude-haiku-4-5` |
モデルIDは、ファーストパーティのClaude APIと同一です。BedrockスタイルのARNや`anthropic.`プレフィックスはありません。
新しいモデルは通常、ファーストパーティのClaude APIと同じ日にClaude Platform on AWSでリリースされます。
新しいClaudeモデルにアップグレードしますか？Claude Codeで `/claude-api migrate` を実行すると、コードベース全体にモデルIDの置き換えと互換性のないパラメータ変更を適用できます。このスキルは、コードが対象としているクラウドプラットフォームを検出し、そのプラットフォームに合わせてモデルIDの形式と機能の変更を調整します。[新しいClaudeモデルへの移行](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/claude-api-skill#migrating-to-a-newer-claude-model)を参照してください。
## リクエストの送信
Claude Platform on AWSは、ファーストパーティのClaude APIと同じAPIエンドポイントを使用します。違いは、ベースURL、認証方法、およびリクエストの対象となる[ワークスペース](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#workspaces)を識別する`anthropic-workspace-id`ヘッダーです。このヘッダーは、Messages API、Models API、Files API、Claude Managed Agentsエンドポイントへの呼び出しなど、推論リクエストとリソースリクエストで必須です。[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)へのリクエストでは必要ありません。
これらの例を実行する前に、[API呼び出しを行う前に](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#before-making-api-calls)の手順を完了してください。
```bash cURL
# URLと--aws-sigv4の両方で、us-west-2をお使いのAWSリージョンに置き換えてください
# 長期的なIAMユーザー認証情報を使用する場合は、x-amz-security-tokenヘッダーを省略してください
curl "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \
--aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
-H "x-amz-security-token: $AWS_SESSION_TOKEN" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
```
```bash CLI
# us-west-2 をお使いの AWS リージョンに置き換えてください
# ant は ANTHROPIC_API_KEY を読み取り、x-api-key として送信します。キーは
# AWS Console で生成してください（APIキー認証を参照）。
export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"
ant messages create \
--base-url https://aws-external-anthropic.us-west-2.api.aws \
--workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \
--model claude-sonnet-5-5 \
--max-tokens 1024 \
--message '{role: user, content: "Hello!"}' \
--transform content
```
```python Python
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(message)
```
```typescript TypeScript
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws();
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }]
});
console.log(message);
```
```csharp C#
using Anthropic;
using Anthropic.Aws;
var client = new AnthropicAwsClient();
var message = await client.Messages.Create(new()
{
Model = Model.ClaudeSonnet5_5,
MaxTokens = 1024,
Messages = [new() { Role = Role.User, Content = "Hello!" }]
});
Console.WriteLine(message);
```
```go Go
client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})
if err != nil {
panic(err)
}
message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5_5,
MaxTokens: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
},
})
if err != nil {
panic(err)
}
fmt.Println(message)
```
```java Java
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.fromEnv())
.build();
Message message = client.messages().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5_5)
.maxTokens(1024)
.addUserMessage("Hello!")
.build()
);
IO.println(message);
}
```
```php PHP
use Anthropic\Aws\Client;
$client = new Client();
$message = $client->messages->create(
model: 'claude-sonnet-5-5',
maxTokens: 1024,
messages: [['role' => 'user', 'content' => 'Hello!']],
);
echo $message;
```
```ruby Ruby
require "anthropic"
client = Anthropic::AWSClient.new
message = client.messages.create(
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }]
)
puts message
```
クライアントは環境から`AWS_REGION`（または`AWS_DEFAULT_REGION`）と`ANTHROPIC_AWS_WORKSPACE_ID`を読み取ります。クライアントの作成時に`aws_region` (typescript, php: `awsRegion`; go: `AWSRegion`; java: `.region()`; csharp: `AwsClientOptions.AwsRegion`)または`workspace_id` (typescript, php: `workspaceId`; go: `WorkspaceID`; java: `.workspaceId()`; csharp: `AwsClientOptions.WorkspaceId`)を渡すことで、いずれも上書きできます。リージョンとワークスペースIDはどちらも必須です。いずれかを解決できない場合、コンストラクタはエラーを発生させます。
`x-amz-security-token`ヘッダー（cURL）は、IAMロール、SSO、STSなどの一時的な認証情報の場合にのみ必要です。長期的なIAMユーザーの認証情報を使用する場合は省略してください。SDKクライアントは、認証情報のソースに基づいてこれを自動的に処理します。
`--aws-sigv4`の値は`aws:amz::`の形式に従います。SigV4のサービス名は`aws-external-anthropic`であり、リージョンはエンドポイントURLのリージョンと一致する必要があります。いずれかが一致しない場合、具体的な診断ではなく、一般的な署名拒否エラーが発生します。
### コンテキストウィンドウ
Claude Platform on AWSの「context window」（コンテキストウィンドウ）のサイズは、ファーストパーティのClaude APIと同一です。モデルごとの制限については、[コンテキストウィンドウ](https://platform.claude.com/docs/ja/build-with-claude/context-windows)を参照してください。
## 機能サポート
Claude Platform on AWSはClaude APIエンドポイントを直接使用するため、ファーストパーティのClaude APIと完全な機能パリティが得られます（[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)に記載されている場合を除く）。
* **機能へのアクセス：** Anthropicが両方のプラットフォームを運用しているため、ほとんどの新機能とベータヘッダーは、別途の統合手順なしにClaude Platform on AWSで利用可能になります。例外については[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照してください。
* **ベータ機能：** Claude APIと同様に、標準の`anthropic-beta`ヘッダーを渡してベータ機能にアクセスします。
* **Agent Skills：** Claude APIと同じ`container.skills`パラメータで、事前構築済みおよびカスタムの[Agent Skills](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview)を使用できます。すべての事前構築済みSkills（PowerPoint、Excel、Word、PDF）はそのまま動作します。
* **コード実行：** [コード実行ツール](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/code-execution-tool)を使用して、Anthropicが管理するサンドボックスでコードを実行します。
* **ツール使用：** コンピュータ使用およびブラウザ使用のツールセットを除き、すべての[「tool use」（ツール使用）機能](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/overview)を利用できます。[サポートされていない機能](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照してください。
* **思考：** [適応型思考](https://platform.claude.com/docs/ja/build-with-claude/thinking)、[effortパラメータ](https://platform.claude.com/docs/ja/build-with-claude/effort)、およびサポートされているモデルでは[「extended thinking」（拡張思考）](https://platform.claude.com/docs/ja/build-with-claude/extended-thinking)が、Claude APIと同じパラメータで動作します。
* **ストリーミング：** リアルタイムレスポンスのための完全なSSEストリーミングサポート。
* **バッチ処理：** 高スループットのワークロード向けにバッチリクエストを送信します。
* **プロンプトキャッシング：** ツール、システムプロンプト、メッセージ履歴をキャッシュして、レイテンシとコストを削減します。すべての「prompt caching」（プロンプトキャッシング）機能（5分TTL、1時間TTL、自動キャッシング）が利用可能です。
* **Files API：** ファイルをアップロードし、リクエスト間で参照します。
* **顧客管理暗号化キー（CMEK）：** [CMEK](https://platform.claude.com/docs/ja/manage-claude/cmek)は[AWS KMS](https://platform.claude.com/docs/ja/manage-claude/cmek-aws-kms)キーでのみ利用可能です。Google Cloud KMSおよびAzure Key Vaultのキーは登録できません。キーは、アタッチするワークスペースと同じAWSアカウントおよびリージョンにある単一リージョンのKMSキーである必要があり、そのキーポリシーは`aws-external-anthropic.amazonaws.com`サービスプリンシパルにアクセスを付与する必要があります。[Claude Platform on AWSでのCMEKのセットアップ](https://platform.claude.com/docs/ja/manage-claude/cmek-aws-kms#claude-platform-on-aws)を参照してください。キーの登録とアタッチは[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#using-the-claude-console)で行います。外部キーエンドポイントも利用可能で、[IAMアクション](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#encryption-keys)を通じて認可されます。別途の検証手順はありません。キーはワークスペースにアタッチする際に暗黙的に検証されるため（アタッチ呼び出しが暗号化/復号のラウンドを実行します）、キーポリシーの問題は登録時ではなくアタッチ時に表面化します。
* **Compliance API：** [Compliance API](https://platform.claude.com/docs/ja/manage-claude/compliance-api)が利用可能です。アクセスはAWS IAMの[`ListComplianceActivities`アクション](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#compliance)を通じて認可されます。
Amazon Bedrockとの機能の利用可能性の違いについては、[比較表](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#claude-platform-on-aws-vs-amazon-bedrock)を参照してください。
### Claude Managed Agents
[Claude Managed Agents](https://platform.claude.com/docs/ja/managed-agents/overview)は、Claude Platform on AWSで利用できます。これには、[エージェント](https://platform.claude.com/docs/ja/managed-agents/agent-setup)、[環境](https://platform.claude.com/docs/ja/managed-agents/environments)、[セッション](https://platform.claude.com/docs/ja/managed-agents/sessions)、[スケジュールされたデプロイメント](https://platform.claude.com/docs/ja/managed-agents/scheduled-deployments)、[認証情報ボールト](https://platform.claude.com/docs/ja/managed-agents/vaults)、[メモリストア](https://platform.claude.com/docs/ja/managed-agents/memory)、[Webhook](https://platform.claude.com/docs/ja/managed-agents/webhooks)、[マルチエージェントオーケストレーション](https://platform.claude.com/docs/ja/managed-agents/multiagent-orchestration)、および[セルフホスト型サンドボックス](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes)が含まれます。
Claude Platform on AWS上のセッションとセルフホストワーカーは、ファーストパーティのClaude Managed Agentsと次の3点で異なります。
* **自律セッションの再認証：** セッションは、[ユーザーイベント](https://platform.claude.com/docs/ja/managed-agents/reference#event-types)なしで最大6時間自律的に実行できます。6時間を過ぎると、セッションは続行する前に再認証が必要になります。再認証するには、任意のユーザーロールのイベントをセッションに送信してください（[イベントとストリーミング](https://platform.claude.com/docs/ja/managed-agents/events-and-streaming)を参照）。ファーストパーティのClaude Managed Agentsには自律セッションの実行時間制限はありません。
* **[セルフホスト環境でのメモリストア](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes-memory)：** セルフホスト環境で実行されるセッションはメモリストアをアタッチできません。メモリストアを含むセッションは作成時に拒否されます。クラウド環境のセッションは通常どおりメモリストアをアタッチできます。ファーストパーティのClaude Managed Agentsでは、クラウド環境とセルフホスト環境の両方のセッションでメモリストアをアタッチできます。
* **[セルフホスト環境でのワーカー認証](https://platform.claude.com/docs/ja/managed-agents/self-hosted-sandboxes#prerequisites)：** ワーカーは、環境キーではなく、AWS IAM（SigV4）または[AWS Consoleで生成したAPIキー](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#api-key-authentication)で認証します。Claude Consoleで生成した環境キーは、Claude Platform on AWSのエンドポイントでは機能しません。
### サポートされていない機能
次の機能は現在Claude Platform on AWSでは利用できません。
* **HIPAA対応：** AnthropicのHIPAA対応プログラムは利用できません。[APIとデータ保持](https://platform.claude.com/docs/ja/manage-claude/api-and-data-retention)を参照してください。
* **コンピュータ使用およびブラウザ使用のツールセット：** `computer_toolset_20260801`と`browser_toolset_20260801`は、現在Claude Platform on AWSでは利用できません。ベータ版のコンピュータ使用ツールのバージョンは、[以前のツールバージョン](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions)に記載されているモデルで引き続き利用できます。
- **Admin API：** ワークスペースエンドポイント（`/v1/organizations/workspaces`に対する作成、取得、一覧表示、更新、アーカイブ）、外部キーエンドポイント（[CMEK](https://platform.claude.com/docs/ja/manage-claude/cmek)用の`/v1/organizations/external_keys`に対する登録、取得、一覧表示、更新、削除。キーは検証エンドポイントではなく、ワークスペースにアタッチされた時点で検証されます）、および[テレメトリ送信先エンドポイント](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#telemetry-destinations)は利用できます。その他のAdmin APIエンドポイント（組織メンバー、ワークスペースメンバー、招待、APIキー、使用量レポート、コストレポート、レート制限レポート）は現在利用できません。代わりに[Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#using-the-claude-console)で使用量とコストのデータを確認してください。組織のメンバーシップはAWS IAMが管理します。
- **ワークスペースメンバー管理：** 個々のワークスペースへのユーザーの追加または削除は利用できません。ワークスペースARNに対するAWS IAMポリシーがアクセスを制御します。
- **Claude CodeワークスペースとAnalytics API：** 自動レート制限付きのClaude Codeワークスペースは利用できません。Claude Codeの使用量は専用画面ではなく一般的な使用量ビューに表示されます。
- **OAuth認証：** サポートされていません。SigV4またはAPIキー認証を使用してください。
- **Fastモード：** Claude Platform on AWSでは利用できません。
- **OpenAI互換APIエンドポイント：** Claude Platform on AWSでは利用できません。
- **MCPトンネル：** パブリックインターネット上に公開されているMCPサーバーのみがサポートされます。
## データレジデンシー
Claude Platform on AWSは、以下の「inference geography」（推論ジオグラフィ）をサポートしています。
* **US：** 推論は米国のデータセンター内に留まります。1.1倍の料金乗数が適用されます。
* **Global：** 推論は世界中のAnthropicが運用する任意のデータセンターにルーティングされる可能性があります。標準料金が適用されます。
ワークスペースがバインドされているAWSリージョンは、呼び出すゲートウェイエンドポイントと、AWS側のリソース（IAM、CloudTrail、請求）のスコープを決定します。モデル推論が実行される場所を固定するものではありません。推論を特定のジオグラフィに固定するには、各リクエストで`inference_geo`を設定するか、ワークスペースのデフォルトを構成してください。
`inference_geo`パラメータを使用して、リクエストごとに推論ジオグラフィを設定します。
`inference_geo`パラメータは、Claude 4.6以降のモデルでサポートされています。Claude Opus 4.5、Claude Sonnet 4.5（非推奨）、またはClaude Haiku 4.5で`inference_geo`を指定したリクエストは、400エラーを返します。モデルの利用可能性の詳細については、[データレジデンシー](https://platform.claude.com/docs/ja/manage-claude/data-residency)を参照してください。
```bash cURL
# URLと--aws-sigv4の両方で、us-west-2をご利用のAWSリージョンに置き換えてください
# 長期的なIAMユーザー認証情報を使用する場合は、x-amz-security-tokenヘッダーを省略してください
curl "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \
--aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
-H "x-amz-security-token: $AWS_SESSION_TOKEN" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"inference_geo": "us",
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
```
```bash CLI
# us-west-2 をお使いの AWS リージョンに置き換えてください
# ant は ANTHROPIC_API_KEY を読み取り、x-api-key として送信します。キーは
# AWS Console で生成してください（APIキー認証を参照）。
export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"
ant messages create \
--base-url https://aws-external-anthropic.us-west-2.api.aws \
--workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \
--model claude-sonnet-5-5 \
--max-tokens 1024 \
--inference-geo us \
--message '{role: user, content: "Hello!"}' \
--transform content
```
```python Python
from anthropic import AnthropicAWS
client = AnthropicAWS()
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=1024,
inference_geo="us",
messages=[{"role": "user", "content": "Hello!"}],
)
print(message)
```
```typescript TypeScript
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws();
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
inference_geo: "us",
messages: [{ role: "user", content: "Hello!" }]
});
console.log(message);
```
```csharp C#
using Anthropic;
using Anthropic.Aws;
var client = new AnthropicAwsClient();
var message = await client.Messages.Create(new()
{
Model = Model.ClaudeSonnet5_5,
MaxTokens = 1024,
InferenceGeo = "us",
Messages = [new() { Role = Role.User, Content = "Hello!" }]
});
Console.WriteLine(message);
```
```go Go
client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})
if err != nil {
panic(err)
}
message, err := client.Messages.New(context.Background(), anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5_5,
MaxTokens: 1024,
InferenceGeo: anthropic.String("us"),
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
},
})
if err != nil {
panic(err)
}
fmt.Println(message)
```
```java Java
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.fromEnv())
.build();
Message message = client.messages().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5_5)
.maxTokens(1024)
.inferenceGeo("us")
.addUserMessage("Hello!")
.build()
);
IO.println(message);
}
```
```php PHP
use Anthropic\Aws\Client;
$client = new Client();
$message = $client->messages->create(
model: 'claude-sonnet-5-5',
maxTokens: 1024,
inferenceGeo: 'us',
messages: [['role' => 'user', 'content' => 'Hello!']],
);
echo $message;
```
```ruby Ruby
require "anthropic"
client = Anthropic::AWSClient.new
message = client.messages.create(
model: "claude-sonnet-5-5",
max_tokens: 1024,
inference_geo: "us",
messages: [{ role: "user", content: "Hello!" }]
)
puts message
```
`inference_geo`を省略した場合、リクエストはワークスペースの`default_inference_geo`が構成されていればそれを使用し、構成されていなければ`global`を使用します。
ワークスペースレベルの推論ジオグラフィ制御（`allowed_inference_geos`と`default_inference_geo`）も、Claude Platform on AWSで利用できます。[ワークスペースレベルの制限](https://platform.claude.com/docs/ja/manage-claude/data-residency#workspace-level-restrictions)を参照してください。
## ワークスペース
Claude Platform on AWSでの推論リクエストおよびリソースリクエストは、ワークスペースを対象とします。これらのAPI呼び出しでは、`anthropic-workspace-id`ヘッダーにワークスペースのIDを渡します。ワークスペースIDは、`wrkspc_`の後に英数字の識別子が続くタグ付き形式を使用します（例：`wrkspc_01AbCdEf23GhIj`）。まだIDをお持ちでない場合は、[ワークスペースIDを取得する](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#obtain-your-workspace-id)を参照してください。
### ワークスペースのスコープ
ワークスペースは単一のAWSリージョンにバインドされます。`us-west-2`で作成されたワークスペースは、`us-west-2`エンドポイントを通じてのみアクセスできます。使用量、クォータ、コスト、ファイル、バッチ、Skillsはすべてワークスペースごとに集計されるため、Claude Consoleでリージョンごとの内訳を確認できます。
ワークスペースは、Claude Platform on AWSの主要なIAMリソースとしても機能します。ワークスペースARNを使用したAWS IAMポリシーを通じて、特定のワークスペースへのアクセスを許可または拒否します。ARNのリソースセグメントは、`anthropic-workspace-id`ヘッダーに渡すものと同じ`wrkspc_`プレフィックス付きのIDです。
```text wrap
arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}
```
例：
```text wrap
arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj
```
ポリシーの例については、[IAMポリシー](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#iam-policies)を参照してください。
### ワークスペースの管理
AWS Consoleの**Workspaces**ページ、または[Admin API](https://platform.claude.com/docs/ja/manage-claude/admin-api)のワークスペースエンドポイントから、追加のワークスペースの作成、ワークスペースの名前変更、ワークスペースのアーカイブを行えます。これらのエンドポイントには`anthropic-workspace-id`ヘッダーは不要です。作成と一覧表示は組織に対して動作し、取得、更新、アーカイブはURLパスでワークスペースIDを受け取ります。新しいワークスペースは、作成時に呼び出したエンドポイントのAWSリージョンにバインドされます（[ワークスペースのスコープ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#workspace-scoping)を参照）。Adminロールがあれば、Claude Consoleの**Workspaces**ページからもワークスペースの作成、名前変更、アーカイブを行えます。
## Claude Consoleの使用
Claude Platform on AWSは、[platform.claude.com](https://platform.claude.com)にある標準のClaude Consoleを使用します。AWS Consoleからサインインすると、Claude Consoleサイドバーの左下に**Account managed by AWS**インジケーターが表示され、ConsoleのスコープがClaude Platform on AWS組織に設定されます。使用量分析、コストの内訳、レート制限の可視化、ワークスペース管理に加え、ファイル、Agent Skills、バッチジョブ、Claude Managed Agentsリソース（エージェント、セッション、環境、認証情報ボールト、メモリストア、Webhook）を管理するためのページを提供します。
### サインイン
Claude Consoleへのアクセスは、AWS IAMを通じてフェデレーションされます。初回サインインの完全なフローについては、[アカウントをセットアップする](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#set-up-your-account)を参照してください。要約すると次のとおりです。
1. `aws-external-anthropic:AssumeConsole`権限を持つIAMロールを引き受けます。[Claude Platform on AWSのIAMアクション](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#console-access)を参照してください。
2. [AWS Console](https://console.aws.amazon.com/)でClaude Platform on AWSのページに移動します。
3. **Open Claude Console**を選択します。AWS ConsoleがJWTを発行し、`platform.claude.com`にリダイレクトします。
4. 初回サインイン時に、メールアドレスの入力を求められます。業務用メールアドレスを入力してください。プラットフォームがClaude Consoleユーザーをジャストインタイムでプロビジョニングします。
Claude Consoleのロールは、**Admin**と**Developer**の2つが利用できます。Adminロールは、Claude Platform on AWSで利用可能なすべてのClaude Consoleページと設定へのアクセスを付与します。Developerロールは、使用量、コスト、レート制限、ワークスペース情報への読み取りアクセスを付与します。プリンシパルにAdminまたはDeveloperロールを割り当てるには、Anthropicのアカウント担当者にお問い合わせください。
### 利用可能なページ
**AWSゲートウェイ経由**列は、そのページがAWSゲートウェイを通じてデータを読み書きするかどうか（したがって[IAMアクション](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions)によって管理されるかどうか）を示します。**いいえ**と記載されたページは、組織レベルのメタデータをAnthropicから直接読み取り、IAMアクションのチェックをバイパスします。
| ページ | 利用可否 | AWSゲートウェイ経由 | 備考 |
| --------------------- | -------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Usage** | はい | いいえ | モデル、ワークスペース、ディメンション別のトークン使用量を表示します。リクエスト後、データが表示されるまで数分かかる場合があります。 |
| **Cost** | はい | いいえ | モデルおよびワークスペース別のコストの内訳を表示します。AWS Cost Explorerには、集計された[Claude Consumption Unit（CCU）](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#billing)の明細項目が表示されます。 |
| **Rate limits** | はい | いいえ | レート制限を表示します（読み取り専用）。ティアの引き上げはAnthropicのアカウント担当者を通じて行われます。[レート制限とクォータ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)を参照してください。 |
| **Workspaces** | はい | はい（支出制限を除く） | リージョンごとのワークスペースを表示します。Adminロールがあれば、ワークスペースの作成、名前変更、アーカイブ、およびワークスペースごとの[支出制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#spend-limits)の設定も行えます。 |
| **Encryption keys** | はい | はい | Claude Consoleの[Data retention](https://platform.claude.com/settings/privacy#encryption-keys)ページ（`platform.claude.com/settings/privacy`）内のセクションで、ページ上部のドロップダウンメニューで**Organization**が選択されているときに表示されます。そこで[CMEK](https://platform.claude.com/docs/ja/manage-claude/cmek-aws-kms#claude-platform-on-aws)用のAWS KMSキーを登録します（Adminロール）。登録済みのキーをワークスペースにアタッチするには、そのドロップダウンメニューからワークスペースを選択し、**Encryption key**でキーを選択します。 |
| **Files** | はい | はい | アップロードされたファイルを表示および管理します。 |
| **Skills** | はい | はい | Agent Skillsを表示および管理します。 |
| **Batches** | はい | はい | バッチ処理ジョブを表示および管理します。 |
| **Agents** | はい | はい | エージェント定義を表示および管理します。 |
| **Sessions** | はい | はい | エージェントセッションとイベント履歴を表示します。 |
| **Environments** | はい | はい | セッション用のクラウドサンドボックス構成を表示および管理します。 |
| **Credential vaults** | はい | はい | セッション認証用の認証情報ボールトを表示および管理します。 |
| **Memory stores** | はい | はい | 永続的なエージェントメモリを表示および管理します。 |
| **Webhooks** | はい | はい | Webhookエンドポイントを表示および管理します。 |
| **API keys** | いいえ | 該当なし | AWS Console（**Claude Platform on AWS → API keys**）でAPIキーを管理します。[APIキー認証](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#api-key-authentication)を参照してください。 |
| **Members** | いいえ | 該当なし | 該当なし。AWS IAMがアクセスを管理します。 |
| **Billing** | はい（制限付き） | いいえ | 組織の月間支出制限を設定します。[支出制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#spend-limits)を参照してください。請求書の発行はAWS Marketplaceが管理します。コストの内訳はCostページで確認します。 |
| **Claude Code** | いいえ | 該当なし | Claude Codeの使用量はUsageページで確認します。 |
### 組織の切り替え
Claude Consoleは、Claude Platform on AWSでの組織の切り替えをサポートしていません。別の組織にアクセスするには、サインアウトし、その組織のAWSアカウント用のIAMロールを使用してAWS Console経由で再認証してください。
## レート制限とクォータ
Claude Platform on AWSの組織は、Startティアに配置されます。Anthropicは、AWSのクォータシステムを通じてではなく、レート制限を直接管理します。
Claude Platform on AWSの組織は、支払い済みのAWS Marketplace請求書の履歴が蓄積されるにつれて、自動的に上位の使用量ティアに移行できます。Claude Consoleのセルフサービスの**Request tier increase**フローは利用できません。代わりに、Rate limitsページではAnthropicのアカウント担当者に問い合わせるよう案内されます。
より高い制限をリクエストするには、Anthropicのアカウント担当者または[Anthropicサポート](https://support.claude.com)にお問い合わせください。リクエストには以下を含めてください。
* 引き上げが必要なモデル
* 各モデルの1分あたりのピーク入力トークン数と1分あたりのピーク出力トークン数（1日の合計ではありません）
* 入力のうち、キャッシュされたコンテキストまたは繰り返しのコンテキストが占めるおおよその割合（ほとんどのモデルでは、キャッシュ読み取りは入力トークン制限にカウントされません。[キャッシュ対応ITPM](https://platform.claude.com/docs/ja/api/rate-limits#cache-aware-itpm)を参照してください）
使用量ティアは固定された段階です。各ティアはレート制限と[月間支出上限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#spend-limits)を組み合わせたもので、上位のティアに移行すると両方が引き上げられます。ティアの詳細とモデルごとの制限については、[レート制限](https://platform.claude.com/docs/ja/api/rate-limits)を参照してください。
## 請求
Claude Platform on AWSは、[AWS Marketplace](https://aws.amazon.com/marketplace)を通じて請求されます。使用量はClaude Consumption Unit（CCU）建てで、1時間ごとに計測され、AWSの請求書で毎月後払いで請求されます。CCUはプリペイドクレジットではありません。CCUの残高やコミットメントはありません。
CCUの価格、換算の仕組み、割引の適用、モデルごとのトークンレートについては、[Claude Platform on AWSの価格](https://platform.claude.com/docs/ja/about-claude/pricing#claude-platform-on-aws-pricing)を参照してください。
### 支出制限
Start、Build、Scaleの各使用量ティアには月間支出上限があります。現在の値については、[ティアごとの支出上限](https://platform.claude.com/docs/ja/api/rate-limits#spend-limits)を参照してください。組織の暦月の使用量がそのティアの上限に達すると、翌月1日の00:00 UTCまでAPIリクエストは[支出上限エラー](https://platform.claude.com/docs/ja/api/rate-limits#reaching-your-spend-cap)で失敗し、それより前に再試行しても成功しません。支出上限とレート制限は同じティアに属します。上限を引き上げる場合、または上限到達後にアクセスを回復する場合は、Anthropicのアカウント担当者または[Anthropicサポート](https://support.claude.com)を通じてティアの引き上げをリクエストしてください（[レート制限とクォータ](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)を参照）。
Billingページの**Email recipients**に少なくとも1人の受信者を追加した後、上限を下回る独自の月間支出制限を設定することもできます。
* **組織の支出制限:** [Claude Console](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#using-the-claude-console)の[Settings > Billing](https://platform.claude.com/settings/billing)に移動して、月間支出制限を設定します。
* **ワークスペースの支出制限:** Claude Consoleの[Workspaces](https://platform.claude.com/settings/workspaces)ページ（`platform.claude.com/settings/workspaces`）でワークスペースを選択します。開いたパネルで**Spend limits**をクリックします。
使用量が設定した制限に達すると、翌月1日の00:00 UTCまで、または制限を引き上げるか削除するまで、リクエストはHTTP 400で失敗します（[支出制限エラー](https://platform.claude.com/docs/ja/api/rate-limits#setting-your-own-spend-limit)を参照）。
支出は定価で計算され、直近の使用量が反映されるまで約2時間かかる場合があるため、リクエストが失敗し始める前に使用量が上限または制限を超える可能性があります。超過分は請求されます。ティアの上限または組織の支出制限によってリクエストが停止されると、Billingページの**Email recipients**に記載された受信者にメール通知が送信されます。すべての管理者などのロールベースの受信者は、Claude Platform on AWSでは利用できません。ティア上限の通知は、AWS Marketplaceのサインアップ時に使用したメールアドレスにも送信されます。
## モニタリングとロギング
AWS CloudTrailは、Claude Platform on AWSへのすべてのリクエストをキャプチャできます。ワークスペース、外部キー、テレメトリ送信先、コンプライアンス、ボールト、Webhookの操作は、デフォルトで管理イベントとしてログに記録されます。推論、バッチ、ファイル、スキル、モデル、ユーザープロファイル、およびClaude Managed Agentsの操作（ボールトとWebhookを除く）はデータイベントに分類され、明示的なデータイベントロギングの設定が必要です。これにはCloudTrailの追加料金が発生します。イベントタイプの完全な分類については[IAMアクションリファレンス](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#route-to-action-mapping)を、設定の詳細については[AWS CloudTrailのドキュメント](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。
### リクエストID
各レスポンスには、レスポンスヘッダーに2つのリクエストIDが含まれます。
* **AWSリクエストID（`x-amzn-requestid`）:** プライマリIDで、CloudTrailでインデックス化されます。AWSツールを通じてリクエストを調査する場合、またはAWSサポートに問い合わせる場合に使用します。
* **AnthropicリクエストID（`request-id`）:** セカンダリIDです。Anthropicサポートに問い合わせる場合に使用します。
```bash cURL
# URLと--aws-sigv4の両方でus-west-2をお使いのAWSリージョンに置き換えてください
# -iはレスポンスヘッダーを出力に含めます
# 長期IAMユーザー認証情報を使用する場合はx-amz-security-tokenヘッダーを省略してください
curl -i "https://aws-external-anthropic.us-west-2.api.aws/v1/messages" \
--aws-sigv4 "aws:amz:us-west-2:aws-external-anthropic" \
--user "$AWS_ACCESS_KEY_ID:$AWS_SECRET_ACCESS_KEY" \
-H "x-amz-security-token: $AWS_SESSION_TOKEN" \
-H "content-type: application/json" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-workspace-id: $ANTHROPIC_AWS_WORKSPACE_ID" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello!"}
]
}'
```
```bash CLI
# us-west-2 をお使いの AWS リージョンに置き換えてください
# ant は ANTHROPIC_API_KEY を読み取り、x-api-key として送信します。キーは
# AWS Console で生成してください（APIキー認証を参照）。
export ANTHROPIC_API_KEY="YOUR_AWS_API_KEY"
# --debug は X-Amzn-Requestid ヘッダーと
# Request-Id ヘッダーを含む HTTP レスポンスを stderr に出力します
ant --debug messages create \
--base-url https://aws-external-anthropic.us-west-2.api.aws \
--workspace-id "$ANTHROPIC_AWS_WORKSPACE_ID" \
--model claude-sonnet-5-5 \
--max-tokens 1024 \
--message '{role: user, content: "Hello!"}'
```
```python Python
from anthropic import AnthropicAWS
client = AnthropicAWS()
response = client.messages.with_raw_response.create(
model="claude-sonnet-5-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Hello!"}],
)
print(response.headers.get("x-amzn-requestid")) # AWS request ID
print(response.headers.get("request-id")) # Anthropic request ID
message = response.parse()
print(message.content)
```
```typescript TypeScript
import AnthropicAws from "@anthropic-ai/aws-sdk";
const client = new AnthropicAws();
const { data: message, response } = await client.messages
.create({
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }]
})
.withResponse();
console.log(response.headers.get("x-amzn-requestid")); // AWS request ID
console.log(response.headers.get("request-id")); // Anthropic request ID
console.log(message.content);
```
```csharp C#
using Anthropic;
using Anthropic.Aws;
var client = new AnthropicAwsClient();
var response = await client.WithRawResponse.Messages.Create(new()
{
Model = Model.ClaudeSonnet5_5,
MaxTokens = 1024,
Messages = [new() { Role = Role.User, Content = "Hello!" }]
});
Console.WriteLine(response.Headers.GetValues("x-amzn-requestid").First()); // AWS request ID
Console.WriteLine(response.Headers.GetValues("request-id").First()); // Anthropic request ID
Console.WriteLine(response.Value.Content);
```
```go Go
client, err := anthropicaws.NewClient(context.Background(), anthropicaws.ClientConfig{})
if err != nil {
panic(err)
}
var response *http.Response
message, err := client.Messages.New(
context.Background(),
anthropic.MessageNewParams{
Model: anthropic.ModelClaudeSonnet5_5,
MaxTokens: 1024,
Messages: []anthropic.MessageParam{
anthropic.NewUserMessage(anthropic.NewTextBlock("Hello!")),
},
},
option.WithResponseInto(&response),
)
if err != nil {
panic(err)
}
fmt.Println(response.Header.Get("x-amzn-requestid")) // AWS request ID
fmt.Println(response.Header.Get("request-id")) // Anthropic request ID
fmt.Println(message.Content)
```
```java Java
import com.anthropic.aws.backends.AwsBackend;
import com.anthropic.client.AnthropicClient;
import com.anthropic.client.okhttp.AnthropicOkHttpClient;
import com.anthropic.core.http.HttpResponseFor;
import com.anthropic.models.messages.Message;
import com.anthropic.models.messages.MessageCreateParams;
import com.anthropic.models.messages.Model;
void main() {
AnthropicClient client = AnthropicOkHttpClient.builder()
.backend(AwsBackend.fromEnv())
.build();
HttpResponseFor response = client.messages().withRawResponse().create(
MessageCreateParams.builder()
.model(Model.CLAUDE_SONNET_5_5)
.maxTokens(1024)
.addUserMessage("Hello!")
.build()
);
IO.println(response.headers().values("x-amzn-requestid").get(0)); // AWS request ID
IO.println(response.requestId().orElse(null)); // Anthropic request ID
IO.println(response.parse().content());
}
```
```php PHP
use Anthropic\Aws\Client;
$client = new Client();
$response = $client->messages->raw->create(
model: 'claude-sonnet-5-5',
maxTokens: 1024,
messages: [['role' => 'user', 'content' => 'Hello!']],
);
echo $response->getHeaderLine('x-amzn-requestid') . "\n"; // AWS request ID
echo $response->getHeaderLine('request-id') . "\n"; // Anthropic request ID
echo $response->parse()->content;
```
```ruby Ruby
require "anthropic"
client = Anthropic::AWSClient.new
# レスポンスヘッダーはリクエストごとのミドルウェアで読み取ります。ミドルウェアは
# SDK が解析する前の生の HTTP レスポンスを受け取ります
aws_request_id = nil
anthropic_request_id = nil
read_request_ids = lambda do |request, call_next|
response = call_next.call(request)
# response.headers のキーは小文字です
aws_request_id = response.headers["x-amzn-requestid"]
anthropic_request_id = response.headers["request-id"]
response
end
message = client.messages.create(
model: "claude-sonnet-5-5",
max_tokens: 1024,
messages: [{ role: "user", content: "Hello!" }],
request_options: { middleware: [read_request_ids] }
)
puts aws_request_id # AWS request ID
puts anthropic_request_id # Anthropic request ID
puts message.content
```
Anthropicは、使用パターンを把握し問題を調査するために、少なくとも30日間のローリングベースでアクティビティをログに記録することを推奨します。
AWS CloudTrailはお客様のAWSアカウント内で構成されます。ロギングを有効にしても、請求およびサービス運用に必要な範囲を超えて、AWSまたはAnthropicがお客様のコンテンツにアクセスできるようになることはありません。
## Amazon Bedrockからの移行
現在BedrockでClaudeを使用している場合、Claude Platform on AWSへの移行にはインテグレーション全体にわたる変更が必要です。SigV4署名は引き続きサポートされますが、署名コンテキスト、ベースURL、API形式、モデルID、SDKクライアントとパッケージ、ストリーミング形式、リクエストヘッダー、リージョンの利用可否がすべて変わります。また、Claude Platform on AWSは新しいAnthropic組織をプロビジョニングします。以下の表に相違点をまとめます。
### 変更点
移行に伴う差分は、移行元のBedrock統合によって異なります。以下の表は、[現在のBedrock統合](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)（`bedrock-mantle.{region}.api.aws`のMessages API）と[レガシーのInvokeModel統合](https://platform.claude.com/docs/ja/build-with-claude/claude-on-amazon-bedrock-legacy)の両方を示しています。
| 項目 | [Claude in Amazon Bedrock](https://platform.claude.com/docs/ja/build-with-claude/claude-in-amazon-bedrock)から | [Amazon Bedrock（Opus 4.6以前）](https://platform.claude.com/docs/ja/build-with-claude/claude-on-amazon-bedrock-legacy)から | Claude Platform on AWSへ |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **ベースURL** | `bedrock-mantle.{region}.api.aws` | `bedrock-runtime.{region}.amazonaws.com` | `aws-external-anthropic.{region}.api.aws` |
| **API形式** | `/anthropic/v1/messages`のMessages API | Bedrock Converse / InvokeModel | Claude API（`/v1/{endpoint}`） |
| **モデルID** | anthropic.claude-haiku-4-5 | anthropic.claude-haiku-4-5-20251001-v1:0（`us.`または`global.`の推論プロファイルプレフィックス付き） | claude-haiku-4-5 |
| **SDKクライアント** | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK | プラットフォーム固有のクライアント（[SDKをインストールする](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#install-an-sdk)を参照）、ベータ版 |
| **SDKパッケージ** | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`) | `anthropic[bedrock]` (typescript: `@anthropic-ai/bedrock-sdk`; csharp: `Anthropic.Bedrock`; go: `github.com/anthropics/anthropic-sdk-go/bedrock`; java: `com.anthropic:anthropic-java-bedrock`; php: `anthropic-ai/sdk`; ruby: `anthropic`)、またはAWS SDK | `anthropic[aws]` (typescript: `@anthropic-ai/aws-sdk`; csharp: `Anthropic.Aws`; go: `github.com/anthropics/anthropic-sdk-go/aws`; java: `com.anthropic:anthropic-java-aws`; php: `anthropic-ai/sdk`; ruby: `anthropic`)（[SDKをインストールする](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#install-an-sdk)を参照） |
| **SigV4サービス名** | `bedrock-mantle` | `bedrock` | `aws-external-anthropic` |
| **ストリーミング形式** | SSE | AWS EventStream | SSE（Claude APIと同じ） |
| **ワークスペースヘッダー** | 該当なし | 該当なし | `anthropic-workspace-id`、推論リクエストとリソースリクエストで必須 |
| **リージョンの利用可能性** | [Amazon Bedrockのリージョン](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html)を参照 | [Amazon Bedrockのリージョン](https://docs.aws.amazon.com/bedrock/latest/userguide/bedrock-regions.html)を参照 | すべてのAWS商用リージョン |
| **Anthropic組織** | 不要 | 不要 | サインアップ時に新しい組織が作成されます。既存の組織は変換できません（[既存のAnthropic組織からの移行](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#moving-from-an-existing-anthropic-organization)を参照） |
現在のBedrock統合を使用している場合、リクエストボディの形式はすでにMessages APIです。変更点は、ベースURL、SigV4サービス名、モデルID、および`anthropic-workspace-id`ヘッダーの追加です。レガシーのInvokeModelまたはConverse APIを使用している場合は、リクエストとレスポンスの形状もMessages API形式に書き換える必要があります。リクエスト形状の対応については、[Claude on Amazon Bedrock（Opus 4.6以前）](https://platform.claude.com/docs/ja/build-with-claude/claude-on-amazon-bedrock-legacy)を参照してください。
### 得られるメリット
* 新しいモデルと機能への通常は同日のアクセス（[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照）
* ドキュメント生成用のAgent Skills（PowerPoint、Excel、Word、PDF）
* Anthropicのマネージドサンドボックスでのコード実行
* `anthropic-beta`ヘッダーを通じた、Amazon Bedrockでは提供されていないClaude APIのベータ機能（[機能の制限](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#features-not-supported)を参照）
* クォータの可視化と使用量分析のためのClaude Console
* Anthropicによる直接サポート
* SigV4の代替としてのAPIキー認証（[APIキー認証](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#api-key-authentication)を参照）
### 変わらないもの
* AWS IAM認証（SigV4）
* 請求書発行者としてのAWS。請求チャネルはネイティブのAWSサービスからAWS Marketplaceに変わります（[商業上の考慮事項](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#commercial-considerations)を参照）。
* AWSコミットメントの消化
### 移行時の落とし穴
**最初にアウトバウンドWeb IDフェデレーションを有効にしてください。** AWSアカウントでこれまでClaude Platform on AWSを使用したことがない場合、リクエストを行う前にアカウントごとに1回、[アウトバウンドWeb IDフェデレーションを有効にする](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)必要があります。この手順を行わないと、すべてのリクエストがフェデレーションエラーで失敗します（正確なエラーと対処方法については、[アウトバウンドWeb IDフェデレーションを有効にする](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)を参照してください）。この手順はBedrockでは不要です。
**Zero Data Retention（ZDR）はClaude Platform on AWSではオプトインです。** Bedrockでは、AWSがデータ処理者であり、Anthropicは推論の入力や出力を保持しません。AnthropicのZDRプログラムはそこには適用されません。Claude Platform on AWSでは、Anthropicが独立したデータ処理者として推論データを処理し、ZDRはファーストパーティのClaude APIのモデルに従います。つまり、Anthropicのアカウント担当者を通じてリクエストに応じて利用できます。データ保持の保証に依存する本番ワークロードを移行する前に、ZDRへの登録を確認してください。
### 商業上の考慮事項
* **Anthropicの利用規約:** Claude Platform on AWSを使用するには、AnthropicのCommercial Terms of ServiceおよびUsage Policyに同意する必要があります。組織がまだこれらに同意していない場合（たとえば、Bedrock経由でのみClaudeを使用してきた場合）、アカウントのセットアップ中に同意を求められます。[アカウントをセットアップする](https://platform.claude.com/docs/ja/build-with-claude/claude-platform-on-aws#set-up-your-account)を参照してください。
* **割引とプライベートオファー:** 交渉済みの割引やAWS Marketplaceのプライベートオファーは、BedrockとClaude Platform on AWSの間で自動的には引き継がれません。Anthropicのアカウント担当者と協力して、Claude Platform on AWSの商業条件を設定してください。
## IAMポリシー
Claude Platform on AWSは、アクセス制御のためにAWS IAMと統合されています。標準のIAMポリシー構文を使用して、特定のワークスペースに対する特定のAPIアクションへのアクセスを許可または拒否します。
SigV4サービス名およびIAMアクションの名前空間は`aws-external-anthropic`です。アクションは`aws-external-anthropic:`のパターンに従います（例：`aws-external-anthropic:CreateInference`）。
### 例：バッチ推論を拒否する
以下のポリシーは、リアルタイム推論を許可しつつ、バッチ処理をブロックします。
```json
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"aws-external-anthropic:CreateInference",
"aws-external-anthropic:CountTokens",
"aws-external-anthropic:GetModel",
"aws-external-anthropic:ListModels",
"aws-external-anthropic:GetWorkspace"
],
"Resource": "arn:aws:aws-external-anthropic:*:*:workspace/*"
},
{
"Effect": "Allow",
"Action": "aws-external-anthropic:ListWorkspaces",
"Resource": "*"
},
{
"Effect": "Deny",
"Action": [
"aws-external-anthropic:CreateBatchInference",
"aws-external-anthropic:GetBatchInference",
"aws-external-anthropic:ListBatchInferences"
],
"Resource": "*"
}
]
}
```
`GetBatchInference`アクションは、バッチメタデータのルートとバッチ結果のルートの両方を認可します。これを拒否すると、両方の読み取りがブロックされます。ZDRに敏感なワークロードに適したDenyのみのポリシーについては、[ZDRに敏感なワークスペースの機能ロックダウン](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#feature-lockdown-for-a-zdr-sensitive-workspace)を参照してください。
`ListWorkspaces`はアカウントスコープであるため、`"Resource": "*"`を指定した別のAllowステートメントに記述されています。アカウントスコープのアクションにワークスペースARNを指定しても効果はありません（[プロビジョニングの自動化](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#provisioning-automation)を参照）。
このポリシーはAWS SigV4認証を前提としています。プリンシパルがAPIキーで認証する場合は、`"Resource": "*"`のAllowステートメントに`aws-external-anthropic:CallWithBearerToken`も追加してください。`CallWithBearerToken`は、ワークスペースARNにバインドされない、ルートを持たない認証レイヤーのアクションです。2つのステートメントを使用するパターンについては、[顧客ごとのワークスペース分離](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#per-customer-workspace-isolation)を参照してください。
### マネージドポリシー
AWSは、一般的なアクセスパターン向けに5つのマネージドポリシー（`AnthropicFullAccess`、`AnthropicReadOnlyAccess`、`AnthropicInferenceAccess`、`AnthropicLimitedAccess`、`AnthropicSelfHostedEnvironmentAccess`）を提供しています。各ポリシーが付与するアクション、IAMアクションの完全なリスト、ルートからアクションへのマッピング、および追加のポリシー例については、[Claude Platform on AWSのIAMアクション](https://platform.claude.com/docs/ja/api/claude-platform-on-aws-iam-actions#managed-policies)を参照してください。
## 次のステップ
Claudeの高度な機能と能力を探索します。
Claude Platform on AWSの価格とClaude Consumption Unitのレートについて学びます。
より安全で高性能なモデルがリリースされるにつれ、Anthropicは定期的に古いモデルを廃止します。すべてのAPIの非推奨と、推奨される代替モデルを確認してください。
## 追加リソース
Claude Consoleで使用量、コスト、ワークスペースを確認します。AWS Console経由でサインインしてください。
AWSを唯一のデータ処理者とする必要がある場合は、AWSが運用するClaudeを使用してください。
AWS Marketplaceのサブスクリプションと請求を管理します。