AWS 上的 Claude Platform 上的 Claude Code

AWS 上的 Claude Platform 是 Anthropic 營運的 Claude API，具有 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。請求直接到達 Anthropic 的 API，因此您可以獲得與 Claude API 相同的模型和 API 功能，並遵循相同的發佈時程表。您使用 AWS 認證或工作區 API 金鑰進行驗證，並透過 AWS Marketplace 付款。 Claude Code 透過 Anthropic 的功能旗標服務啟用的用戶端功能預設為關閉，且 advisor 工具無法使用。請參閱功能可用性矩陣以取得完整清單。使用本指南將 Claude Code 指向您已透過 AWS 上的 Claude Platform 佈建的工作區。有關在此之前的 AWS 訂閱和工作區設定，請參閱 AWS 上的 Claude Platform 文件。

透過 AWS Marketplace 訂閱會佈建一個與您的 AWS 帳戶相關聯的新 Anthropic 組織。此組織與您已有的任何 Anthropic 組織分開，認證不會在它們之間轉移。使用來自 AWS 連結組織的工作區 ID 和 API 金鑰，而不是來自預先存在的 Claude Console 帳戶。

先決條件

在設定 Claude Code 之前，您需要：

透過 AWS Marketplace 的有效 AWS 上的 Claude Platform 訂閱
您的 AWS 連結 Anthropic 組織中的工作區，及其工作區 ID
具有叫用 Anthropic 服務權限的 IAM 主體，或限定於工作區的 API 金鑰
您環境中的 AWS 認證、~/.aws/credentials 中的認證，或來自附加 IAM 角色的認證（如果您想要 SigV4 驗證）。AWS CLI 僅在 SSO 登入流程中需要。

設定

設定 AWS 認證

Claude Code 支援 AWS 上的 Claude Platform 的兩種驗證方法。選擇適合您的團隊如何管理存取的方法。 選項 A：使用 SigV4 的 AWS 認證 Claude Code 使用標準 AWS 認證鏈使用 SigV4 簽署請求：環境變數、~/.aws/credentials 中的共享認證、IAM 角色、AWS SSO 工作階段，以及 AWS SDK 支援的任何其他來源。對於本機使用，在啟動 Claude Code 之前使用 AWS CLI 登入。下面的範例使用 SSO 設定檔，但任何在標準位置產生認證的方法都有效。

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

對於 CI 和自動化，給予執行器具有叫用 Anthropic 服務權限的 IAM 角色，並設定 AWS_REGION。認證鏈會自動選取該角色。如果您的 SSO 認證在工作階段中途過期，請設定 awsAuthRefresh，以便 Claude Code 重新執行您的登入命令並重試，而不是失敗。AWS 上的 Claude Platform 上的自動重新整理需要 Claude Code v2.1.198 或更新版本；較早的版本會停止並提示執行 /login，這無法重新整理 AWS 認證。將命令新增至您的設定檔，例如 ~/.claude/settings.json：

{
  "awsAuthRefresh": "aws sso login --profile my-profile"
}

Claude Code 也會在啟動時執行此命令，當它無法驗證您現有的 AWS 認證時，並在 Authentication 面板中顯示命令的輸出，直到登入完成。設定 awsAuthRefresh 後，執行 /login，選取第三方平台，然後在使用第三方平台下選取 Claude Platform on AWS · 重新整理認證。Claude Code 會執行已設定的命令，並重新讀取您的 AWS 認證，而無需重新啟動。 選項 B：工作區 API 金鑰 工作區 API 金鑰是長期有效的祕密，在您不想管理聯合 AWS 認證時很有用。在 AWS Console 中的 Claude Platform on AWS → API keys 下產生一個，並將其設定為 ANTHROPIC_AWS_API_KEY：

export ANTHROPIC_AWS_API_KEY=sk-ant-xxxxx

金鑰以 x-api-key 形式傳送，優先於 SigV4，因此您環境中的任何 AWS 認證都會被忽略。來自單獨 Claude Console 組織的 API 金鑰在此不起作用。將工作區 API 金鑰視為任何其他生產認證。使用者設定檔 env 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。

/login 和 /logout 命令不會將您登入 Claude Platform on AWS 的 claude.ai 訂閱。驗證透過您的 AWS 認證或工作區 API 金鑰執行。

設定 Claude Code

設定環境變數，將 Claude Code 路由透過 AWS 上的 Claude Platform，而不是預設的 Anthropic API。

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

ANTHROPIC_AWS_WORKSPACE_ID 是必需的。Claude Code 在每個請求上將其作為 anthropic-workspace-id 標頭傳送。將範例 wrkspc_01ABCDEFGHIJKLMN 值替換為您從 AWS 上的 Claude Platform 設定中的工作區 ID。 Claude Code 從 AWS 區域計算基礎 URL 為 https://aws-external-anthropic.{region}.api.aws，它使用與 Amazon Bedrock 相同的優先順序進行解析。若要直接覆寫 URL，請設定 ANTHROPIC_AWS_BASE_URL。即使您的環境中存在 AWS 認證，AWS 上的 Claude Platform 也是選擇加入的。Amazon Bedrock 和 Microsoft Foundry 在提供者路由中優先，因此如果設定了 CLAUDE_CODE_USE_BEDROCK 和 CLAUDE_CODE_USE_FOUNDRY，請取消設定它們。

固定模型版本

AWS 上的 Claude Platform 使用與直接 Claude API 相同的模型 ID。預設別名 fable、opus、sonnet 和 haiku 解析為 Claude Code 針對 AWS 上的 Claude Platform 的內建預設值，這些值可能落後於最新版本。沒有 ANTHROPIC_DEFAULT_OPUS_MODEL，opus 別名解析為 Opus 5.5。在 v2.1.280 之前，它解析為 v2.1.219 的 Opus 5，在 v2.1.207 之前解析為 Opus 4.8，在此之前解析為 Opus 4.7。如果您將 Claude Code 部署到團隊，請明確固定模型 ID，以便新版本不會一次移動所有人：

export ANTHROPIC_DEFAULT_FABLE_MODEL=claude-fable-5
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-5
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

有關模型 ID 和別名的完整清單，請參閱模型概述。有關其他模型相關變數，請參閱模型設定。 Prompt caching 會自動啟用。若要要求 1 小時快取 TTL 而不是 5 分鐘預設值，請設定 ENABLE_PROMPT_CACHING_1H=1。API 以更高的費率計費 1 小時快取寫入。有關費率，請參閱 prompt caching 定價。若要為您的主要對話和 Claude Code 在其外部進行的請求設定不同的 TTL，請自行選擇 TTL。

啟動並驗證

啟動 Claude Code 並確認路由：

claude

當提供者處於活動狀態時，啟動橫幅會顯示 Claude Platform on AWS。執行 /status 以檢查詳細資訊：API provider 行讀取 Claude Platform on AWS，輸出包括您的 Workspace ID、AWS region 和 Claude Platform on AWS base URL（如果您設定了覆寫）。

使用 Agent SDK

Agent SDK 讀取與 CLI 相同的環境變數，因此任何產生 Claude Code 子程序的程式都可以透過在呼叫前匯出 CLAUDE_CODE_USE_ANTHROPIC_AWS、ANTHROPIC_AWS_WORKSPACE_ID 和 ANTHROPIC_AWS_API_KEY 或 AWS 認證來針對 AWS 上的 Claude Platform。

import { query } from "@anthropic-ai/claude-agent-sdk";

process.env.CLAUDE_CODE_USE_ANTHROPIC_AWS = "1";
process.env.ANTHROPIC_AWS_WORKSPACE_ID = "wrkspc_01ABCDEFGHIJKLMN";
process.env.AWS_REGION = "us-east-1";

for await (const msg of query({ prompt: "What's in this repo?" })) {
  console.log(msg);
}

此範例依賴環境 AWS 認證鏈進行 SigV4。若要改用工作區 API 金鑰進行驗證，請以相同方式設定 ANTHROPIC_AWS_API_KEY。有關更廣泛的 Agent SDK 表面，請參閱 Agent SDK 概述。

透過公司代理路由

若要透過代理或 LLM gateway 路由流量，請將 ANTHROPIC_AWS_BASE_URL 設定為代理的位址。Claude Code 將請求傳送至該 URL，並使用相同的工作區和驗證標頭，因此任何轉發它們不變的閘道都有效。

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

如果您的閘道自行簽署請求，請設定 CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1，以便 Claude Code 傳送未簽署的請求，並讓閘道在轉發到 AWS 之前新增 SigV4 標頭。如果閘道需要自己的權杖，請在 ANTHROPIC_AUTH_TOKEN 中設定它。

export CLAUDE_CODE_USE_ANTHROPIC_AWS=1
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

Troubleshooting

執行 /status 以查看已解析的提供者和任何明確設定的工作區 ID、區域、基礎 URL 覆寫和驗證跳過設定。這是確認 Claude Code 是否完全針對 AWS 上的 Claude Platform 的最快方式。

`403 Forbidden` 或 `AccessDenied` 在每個請求上

Claude Code 解析的 IAM 主體可能缺少在您的工作區中叫用 Anthropic 服務的權限。檢查附加到您的 AWS 設定檔或啟動 Claude Code 的執行器的角色，並驗證它具有 IAM 動作參考中記錄的 aws-external-anthropic 動作。如果您設定了 ANTHROPIC_AWS_API_KEY，金鑰優先於 SigV4，過期的金鑰會產生相同的錯誤。在 AWS Console 中的 Claude Platform on AWS → API keys 下重新產生金鑰，或取消設定變數以回退到您的 AWS 認證。

請求失敗，出現遺失工作區錯誤

ANTHROPIC_AWS_WORKSPACE_ID 可能未設定或為空。每個 AWS 上的 Claude Platform 請求都必須包含工作區 ID。它不是由您的 AWS 認證隱含的。在您的 Claude Platform on AWS 設定中找到 ID，並在啟動 Claude Code 之前匯出它。

請求仍然轉到 `api.anthropic.com`

CLAUDE_CODE_USE_ANTHROPIC_AWS 可能未設定或設定為不解析為真值的值。將其設定為 1 並執行 /status 以確認已解析的提供者。如果也設定了 CLAUDE_CODE_USE_BEDROCK 或 CLAUDE_CODE_USE_FOUNDRY，那些優先於 AWS 上的 Claude Platform。

其他資源

設定 Claude Code 之前的 AWS 上的 Claude Platform 訂閱、工作區和 IAM 設定涵蓋在平台文件中：

AWS 上的 Claude Platform 概述：訂閱、工作區設定和產品參考
IAM 動作參考：權限和受管原則

設定與存取

部署

閘道

使用量與成本

安全性和資料

採用

AWS 上的 Claude Platform 上的 Claude Code

先決條件

設定

設定 AWS 認證

設定 Claude Code

固定模型版本

啟動並驗證

使用 Agent SDK

透過公司代理路由

Troubleshooting

`403 Forbidden` 或 `AccessDenied` 在每個請求上

請求失敗，出現遺失工作區錯誤

請求仍然轉到 `api.anthropic.com`

其他資源

​先決條件

​設定

​ 設定 AWS 認證

​ 設定 Claude Code

​ 固定模型版本

​ 啟動並驗證

​使用 Agent SDK

​透過公司代理路由

​Troubleshooting

​403 Forbidden 或 AccessDenied 在每個請求上

​請求失敗，出現遺失工作區錯誤

​請求仍然轉到 api.anthropic.com

​其他資源

先決條件

設定

設定 AWS 認證

設定 Claude Code

固定模型版本

啟動並驗證

使用 Agent SDK

透過公司代理路由

Troubleshooting

`403 Forbidden` 或 `AccessDenied` 在每個請求上

請求失敗，出現遺失工作區錯誤

請求仍然轉到 `api.anthropic.com`

其他資源