先决条件

在使用 Bedrock 配置 Claude Code 之前,请确保您具备:

  • 启用了 Bedrock 访问权限的 AWS 账户
  • 在 Bedrock 中访问所需的 Claude 模型(例如,Claude Sonnet 4)
  • 已安装并配置的 AWS CLI(可选 - 仅在您没有其他获取凭证机制时需要)
  • 适当的 IAM 权限

设置

1. 启用模型访问

首先,确保您在 AWS 账户中可以访问所需的 Claude 模型:

  1. 导航到 Amazon Bedrock 控制台
  2. 在左侧导航中转到模型访问
  3. 请求访问所需的 Claude 模型(例如,Claude Sonnet 4)
  4. 等待批准(大多数区域通常是即时的)

2. 配置 AWS 凭证

Claude Code 使用默认的 AWS SDK 凭证链。使用以下方法之一设置您的凭证:

Claude Code 目前不支持动态凭证管理(例如自动调用 aws sts assume-role)。您需要自己运行 aws configureaws sso login 或设置 AWS_ 环境变量。

选项 A:AWS CLI 配置

aws configure

选项 B:环境变量(访问密钥)

export AWS_ACCESS_KEY_ID=your-access-key-id
export AWS_SECRET_ACCESS_KEY=your-secret-access-key
export AWS_SESSION_TOKEN=your-session-token

选项 C:环境变量(SSO 配置文件)

aws sso login --profile=<your-profile-name>

export AWS_PROFILE=your-profile-name

3. 配置 Claude Code

设置以下环境变量以启用 Bedrock:

# 启用 Bedrock 集成
export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-east-1  # 或您首选的区域

AWS_REGION 是必需的环境变量。Claude Code 不会从 .aws 配置文件中读取此设置。

4. 模型配置

Claude Code 为 Bedrock 使用这些默认模型:

模型类型默认值
主要模型us.anthropic.claude-3-7-sonnet-20250219-v1:0
小型/快速模型us.anthropic.claude-3-5-haiku-20241022-v1:0

要自定义模型,请使用以下方法之一:

# 使用推理配置文件 ID
export ANTHROPIC_MODEL='us.anthropic.claude-opus-4-20250514-v1:0'
export ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# 使用应用程序推理配置文件 ARN
export ANTHROPIC_MODEL='arn:aws:bedrock:us-east-2:your-account-id:application-inference-profile/your-model-id'

IAM 配置

为 Claude Code 创建具有所需权限的 IAM 策略。

有关详细信息,请参阅 Bedrock IAM 文档

我们建议为 Claude Code 创建专用的 AWS 账户,以简化成本跟踪和访问控制。

故障排除

如果您遇到区域问题:

  • 检查模型可用性:aws bedrock list-inference-profiles --region your-region
  • 切换到支持的区域:export AWS_REGION=us-east-1
  • 考虑使用推理配置文件进行跨区域访问

如果您收到”不支持按需吞吐量”错误:

其他资源