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 条评论

登录 后参与评论

还没有评论,来抢沙发~