2025年5月15日作者 D.Sheep 0

Claude Code Bedrock 与 Vertex 集成

了解如何配置 Claude Code 与 Amazon Bedrock 和 Google Vertex AI 集成，以及如何通过代理连接。

模型配置

Claude Code 默认使用 claude-3-7-sonnet-20250219。你可以通过以下环境变量覆盖默认设置：

# Anthropic API
ANTHROPIC_MODEL='claude-3-7-sonnet-20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku-20241022'

# Amazon Bedrock
ANTHROPIC_MODEL='us.anthropic.claude-3-7-sonnet-20250219-v1:0'
ANTHROPIC_SMALL_FAST_MODEL='us.anthropic.claude-3-5-haiku-20241022-v1:0'

# Google Vertex AI
ANTHROPIC_MODEL='claude-3-7-sonnet@20250219'
ANTHROPIC_SMALL_FAST_MODEL='claude-3-5-haiku@20241022'

你也可以通过全局配置设置这些变量：

# 配置为 Anthropic API
claude config set --global env '{"ANTHROPIC_MODEL": "claude-3-7-sonnet-20250219"}'

# 配置为 Bedrock
claude config set --global env '{"CLAUDE_CODE_USE_BEDROCK": "true", "ANTHROPIC_MODEL": "us.anthropic.claude-3-7-sonnet-20250219-v1:0"}'

# 配置为 Vertex AI
claude config set --global env '{"CLAUDE_CODE_USE_VERTEX": "true", "ANTHROPIC_MODEL": "claude-3-7-sonnet@20250219"}'

有关不同提供商下全部可用模型的详细名称，请参阅我们的模型名称参考文档。

与第三方 API 一起使用

无论你用哪个 API 提供商，Claude Code 都需要同时访问 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 两个模型。

连接 Amazon Bedrock

CLAUDE_CODE_USE_BEDROCK=1

如需通过代理访问 Claude Code，可以设置：

ANTHROPIC_BEDROCK_BASE_URL='https://your-proxy-url'

如果没有启用 prompt 缓存，还需设置：

DISABLE_PROMPT_CACHING=1

需要标准 AWS SDK 凭据（如 ~/.aws/credentials 或环境变量 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）。设置 AWS 凭据命令：

aws configure

建议联系 Amazon Bedrock 启用 prompt 缓存，以降低成本和提升速率限制。

用户需要在 AWS 账号下拥有对 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型的访问权限。如有模型访问角色，但未开放权限，需单独申请访问。Bedrock 需在各区域内开放，因为推理配置文件需要跨区域能力。

连接 Google Vertex AI

CLAUDE_CODE_USE_VERTEX=1
CLOUD_ML_REGION=us-east5
ANTHROPIC_VERTEX_PROJECT_ID=your-project-id

如需通过代理访问 Claude Code，可以设置：

ANTHROPIC_VERTEX_BASE_URL='https://your-proxy-url'

如未启用 prompt 缓存，还需设置：

DISABLE_PROMPT_CACHING=1

Claude Code 在 Vertex AI 目前仅支持 us-east5 区域，确保你的项目在该区域分配了配额。

用户需在 Vertex AI 项目中同时有 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型访问权限。

需要通过 google-auth-library 配置标准 GCP 凭据。设置 GCP 凭据命令：

gcloud auth application-default login

如需更好体验，建议联系 Google 提升速率限制。

通过代理连接

在使用 LLM 代理（如 LiteLLM）时，可以通过如下环境变量和配置控制认证行为。这些变量可与 Bedrock、Vertex 专属设置混用。

环境变量：

ANTHROPIC_AUTH_TOKEN：自定义 Authorization 和 Proxy-Authorization 头部（会自动添加 Bearer 前缀）
ANTHROPIC_CUSTOM_HEADERS：自定义请求头（Name: Value 格式）
HTTP_PROXY：设置 HTTP 代理地址
HTTPS_PROXY：设置 HTTPS 代理地址

如不想用环境变量，也可把这些变量写入全局 Claude 配置文件的 env 字段（在 ~/.claude.json）。

全局配置选项

apiKeyHelper：可自定义 shell 脚本，用于获取 API key（在每次启动时调用一次，整个会话缓存）