结论先说
- 最快路径是用内置向导
/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 条评论
还没有评论,来抢沙发~