---
title: Claude Platform on AWS
url: https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws
description: 透過 AWS 以 Anthropic 管理的基礎設施存取 Claude 的完整平台功能。
---
Claude Platform on AWS 為您提供完整的 Anthropic 平台體驗，包括 Messages API、Agent Skills、程式碼執行以及 beta 功能，皆可透過您的 AWS 帳戶存取。與由 AWS 營運推論堆疊的 [Amazon Bedrock](https://platform.claude.com/docs/zh-TW/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 依據 Marketplace 模式處理帳單和身分中繼資料。透過 Claude Platform on AWS 使用 Claude 的客戶須遵守 Anthropic 的[資料使用條款](https://www.anthropic.com/legal)。
Anthropic 使用 AWS 基礎設施來處理您的 API 請求、執行模型推論，並儲存您的「workspace」（工作區）內容（例如提示、輸出、檔案、Skills 和批次）。對於在 2026 年 9 月 18 日 00:00 UTC 之前建立的工作區，Anthropic 可能會在 AWS 之外處理請求、儲存資料和執行推論。無論哪種情況，子服務都可能在未經通知的情況下變更。請針對每個請求設定 [`inference_geo`](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-in-amazon-bedrock) | [Amazon Bedrock（Opus 4.6 及更早版本）](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)） | 依 Amazon Bedrock 發布時程 | 依 Amazon Bedrock 發布時程 |
| **Agent Skills** | 可用 | 不可用（需要程式碼執行） | 不可用 |
| **Beta 功能** | 透過 `anthropic-beta` 標頭傳遞（請參閱[功能限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)） | Amazon Bedrock 支援的 beta 功能，透過 `anthropic-beta` 標頭 | Amazon Bedrock 支援的 beta 功能，透過 InvokeModel 請求主體的 `anthropic_beta` 欄位 |
| **驗證** | AWS IAM / SigV4 或 API 金鑰 | AWS IAM / SigV4 | AWS IAM / SigV4 或 bearer token |
| **帳單** | 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`)，beta 版 | `AnthropicBedrockMantle` | `AnthropicBedrock` / Bedrock SDK |
| **主控台** | Claude Console（`platform.claude.com`，透過 AWS Console 存取） | Bedrock Console | Bedrock Console |
| **速率限制（rate limits）與配額** | 由 Anthropic 管理 | 由 AWS 管理 | 由 AWS 管理 |
| **推論資料處理者** | Anthropic | AWS | AWS |
如果您需要由 AWS 營運的 Claude，請參閱 [Claude in Amazon Bedrock](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock)。Claude Platform on AWS 使用的容量池與第一方 Claude API 和 Amazon Bedrock 皆分開。您可以在多個平台上執行工作負載，並在它們之間進行容錯移轉。
支援使用 [AWS PrivateLink](https://docs.aws.amazon.com/vpc/latest/privatelink/what-is-privatelink.html) 將您的 VPC 連接到 Claude Platform on AWS 端點。
**何時選擇 Bedrock：** 受監管產業中需要 FedRAMP High、IL4、IL5 或 HIPAA 就緒合規性的組織，或需要 AWS 作為唯一資料處理者的組織，應使用 [Claude in Amazon Bedrock](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-platform-on-aws#using-the-claude-console) 和 AWS Console 中管理。
* **[Claude in Amazon Bedrock](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock)：** AWS 原生服務。在 Amazon Bedrock 主控台中管理，並以 AWS 服務用量計費。
* **透過 AWS Marketplace 採購的 Claude Enterprise：** 一種 [claude.ai](https://claude.ai) 方案（Claude 聊天產品），而非 API 平台。在 claude.ai 管理，其帳戶與遷移行為與本頁所述不同。請參閱 [Claude 說明中心](https://support.claude.com)。
* **直接的 Anthropic 帳戶：** 由 Anthropic 計費的第一方 Claude API 和 claude.ai 方案。在 Claude Console 和 claude.ai 管理。
## 設定您的帳戶
設定 Claude Platform on AWS 分為四個階段：在 AWS Console 服務頁面上註冊、完成您的 Anthropic 組織設定、記下您的工作區 ID，以及登入 Claude Console。
透過 AWS Console 註冊會佈建一個與您的 AWS 帳戶綁定的新 Anthropic 組織。此組織與您公司在 Anthropic 的任何現有組織分開，包括透過 AWS Marketplace 採購的 Claude Enterprise 組織。來自第一方 Anthropic 組織的 API 金鑰、工作區和 Claude Console 設定不會轉移。
如果您已有 Amazon Bedrock「private offer」（私人優惠），請在註冊前聯絡您的 Anthropic 或 AWS 客戶代表，以便您的折扣從第一個請求起即適用。折扣無法追溯套用至您接受私人優惠之前產生的用量。請參閱[私人優惠](https://platform.claude.com/docs/zh-TW/about-claude/pricing#private-offers)。
1. 開啟 [AWS Console](https://console.aws.amazon.com/) 並前往 **Claude Platform on AWS** 服務頁面。
2. 選擇 **Sign up**。
3. 在 Sign-up 頁面上，檢閱條款（Anthropic 的最終使用者授權合約、AWS 隱私權聲明和 AWS 客戶協議），並選取同意核取方塊。
4. 選擇 **Continue**。
頁面會顯示 **Sign-up in progress** 橫幅。請停留在此頁面。註冊需要幾分鐘，期間 AWS 會為您處理 AWS Marketplace 訂閱，然後自動將您重新導向。
如果您的組織有來自 Anthropic 的私人優惠，Console 會查詢該優惠並提示您在 AWS Marketplace 中接受。詳情請參閱[私人優惠](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-platform-on-aws#workspaces)。
您可以在 AWS Console **Claude Platform on AWS** 服務頁面的 **Workspaces** 下，或在 [Claude Console](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#using-the-claude-console) 中找到工作區 ID。工作區 ID 使用 `wrkspc_` 後接英數字元識別碼的格式。
Claude Console 的存取透過 AWS IAM 進行聯合驗證：
1. 擔任具有 `aws-external-anthropic:AssumeConsole` 權限的 IAM 角色。請參閱 [Claude Platform on AWS 的 IAM 動作](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#console-access)。
2. 在 **Claude Platform on AWS** 服務頁面中，選擇 **Open Claude Console**。AWS Console 會核發 JWT 並將您重新導向至 `platform.claude.com`。
3. 首次登入時，系統會提示您輸入電子郵件地址。請輸入您的工作電子郵件。平台會即時（just-in-time）佈建您的 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 組織。
請將從現有組織的遷移規劃為「cutover」（切換）至新組織：
* **先建立新組織。** 透過 AWS Console 註冊（請參閱[設定您的帳戶](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#set-up-your-account)）。如果您的遷移涉及私人優惠，請在接受優惠之前完成註冊：折扣從接受時起適用，不會追溯。請參閱[私人優惠](https://platform.claude.com/docs/zh-TW/about-claude/pricing#private-offers)。
* **重新建立存取權和設定。** API 金鑰、工作區和 Claude Console 設定不會從現有組織轉移。請在新組織中建立工作區，並將您的應用程式切換為 [Claude Platform on AWS 驗證](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-platform-on-aws#making-requests)。部分平台功能有所不同；請參閱[不支援的功能](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)。
* **依您自己的時程進行切換。** 新組織獨立於您的現有組織，兩者可以並行處理流量。無需一次性硬切換：逐步轉移工作負載，直到您的所有流量都在新組織上。
新組織開始運作後，差異主要集中在帳單和驗證方面，這些都透過 AWS 處理：
* **帳單**移至 AWS Marketplace：用量以 Claude Consumption Units 計費，而非預付點數（請參閱[計費](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#billing)），且您可以在 Billing 頁面上設定支出限制（請參閱[支出限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#spend-limits)）。在過渡期間，帳單保持分開：現有組織會繼續按照目前的方式計費。
* **驗證和存取**移至 AWS：請求使用 AWS 憑證或在 AWS Console（而非 Claude Console）中產生的 API 金鑰進行驗證（請參閱[驗證](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#authentication)）。組織成員資格透過 AWS IAM 而非 Claude Console 管理（請參閱[可用頁面](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#available-pages)），且 Anthropic 的用戶端 SDK 提供平台專屬的用戶端類別（請參閱[安裝 SDK](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#install-an-sdk)）。
* **日常 API 使用**的運作方式與第一方 Claude API 相同，但[功能限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)中註明的情況除外。在轉移正式環境流量之前，請檢查您的「rate limit」（速率限制）：新組織會被放在 Start 層級，提高限制需透過您的 Anthropic 客戶代表（請參閱[速率限制與配額](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)）。
對於行為不同的 Claude Enterprise（claude.ai）組織，請參閱[方案比較](https://platform.claude.com/docs/zh-TW/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 身分聯合](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)。
## 發出 API 呼叫之前
請確認您具備：
1. 已訂閱 Claude Platform on AWS 的有效 AWS 帳戶（請參閱[設定您的帳戶](https://platform.claude.com/docs/zh-TW/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 身分聯合**，這是一次性的設定步驟（請參閱[啟用對外 Web 身分聯合](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)）
4. 您的工作區 ID（請參閱[取得您的工作區 ID](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-platform-on-aws#iam-policies)）
### 啟用對外 Web 身分聯合
Claude Platform on AWS 閘道會在伺服器端呼叫 `sts:GetWebIdentityToken`，以鑄造一個轉發給 Anthropic 的 JWT。此 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/zh-TW/build-with-claude/claude-platform-on-aws#set-up-your-account)）。工作區綁定至單一 AWS 區域。您可以在 [Claude Console](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#using-the-claude-console) 的 **Workspaces** 下，或在 AWS Console 服務頁面的 **Workspaces** 區段中找到工作區 ID。
設定 `ANTHROPIC_AWS_WORKSPACE_ID` 和 `AWS_REGION` 環境變數，讓 SDK 用戶端自動讀取：
```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 支援兩種驗證方法：使用 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`）
* 共用設定檔案（`~/.aws/config`），包括 SSO 與 `credential_process`
* Web 身分（`AWS_WEB_IDENTITY_TOKEN_FILE` 與 `AWS_ROLE_ARN`），適用於 IRSA 與 GitHub Actions
* ECS 容器憑證
* EC2 執行個體中繼資料服務（IMDS）
驗證您的憑證是否正常運作：
```bash CLI
aws sts get-caller-identity
```
### API 金鑰驗證
對於較簡單的整合途徑（本機開發和指令碼），您可以使用 API 金鑰而非 SigV4 進行驗證。設定 `ANTHROPIC_AWS_API_KEY` 環境變數，或在建立用戶端時傳入 `api_key` (typescript, php: `apiKey`; go: `APIKey`; java: `.apiKey()`; csharp: `AwsClientOptions.ApiKey`)。
在 **AWS Console** 的 **Claude Platform on AWS → API keys** 下產生 API 金鑰。選擇 **Generate a key**，然後複製金鑰值。將 `aws-external-anthropic:CallWithBearerToken` IAM 動作授予應允許使用 API 金鑰驗證的主體。
Claude Platform on AWS 的 API 金鑰在 AWS Console 中管理，而非 Claude Console。在標準 [Claude Console](https://platform.claude.com/) 中建立的金鑰（用於第一方 API 存取）無法用於 Claude Platform on AWS 端點。
#### 短期 API 金鑰
對於需要將憑證交給另一個程序的工作負載（例如 LLM 閘道、無伺服器函式，或支援 bearer-token 驗證但不支援 SigV4 的工具），請從您的 AWS 憑證產生短期 API 金鑰，而非在 AWS Console 中佈建長期金鑰。
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。
將產生的權杖傳遞給 SDK，方式與傳遞 AWS Console 產生的 API 金鑰相同：
```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/zh-TW/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]"
```
在使用 Homebrew Python 的 macOS 或其他外部管理的 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 用戶端目前為 beta 版。
## 可用模型
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/zh-TW/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/zh-TW/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/zh-TW/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/zh-TW/manage-claude/admin-api) 的請求則不需要。
執行這些範例之前，請完成[發出 API 呼叫之前](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/context-windows)。
## 功能支援
Claude Platform on AWS 直接使用 Claude API 端點，這表示您可獲得與第一方 Claude API 完全一致的功能（[功能限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)中註明者除外）：
* **功能存取：** 由於 Anthropic 同時營運兩個平台，大多數新功能與 beta 標頭無需額外的整合步驟即可在 Claude Platform on AWS 上使用。例外情況請參閱[功能限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)。
* **Beta 功能：** 傳遞標準的 `anthropic-beta` 標頭即可存取 beta 功能，與使用 Claude API 時相同。
* **Agent Skills：** 使用與 Claude API 相同的 `container.skills` 參數來使用預建與自訂的 [Agent Skills](https://platform.claude.com/docs/zh-TW/agents-and-tools/agent-skills/overview)。所有預建 Skills（PowerPoint、Excel、Word、PDF）皆可直接使用。
* **程式碼執行：** 使用[程式碼執行工具](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/code-execution-tool)在 Anthropic 管理的沙箱中執行程式碼。
* **工具使用：** 除了電腦使用和瀏覽器使用工具集之外，所有[工具使用功能](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/overview)皆可使用；請參閱[不支援的功能](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)。
* **思考：** [「Adaptive thinking」（自適應思考）](https://platform.claude.com/docs/zh-TW/build-with-claude/thinking)、[effort 參數](https://platform.claude.com/docs/zh-TW/build-with-claude/effort)，以及在支援的模型上的[「extended thinking」（擴展思考）](https://platform.claude.com/docs/zh-TW/build-with-claude/extended-thinking)，皆使用與 Claude API 相同的參數運作。
* **串流：** 完整的 SSE「streaming」（串流）支援，提供即時回應。
* **批次處理：** 為高吞吐量工作負載提交批次請求。
* **提示快取：** 快取工具、系統提示與訊息歷史記錄，以降低延遲與成本。所有「prompt caching」（提示快取）功能（5 分鐘 TTL、1 小時 TTL 與自動快取）皆可使用。
* **Files API：** 上傳檔案並在多個請求間參照。
* **客戶管理的加密金鑰（CMEK）：** [CMEK](https://platform.claude.com/docs/zh-TW/manage-claude/cmek) 僅支援 [AWS KMS](https://platform.claude.com/docs/zh-TW/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/zh-TW/manage-claude/cmek-aws-kms#claude-platform-on-aws)。在 [Claude Console](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#using-the-claude-console) 中註冊並附加金鑰；外部金鑰端點亦可使用，透過 [IAM 動作](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#encryption-keys)授權。沒有獨立的驗證步驟：金鑰會在您將其附加至工作區時隱含驗證（附加呼叫會執行一輪加密/解密），因此金鑰政策問題會在附加時而非註冊時浮現。
* **Compliance API：** [Compliance API](https://platform.claude.com/docs/zh-TW/manage-claude/compliance-api) 可供使用。存取透過 AWS IAM [`ListComplianceActivities` 動作](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#compliance)授權。
與 Amazon Bedrock 的功能可用性差異請參閱[比較表](https://platform.claude.com/docs/zh-TW/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/zh-TW/managed-agents/overview) 可在 Claude Platform on AWS 上使用，包括[代理](https://platform.claude.com/docs/zh-TW/managed-agents/agent-setup)、[環境](https://platform.claude.com/docs/zh-TW/managed-agents/environments)、[工作階段](https://platform.claude.com/docs/zh-TW/managed-agents/sessions)、[排程部署](https://platform.claude.com/docs/zh-TW/managed-agents/scheduled-deployments)、[憑證保管庫](https://platform.claude.com/docs/zh-TW/managed-agents/vaults)、[記憶體儲存區](https://platform.claude.com/docs/zh-TW/managed-agents/memory)、[webhooks](https://platform.claude.com/docs/zh-TW/managed-agents/webhooks)、[多代理協調](https://platform.claude.com/docs/zh-TW/managed-agents/multiagent-orchestration)以及[自行託管沙箱](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes)。
Claude Platform on AWS 上的工作階段和自行託管 worker，與第一方 Claude Managed Agents 有三點不同：
* **自主工作階段重新驗證：** 工作階段可在沒有任何[使用者事件](https://platform.claude.com/docs/zh-TW/managed-agents/reference#event-types)的情況下自主執行最多 6 小時。6 小時後，工作階段需要重新驗證才能繼續。若要重新驗證，請向該工作階段傳送任何使用者角色事件（請參閱[事件與串流](https://platform.claude.com/docs/zh-TW/managed-agents/events-and-streaming)）。第一方 Claude Managed Agents 沒有自主工作階段執行時間限制。
* **[自行託管環境上的記憶體儲存區](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes-memory)：** 在自行託管環境上執行的工作階段無法附加記憶體儲存區；包含記憶體儲存區的工作階段會在建立時被拒絕。雲端環境上的工作階段可照常附加記憶體儲存區。在第一方 Claude Managed Agents 上，雲端和自行託管環境上的工作階段都可以附加記憶體儲存區。
* **[自行託管環境上的 worker 驗證](https://platform.claude.com/docs/zh-TW/managed-agents/self-hosted-sandboxes#prerequisites)：** worker 使用 AWS IAM（SigV4）或[在 AWS Console 中產生的 API 金鑰](https://platform.claude.com/docs/zh-TW/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/zh-TW/manage-claude/api-and-data-retention)。
* **電腦使用與瀏覽器使用工具集：** `computer_toolset_20260801` 和 `browser_toolset_20260801` 目前在 Claude Platform on AWS 上不可用。Beta 版電腦使用工具版本仍可用於[較早的工具版本](https://platform.claude.com/docs/zh-TW/agents-and-tools/tool-use/computer-use-tool#earlier-tool-versions)下所列的模型。
- **Admin API：** 工作區端點（`/v1/organizations/workspaces` 上的建立、取得、列出、更新與封存）、外部金鑰端點（`/v1/organizations/external_keys` 上的註冊、取得、列出、更新與刪除，用於 [CMEK](https://platform.claude.com/docs/zh-TW/manage-claude/cmek)；金鑰會在附加至工作區時進行驗證，而非透過驗證端點），以及[遙測目的地端點](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#telemetry-destinations)皆可使用。其他 Admin API 端點（組織成員、工作區成員、邀請、API 金鑰、用量報告、成本報告與速率限制報告）目前無法使用。請改在 [Claude Console](https://platform.claude.com/docs/zh-TW/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 金鑰驗證。
- **快速模式：** 在 Claude Platform on AWS 上不可用。
- **OpenAI 相容 API 端點：** 在 Claude Platform on AWS 上不可用。
- **MCP 通道：** 僅支援透過公開網際網路公開的 MCP 伺服器。
## 資料駐留
Claude Platform on AWS 支援以下推論地理區域：
* **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/zh-TW/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/zh-TW/manage-claude/data-residency#workspace-level-restrictions)。
## 工作區
Claude Platform on AWS 上的推論與資源請求以「workspace」（工作區）為目標。您在這些 API 呼叫的 `anthropic-workspace-id` 標頭中傳遞工作區的 ID。工作區 ID 使用帶標記的格式：`wrkspc_` 後接英數字元識別碼（例如 `wrkspc_01AbCdEf23GhIj`）。如果您尚未取得，請參閱[取得您的工作區 ID](https://platform.claude.com/docs/zh-TW/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 資源。您可透過 AWS IAM 政策使用工作區 ARN 授予或拒絕對特定工作區的存取。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/zh-TW/build-with-claude/claude-platform-on-aws#iam-policies)以取得政策範例。
### 管理工作區
您可以從 AWS Console 的 **Workspaces** 頁面，或使用 [Admin API](https://platform.claude.com/docs/zh-TW/manage-claude/admin-api) 的工作區端點，建立其他工作區、重新命名工作區或封存工作區。這些端點不需要 `anthropic-workspace-id` 標頭。建立和列出作用於組織；取得、更新和封存則在 URL 路徑中接受工作區 ID。新工作區會綁定至您用來建立它的端點所在的 AWS 區域（請參閱[工作區範圍](https://platform.claude.com/docs/zh-TW/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/zh-TW/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/zh-TW/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**。Admin 角色授予對 Claude Platform on AWS 可用的所有 Claude Console 頁面和設定的存取權。Developer 角色授予對用量、成本、速率限制和工作區資訊的讀取權限。請聯絡您的 Anthropic 客戶代表，以將 Admin 或 Developer 角色指派給主體。
### 可用頁面
**透過 AWS 閘道**欄位表示該頁面是否透過 AWS 閘道讀取和寫入資料（因此受 [IAM 動作](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions)管控）。標記為**否**的頁面直接從 Anthropic 讀取組織層級的中繼資料，並繞過 IAM 動作檢查。
| 頁面 | 可用 | 透過 AWS 閘道 | 備註 |
| --------------------- | ----- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Usage** | 是 | 否 | 依模型、工作區和維度檢視 token 用量。請求後，資料可能需要幾分鐘才會顯示。 |
| **Cost** | 是 | 否 | 依模型和工作區檢視成本細分。AWS Cost Explorer 會顯示彙總的 [Claude Consumption Unit (CCU)](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#billing) 明細項目。 |
| **Rate limits** | 是 | 否 | 檢視速率限制（唯讀）。層級提升需透過您的 Anthropic 客戶代表辦理；請參閱[速率限制與配額](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)。 |
| **Workspaces** | 是 | 是（支出限制除外） | 檢視各區域的工作區。擁有 Admin 角色時，您也可以建立、重新命名和封存工作區，並設定各工作區的[支出限制](https://platform.claude.com/docs/zh-TW/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/zh-TW/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 中管理 API 金鑰（**Claude Platform on AWS → API keys**）。請參閱 [API 金鑰驗證](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#api-key-authentication)。 |
| **Members** | 否 | 不適用 | 不適用。存取權由 AWS IAM 管理。 |
| **Billing** | 是（有限） | 否 | 設定組織每月支出限制；請參閱[支出限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#spend-limits)。發票由 AWS Marketplace 管理。請在 Cost 頁面檢視成本細分。 |
| **Claude Code** | 否 | 不適用 | 請在 Usage 頁面檢視 Claude Code 用量。 |
### 切換組織
Claude Console 不支援 Claude Platform on AWS 的組織切換。若要存取不同的組織，請登出並使用該組織 AWS 帳戶的 IAM 角色透過 AWS Console 重新驗證。
## 速率限制與配額
Claude Platform on AWS 上的組織會被置於 Start 層級。Anthropic 直接管理速率限制，而非透過 AWS 配額系統。
Claude Platform on AWS 上的組織在累積已付款的 AWS Marketplace 發票紀錄後，可以自動升級至更高的「usage tier」（用量層級）。Claude Console 中的自助式 **Request tier increase** 流程無法使用：Rate limits 頁面會改為引導您聯絡您的 Anthropic 客戶代表。
若要申請更高的限制，請聯絡您的 Anthropic 客戶代表或 [Anthropic 支援](https://support.claude.com)。請在申請中包含下列資訊：
* 您需要提高限制的模型
* 每個模型的每分鐘尖峰輸入 token 數和每分鐘輸出 token 數（而非每日總量）
* 您的輸入中屬於快取或重複上下文的大約比例（對大多數模型而言，快取讀取不計入輸入 token 限制；請參閱[快取感知 ITPM](https://platform.claude.com/docs/zh-TW/api/rate-limits#cache-aware-itpm)）
用量層級是固定的級距：每個層級都將速率限制與[每月支出上限](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#spend-limits)配對，升至更高層級會同時提高兩者。如需層級詳細資訊和各模型的限制，請參閱[速率限制](https://platform.claude.com/docs/zh-TW/api/rate-limits)。
## 計費
Claude Platform on AWS 透過 [AWS Marketplace](https://aws.amazon.com/marketplace) 計費。用量以 Claude Consumption Units (CCU) 計價，每小時計量，並於每月事後在您的 AWS 帳單上開立發票。CCU 不是預付點數。沒有 CCU 餘額或承諾用量。
如需 CCU 價格、換算機制、折扣套用方式和各模型 token 費率，請參閱 [Claude Platform on AWS 定價](https://platform.claude.com/docs/zh-TW/about-claude/pricing#claude-platform-on-aws-pricing)。
### 支出限制
Start、Build 和 Scale 用量層級各自帶有每月支出上限；請參閱[各層級支出上限](https://platform.claude.com/docs/zh-TW/api/rate-limits#spend-limits)以了解目前數值。當您的組織在該日曆月的用量達到其層級上限時，API 請求會以[支出上限錯誤](https://platform.claude.com/docs/zh-TW/api/rate-limits#reaching-your-spend-cap)失敗，直到下個月第一天 00:00 UTC 為止，提前重試不會成功。支出上限和速率限制屬於同一層級。若要提高上限，或在達到上限後恢復存取，請透過您的 Anthropic 客戶代表或 [Anthropic 支援](https://support.claude.com)申請層級提升（請參閱[速率限制與配額](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas)）。
在 Billing 頁面的 **Email recipients** 下新增至少一位收件人後，您也可以設定低於上限的自訂每月支出限制：
* **組織支出限制：** 前往 [Claude Console](https://platform.claude.com/docs/zh-TW/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**。
當用量達到您設定的限制時，請求會以 HTTP 400 失敗（請參閱[支出限制錯誤](https://platform.claude.com/docs/zh-TW/api/rate-limits#setting-your-own-spend-limit)），直到下個月第一天 00:00 UTC，或直到您提高或移除該限制為止。
支出以定價表價格計算，且可能需要約 2 小時才能反映最近的用量，因此在請求開始失敗之前，用量可能會超過上限或限制。超出部分會被計費。當層級上限或組織支出限制停止您的請求時，系統會向 Billing 頁面 **Email recipients** 下列出的收件人發送電子郵件通知。基於角色的收件人（例如所有管理員）在 Claude Platform on AWS 上不可用。層級上限通知也會發送至 AWS Marketplace 註冊時使用的電子郵件地址。
## 監控與日誌記錄
AWS CloudTrail 可擷取對 Claude Platform on AWS 的所有請求。工作區、外部金鑰、遙測目的地、合規、保管庫與 webhook 操作預設會記錄為管理事件（Management events）。推論、批次、檔案、skill、模型、使用者設定檔與 Claude Managed Agents 操作（保管庫與 webhook 除外）則歸類為資料事件（Data events），需要明確設定資料事件日誌記錄，這會產生額外的 CloudTrail 費用。如需完整的事件類型分類，請參閱 [IAM 動作參考](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#route-to-action-mapping)；如需設定詳細資訊，請參閱 [AWS CloudTrail 文件](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)。
### 請求 ID
每個回應在回應標頭中包含兩個請求 ID：
* **AWS 請求 ID（`x-amzn-requestid`）：** 主要 ID，在 CloudTrail 中建立索引。透過 AWS 工具調查請求或聯絡 AWS 支援時使用此 ID。
* **Anthropic 請求 ID（`request-id`）：** 次要 ID。聯絡 Anthropic 支援時使用此 ID。
```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 會將 HTTP 回應（包含 X-Amzn-Requestid 與
# Request-Id 標頭）輸出至 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
# 在每個請求的 middleware（中介軟體）中讀取回應標頭，它會在
# 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/zh-TW/build-with-claude/claude-in-amazon-bedrock)（位於 `bedrock-mantle.{region}.api.aws` 的 Messages API）和[舊版 InvokeModel 整合](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-on-amazon-bedrock-legacy)。
| 面向 | 從 [Claude in Amazon Bedrock](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-in-amazon-bedrock) | 從 [Amazon Bedrock（Opus 4.6 及更早版本）](https://platform.claude.com/docs/zh-TW/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/zh-TW/build-with-claude/claude-platform-on-aws#install-an-sdk)），處於 beta 階段 |
| **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/zh-TW/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/zh-TW/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 格式。如需請求結構對應，請參閱 [Amazon Bedrock 上的 Claude（Opus 4.6 及更早版本）](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-on-amazon-bedrock-legacy)。
### 您將獲得的好處
* 通常可在當天取得新模型和功能（請參閱[功能限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)）
* 用於文件生成的 Agent Skills（PowerPoint、Excel、Word、PDF）
* 在 Anthropic 託管沙箱中執行程式碼
* 透過 `anthropic-beta` 標頭使用 Amazon Bedrock 未提供的 Claude API beta 功能（請參閱[功能限制](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#features-not-supported)）
* 用於配額可見性和用量分析的 Claude Console
* 直接的 Anthropic 支援
* API 金鑰驗證作為 SigV4 的替代方案（請參閱 [API 金鑰驗證](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#api-key-authentication)）
### 維持不變的部分
* AWS IAM 驗證（SigV4）
* AWS 作為發票開立方。計費管道從原生 AWS 服務變更為 AWS Marketplace（請參閱[商業考量](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#commercial-considerations)）。
* AWS 承諾用量抵扣
### 遷移陷阱
**請先啟用對外 Web 身分聯合。** 如果您的 AWS 帳戶先前未曾使用過 Claude Platform on AWS，您必須在發出請求之前為每個帳戶[啟用對外 Web 身分聯合](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)一次。若未執行此步驟，所有請求都會以聯合錯誤失敗（請參閱[啟用對外 Web 身分聯合](https://platform.claude.com/docs/zh-TW/build-with-claude/claude-platform-on-aws#enable-outbound-web-identity-federation)以了解確切的錯誤和補救方式）。Bedrock 不需要此步驟。
**零資料保留（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 的商業服務條款和使用政策。如果您的組織尚未接受這些條款（例如，如果您僅透過 Bedrock 使用過 Claude），系統會在帳戶設定期間提示您。請參閱[設定您的帳戶](https://platform.claude.com/docs/zh-TW/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-only）政策，請參閱 [ZDR 敏感工作區的功能鎖定](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#feature-lockdown-for-a-zdr-sensitive-workspace)。
`ListWorkspaces` 是帳戶範圍的，因此它出現在帶有 `"Resource": "*"` 的獨立 Allow 陳述式中。在帳戶範圍的動作上指定工作區 ARN 沒有效果（請參閱[佈建自動化](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#provisioning-automation)）。
此政策假設使用 AWS SigV4 驗證。如果主體使用 API 金鑰進行驗證，請同時將 `aws-external-anthropic:CallWithBearerToken` 新增至 `"Resource": "*"` Allow 陳述式。`CallWithBearerToken` 是一個無路由的驗證層動作，不會綁定至工作區 ARN。請參閱[每位客戶的工作區隔離](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions#per-customer-workspace-isolation)以了解雙陳述式模式。
### 受管政策
AWS 提供五個受管政策（`AnthropicFullAccess`、`AnthropicReadOnlyAccess`、`AnthropicInferenceAccess`、`AnthropicLimitedAccess` 和 `AnthropicSelfHostedEnvironmentAccess`）以因應常見的存取模式。如需每個政策授予的動作、完整的 IAM 動作清單、路由至動作的對應，以及其他政策範例，請參閱 [Claude Platform on AWS 的 IAM 動作](https://platform.claude.com/docs/zh-TW/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 訂閱和帳單。