結論先說
- 最快路徑是用內置嚮導
/setup-bedrock:首次運行claude在登入頁選 第三方平台(3rd-party platform)> Amazon Bedrock,或在已有會話裏完整輸入/setup-bedrock,即可按提示選認證、選區域並把配置寫進用戶級設定。 - 手動配置核心是兩個變量:開啟
CLAUDE_CODE_USE_BEDROCK=1,並顯式指定AWS_REGION(Claude Code 不會自動讀取.aws/config裏的預設區域)。 - IAM 權限不能漏掉推理配置文件(Inference Profiles):新版本 Claude 模型在 Bedrock 上普遍通過跨區域推理配置文件調用,IAM 策略除了
bedrock:InvokeModel*還要放行bedrock:ListInferenceProfiles與bedrock:GetInferenceProfile。 - 生產環境建議顯式固定(Pin)模型 ID:用
ANTHROPIC_DEFAULT_SONNET_MODEL等變量綁定帳號已開通的推理配置文件 ID,防止客戶端升級預設模型後在當前區域報未開通錯誤。 - 注意兩項平台差異:走 Bedrock 時認證歸 AWS 接管,
/logout命令不可用;內置的WebSearch聯網搜尋工具在 Bedrock 後端下也不支持。 - Claude Code 訂閱與高配額開通入口:國內無境外卡可通過本站 iOS 免上號自助卡密開通 Claude Pro 會員 或 5 倍以上額度的 Claude Max 會員,完整檔位選型見 Claude Code 訂閱說明頁。

圖:本站根據 Claude Code 官方文檔:Claude Code on Amazon Bedrock 整理的示意圖
本文根據 Claude Code 官方文檔《Claude Code on Amazon Bedrock》《Enterprise deployment overview》《Model configuration》整理,資料核對於 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 或 AWS 官方網站。
適用於誰
- 搜「claude code 配置 bedrock」「claude code aws bedrock 權限」,想讓終端編碼請求走企業 AWS 統一帳單與合規邊界的開發者和運維工程師;
- 配了
CLAUDE_CODE_USE_BEDROCK=1後遇到AccessDeniedException、找不到跨區域模型 ID 或 AWS SSO 令牌過期斷連的人; - 想分清交互式嚮導
/setup-bedrock與手動寫settings.json各自怎麼配的人。
如果你只是想先弄清「換 Claude 型號」與「換雲廠商平台」的區別,可先看 Claude Code 可以使用其他模型嗎。
一、前置準備:在 AWS 控制檯開通模型與配置 IAM 最小權限
在改本地終端配置前,先確認目標 AWS 帳號和 IAM 身份滿足兩項條件:
- 開通 Anthropic 模型訪問權:登入 Amazon Bedrock 控制檯(Amazon Bedrock Console),進入左側 模型目錄(Model catalog) 選中計劃使用的 Claude 模型(如 Sonnet、Opus、Haiku),提交一次用例說明表單(Use case details)。官方說明每個 AWS 帳號只需提交一次,通常提交後立即生效。
- 綁定 IAM 最小權限策略:給開發者的 IAM Role、SSO Permission Set 或 IAM User 掛載調用與查詢權限。按官方推薦整理的最小權限 JSON 如下:
json
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowClaudeCodeBedrockInvoke",
"Effect": "Allow",
"Action": [
"bedrock:InvokeModel",
"bedrock:InvokeModelWithResponseStream",
"bedrock:ListInferenceProfiles",
"bedrock:GetInferenceProfile"
],
"Resource": "*"
},
{
"Sid": "AllowMarketplaceModelSubscription",
"Effect": "Allow",
"Action": [
"aws-marketplace:ViewSubscriptions",
"aws-marketplace:Subscribe"
],
"Resource": "*",
"Condition": {
"StringEquals": {
"aws:CalledViaLast": "bedrock.amazonaws.com"
}
}
}
]
}
其中第二段 aws-marketplace 條件權限用於滿足部分區域首次調用第三方模型時的訂閱校驗;若安全團隊要求鎖死 Resource,需把基礎模型 ARN(foundation-model/)和跨區域推理配置文件 ARN(inference-profile/)一併列入白名單。
二、準備 AWS 本地憑證:四種官方認證方式對照
Claude Code 底層複用標準 AWS SDK 憑證鏈,也支持近年新增的 Bedrock 專用 API Key(與直連 Anthropic 密鑰的優先級差異見 Claude Code 不登入直接用 API Key):
| 認證方式 | 適用場景 | 關鍵配置項 |
|---|---|---|
| AWS IAM Identity Center(SSO) | 企業員工日常開發(推薦) | 運行 aws sso login --profile=<名稱>,設定 AWS_PROFILE=<名稱> |
| Bedrock API Key | 快速測試或不想裝 AWS CLI | 設定環境變量 AWS_BEARER_TOKEN_BEDROCK=<你的密鑰> |
| 訪問密鑰(Access Key) | 傳統 IAM 用戶或固定環境 | 運行 aws configure 或設 AWS_ACCESS_KEY_ID 與 AWS_SECRET_ACCESS_KEY |
| STS 臨時會話憑證 | 跨帳號扮演角色(AssumeRole) | 同時傳入 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN |
企業用 AWS SSO 時最常遇到「寫代碼到一半臨時令牌過期報錯」。官方提供了自動刷新配置:在 ~/.claude/settings.json 頂層加上 awsAuthRefresh 字段(設定文件結構詳見 Claude Code settings.json 配置詳解),檢測到憑證失效時會自動拉起登入命令:
json
{
"awsAuthRefresh": "aws sso login --profile my-corp-profile",
"env": {
"AWS_PROFILE": "my-corp-profile"
}
}
三、開啟 Bedrock 模式並固定區域與模型 ID
方法 A:使用交互式嚮導 /setup-bedrock
本地憑證就緒後,在終端運行 claude:
- 若尚未登入,在啟動選單選 第三方平台(3rd-party platform),再選 Amazon Bedrock;
- 若之前已用個人帳號登入過、直接進了對話框,手動完整輸入
/setup-bedrock並回車(官方說明未開啟CLAUDE_CODE_USE_BEDROCK=1前,該命令不會顯示在/下拉提示裏); - 按嚮導提示選擇憑證來源與 AWS 區域,嚮導會自動探測當前帳號有權限調用的 Claude 版本,並將結果寫入用戶級
settings.json。
方法 B:手動寫入環境變量或 settings.json
需要在團隊內部標準化分發配置,或寫進自動化腳本時,先在終端查出當前區域可用的推理配置文件 ID:
bash
aws bedrock list-inference-profiles --region us-east-1 \
--query "inferenceProfileSummaries[?contains(inferenceProfileId, 'anthropic')].[inferenceProfileId,inferenceProfileName]" \
--output table
隨後把開關、區域和主備模型 ID 寫進 ~/.claude/settings.json 的 env 對象(也可以用 export 寫入 ~/.zshrc):
json
{
"env": {
"CLAUDE_CODE_USE_BEDROCK": "1",
"AWS_REGION": "us-east-1",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "us.anthropic.claude-sonnet-4-6-v1",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "us.anthropic.claude-opus-4-6-v1",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "us.anthropic.claude-haiku-4-5-20251001-v1:0"
}
}
這裏用 ANTHROPIC_DEFAULT_SONNET_MODEL、OPUS_MODEL、HAIKU_MODEL 分別綁定三檔模型別名後,會話裏照常敲 /model 就能在已綁定的型號間順暢切換(切換細節見 Claude Code 切換模型),後台輕量任務也會自動走你指定的 Haiku ID。啟動後輸入 /status,看到 API provider 顯示為 Amazon Bedrock 即表示接通。
如果你是獨立開發者,手上沒有現成企業 AWS 帳號,也不想折騰 IAM 策略和按 Token 浮動出帳,直接開通個人固定週期額度的 Claude Pro 或 Claude Code 訂閱方案 會省去整套雲端運維步驟。
四、常見報錯排查

圖:本站根據 Claude Code 官方文檔:Claude Code on Amazon Bedrock 整理的示意圖
- 報
Region is missing或連錯區域:即便~/.aws/config裏配了region = us-west-2,也必須在環境變量或settings.json的env裏顯式聲明AWS_REGION。 - 報
ValidationException: Invocation of model ID ... with on-demand throughput isn't supported:新模型在 Bedrock 上不支持直接填裸基礎模型 ID 按需調用,必須改成帶us.、eu.、apac.或global.前綴的跨區域推理配置文件 ID(Inference Profile ID)或應用推理配置文件 ARN。 - 提示詞緩存(Prompt Caching)異常:Bedrock 預設支持提示詞緩存以降低長代碼庫延遲與成本;只有當你在個別受限區域遇到緩存報錯排查問題時,才需要臨時加
DISABLE_PROMPT_CACHING=1關閉。 - Windows 下沒有註冊 PowerShell 工具:官方說明通過第三方雲平台運行時,Windows 原生 PowerShell 工具預設不開啟;若需要啟用,可在
env中加"CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"。
常見問題
問:接了 Bedrock 之後,怎麼退出或切回個人 Claude 訂閱?
答:走 Bedrock 時 /logout 命令不生效。要把後端切回個人訂閱或官方 Console,需在環境變量中取消 CLAUDE_CODE_USE_BEDROCK(或刪掉 settings.json 裏對應的 env 項),重開終端後再運行 claude 執行 /login。
問:能不能給主模型和輕量小模型指定不同的 AWS 區域?
答:可以。官方支持通過 ANTHROPIC_SMALL_FAST_MODEL_AWS_REGION 單獨指定輕量後台模型的調用區域,其餘請求仍走主 AWS_REGION。
問:為什麼在 Bedrock 模式下讓 Claude 聯網查最新文檔沒反應?
答:官方文檔寫明,Anthropic 原生的服務端 WebSearch 工具目前在 Bedrock 上不可用。若需檢索外部網頁或文檔,可通過本地或遠程 MCP 伺服器補充檢索能力。
問:國內沒有海外銀行卡,怎麼給 Claude Code 開通 Pro 或 Max 訂閱?
答:可在 Claude Code 訂閱頁 選擇走 iOS 訂閱鏈路的 Claude Pro 自助卡密 或 Claude Max 充值,支持支付寶、微信支付與 AlipayHK,無需交出帳號密碼;若帳號彈出身份核驗也可查看 Claude KYC 認證人工協助(失敗不收費,封號不在質保範圍)。
相關教學
- Claude Code 可以使用其他模型嗎:換型號與三大雲平台概覽
- Claude Code settings.json 配置詳解:文件位置、優先級與常用示例
- Claude Code 切換模型:/model 命令、模型別名、effort 與 fast 模式
- Claude Code 不登入直接用 API Key:憑據優先級與配置說明
參考資料
- Claude Code 官方文檔:Claude Code on Amazon Bedrock — https://code.claude.com/docs/en/amazon-bedrock
- Claude Code 官方文檔:Enterprise deployment overview — https://code.claude.com/docs/en/third-party-integrations
- Claude Code 官方文檔:Model configuration — https://code.claude.com/docs/en/model-config
0 條評論
還沒有評論,來搶沙發~