Amazon Bedrock 上的 Claude Code

前置条件

在使用 Bedrock 配置 Claude Code 之前，请确保您拥有：

• 启用了 Amazon Bedrock 的 AWS 账户
• 具有适当权限的 IAM 用户或角色
• 访问 Claude 模型的权限

设置

1. 提交用例详情

Anthropic 模型的首次用户需要在调用模型之前提交用例详情：

1. 导航到 Amazon Bedrock 控制台
2. 选择 Chat/Text playground
3. 选择任何 Anthropic 模型，您将被提示填写用例表单

2. 配置 AWS 凭证

Claude Code 使用默认的 AWS SDK 凭证链。

选项 A：AWS CLI 配置

aws configure

选项 B：环境变量（访问密钥）

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=us-east-1

选项 C：环境变量（SSO 配置文件）

export AWS_PROFILE=your-sso-profile

选项 D：Bedrock API 密钥

export AWS_BEARER_TOKEN_BEDROCK=your_api_key

3. 配置 Claude Code

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

export CLAUDE_CODE_USE_BEDROCK=1

4. 模型配置

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

模型类型	默认值
主模型	global.anthropic.claude-sonnet-4-5-20250929-v1:0
小型/快速模型	us.anthropic.claude-haiku-4-5-20251001-v1:0

要自定义模型：

export ANTHROPIC_MODEL=us.anthropic.claude-sonnet-4-5-20250929-v1:0

5. 输出令牌配置

在使用 Claude Code 与 Amazon Bedrock 时，建议以下令牌设置：

export CLAUDE_CODE_MAX_OUTPUT_TOKENS=16384

IAM 配置

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

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowModelAndInferenceProfileAccess",
      "Effect": "Allow",
      "Action": [
        "bedrock:InvokeModel",
        "bedrock:InvokeModelWithResponseStream",
        "bedrock:ListInferenceProfiles"
      ],
      "Resource": [
        "arn:aws:bedrock:*:*:inference-profile/*",
        "arn:aws:bedrock:*:*:foundation-model/*"
      ]
    }
  ]
}

故障排除

如果您遇到区域问题：

• 确保您的 AWS_REGION 设置正确
• 检查模型在您的区域是否可用

如果您收到错误"不支持按需吞吐量"：

• Claude Code 使用 Bedrock Invoke API，不支持 Converse API