Claude Code 接入 Amazon Bedrock 完整步驟:AWS 憑證、IAM 最小權限、區域與模型 ID 配置

想讓 Claude Code 走公司 AWS 帳單調用 Claude 模型?本文按官方文檔整理 Amazon Bedrock 完整配置流程:控制檯模型開通、IAM 最小權限策略、四種 AWS 認證方式、/setup-bedrock 嚮導與跨區域模型 ID 固定寫法。

NNathaniel bigo··原創首發·AI 輔助撰寫
14 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 其他 帳號

結論先說

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

接入 Amazon Bedrock 四步流程

圖:本站根據 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 身份滿足兩項條件:

  1. 開通 Anthropic 模型訪問權:登入 Amazon Bedrock 控制檯(Amazon Bedrock Console),進入左側 模型目錄(Model catalog) 選中計劃使用的 Claude 模型(如 Sonnet、Opus、Haiku),提交一次用例說明表單(Use case details)。官方說明每個 AWS 帳號只需提交一次,通常提交後立即生效。
  2. 綁定 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:

  1. 若尚未登入,在啟動選單選 第三方平台(3rd-party platform),再選 Amazon Bedrock;
  2. 若之前已用個人帳號登入過、直接進了對話框,手動完整輸入 /setup-bedrock 並回車(官方說明未開啟 CLAUDE_CODE_USE_BEDROCK=1 前,該命令不會顯示在 / 下拉提示裏);
  3. 按嚮導提示選擇憑證來源與 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 訂閱方案 會省去整套雲端運維步驟。

四、常見報錯排查

Bedrock 接入常見報錯與認證排查對照

圖:本站根據 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 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

Nathaniel 的更多內容

  1. 01

    獨立開發者用 ChatGPT + Codex 跑通產品全流程:市場驗證、PRD、原型到代碼上線覆盤清單

    單人做獨立產品最容易陷入「閉門寫兩個月代碼上線零用戶」或「AI 寫到一半目錄越改越崩」。本文整理「ChatGPT 負責市場驗證、PRD 與覆盤 + Codex 負責工程實現與測試」的五階段雙軌流程,附起手提示詞與 7 項上線覆盤清單。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成規範文件命名規則、整理混亂目錄樹與合併零散發票抬頭清單腳本

    面對滿桌面的「新建文件夾」「最終版2」和上百張零散電子發票,手工改名抄台帳耗時又容易漏重。本文分享先脫敏取樣、再用 ChatGPT 生成帶預演和回滾日誌的本地 Python 腳本,離線安全完成目錄整理與發票抬頭合併去重的實戰流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外電郵營銷(EDM)受眾分層文案、A/B 主題行測試與防進垃圾箱自檢

    做海外獨立站或出海 SaaS 電郵營銷(EDM),最怕千人一面群發被直接送進垃圾箱。本文結合 Gmail/Yahoo 批量發件人規範,梳理用 ChatGPT 設計受眾分層文案、批量生成 A/B 主題行矩陣並開展發前垃圾詞與合規自檢的實戰提示詞。

    ChatGPT0
  4. 04

    用 ChatGPT 寫 Notion Formula 2.0 公式、Obsidian Dataview 查詢與 Airtable 自動化腳本

    給 Notion 數據庫寫多條件 Formula 2.0 公式、給 Obsidian 寫 Dataview 動態看板,或在 Airtable 裏寫自動化腳本,經常因為一個小括號或類型不匹配報錯半天。本文整理三大工具的通用上下文喂料規範與三套直接可複製的生成提示詞。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 處理複雜 JSON / YAML / XML 字段映射、格式轉換與校驗規則編寫實戰

    對接第三方 API、遷移 Kubernetes 配置或解析政企 XML 報文時,手工對照幾百行嵌套字段既慢又容易漏掉空值與類型邊界。本文整理用 ChatGPT 完成字段映射表梳理、生成確定性轉換腳本以及編寫 JSON Schema / Pydantic / XSD 校驗規則的實戰流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 準備本科/碩士畢業論文答辯:提煉答辯 PPT 結構、模擬導師犀利追問與 3 分鐘自述稿

    畢業論文寫完後,要在 3–5 分鐘內講清研究價值並頂住答辯評委的連環追問並不輕鬆。本文整理在嚴格遵守高校學術規範的前提下,用 ChatGPT 提煉答辯 PPT 結構、打磨 3 分鐘口語自述稿並開展模擬導師犀利追問的排練流程與提示詞。

    ChatGPT0

同產品的其他教學

  1. 01

    Anthropic Contextual Retrieval(上下文增強檢索)是什麼、怎麼實現:給文檔塊自動補背景摘要結合緩存降失誤率

    長文檔切成小塊後丟了公司名、年份和主語指代導致 RAG 頻頻搜錯?本文按 Anthropic 官方技術文章詳解 Contextual Retrieval 原理、官方公開評測失誤率下降 49% 至 67% 的組合架構,以及用 Claude 提示詞緩存低成本批量生成切片背景的完整 Python 代碼。

    Claude其他 AI 工具0
  2. 02

    RAG 知識庫回答不準怎麼調優:切片大小(Chunking)、BM25 + 向量混合檢索與 Rerank 重排序三步排查法

    搭好的 RAG 企業知識庫一問具體型號、報錯碼或跨行表格就答非所問?本文按 OpenAI 與 Anthropic 官方檢索文檔,給出先隔離檢索與生成故障、再按結構化切片(Chunking)、BM25 加向量混合召回(RRF)與 Rerank 重排序逐層調優的三步法。

    Claude其他 AI 工具0
  3. 03

    Langfuse 開源本地部署(Docker Compose)與提示詞版本管理(Prompt Management)從零上手教學

    企業內網嚴禁業務日誌出境,又想免費擁有大模型調用鏈追蹤與不發版熱更新提示詞的能力?本文按 Langfuse 官方文檔整理 Docker Compose 本地一鍵啟動(含 ClickHouse 架構注意事項)、密鑰配置與 Prompt Management 標籤化版本管理全流程。

    Claude其他 AI 工具0
  4. 04

    LangSmith 入門教學:給 LangGraph 與原生 OpenAI / Claude 接口加調用鏈追蹤、Token 成本統計與免費層限額

    智能體多步調用總是找不到哪一輪提示詞跑偏、單次請求到底燒了多少 Token?本文按 LangSmith 官方文檔講清環境變量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 與 @traceable 追蹤原生接口,以及 Developer 免費層額度與留存規則。

    Claude其他 AI 工具0
  5. 05

    Zotero 搭配 Claude / ChatGPT 高效讀英文文獻:PDF 翻譯插件、批註導出精讀與防捏造參考文獻流程

    在 Zotero 裏讀英文頂會論文怎麼無縫聯動 Claude 與 ChatGPT?本文整理 Translate for Zotero 劃詞翻譯配置、高亮批註導出精讀提示詞,以及杜絕 AI 捏造假 DOI 參考文獻的核驗閉環。

    Claude其他 AI 工具0
  6. 06

    Obsidian 接入 Claude、ChatGPT 與本地 Ollama 做個人雙鏈筆記問答:主流插件配置與私隱脫敏邊界

    想在 Obsidian 裏基於自己的雙鏈筆記庫做 AI 問答又擔心私隱外泄?本文對比 Copilot 與 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 與本地 Ollama 的步驟及敏感目錄隔離規則。

    Claude其他 AI 工具0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~