它到底是什么

/setup-bedrock 是 Claude Code 内置的会话内 slash 命令，用于重新打开 Amazon Bedrock 登录向导。通过它可以在不退出 Claude Code 的情况下更改 AWS 凭证、区域（region）或模型固定版本（model pin）。

首次将 Claude Code 接入 Bedrock 时，启动登录提示会自动引导完成相同流程（选择 "3rd-party platform" → "Amazon Bedrock"）；后续任何时候需要重新配置，在会话内运行 /setup-bedrock 即可再次触发该向导。向导执行完毕后将配置写入用户设置文件的 env 块，无需手动 export 任何环境变量。

前置条件（Bedrock 集成层面，非命令本身的要求）：

• 已有 AWS 账号，且 Bedrock 访问权限已启用
• 所需 Claude 模型已在 Amazon Bedrock 控制台提交使用场景申请并获批
• 至少一种 AWS 凭证可用（见下方凭证选项）

怎么触发 / 怎么使用

1. 首次接入——启动时自动进入向导

claude

在登录提示中依次选择：

→ 3rd-party platform
  → Amazon Bedrock

后续流程与 /setup-bedrock 完全等价。

2. 重新配置——会话内运行

/setup-bedrock

无参数。向导按序提示：

1. 选择凭证类型（向导从以下方式中让你选一种）：

   • 检测到的 ~/.aws AWS profile
   • Bedrock API key（对应环境变量 AWS_BEARER_TOKEN_BEDROCK）
   • Access key + Secret（静态密钥，对应 AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY）
   • 已存在于当前环境变量中的凭证

2. 读取区域：向导自动读取（picks up）你已配置的区域。

3. 验证模型可用性：检查当前账号可调用的 Claude 模型并列出。

4. 固定模型版本（pin models）：选定后写入设置文件 env 块。固定模型时，若选中支持 1M token 的变体，向导会在这一步顺带提供 1M context 选项（等效于手动在模型 ID 后附加 [1m]）——它是固定模型步骤的组成部分，而非独立的一步。

保存 / 配置 / 集成

向导写入位置

向导将配置保存到 Claude Code 用户设置文件的 env 块。等效的手动配置（用于 CI 或企业脚本化部署）：

# 启用 Bedrock
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1   # 若 AWS profile 已含 region 则可省略

# 固定模型版本（多用户部署时强烈推荐）
export ANTHROPIC_DEFAULT_OPUS_MODEL='us.anthropic.claude-opus-4-8'
export ANTHROPIC_DEFAULT_SONNET_MODEL='us.anthropic.claude-sonnet-4-6'
export ANTHROPIC_DEFAULT_HAIKU_MODEL='us.anthropic.claude-haiku-4-5-20251001-v1:0'

也可将变量写入设置文件 env 块（避免泄漏到其他进程）：

{
  "env": {
    "CLAUDE_CODE_USE_BEDROCK": "1",
    "AWS_PROFILE": "my-bedrock-profile"
  }
}

自动凭证刷新

在设置文件中配置可在凭证过期时自动续期：

{
  "awsAuthRefresh": "aws sso login --profile myprofile",
  "env": {
    "AWS_PROFILE": "myprofile"
  }
}

awsCredentialExport 要求输出格式：

{
  "Credentials": {
    "AccessKeyId": "value",
    "SecretAccessKey": "value",
    "SessionToken": "value",
    "Expiration": "2026-01-01T00:00:00Z"
  }
}

Expiration 为可选字段。自 v2.1.176 起，当命令返回合法的 ISO 8601 Expiration 时，Claude Code 会将凭证缓存至该时间前 5 分钟；缺省该字段或更早版本下，凭证缓存 1 小时。（另：自 v2.1.181 起，也接受 aws configure export-credentials --format process 的扁平输出，即同名字段位于顶层而非嵌套在 Credentials 下。）

关键环境变量速查

运行约束 / 限制

跟同类原语对比

经典使用场景

• 首次切换到 Bedrock：claude 启动时选 3rd-party platform，向导引导完成所有配置，等价于 /setup-bedrock 但不需要先有活跃会话。
• 更换 AWS profile 或 region：在现有会话中运行 /setup-bedrock，选择新 profile，向导更新设置文件并立即生效。
• 多用户团队部署前固定模型版本：通过向导将 ANTHROPIC_DEFAULT_SONNET_MODEL 等写入配置，防止 sonnet/opus 别名在 Bedrock 侧更新后自动漂移到账号中尚未开通的版本。
• 启用 1M context：向导在模型选择步骤直接提供 1M 变体选项，等效于手动在模型 ID 后附加 [1m]。

常见坑

1. 未先在 Bedrock 控制台申请模型访问：向导的模型验证步骤会失败。需先在 Amazon Bedrock 控制台打开 Model catalog，选择 Anthropic 模型并提交使用场景表单；访问权限即时生效。

2. SSO 认证死循环：awsAuthRefresh + 企业代理（VPN / TLS 检查）组合下，代理中断浏览器 SSO 流程，Claude Code 将其视为认证失败并反复重触发 awsAuthRefresh，形成无限循环。解决方法：从设置文件删除 awsAuthRefresh，改为在启动 claude 前手动运行 aws sso login。

3. 旧版本不读 AWS config 文件：v2.1.171 及更早版本不从 ~/.aws/config 读取 region，向导或手动配置须显式设置 AWS_REGION。v2.1.172 起才支持自动读取。可在会话内运行 /status 查看当前解析到的 region 及其来源。

4. 模型别名漂移：未固定版本时，sonnet/opus 解析到 Claude Code 内置的 Bedrock 默认值（可能滞后于最新发布，也可能尚未在你账号的区域开通）。通过向导固定，或手动设置 ANTHROPIC_DEFAULT_*_MODEL 可避免。

5. bedrock:GetInferenceProfile 权限缺失：缺少该权限时 Claude Code 能自动重试恢复，但每次调用新模型多一次 round-trip。使用 AWS_BEARER_TOKEN_BEDROCK 时 token policy 通常较窄，尤其需要检查此权限是否已授予。

来源

• Claude Code on Amazon Bedrock — 官方文档
• Commands — 官方文档