AWS 上的 Claude Platform

AWS 上的 Claude Platform 為您提供完整的 Anthropic 平台體驗，包括 Messages API、Agent Skills、程式碼執行和 beta 功能，可透過您的 AWS 帳戶存取。與 Amazon Bedrock（由 AWS 營運推論堆疊）不同，AWS 上的 Claude Platform 由 Anthropic 營運。AWS 提供身份驗證層（SigV4 或 API 金鑰）、基於 IAM 的存取控制，以及透過 AWS Marketplace 的帳務整合。



平台整合的運作方式

Claude 模型在 Anthropic 管理的基礎設施上執行。這是一項用於透過 AWS 進行帳務和存取的商業整合。Anthropic 是推論輸入和輸出的資料處理者。AWS 在 marketplace 模式下處理帳務和身份中繼資料。透過 AWS 上的 Claude Platform 使用 Claude 的客戶受 Anthropic 的資料使用條款約束。

AWS 上的 Claude Platform 具有以下營運特性：資料可能不會存放在 AWS 中、推論可能路由到 Anthropic 的主要雲端，且子服務可能在不另行通知的情況下變更。請在每個請求中設定 inference_geo 參數，以將推論固定到特定地理區域。

AWS 上的 Claude Platform 遵循與第一方 Claude API 相同的資料保留政策。「Zero Data Retention」（零資料保留），即 ZDR，可依要求提供。請聯繫您的 Anthropic 客戶代表為您的組織啟用此功能。



AWS 上的 Claude Platform 與 Amazon Bedrock 的比較

這兩種產品都讓您可以透過 AWS 使用 Claude，但它們在架構、API 介面和功能可用性方面有所不同。

如果您需要由 AWS 營運的 Claude，請參閱 Amazon Bedrock 中的 Claude。AWS 上的 Claude Platform 使用與第一方 Claude API 和 Amazon Bedrock 都不同的獨立容量池。您可以在多個平台上執行工作負載並在它們之間進行容錯移轉。

支援使用 AWS PrivateLink 將您的 VPC 連接到 AWS 上的 Claude Platform 端點。

何時選擇 Bedrock： 受監管產業中需要 FedRAMP High、IL4、IL5 或 HIPAA-ready 合規性，或需要 AWS 作為唯一資料處理者的組織，應使用 Amazon Bedrock 中的 Claude。Bedrock 完全在 AWS 控制的基礎設施上執行，由 AWS 作為營運方。

您使用的是哪種產品？ Claude 可透過幾種不同的產品取得：

• AWS 上的 Claude Platform（本頁面）：透過 AWS Marketplace 計費的 Claude API 平台。在 Claude Console 和 AWS Console 中管理。
• Amazon Bedrock 中的 Claude： AWS 原生服務。在 Amazon Bedrock 主控台中管理，並以 AWS 服務使用量計費。
• 透過 AWS Marketplace 採購的 Claude Enterprise： 一種 claude.ai 方案（Claude 聊天產品），而非 API 平台。在 claude.ai 上管理，其帳戶和遷移行為與本頁面所述不同。請參閱 Claude 說明中心。
• 直接的 Anthropic 帳戶： 由 Anthropic 計費的第一方 Claude API 和 claude.ai 方案。在 Claude Console 和 claude.ai 上管理。



設定您的帳戶

設定 AWS 上的 Claude Platform 分為四個階段：在 AWS Console 服務頁面上註冊、完成您的 Anthropic 組織設定、記下您的工作區 ID，以及登入 Claude Console。



從現有的 Anthropic 組織遷移

註冊 AWS 上的 Claude Platform 一律會佈建一個與您的 AWS 帳戶綁定的新 Anthropic 組織。沒有就地轉換：現有組織（例如第一方 Claude API 組織）無法變成 AWS 上的 Claude Platform 組織。

請將從現有組織的遷移規劃為切換到新組織：

• 先建立新組織。 透過 AWS Console 註冊（請參閱設定您的帳戶）。如果您的遷移涉及私人優惠，請在優惠被接受之前完成註冊：折扣從接受時開始適用，而非追溯適用。請參閱私人優惠。
• 重新建立存取權和設定。 API 金鑰、工作區和 Claude Console 設定不會從現有組織轉移過來。在新組織中建立工作區，並將您的應用程式切換到 AWS 上的 Claude Platform 身份驗證。
• 更新您的整合。 AWS 上的 Claude Platform 提供 Claude API（/v1/{endpoint}），因此請求和回應的結構與第一方 Claude API 相同。改變的是基礎 URL、身份驗證方法和必要的 anthropic-workspace-id 標頭；請參閱發出請求。某些平台功能有所不同；請參閱不支援的功能。
• 依照您自己的時程切換。 新組織獨立於您現有的組織，兩者可以並行處理流量。不需要硬性切換：逐步轉移工作負載，直到您的所有流量都在新組織上。

新組織開始運作後，差異主要集中在透過 AWS 處理的帳務和身份驗證：

• 帳務移至 AWS Marketplace：使用量以 Claude Consumption Units 計費，而非預付額度（請參閱帳務），支出限制在 Billing 頁面而非 Limits 頁面管理（請參閱支出限制）。在過渡期間，帳務保持分開：現有組織繼續按目前方式計費。
• 身份驗證和存取移至 AWS：請求使用 AWS 憑證或在 AWS Console（而非 Claude Console）中產生的 API 金鑰進行身份驗證（請參閱身份驗證）。組織成員資格透過 AWS IAM 而非 Claude Console 管理（請參閱可用頁面），且 Anthropic 的用戶端 SDK 提供平台專屬的用戶端類別（請參閱安裝 SDK）。
• 日常 API 使用的運作方式與第一方 Claude API 相同，除了功能限制中註明的部分。在轉移生產流量之前，請檢查您的速率限制：新組織會被置於 Start 層級，限制提升需透過您的 Anthropic 客戶代表處理（請參閱速率限制和配額）。

對於行為不同的 Claude Enterprise（claude.ai）組織，請參閱產品比較。



帳戶設定疑難排解

• 「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 身份聯合驗證。



發出 API 呼叫之前

請確保您具備：

1. 已訂閱 AWS 上的 Claude Platform 的有效 AWS 帳戶（請參閱設定您的帳戶）
2. 已安裝並設定 AWS CLI
3. 在您的 AWS 帳戶上啟用對外 Web 身份聯合驗證，這是一次性的設定步驟（請參閱啟用對外 Web 身份聯合驗證）
4. 您的工作區 ID（請參閱取得您的工作區 ID）
5. 呼叫 API 的 IAM 權限：您工作區上的 aws-external-anthropic:CreateInference 動作，如果您使用 API 金鑰進行身份驗證，還需要 aws-external-anthropic:CallWithBearerToken（請參閱 IAM 政策）



啟用對外 Web 身份聯合驗證

AWS 上的 Claude Platform 閘道會在伺服器端呼叫 sts:GetWebIdentityToken 來產生轉發給 Anthropic 的 JWT。此 STS 功能在每個 AWS 帳戶上預設為停用。每個帳戶需啟用一次：

aws iam enable-outbound-web-identity-federation

如果回應是 [ERROR] (FeatureEnabled) ... already enabled，表示您的帳戶已開啟此設定，您可以繼續下一步。驗證並取得您帳戶的發行者 URL：

aws iam get-outbound-web-identity-federation-info



取得您的工作區 ID

完成帳戶設定後，您可以從 AWS Console 建立工作區（請參閱設定您的帳戶）。工作區綁定到單一 AWS 區域。您可以在 Claude Console 的 Workspaces 下，或在 AWS Console 服務頁面的 Workspaces 區段中找到工作區 ID。

設定 ANTHROPIC_AWS_WORKSPACE_ID 和 AWS_REGION 環境變數，讓 SDK 用戶端自動讀取它們：

export ANTHROPIC_AWS_WORKSPACE_ID='wrkspc_01AbCdEf23GhIj'
export AWS_REGION='us-west-2'  # Your workspace's AWS region

區域是必要的。如果未設定區域，SDK 用戶端會引發錯誤。將 aws_region/awsRegion 傳遞給建構函式，或設定 AWS_REGION（或 AWS_DEFAULT_REGION）。支援所有 AWS 商業區域。



身份驗證

AWS 上的 Claude Platform 支援兩種身份驗證方法：使用 Signature Version 4（SigV4）請求簽署的 AWS IAM（主要方式）和 API 金鑰身份驗證。兩者使用相同的基礎 URL 和請求格式。



SigV4 身份驗證

SigV4 是企業原生路徑，可與您現有的 AWS IAM 政策、角色和稽核整合。使用 AWS 預設憑證提供者鏈支援的任何方法設定 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）

驗證您的憑證是否正常運作：

aws sts get-caller-identity



API 金鑰身份驗證

對於較簡單的整合路徑（本機開發和指令碼），您可以使用 API 金鑰而非 SigV4 進行身份驗證。設定 ANTHROPIC_AWS_API_KEY 環境變數，或將 apiKey 傳遞給 SDK 建構函式。

在 AWS Console 的 Claude Platform on AWS → API keys 下產生 API 金鑰。選擇 Generate a key，然後複製金鑰值。將 aws-external-anthropic:CallWithBearerToken IAM 動作授予應允許使用 API 金鑰身份驗證的主體。



短期 API 金鑰

對於需要將憑證交給獨立程序（例如 LLM 閘道、無伺服器函式，或支援 bearer token 身份驗證但不支援 SigV4 的工具）的工作負載，請從您的 AWS 憑證產生短期 API 金鑰，而非在 AWS Console 中佈建長期金鑰。

AWS 發布了適用於 JavaScript、Python 和 Java 的 token 產生器函式庫。每個函式庫都透過標準提供者鏈讀取您的 AWS 憑證，並回傳可與 x-api-key 標頭搭配使用的限時 token。Token 存留期預設為 12 小時，上限為您請求的持續時間、您的 AWS 憑證到期時間和 12 小時三者中的最小值。有關安裝和完整設定選項，請參閱連結的儲存庫 README。

將產生的 token 傳遞給 SDK，方式與傳遞 AWS Console 產生的 API 金鑰相同：

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")

如果您可以在本機產生 token，表示您的程序已經擁有 SigV4 憑證，此時 SigV4 身份驗證通常是更簡單的選擇。當發出 API 呼叫的程序與持有 AWS 憑證的程序分開時，請使用短期金鑰。

SDK 不會自動重新整理短期金鑰。當 token 過期時，請產生新的 token 並建構新的用戶端。使用該 token 的主體仍需要 aws-external-anthropic:CallWithBearerToken IAM 動作。



憑證優先順序

平台專屬用戶端按以下順序解析身份驗證。引數名稱因語言慣例而異：TypeScript 和 PHP 使用如下所示的 camelCase，Python 和 Ruby 使用 snake_case，Go 使用首字母縮寫大寫的 PascalCase，C# 和 Java 使用該語言的屬性或建構器慣用語法。

1. apiKey 建構函式引數 → x-api-key 標頭
2. awsAccessKey + awsSecretAccessKey 建構函式引數 → AWS SigV4
3. awsProfile 建構函式引數 → 使用具名設定檔的 AWS SigV4
4. ANTHROPIC_AWS_API_KEY 環境變數 → x-api-key 標頭
5. 預設 AWS 憑證提供者鏈 → AWS SigV4



區域解析

如果未將 aws_region/awsRegion 傳遞給建構函式，用戶端會從環境中讀取 AWS_REGION，並回退到 AWS_DEFAULT_REGION 以與標準 AWS SDK 相容。區域是必要的。沒有回退預設值。與會回退到 us-east-1 的 AnthropicBedrock 不同，如果建構函式引數和環境變數都未設定，AnthropicAWS/AnthropicAws 用戶端會引發錯誤。



安裝 SDK

Anthropic 的用戶端 SDK 支援 AWS 上的 Claude Platform。每個 SDK 都提供平台專屬的用戶端類別，負責處理 SigV4 簽署、基於區域的基礎 URL 建構，以及 anthropic-workspace-id 標頭。

pip install -U "anthropic[aws]"



可用模型

AWS 上的 Claude Platform 提供以下模型：

模型 ID 與第一方 Claude API 完全相同。沒有 Bedrock 風格的 ARN 或 anthropic. 前綴。

新模型通常與第一方 Claude API 同日在 AWS 上的 Claude Platform 推出。



發出請求

AWS 上的 Claude Platform 使用與第一方 Claude API 相同的 API 端點。差異在於基礎 URL、身份驗證方法，以及用於識別請求目標工作區的必要 anthropic-workspace-id 標頭。

在執行這些範例之前，請完成發出 API 呼叫之前中的步驟。

from anthropic import AnthropicAWS

client = AnthropicAWS()

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

用戶端會從環境中讀取 AWS_REGION（或 AWS_DEFAULT_REGION）和 ANTHROPIC_AWS_WORKSPACE_ID。您可以透過將 aws_region / awsRegion 或 workspace_id / workspaceId 傳遞給建構函式來覆寫任一項。區域和工作區 ID 都是必要的。如果任一項無法解析，建構函式會引發錯誤。

--aws-sigv4 值遵循 aws:amz:<region>:<service> 格式。SigV4 服務名稱是 aws-external-anthropic，且區域必須與您端點 URL 中的區域相符。任一項不相符都會產生一般性的簽章拒絕錯誤，而非具體的診斷訊息。



上下文視窗

AWS 上的 Claude Platform 的上下文視窗大小與第一方 Claude API 完全相同。有關各模型的限制，請參閱上下文視窗。



功能支援

AWS 上的 Claude Platform 直接使用 Claude API 端點，這表示您可以獲得與第一方 Claude API 完全相同的功能（除了功能限制中註明的部分）：

• 功能存取： 由於 Anthropic 營運這兩個平台，大多數新功能和 beta 標頭無需額外的整合步驟即可在 AWS 上的 Claude Platform 上使用。例外情況請參閱功能限制。
• Beta 功能： 傳遞標準的 anthropic-beta 標頭來存取 beta 功能，就像使用 Claude API 一樣。
• Agent Skills： 使用與 Claude API 相同的 container.skills 參數和 beta 標頭來使用預建和自訂的 Agent Skills。所有預建 Skills（PowerPoint、Excel、Word、PDF）都可以直接使用。
• 程式碼執行： 使用程式碼執行工具在 Anthropic 管理的沙箱中執行程式碼。
• 工具使用： 電腦使用和所有其他工具使用功能都可用。
• 擴展思考： 使用與 Claude API 相同的參數啟用擴展思考。
• 串流： 完整支援 SSE 串流以提供即時回應。
• 批次處理： 為高吞吐量工作負載提交批次請求。
• 提示快取： 快取工具、系統提示和訊息歷史記錄，以降低延遲和成本。所有提示快取功能（5 分鐘 TTL、1 小時 TTL 和自動快取）都可用。
• Files API： 上傳檔案並在多個請求之間引用。
• 客戶管理的加密金鑰（CMEK）： CMEK 僅可搭配 AWS KMS 金鑰使用。無法註冊 Google Cloud KMS 和 Azure Key Vault 金鑰。在 Claude Console 中建立、驗證和附加金鑰。external_keys Admin API 端點目前不可用。金鑰必須與其附加的工作區位於相同的 AWS 區域。
• Compliance API： Compliance API 可用。存取透過 AWS IAM 授權。

有關與 Amazon Bedrock 的功能可用性差異，請參閱比較表。



Claude Managed Agents

Claude Managed Agents 可在 AWS 上的 Claude Platform 上使用，包括代理、環境、工作階段、憑證保管庫、記憶體儲存、webhooks、多代理協調和自行託管沙箱。

AWS 上的 Claude Platform 的工作階段行為與第一方 Claude Managed Agents 有一點不同：

• 自主工作階段重新驗證： 工作階段可以在沒有任何使用者事件的情況下自主執行最多 6 小時。6 小時後，工作階段需要重新驗證才能繼續。若要重新驗證，請向工作階段傳送任何使用者角色事件（請參閱事件和串流）。第一方 Claude Managed Agents 沒有自主工作階段執行時間限制。



不支援的功能

以下功能目前在 AWS 上的 Claude Platform 上不可用：

• HIPAA 就緒性： Anthropic 的 HIPAA-ready 計畫不可用。請參閱 API 和資料保留。

• Admin API： 工作區端點（/v1/organizations/workspaces 上的建立、取得、列出、更新和封存）可用。其他 Admin API 端點（組織成員、工作區成員、邀請、API 金鑰、使用量報告、成本報告、速率限制報告和外部金鑰）目前不可用。請改為在 Claude Console 中管理 CMEK 金鑰。請改為在 Claude Console 中檢視使用量和成本資料。AWS IAM 管理組織成員資格。
• 工作區成員管理： 無法從個別工作區新增或移除使用者。工作區 ARN 上的 AWS IAM 政策控制存取權。
• Claude Code 工作區和 Analytics API： 具有自動速率限制的 Claude Code 工作區不可用。Claude Code 使用量會顯示在一般使用量檢視中，而非專用畫面。
• OAuth 身份驗證： 不支援。請使用 SigV4 或 API 金鑰身份驗證。
• 快速模式： 在 AWS 上的 Claude Platform 上不可用。
• OpenAI 相容的 API 端點： 在 AWS 上的 Claude Platform 上不可用。
• MCP 通道： 僅支援透過公開網際網路公開的 MCP 伺服器。



資料落地

AWS 上的 Claude Platform 支援以下推論地理區域：

• US： 推論保留在美國資料中心內。適用 1.1 倍的定價乘數。
• Global： 推論可以路由到全球任何 Anthropic 營運的資料中心。適用標準定價。

使用 inference_geo 參數為每個請求設定推論地理區域：

from anthropic import AnthropicAWS

client = AnthropicAWS()
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    inference_geo="us",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(message)

如果您省略 inference_geo，請求會使用工作區的 default_inference_geo（如果已設定），否則使用 global。

工作區層級的推論地理區域控制（allowed_inference_geos 和 default_inference_geo）也可在 AWS 上的 Claude Platform 上使用。請參閱工作區層級限制。



工作區

Claude Platform on AWS 上的推論和資源請求都以工作區為目標。您在這些 API 呼叫的 anthropic-workspace-id 標頭中傳遞工作區的 ID。工作區 ID 使用帶標籤的格式 wrkspc_ 後接英數字識別碼（例如 wrkspc_01AbCdEf23GhIj）。如果您還沒有工作區 ID，請參閱取得您的工作區 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 相同：

arn:aws:aws-external-anthropic:{region}:{account-id}:workspace/{workspace-id}

例如：

arn:aws:aws-external-anthropic:us-west-2:123456789012:workspace/wrkspc_01AbCdEf23GhIj

請參閱 IAM 政策以取得政策範例。



管理工作區

從 AWS Console 的 Workspaces 頁面或使用 Admin API 工作區端點來建立額外的工作區、重新命名工作區或封存工作區。新工作區會綁定到您呼叫以建立它的端點所在的 AWS 區域（請參閱工作區範圍）。Claude Console 的 Workspaces 頁面為唯讀。



使用 Claude Console

Claude Platform on AWS 使用位於 platform.claude.com 的標準 Claude Console。當您從 AWS Console 登入時，Claude Console 側邊欄的左下角會出現 Account managed by AWS 指示器，且 Console 的範圍會限定在您的 Claude Platform on AWS 組織。它提供用量分析、成本細分、速率限制可見性、工作區可見性，以及用於管理檔案、Agent Skills、批次作業和 Claude Managed Agents 資源（代理程式、工作階段、環境、憑證保管庫、記憶體儲存區和 webhooks）的頁面。



登入

對 Claude Console 的存取是透過 AWS IAM 進行聯合驗證。請參閱設定您的帳戶以了解完整的首次登入流程。簡而言之：

1. 擔任具有 aws-external-anthropic:AssumeConsole 權限的 IAM 角色。請參閱 Claude Platform on AWS 的 IAM 動作。
2. 在 AWS Console 中導覽至 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 動作管轄）。標記為否的頁面直接從 Anthropic 讀取組織層級的中繼資料，並繞過 IAM 動作檢查。



切換組織

Claude Console 不支援 Claude Platform on AWS 的組織切換。若要存取不同的組織，請登出並使用該組織 AWS 帳戶的 IAM 角色透過 AWS Console 重新驗證。



速率限制與配額

Claude Platform on AWS 上的組織會被置於 Start 層級。Anthropic 直接管理速率限制，而非透過 AWS 配額系統。

Claude Platform on AWS 上的組織不會自動在用量層級之間移動。基於用量的層級提升適用於第一方 Claude API 組織，不適用於透過 AWS Marketplace 計費的組織。Claude Console 中的自助式 Request rate limit increase 流程也不可用：Limits 頁面會引導您改為聯絡您的 Anthropic 客戶代表。

若要請求更高的限制，請聯絡您的 Anthropic 客戶代表或支援。請在您的請求中包含以下內容：

• 您需要提高限制的模型
• 每個模型的尖峰每分鐘輸入 token 數和每分鐘輸出 token 數（而非每日總計）
• 您的輸入中屬於快取或重複上下文的大致比例（對大多數模型而言，快取讀取不計入輸入 token 限制；請參閱快取感知 ITPM）

用量層級是固定的階梯：每個層級將速率限制與每月支出上限配對，移至更高層級會同時提高兩者。有關層級詳細資訊和各模型限制，請參閱速率限制。



計費

Claude Platform on AWS 透過 AWS Marketplace 計費。用量以 Claude Consumption Units（CCU）計價，按小時計量，並在您的 AWS 帳單上按月後付開立發票。CCU 不是預付額度。沒有 CCU 餘額或承諾。

有關 CCU 價格、轉換機制、折扣套用和各模型 token 費率，請參閱 Claude Platform on AWS 定價。



支出限制

Start、Build 和 Scale 用量層級各自帶有每月支出上限；請參閱各層級支出上限以取得目前的數值。支出上限和速率限制屬於同一層級，因此若要提高上限，請透過您的 Anthropic 客戶代表或支援請求層級提升（請參閱速率限制與配額）。

您也可以設定自己的每月支出限制來限制組織的支出：

• **組織支出限制：**前往 Claude Console 中的 Settings > Billing 設定每月支出限制。在 Claude Platform on AWS 上，支出限制是在 Billing 頁面而非 Limits 頁面管理。
• **工作區支出限制：**從每個工作區的限制設定中為個別工作區設定每月支出限制。

您設定的支出限制是軟性限制：支出以標價計算，且可能需要約兩小時才能反映最近的用量。



監控與記錄

AWS CloudTrail 可以擷取對 Claude Platform on AWS 的所有請求。工作區、保管庫和 webhook 操作預設會記錄為 Management 事件。推論、批次、檔案、技能、模型、使用者設定檔和 Claude Managed Agents 操作（保管庫和 webhooks 除外）被分類為 Data 事件，需要明確的資料事件記錄組態，這會產生額外的 CloudTrail 費用。請參閱 IAM 動作參考以取得完整的事件類型分類，以及 AWS CloudTrail 文件以取得組態詳細資訊。



請求 ID

每個回應在回應標頭中包含兩個請求 ID：

• **AWS 請求 ID（x-amzn-requestid）：**主要 ID，在 CloudTrail 中建立索引。透過 AWS 工具調查請求或聯絡 AWS 支援時使用此 ID。
• **Anthropic 請求 ID（request-id）：**次要 ID。聯絡 Anthropic 支援時使用此 ID。

from anthropic import AnthropicAWS

client = AnthropicAWS()

response = client.messages.with_raw_response.create(
    model="claude-sonnet-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)

Anthropic 建議至少以 30 天滾動週期記錄您的活動，以了解用量模式並調查問題。



從 Amazon Bedrock 遷移

如果您目前在 Bedrock 上使用 Claude，遷移到 Claude Platform on AWS 需要在整個整合中進行變更。SigV4 簽署仍然受支援，但簽署上下文、基礎 URL、API 格式、模型 ID、SDK 用戶端和套件、串流格式、請求標頭和區域可用性都會改變。Claude Platform on AWS 也會佈建一個新的 Anthropic 組織。下表總結了這些差異。



有哪些變更

遷移的差異取決於您來自哪種 Bedrock 整合。下表顯示目前的 Bedrock 整合（位於 bedrock-mantle.{region}.api.aws 的 Messages API）和舊版 InvokeModel 整合。

如果您使用的是目前的 Bedrock 整合，請求主體格式已經是 Messages API。變更的部分是基礎 URL、SigV4 服務名稱、模型 ID，以及新增 anthropic-workspace-id 標頭。如果您使用的是舊版 InvokeModel 或 Converse API，您還需要將請求和回應的結構重寫為 Messages API 格式。請參閱 Claude on Amazon Bedrock（Opus 4.6 及更早版本）以取得請求結構對應。



您將獲得什麼

• 通常可在當天取得新模型和功能（請參閱功能限制）
• 用於文件產生的 Agent Skills（PowerPoint、Excel、Word、PDF）
• 在 Anthropic 受管沙箱中執行程式碼
• 透過 anthropic-beta 標頭使用測試版功能（請參閱功能限制）
• 用於配額可見性和用量分析的 Claude Console
• 直接的 Anthropic 支援
• 作為 SigV4 替代方案的 API 金鑰驗證（請參閱 API 金鑰驗證）



哪些保持不變

• AWS IAM 驗證（SigV4）
• AWS 作為開立發票方。計費管道從原生 AWS 服務變更為 AWS Marketplace（請參閱商業考量）。
• AWS 承諾額度抵扣



遷移陷阱



商業考量

• **Anthropic 服務條款：**使用 Claude Platform on AWS 需要接受 Anthropic 的商業服務條款和使用政策。如果您的組織尚未接受這些條款（例如，如果您只透過 Bedrock 使用過 Claude），系統會在帳戶設定期間提示您。請參閱設定您的帳戶。
• **折扣和私人優惠：**協商的折扣和 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:<Action> 模式（例如 aws-external-anthropic:CreateInference）。



範例：拒絕批次推論

以下政策允許即時推論，同時封鎖批次處理：

{
  "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 敏感工作區的功能鎖定。



受管政策

AWS 提供五個受管政策（AnthropicFullAccess、AnthropicReadOnlyAccess、AnthropicInferenceAccess、AnthropicLimitedAccess 和 AnthropicSelfHostedEnvironmentAccess）以滿足常見的存取模式。有關每個政策授予的動作、IAM 動作的完整清單、路由到動作的對應以及其他政策範例，請參閱 Claude Platform on AWS 的 IAM 動作。



後續步驟



其他資源