SSD Nodes Learn Hosting plans →
指南 Matt Connor作者: Matt Connor

如何在 Bedrock 或 Vertex AI 執行 Claude Code

了解在 Amazon Bedrock 或 Google Vertex AI 執行 Claude Code 所需的環境變數、credentials 來源、帳單歸屬,以及會失去哪些功能。

在你自己的 cloud account 上執行 Claude Code 時有哪些變化

你可以在 Amazon Bedrock 或 Google Vertex AI 上執行 Claude Code。切換時只需設定兩或三個環境變數,再搭配團隊已有的 cloud credentials。所有本機功能都維持不變,包括 CLI、subagents、hooks、skills、MCP servers 和 CLAUDE.md 檔案。只有模型呼叫會轉移到雲端,並且會連帶改變以下 4 件事:請求經過的網路、支付費用的 account、你獲准呼叫的 Claude models,以及伺服器端是否提供相關功能。

問題通常不是能否運作。它可以正常運作。真正需要考量的是,你最在意這 4 項中的哪一項。

3 種路由,以及各自的代價

直接使用 Anthropic 搭配訂閱方案。 使用 Pro、Max、Team 或 Enterprise 方案的 claude.ai 帳戶登入。請求會傳送至 Anthropic 的 API。Pro、Max 與 Team 方案按使用者席次計費,使用量受方案上限限制,而不是依 token 用量計費。目前的 Enterprise 方案例外:席次費不包含使用量,每個 token 都會依標準 API 費率另行計費;舊有按席次計費的 Enterprise 合約,也會在續約時改用這種模式。只有這種路由能存取以帳戶為基礎的介面,例如網頁版 Claude Code、行動應用程式與 Remote Control。對團隊而言,Team 方案已包含單一登入,以及由伺服器管理的組織級 Claude Code 設定;Claude Enterprise 方案則在此基礎上增加稽核日誌、SCIM、自訂資料保留控制項與 Compliance API。

直接使用 Anthropic 搭配 API key。 在 Anthropic Console 建立 key,並按 token 用量付費。基礎架構與區域和訂閱方案相同,不需支付席次費,使用量會顯示在 Anthropic 自有的儀表板中。兩者哪一種較便宜,取決於代理程式每天實際執行多少小時;這正是API 與訂閱方案的成本比較以及Claude Code 實際成本所探討的主題。

在 Bedrock 或 Vertex 上使用第三方端點。 由你自己的 AWS 或 Google Cloud 帳戶提供模型服務。推論時,請求不會經過 Anthropic。token 用量會計入你原本就會收到的帳單,並受你現有的 IAM(身分與存取管理)政策及稽核日誌管理。另有 Microsoft Foundry 與 AWS 上的 Claude Platform 這 2 種第三方選項,其運作方式相同:由 1 個環境變數選取供應商,費用則由雲端帳戶支付。

名稱說明,截至 2026 年 10 月:Google 已將 Vertex AI 重新命名為 Google Cloud 的 Agent Platform。Anthropic 的文件使用新名稱,但 Claude Code 的登入提示仍顯示 Google Vertex AI,環境變數仍使用 VERTEX。

資料落地位置才是團隊採用這種做法的真正原因

在 Bedrock 上,請求會送至你所選 AWS 區域中的 Bedrock endpoint,且位於你自己的帳戶內。靜態資料會使用 AWS 管理的金鑰以 AES-256 加密;你也可以透過 AWS KMS(key management service)提供自己的金鑰。在 Vertex 上,對應機制是使用 Google 管理的加密金鑰,也可使用 CMEK(customer-managed encryption keys)。存取權限由你現有的 IAM roles 管理,這些呼叫也會如同其他 API 呼叫一樣,記錄在 CloudTrail 或 Cloud Audit Logs 中。對受法規規範的團隊而言,這就是完整的理由,而且是充分的理由。

不過,有兩個細節使實際情況不像行銷內容所說得那麼絕對。

跨區域 inference profile 並不代表單一區域。 在 Bedrock 上,Claude Code 會將內建的預設模型解析為跨區域 inference profile ID,而偏好的 prefix 取決於解析結果所在的區域:us. 位於 us-* 區域、eu. 位於 eu-* 區域、apac. 位於 ap-* 區域,以及 us-gov. 位於 GovCloud。跨區域 profile 可能會在該地理區域內的其他區域處理請求,因此你取得的保證是地理區域,而不是單一城市。若需求指定單一區域,請透過你所管理的 application inference profile 轉送,並將 ANTHROPIC_MODEL 設為其 ARN。

部分流量仍會傳送至 Anthropic,但其中不包含你的程式碼。 在 Bedrock 和 Vertex 上,遙測、錯誤回報及 /feedback command 預設都是停用的;/feedback 會在你自己的電腦上於 ~/.claude/feedback-bundles/ 建立封存檔,而不是上傳任何資料。每個 provider 都有兩項例外。WebFetch tool 在擷取 URL 前,會將主機名稱,而且只有主機名稱,傳送至 api.anthropic.com,以檢查安全封鎖清單。工作階段品質調查仍會顯示。你可以在設定檔中使用 skipWebFetchPreflight 關閉前者,並使用 CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY=1 關閉後者。設定 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 也會停止這些調查,以及其他非必要流量,但不會影響 WebFetch 檢查;該檢查有自己的退出設定。

關於訓練:依商業條款,Anthropic 不會使用透過 Claude Code 傳送的程式碼或提示來訓練模型,第三方平台的使用也屬於商業用途。允許訓練的選擇加入方案 Development Partner Program,完全不提供給 Bedrock 或 Vertex 使用者。這些 endpoint 是否零資料保留,取決於你與 AWS 或 Google 簽訂的協議。

將 Claude Code 指向 Amazon Bedrock

在任何用戶端設定生效前,每個 AWS 帳戶都必須先完成兩件事。開啟 Amazon Bedrock 主控台,從模型目錄選取 Anthropic 模型,並提交使用案例表單;提交後會立即授予存取權。接著附加允許 Claude Code 發出請求的 IAM 政策。

  • bedrock:InvokeModel
  • bedrock:InvokeModelWithResponseStream
  • bedrock:ListInferenceProfiles
  • bedrock:GetInferenceProfile

ListInferenceProfiles 可讓 Claude Code 在啟動時確認帳戶實際可呼叫的模型。GetInferenceProfile 可將應用程式推論設定檔 ARN 解析回其背後的基礎模型,讓 Claude Code 選擇正確的請求格式。缺少這項權限時,請求仍會成功,因為 Claude Code 會以另一種格式重試一次。其現象是每個新模型會多一次往返,而不是發生錯誤。Anthropic 發布的政策也允許透過 Bedrock 呼叫 aws-marketplace:ViewSubscriptions 和 aws-marketplace:Subscribe,涵蓋模型訂閱步驟。

最快的用戶端設定方式是使用精靈。執行 claude,選擇 3rd-party platform,再選擇 Amazon Bedrock;或者在已登入的工作階段中輸入 /setup-bedrock。它會讀取 ~/.aws 目錄中的設定檔,驗證可呼叫的模型,並將結果寫入 ~/.claude/settings.json 的 env 區塊,因此不會依賴 shell 設定檔。

若要以指令碼部署,請自行設定變數。

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1

認證資訊來自標準 AWS SDK 認證鏈,因此凡是能用於 aws CLI 的認證方式,也能在此使用:aws configure、SSO 設定檔、assumed role 或 Bedrock API key。

aws sso login --profile=your-profile-name
export AWS_PROFILE=your-profile-name
export AWS_BEARER_TOKEN_BEDROCK=your-bedrock-api-key

Bearer token 是最簡單的選項,也是最需要謹慎處理的選項,因為它是存放在環境變數中的 secret。AWS 會核發最長有效期為 12 小時的短期金鑰,以及有效至指定日期的長期金鑰;AWS 建議長期金鑰只用於探索。對共用的建置主機,優先使用會過期的 role。相同原則也適用於 agent 可讀取的其他所有認證資訊;相關內容請參閱 避免讓 AI agent 取得 secrets。

區域陷阱。 Claude Code 會依下列順序解析區域:AWS_REGION、AWS_DEFAULT_REGION、目前 AWS 設定檔中的 region,最後是 us-east-1。最後一項是預設值,不是錯誤;因此,若團隊未在任何位置設定區域,卻以為流量會經由歐洲路由,請求會在沒有任何警告的情況下傳送至美國區域。請在 Claude Code 中執行 /status,查看解析出的區域及其來源。若要確認帳戶在某個區域可呼叫的內容,請執行 aws bedrock list-inference-profiles --region your-region。

在 Google Vertex AI 上執行 Claude Code

啟用 API 並取得憑證。

gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com
gcloud auth application-default login

在 Model Garden 中申請所需 Claude 模型的存取權。核准不會立即完成,請預留 24 到 48 小時。授予 roles/aiplatform.user,其中包含模型呼叫與 token 計數都會使用的 aiplatform.endpoints.predict 權限。

接著選取 provider。

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

CLOUD_ML_REGION 可接受 global、eu 或 us 等多區域位置,也可接受單一區域。global endpoint 的可用性最高,但對請求實際處理位置的控制最少,因此有資料駐留要求時,通常應改為指定位置。這 3 種形式涵蓋的模型並不相同。當 global endpoint 缺少所需模型時,只將該模型透過 VERTEX_REGION_CLAUDE_* 變數固定到指定位置,其餘設定維持 global。請查看最新的 Vertex AI locations 頁面,不要依賴已經過時的清單。

專案陷阱。 ANTHROPIC_VERTEX_PROJECT_ID 決定請求的目的地。即使 GCLOUD_PROJECT、GOOGLE_CLOUD_PROJECT 或 GOOGLE_APPLICATION_CREDENTIALS 指定的憑證檔案包含不同的專案,Claude Code 仍會將請求傳送至該專案。在 gcloud 指向一個專案、遺留的 ANTHROPIC_VERTEX_PROJECT_ID 卻指定另一個專案的機器上,費用會計入後者,而且工作階段不會顯示任何警告。

每次變更 provider 後都要驗證。執行 /status:API provider 行會顯示 Google Vertex AI,而 GCP project、Default region 與 Model 行會顯示 Claude Code 實際解析出的值。如果缺少 provider 行,表示變數沒有傳遞給程序,因為它們是在啟動 claude 的不同 shell 中 export 的。將這些變數移到設定檔的 env 區塊,也能避免像 AWS_PROFILE 這類值出現在你啟動的其他程序中。

取得哪些模型,以及它們會延遲多久推出

sonnet 和 opus 等別名不代表最新版本。在第三方端點上,這些別名會解析為 Claude Code 針對該供應商內建的預設模型。該模型可能落後於目前版本,也可能根本未在您的帳戶中啟用。預設模型無法使用時,Claude Code 會在該工作階段改用較早版本或較低階的模型,並顯示通知。這項 fallback 不會儲存,因此下一個工作階段會再次嘗試,並再次顯示通知。

若要在團隊中推行,請固定模型版本。

# Copy the exact IDs from your provider's own model catalog.
export ANTHROPIC_DEFAULT_OPUS_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_SONNET_MODEL='<provider model id>'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='<provider model id>'

請從 models overview 和您的供應商型錄取得 ID,因為不同供應商的格式不同:Bedrock 需要 inference profile ID 或 ARN,Vertex 需要純模型名稱。不要從文章中複製 ID,包括本文。固定版本也有助於控制成本,因為預設的主要模型是 Opus 類別模型,而 Opus 每個 token 的費用高於 Sonnet。因此,未固定任何模型的部署會以較高費率計費。若要改為將單一模型固定為工作階段的預設模型,請將 ANTHROPIC_MODEL 設為該模型的完整 ID。

在這項比較中,模型推出時間是最明顯的取捨。在 Anthropic 自有 API 上,模型於發布當天即可使用。在 Bedrock 和 Vertex 上,必須等到雲端供應商在您的區域啟用該模型,且您的帳戶獲得存取權後才能使用;最快也要延遲數天,有時甚至更久。若有工作必須使用最新模型,請保留一條能連線到該模型的 routing。這就是將不同模型路由至不同工作的實際用途。

在 Bedrock 與 Vertex 上需要放棄的功能

所有本機功能都能在每個提供者上運作,包括子代理程式、hooks、斜線命令、skills、plugins、checkpoints、sandboxing、managed settings file 與 OpenTelemetry metrics。差異都在伺服器端。

兩個端點都無法使用的功能包括 fast mode、Advisor、Channels、analytics dashboard、server-managed settings,以及 /design-sync 和 /import 命令。凡是需要 claude.ai 帳戶的功能也無法使用,包括 Claude Code on the web、mobile app、Remote Control、routines 與 artifacts。

Bedrock 特有的限制:其中不存在 WebSearch 工具,因此 Claude 無法從路由至 Bedrock 的工作階段執行搜尋。提供 URL 後,仍可使用 WebFetch 讀取網頁。在 Vertex 上,Claude 4 generation models 及更新版本支援網頁搜尋。

兩者都只有部分支援:auto mode 只能在一組受限的新型 models 上執行;跨工作階段訊息只能傳送至同一台機器上的其他工作階段;而需要自行選擇執行間隔的 /loop 必須使用 Claude Code v2.1.248 或更新版本。Desktop 只能透過 3P 上的 Claude Desktop 存取;在 Vertex 上,也能透過 managed settings 中設定的 Enterprise deployment 存取。在向團隊承諾某項功能前,請先查看 Anthropic 的 功能可用性 頁面,因為這份清單會變動。

費用由誰負擔

訂閱方案與第三方端點是兩筆獨立的採購。兩者不能互相取代。

這點值得明確說明,因為這類錯誤不會顯示警告。在同時登入 Max seat 的機器上設定 CLAUDE_CODE_USE_BEDROCK=1 後,網路流量會由 AWS 計費:依 Bedrock 隨用隨付費率按 token 計費,或從帳戶購買的 provisioned throughput 中扣除。seat 仍會按月收費,且不包含任何這類流量費用。兩者也沒有整合的檢視畫面:支出會顯示在 AWS Cost Explorer 或 Google Cloud Billing 中,而 Anthropic analytics dashboard 在這兩個供應商上都無法使用。/logout command 也會消失,因為不存在可結束的 Anthropic session。此時使用的是 cloud credential。

費率位於各供應商自己的頁面上,且可能變動,因此請查閱 Amazon Bedrock pricing 或 Vertex AI pricing,不要依賴文章中的任何數字。有一點不會改變:這些端點上的隨用隨付 inference 會依 token 計費,因此 agent 若全天執行,費用就會隨使用量增加,沒有 plan cap 可限制支出。兩家 cloud 都提供的替代方案是 provisioned throughput,也就是在持有期間以固定費用保留容量。AWS 按小時計費;設定 provisioned throughput ARN 作為 model ID 後,Claude Code 就會使用它。究竟哪種方案比替所有人購買 seat 更划算,應在 rollout 前計算,而不是等到收到第一張帳單後才處理;Team 與 Enterprise 的 seat 對比按 token 計費會以團隊規模進行比較。

各路由的速率限制與配額運作方式不同

在訂閱方案中,限制屬於帳戶,並依排程重設。達到限制後通常必須等待;但若已啟用用量額度,則不受此限:Pro 和 Max 訂閱者,以及 Team 和較早採用席位制的 Enterprise 組織,都能在達到限制後,繼續以標準 API 速率使用,直到達到支出上限。現行按用量計費的 Enterprise 方案沒有會用盡的內含額度,因為每個 token 都已計費。相關行為說明請參閱 用量限制的運作方式。

在 Anthropic API key 中,限制屬於組織,以每分鐘的請求數與 token 數表示,並會隨用量層級提高。

在 Bedrock 和 Vertex 上,限制是雲端配額,與任何 Anthropic 方案都無關。在 Bedrock 上,配額依帳戶和區域設定,主要按模型區分,另有適用於整個帳戶的每日 token 配額。在 Vertex 上,配額依專案和位置設定。對於 global 和 multi-region endpoint,2026 年 5 月 26 日之後發布的 Claude 模型會共用相同的模型系列配額:在指定位置中,同一模型系列的每個版本都會消耗同一個配額桶,而 global endpoint 與每個 multi-region endpoint 則各自使用獨立的配額桶。429 通常表示其中一項配額已用盡;但在共用的隨用隨付容量中,也可能表示提供者容量不足,因此請先採用退避策略重試,再變更設定。若問題出在你的配額,應在提供者的主控台處理:申請提高配額,或改用仍有餘裕的位置。Bedrock 依 token burndown 規則計算配額,而不是採用固定的請求數;任一雲端的保留容量都必須以 provisioned throughput 購買。在 Vertex 上,429 通常表示單一區域 endpoint 無法同時服務主要模型和小型快速模型,這也是為何 CLOUD_ML_REGION=global 是文件建議的起始點。Google 的 配額 頁面說明提高配額的申請方式。

失敗情況與畫面中會看到的字串

Could not load the default credentials,在 Vertex 上。 Application Default Credentials 遺失或已過期。執行 gcloud auth application-default login,或將 GOOGLE_APPLICATION_CREDENTIALS 指向 service account key 檔案。

指出模型名稱的 404,在 Vertex 上。 該模型未在該專案的 Model Garden 中啟用,或該模型不提供於你設定的位置。有些模型只能透過 global endpoint 或 eu 等多區域位置提供,無法在特定區域使用。

on-demand throughput isn't supported,在 Bedrock 上。 你為只能透過 inference profile 提供的模型傳入了單獨的 foundation model ID。請改用 inference profile ID。

AWS default-chain credential resolve timed out。 AWS credential chain 中的某個步驟卡住,最常見的原因是 credential_process helper 等待永遠不會收到的輸入。每次解析 chain 都會在 60 秒後逾時。如果 chain 確實需要更長時間,例如 wrapper 後方使用 MFA(多因素驗證)的瀏覽器 SSO 流程,請透過 CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS 以毫秒為單位提高限制。

啟動 Bedrock streaming response has content-type 時發生錯誤。 Claude Code 與 Bedrock 之間的某個元件正在改寫串流。Bedrock 使用內容類型為 application/vnd.amazon.eventstream 的二進位 event-stream 格式傳送串流,因此 gateway 若將其重新輸出為 server-sent events,會回傳 Claude Code 無法解碼的內容。請修正 gateway,讓它原封不動地傳遞 response body 與其 Content-Type 標頭。

AWS SSO 期間瀏覽器分頁持續循環開啟。 公司 VPN 或 TLS 檢查 proxy 中斷登入流程,Claude Code 將損壞的連線判定為驗證失敗,重新執行 awsAuthRefresh command,並無限重複。請從設定檔移除 awsAuthRefresh,再手動執行 aws sso login,然後啟動 Claude Code。

選擇路由

如果您希望在新模型發布當天立即使用,並取得完整功能,請選擇 Anthropic direct。如果您希望依 token 計費,且不想購買 seats,請使用 API key。如果要求 inference 必須在您已治理的 cloud account 內執行,且可接受較慢的模型 pipeline 及較精簡的功能清單,請選擇 Bedrock 或 Vertex。值得加入書籤的設定頁面包括 Anthropic 官方的 Amazon Bedrock 與 Google Vertex AI 頁面,以及 AWS 的 models by region 清單。

這 3 種方式都不會改變 agent 本身的執行位置。無論是哪個 endpoint 回應,Claude Code 都是讀取檔案並執行命令的本機 process。這就是為什麼希望在 laptop 以外的位置執行它的團隊,會將 coding agent 部署在 VPS 上,並在該處匯出相同的變數。

FAQ

Claude 訂閱是否包含在 Bedrock 或 Vertex 上使用 Claude Code 的費用?

不包含。Pro、Max、Team 或 Enterprise seat 與第三方 endpoint 是分開購買的,兩者互不涵蓋。設定 CLAUDE_CODE_USE_BEDROCK=1 或 CLAUDE_CODE_USE_VERTEX=1 後,網路流量會由 AWS 或 Google Cloud 依 token 及其隨用隨付費率計費,或從您購買的 provisioned throughput 中扣除,費用會列在對應的 cloud 帳單上;seat 則會繼續按月收費,涵蓋其支援的介面。費用追蹤也會移至 AWS Cost Explorer 或 Google Cloud Billing,因為 Anthropic analytics dashboard 在這兩家 provider 上都無法使用。

Claude Code 會將我的請求傳送到 Amazon Bedrock 的哪個 region?

傳送到解析出的 region;/status 會顯示該 region。Claude Code 會依序檢查 AWS_REGION、AWS_DEFAULT_REGION,以及您目前 AWS profile 上的 region。如果這些項目都未設定,則改用 us-east-1。內建的預設 model 會解析為 cross-region inference profile,其 prefix 會依該 region 而定,例如 us. 或 eu.;cross-region profile 可以從同一 geography 內的其他 region 處理請求。如果明確要求使用某個 named region,請使用由您管理的 application inference profile,並將 ANTHROPIC_MODEL 設為其 ARN。

為什麼我的 Bedrock 或 Vertex account 中沒有最新的 Claude model?

因為各 cloud provider 會依自己的時程啟用 model,而且您的 account 還必須取得存取權限。在 Vertex 上,您要先於 Model Garden 申請存取權限,核准可能需要 24 到 48 小時。在此之前,sonnet 和 opus 等 alias 會解析為 Claude Code 針對該 provider 內建的預設 model。如果該預設 model 無法在您的 account 中使用,Claude Code 會在本次 session 中改用較早或較低階的 model,並顯示通知。請將 ANTHROPIC_DEFAULT_SONNET_MODEL 及其同類設定固定為已確認啟用的 ID。

不提供。Bedrock 不支援 WebSearch tool,因此 Claude 無法從經由 Bedrock 路由的 session 執行搜尋。不過,您提供 URL 後,仍可使用 WebFetch 讀取特定頁面。在 Google Vertex AI 上,web search 可供 Claude 4 generation model 及後續版本使用;這是少數對 Vertex 有利的功能差異之一。

在 Bedrock 或 Vertex 上執行 Claude Code 是否需要 Anthropic account?

不需要。驗證使用的是您的 AWS 或 Google Cloud credential,因此 /logout 在這兩個 provider 上都無法使用。不論使用哪個 provider,仍有一項連線會連到 Anthropic:WebFetch tool 取得 URL 前,會將 hostname,且僅限 hostname,傳送至 api.anthropic.com,以檢查該 hostname 是否列於安全封鎖清單。請在設定檔中設定 skipWebFetchPreflight 以關閉此功能;如果仍要限制 Claude 可連線的 domain,請搭配 WebFetch permission rules 使用。

這篇文章對您有幫助嗎?