部署
Amazon Bedrock 上的 Claude Code
了解如何通过 Amazon Bedrock 配置 Claude Code,包括设置、IAM 配置和故障排除。
先决条件
在使用 Bedrock 配置 Claude Code 之前,请确保您具备:
- 启用了 Bedrock 访问权限的 AWS 账户
- 在 Bedrock 中访问所需的 Claude 模型(例如,Claude Sonnet 4)
- 已安装并配置的 AWS CLI(可选 - 仅在您没有其他获取凭证机制时需要)
- 适当的 IAM 权限
设置
1. 启用模型访问
首先,确保您在 AWS 账户中可以访问所需的 Claude 模型:
- 导航到 Amazon Bedrock 控制台
- 在左侧导航中转到模型访问
- 请求访问所需的 Claude 模型(例如,Claude Sonnet 4)
- 等待批准(大多数区域通常是即时的)
2. 配置 AWS 凭证
Claude Code 使用默认的 AWS SDK 凭证链。使用以下方法之一设置您的凭证:
Claude Code 目前不支持动态凭证管理(例如自动调用 aws sts assume-role
)。您需要自己运行 aws configure
、aws sso login
或设置 AWS_
环境变量。
选项 A:AWS CLI 配置
选项 B:环境变量(访问密钥)
选项 C:环境变量(SSO 配置文件)
3. 配置 Claude Code
设置以下环境变量以启用 Bedrock:
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 |
要自定义模型,请使用以下方法之一:
IAM 配置
为 Claude Code 创建具有所需权限的 IAM 策略。
有关详细信息,请参阅 Bedrock IAM 文档。
我们建议为 Claude Code 创建专用的 AWS 账户,以简化成本跟踪和访问控制。
故障排除
如果您遇到区域问题:
- 检查模型可用性:
aws bedrock list-inference-profiles --region your-region
- 切换到支持的区域:
export AWS_REGION=us-east-1
- 考虑使用推理配置文件进行跨区域访问
如果您收到”不支持按需吞吐量”错误:
- 将模型指定为推理配置文件 ID