Claude Code on Amazon Bedrock

是什么

Amazon Bedrock 是 Claude Code 的云提供商认证选项之一，通过 AWS 凭证访问 Claude 模型，继承 AWS 合规控制和计费体系。适合已有 AWS 基础设施的企业。

核心机制

前置条件

• AWS 账号并开启 Bedrock 访问
• 在 Bedrock 控制台申请目标 Claude 模型访问权限（每个 AWS 账号一次性操作）
• 适当的 IAM 权限

登录向导（推荐）

claude  # 启动后选择 "3rd-party platform" → "Amazon Bedrock"

向导自动检测 ~/.aws 中的 profile，验证可用模型，保存配置到 user settings 的 env 块。之后可用 /setup-bedrock 重新打开向导。

手动配置（CI/批量部署）

# 方式 A：AWS CLI
aws configure
 
# 方式 B：环境变量（access key）
export AWS_ACCESS_KEY_ID=your-key
export AWS_SECRET_ACCESS_KEY=your-secret
export AWS_SESSION_TOKEN=your-token  # 临时凭证时需要
 
# 方式 C：SSO profile
aws sso login --profile=<profile-name>
export AWS_PROFILE=your-profile-name
 
# 设置区域和模型
export AWS_REGION=us-east-1
export ANTHROPIC_MODEL=anthropic.claude-sonnet-4-5-20251001-v1:0

IAM 权限要求 最小权限：bedrock:InvokeModel、bedrock:InvokeModelWithResponseStream

模型版本固定 企业部署推荐固定模型版本，避免自动升级影响稳定性：

export ANTHROPIC_DEFAULT_SONNET_MODEL=anthropic.claude-sonnet-4-5-20251001-v1:0

关键细节

• Bedrock 不发送 metrics 到 Anthropic，成本追踪需通过 AWS Cost Explorer 或 LiteLLM
• Bedrock 上 opus alias 解析为 Opus 4.6，sonnet 解析为 Sonnet 4.5（比 Anthropic API 低一个版本）
• AWS Organizations 可用 PutUseCaseForModelAccess API 一次性为所有子账号申请模型访问
• Bedrock 不支持 server-managed settings，需使用 file-based 或 plist/registry 方式

与其他概念的关联

• authentication - 认证方式总览
• llm-gateway - 通过 gateway 统一管理 Bedrock 访问
• costs - Bedrock 的成本追踪方案

实践要点

• 使用 Bedrock API key（非 IAM 凭证）时，设置 AWS_BEARER_TOKEN_BEDROCK 环境变量
• 团队部署前固定模型版本，避免模型升级导致行为变化
• Bedrock 不支持部分 Claude Code 功能（如 Claude Code on the Web），需提前告知开发者