AWS 上的 Claude Platform 上的 Claude Code

設定 Claude Code 以使用 Anthropic 營運的 Claude API，搭配 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。

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 文件。

[!NOTE]

透過 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 的兩種驗證方法。選擇適合您的團隊如何管理存取的方法：

使用 SigV4 的 AWS 憑證：以 IAM 主體身分進行身分驗證，憑證來自標準 AWS 憑證鏈
工作區 API 金鑰：使用您在 AWS Console 中產生的長期有效金鑰進行身分驗證

使用 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 重新執行您的登入命令並重試，而不是失敗。將命令新增至您的設定檔，例如 ~/.claude/settings.json：

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

Claude Code 也會在啟動時執行此命令，當它無法驗證您現有的 AWS 認證時，並在 Authentication 面板中顯示命令的輸出，直到登入完成。

設定 awsAuthRefresh 後，執行 /login，選取第三方平台，然後在使用第三方平台下選取 Claude Platform on AWS · 重新整理認證。Claude Code 會執行已設定的命令，並重新讀取您的 AWS 認證，而無需重新啟動。

使用工作區 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 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。

[!NOTE]

/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 之前，它解析為 Opus 5（自 v2.1.219 起），以及 Opus 4.8（自 v2.1.207 起）。

如果您將 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 動作參考：權限和受管原則

claude-platform-on-aws.md +21 −233

6 6

7> 設定 Claude Code 以使用 Anthropic 營運的 Claude API，搭配 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。7> 設定 Claude Code 以使用 Anthropic 營運的 Claude API，搭配 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。

8 8

~~9export const ContactSalesCard = ({surface}) => {~~

~~10 const utm = content => `utm_source=claude_code&utm_medium=docs&utm_content=${surface}_${content}`;~~

11 const iconArrowRight = (size = 13) => <svg width={size} height={size} viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2.5" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">

~~12 <line x1="5" y1="12" x2="19" y2="12" />~~

~~13 <polyline points="12 5 19 12 12 19" />~~

~~14 </svg>;~~

~~15 const STYLES = `~~

~~16.cc-cs {~~

~~17 --cs-slate: #141413;~~

~~18 --cs-clay: #d97757;~~

~~19 --cs-clay-deep: #c6613f;~~

~~20 --cs-gray-000: #ffffff;~~

~~21 --cs-gray-700: #3d3d3a;~~

~~22 --cs-border-default: rgba(31, 30, 29, 0.15);~~

~~23 font-family: inherit;~~

~~24}~~

~~25.dark .cc-cs {~~

~~26 --cs-slate: #f0eee6;~~

~~27 --cs-gray-000: #262624;~~

~~28 --cs-gray-700: #bfbdb4;~~

~~29 --cs-border-default: rgba(240, 238, 230, 0.14);~~

~~30}~~

~~31.cc-cs-card {~~

~~32 display: flex; align-items: center; justify-content: space-between;~~

~~33 gap: 16px; padding: 14px 16px; margin: 0;~~

~~34 background: var(--cs-gray-000); border: 0.5px solid var(--cs-border-default);~~

~~35 border-radius: 8px; flex-wrap: wrap;~~

~~36}~~

~~37.cc-cs-text { font-size: 13px; color: var(--cs-gray-700); line-height: 1.5; flex: 1; min-width: 240px; }~~

~~38.cc-cs-text strong { font-weight: 550; color: var(--cs-slate); }~~

~~39.cc-cs-actions { display: flex; align-items: center; gap: 8px; flex-shrink: 0; }~~

~~40.cc-cs-btn-clay {~~

~~41 display: inline-flex; align-items: center; gap: 8px;~~

~~42 background: var(--cs-clay-deep); color: #fff; border: none;~~

~~43 border-radius: 8px; padding: 8px 14px;~~

~~44 font-size: 13px; font-weight: 500;~~

~~45 transition: background-color 0.15s; white-space: nowrap;~~

~~46}~~

~~47.cc-cs-btn-clay:hover { background: var(--cs-clay); }~~

~~48.cc-cs-btn-ghost {~~

~~49 display: inline-flex; align-items: center; gap: 8px;~~

~~50 background: transparent; color: var(--cs-gray-700);~~

~~51 border: 0.5px solid var(--cs-border-default);~~

~~52 border-radius: 8px; padding: 8px 14px;~~

~~53 font-size: 13px; font-weight: 500;~~

~~54}~~

~~55.cc-cs-btn-ghost:hover { background: rgba(0, 0, 0, 0.04); }~~

~~56.dark .cc-cs-btn-ghost:hover { background: rgba(255, 255, 255, 0.04); }~~

~~57@media (max-width: 720px) {~~

~~58 .cc-cs-actions { width: 100%; }~~

~~59}~~

~~60`;~~

~~61 return <div className="cc-cs not-prose">~~

~~62 <style>{STYLES}</style>~~

~~63 <div className="cc-cs-card">~~

~~64 <div className="cc-cs-text">~~

~~65 <strong>Deploying Claude Code across your organization?</strong> Talk to sales about enterprise plans, SSO, and centralized billing.~~

~~66 </div>~~

~~67 <div className="cc-cs-actions">~~

~~68 <a href={`https://claude.com/pricing?${utm('view_plans')}#plans-business`} className="cc-cs-btn-ghost">~~

~~69 View plans~~

~~70 </a>~~

~~71 <a href={`https://claude.com/contact-sales?${utm('contact_sales')}`} className="cc-cs-btn-clay">~~

~~72 Contact sales {iconArrowRight()}~~

~~73 </a>~~

~~74 </div>~~

~~75 </div>~~

~~76 </div>;~~

~~77};~~

~~79export const Experiment = ({flag, treatment, children}) => {~~

~~80 const VID_KEY = 'exp_vid';~~

81 const CONSENT_COUNTRIES = new Set(['AT', 'BE', 'BG', 'HR', 'CY', 'CZ', 'DK', 'EE', 'FI', 'FR', 'DE', 'GR', 'HU', 'IE', 'IT', 'LV', 'LT', 'LU', 'MT', 'NL', 'PL', 'PT', 'RO', 'SK', 'SI', 'ES', 'SE', 'RE', 'GP', 'MQ', 'GF', 'YT', 'BL', 'MF', 'PM', 'WF', 'PF', 'NC', 'AW', 'CW', 'SX', 'FO', 'GL', 'AX', 'GB', 'UK', 'AI', 'BM', 'IO', 'VG', 'KY', 'FK', 'GI', 'MS', 'PN', 'SH', 'TC', 'GG', 'JE', 'IM', 'CA', 'BR', 'IN']);

~~82 const fnv1a = s => {~~

~~83 let h = 0x811c9dc5;~~

~~84 for (let i = 0; i < s.length; i++) {~~

~~85 h ^= s.charCodeAt(i);~~

~~86 h += (h << 1) + (h << 4) + (h << 7) + (h << 8) + (h << 24);~~

~~87 }~~

~~88 return h >>> 0;~~

~~89 };~~

~~90 const bucket = (seed, vid) => fnv1a(fnv1a(seed + vid) + '') % 10000 < 5000 ? 'control' : 'treatment';~~

~~91 const [decision] = useState(() => {~~

~~92 const params = new URLSearchParams(location.search);~~

~~93 const preBucketed = document.documentElement.dataset['gb_' + flag.replace(/-/g, '_')];~~

~~94 const force = params.get('gb-force');~~

~~95 if (force) {~~

~~96 for (const p of force.split(',')) {~~

~~97 const [k, v] = p.split(':');~~

~~98 if (k === flag) return {~~

~~99 variant: v || 'treatment',~~

100 track: false

101 };

102 }

103 }

104 if (navigator.globalPrivacyControl) {

105 return {

106 variant: 'control',

107 track: false

108 };

109 }

110 const prefsMatch = document.cookie.match(/(?:^|; )anthropic-consent-preferences=([^;]+)/);

111 if (prefsMatch) {

112 try {

113 if (JSON.parse(decodeURIComponent(prefsMatch[1])).analytics !== true) {

114 return {

115 variant: 'control',

116 track: false

117 };

118 }

119 } catch {

120 return {

121 variant: 'control',

122 track: false

123 };

124 }

125 } else {

126 const country = params.get('country')?.toUpperCase() || (document.cookie.match(/(?:^|; )cf_geo=([A-Z]{2})/) || [])[1];

127 if (!country || CONSENT_COUNTRIES.has(country)) {

128 return {

129 variant: 'control',

130 track: false

131 };

132 }

133 }

134 let vid;

135 try {

136 const ajsMatch = document.cookie.match(/(?:^|; )ajs_anonymous_id=([^;]+)/);

137 if (ajsMatch) {

138 vid = decodeURIComponent(ajsMatch[1]).replace(/^"|"$/g, '');

139 } else {

140 vid = localStorage.getItem(VID_KEY);

141 if (!vid) {

142 vid = crypto.randomUUID();

143 }

144 document.cookie = `ajs_anonymous_id=${vid}; domain=.claude.com; path=/; Secure; SameSite=Lax; max-age=31536000`;

145 }

146 try {

147 localStorage.setItem(VID_KEY, vid);

148 } catch {}

149 } catch {

150 return {

151 variant: 'control',

152 track: false

153 };

154 }

155 const variant = preBucketed === '1' ? 'treatment' : preBucketed === '0' ? 'control' : bucket(flag, vid);

156 return {

157 variant,

158 track: true,

159 vid

160 };

161 });

162 useEffect(() => {

163 if (!decision.track) return;

164 fetch('https://api.anthropic.com/api/event_logging/v2/batch', {

165 method: 'POST',

166 headers: {

167 'Content-Type': 'application/json',

168 'x-service-name': 'claude_code_docs'

169 },

170 body: JSON.stringify({

171 events: [{

172 event_type: 'GrowthbookExperimentEvent',

173 event_data: {

174 device_id: decision.vid,

175 anonymous_id: decision.vid,

176 timestamp: new Date().toISOString(),

177 experiment_id: flag,

178 variation_id: decision.variant === 'treatment' ? 1 : 0,

179 environment: 'production'

180 }

181 }]

182 }),

183 keepalive: true

184 }).catch(() => {});

185 }, []);

186 return decision.variant === 'treatment' ? treatment : children;

187};

~~188~~

189<Experiment flag="docs-contact-sales-cta" treatment={<ContactSalesCard surface="claude_platform_on_aws" />} />

~~190~~

191AWS 上的 Claude Platform 是 Anthropic 營運的 Claude API，具有 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。請求直接到達 Anthropic 的 API，因此您可以獲得與 [Claude API](https://platform.claude.com/docs) 相同的模型和 API 功能，並遵循相同的發佈時程表。您使用 AWS 認證或工作區 API 金鑰進行驗證，並透過 AWS Marketplace 付款。9AWS 上的 Claude Platform 是 Anthropic 營運的 Claude API，具有 AWS 驗證、IAM 存取控制和 AWS Marketplace 計費。請求直接到達 Anthropic 的 API，因此您可以獲得與 [Claude API](https://platform.claude.com/docs) 相同的模型和 API 功能，並遵循相同的發佈時程表。您使用 AWS 認證或工作區 API 金鑰進行驗證，並透過 AWS Marketplace 付款。

192 10

193Claude Code 透過 Anthropic 的功能旗標服務啟用的用戶端功能預設為關閉，且 [advisor 工具](/docs/zh-TW/advisor) 無法使用。請參閱 [功能可用性矩陣](/docs/zh-TW/feature-availability#summary-by-provider) 以取得完整清單。11Claude Code 透過 Anthropic 的功能旗標服務啟用的用戶端功能預設為關閉，且 [advisor 工具](/docs/zh-TW/advisor) 無法使用。請參閱 [功能可用性矩陣](/docs/zh-TW/feature-availability#summary-by-provider) 以取得完整清單。

194 12

195使用本指南將 Claude Code 指向您已透過 AWS 上的 Claude Platform 佈建的工作區。有關在此之前的 AWS 訂閱和工作區設定，請參閱 [AWS 上的 Claude Platform 文件](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。13使用本指南將 Claude Code 指向您已透過 AWS 上的 Claude Platform 佈建的工作區。有關在此之前的 AWS 訂閱和工作區設定，請參閱 [AWS 上的 Claude Platform 文件](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws)。

196 14

197<Note>15> [!NOTE]

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

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

200 18

201<h2 id="prerequisites">19## 先決條件

202 先決條件

203</h2>

204 20

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

206 22

209* 具有叫用 Anthropic 服務權限的 IAM 主體，或限定於工作區的 API 金鑰25* 具有叫用 Anthropic 服務權限的 IAM 主體，或限定於工作區的 API 金鑰

210* 您環境中的 AWS 認證、`~/.aws/credentials` 中的認證，或來自附加 IAM 角色的認證（如果您想要 SigV4 驗證）。AWS CLI 僅在 SSO 登入流程中需要。26* 您環境中的 AWS 認證、`~/.aws/credentials` 中的認證，或來自附加 IAM 角色的認證（如果您想要 SigV4 驗證）。AWS CLI 僅在 SSO 登入流程中需要。

211 27

212<h2 id="setup">28## 設定

213 設定

214</h2>

215 29

216<h3 id="1-configure-aws-credentials">30### 設定 AWS 認證

217 1. 設定 AWS 認證

218</h3>

219 31

220Claude Code 支援 AWS 上的 Claude Platform 的兩種驗證方法。選擇適合您的團隊如何管理存取的方法：32Claude Code 支援 AWS 上的 Claude Platform 的兩種驗證方法。選擇適合您的團隊如何管理存取的方法：

221 33

222* [使用 SigV4 的 AWS 憑證](#use-aws-credentials-with-sigv4)：以 IAM 主體身分進行身分驗證，憑證來自標準 AWS 憑證鏈34* [使用 SigV4 的 AWS 憑證](#use-aws-credentials-with-sigv4)：以 IAM 主體身分進行身分驗證，憑證來自標準 AWS 憑證鏈

223* [工作區 API 金鑰](#use-a-workspace-api-key)：使用您在 AWS Console 中產生的長期有效金鑰進行身分驗證35* [工作區 API 金鑰](#use-a-workspace-api-key)：使用您在 AWS Console 中產生的長期有效金鑰進行身分驗證

224 36

225<h4 id="use-aws-credentials-with-sigv4">37#### 使用 SigV4 的 AWS 憑證

226 使用 SigV4 的 AWS 憑證

227</h4>

228 38

229Claude Code 使用標準 AWS 認證鏈使用 SigV4 簽署請求：環境變數、`~/.aws/credentials` 中的共享認證、IAM 角色、AWS SSO 工作階段，以及 AWS SDK 支援的任何其他來源。39Claude Code 使用標準 AWS 認證鏈使用 SigV4 簽署請求：環境變數、`~/.aws/credentials` 中的共享認證、IAM 角色、AWS SSO 工作階段，以及 AWS SDK 支援的任何其他來源。

230 40

249 59

250設定 `awsAuthRefresh` 後，執行 `/login`，選取**第三方平台**，然後在**使用第三方平台**下選取 **Claude Platform on AWS · 重新整理認證**。Claude Code 會執行已設定的命令，並重新讀取您的 AWS 認證，而無需重新啟動。60設定 `awsAuthRefresh` 後，執行 `/login`，選取**第三方平台**，然後在**使用第三方平台**下選取 **Claude Platform on AWS · 重新整理認證**。Claude Code 會執行已設定的命令，並重新讀取您的 AWS 認證，而無需重新啟動。

251 61

252<h4 id="use-a-workspace-api-key">62#### 使用工作區 API 金鑰

253 使用工作區 API 金鑰

254</h4>

255 63

256工作區 API 金鑰是長期有效的祕密，在您不想管理聯合 AWS 認證時很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下產生一個，並將其設定為 `ANTHROPIC_AWS_API_KEY`：64工作區 API 金鑰是長期有效的祕密，在您不想管理聯合 AWS 認證時很有用。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下產生一個，並將其設定為 `ANTHROPIC_AWS_API_KEY`：

257 65

263 71

264將工作區 API 金鑰視為任何其他生產認證。[使用者設定檔](/docs/zh-TW/settings) `env` 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。72將工作區 API 金鑰視為任何其他生產認證。[使用者設定檔](/docs/zh-TW/settings) `env` 區塊是在不全域匯出的情況下將金鑰限定於您的機器的便利方式。

265 73

266<Note>74> [!NOTE]

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

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

269 77

270<h3 id="2-configure-claude-code">78### 設定 Claude Code

271 2. 設定 Claude Code

272</h3>

273 79

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

275 81

285 91

286即使您的環境中存在 AWS 認證，AWS 上的 Claude Platform 也是選擇加入的。Amazon Bedrock 和 Microsoft Foundry 在提供者路由中優先，因此如果設定了 `CLAUDE_CODE_USE_BEDROCK` 和 `CLAUDE_CODE_USE_FOUNDRY`，請取消設定它們。92即使您的環境中存在 AWS 認證，AWS 上的 Claude Platform 也是選擇加入的。Amazon Bedrock 和 Microsoft Foundry 在提供者路由中優先，因此如果設定了 `CLAUDE_CODE_USE_BEDROCK` 和 `CLAUDE_CODE_USE_FOUNDRY`，請取消設定它們。

287 93

288<h3 id="3-pin-model-versions">94### 固定模型版本

289 3. 固定模型版本

290</h3>

291 95

292AWS 上的 Claude Platform 使用與直接 Claude API 相同的模型 ID。96AWS 上的 Claude Platform 使用與直接 Claude API 相同的模型 ID。

293 97

308 112

309若要為您的主要對話和 Claude Code 在其外部進行的請求設定不同的 TTL，請[自行選擇 TTL](/docs/zh-TW/prompt-caching#choose-the-ttl-yourself)。113若要為您的主要對話和 Claude Code 在其外部進行的請求設定不同的 TTL，請[自行選擇 TTL](/docs/zh-TW/prompt-caching#choose-the-ttl-yourself)。

310 114

311<h3 id="4-launch-and-verify">115### 啟動並驗證

312 4. 啟動並驗證

313</h3>

314 116

315啟動 Claude Code 並確認路由：117啟動 Claude Code 並確認路由：

316 118

320 122

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

322 124

323<h2 id="use-the-agent-sdk">125## 使用 Agent SDK

324 使用 Agent SDK

325</h2>

326 126

327[Agent SDK](/docs/zh-TW/agent-sdk/overview) 讀取與 CLI 相同的環境變數，因此任何產生 Claude Code 子程序的程式都可以透過在呼叫前匯出 `CLAUDE_CODE_USE_ANTHROPIC_AWS`、`ANTHROPIC_AWS_WORKSPACE_ID` 和 `ANTHROPIC_AWS_API_KEY` 或 AWS 認證來針對 AWS 上的 Claude Platform。127[Agent SDK](/docs/zh-TW/agent-sdk/overview) 讀取與 CLI 相同的環境變數，因此任何產生 Claude Code 子程序的程式都可以透過在呼叫前匯出 `CLAUDE_CODE_USE_ANTHROPIC_AWS`、`ANTHROPIC_AWS_WORKSPACE_ID` 和 `ANTHROPIC_AWS_API_KEY` 或 AWS 認證來針對 AWS 上的 Claude Platform。

328 128

340 140

341此範例依賴環境 AWS 認證鏈進行 SigV4。若要改用工作區 API 金鑰進行驗證，請以相同方式設定 `ANTHROPIC_AWS_API_KEY`。有關更廣泛的 Agent SDK 表面，請參閱 [Agent SDK 概述](/docs/zh-TW/agent-sdk/overview)。141此範例依賴環境 AWS 認證鏈進行 SigV4。若要改用工作區 API 金鑰進行驗證，請以相同方式設定 `ANTHROPIC_AWS_API_KEY`。有關更廣泛的 Agent SDK 表面，請參閱 [Agent SDK 概述](/docs/zh-TW/agent-sdk/overview)。

342 142

343<h2 id="route-through-a-corporate-proxy">143## 透過公司代理路由

344 透過公司代理路由

345</h2>

346 144

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

348 146

361export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com159export ANTHROPIC_AWS_BASE_URL=https://anthropic-proxy.example.com

362```160```

363 161

364<h2 id="troubleshooting">162## Troubleshooting

365 Troubleshooting

366</h2>

367 163

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

369 165

370<h3 id="403-forbidden-or-accessdenied-on-every-request">166### `403 Forbidden` 或 `AccessDenied` 在每個請求上

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

372</h3>

373 167

374Claude Code 解析的 IAM 主體可能缺少在您的工作區中叫用 Anthropic 服務的權限。檢查附加到您的 AWS 設定檔或啟動 Claude Code 的執行器的角色，並驗證它具有 [IAM 動作參考](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions)中記錄的 `aws-external-anthropic` 動作。168Claude Code 解析的 IAM 主體可能缺少在您的工作區中叫用 Anthropic 服務的權限。檢查附加到您的 AWS 設定檔或啟動 Claude Code 的執行器的角色，並驗證它具有 [IAM 動作參考](https://platform.claude.com/docs/zh-TW/api/claude-platform-on-aws-iam-actions)中記錄的 `aws-external-anthropic` 動作。

375 169

376如果您設定了 `ANTHROPIC_AWS_API_KEY`，金鑰優先於 SigV4，過期的金鑰會產生相同的錯誤。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下重新產生金鑰，或取消設定變數以回退到您的 AWS 認證。170如果您設定了 `ANTHROPIC_AWS_API_KEY`，金鑰優先於 SigV4，過期的金鑰會產生相同的錯誤。在 AWS Console 中的 **Claude Platform on AWS → API keys** 下重新產生金鑰，或取消設定變數以回退到您的 AWS 認證。

377 171

378<h3 id="requests-fail-with-a-missing-workspace-error">172### 請求失敗，出現遺失工作區錯誤

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

380</h3>

381 173

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

383 175

384<h3 id="requests-still-go-to-api-anthropic-com">176### 請求仍然轉到 `api.anthropic.com`

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

386</h3>

387 177

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

389 179

390<h2 id="additional-resources">180## 其他資源

391 其他資源

392</h2>

393 181

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

395 183

claude-platform-on-aws.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

AWS 上的 Claude Platform 上的 Claude Code

先決條件

設定

設定 AWS 認證

使用 SigV4 的 AWS 憑證

使用工作區 API 金鑰

設定 Claude Code

固定模型版本

啟動並驗證

使用 Agent SDK

透過公司代理路由

Troubleshooting

403 Forbidden 或 AccessDenied 在每個請求上

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

請求仍然轉到 api.anthropic.com

其他資源

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

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