Bedrock 和 Vertex 集成
配置 Claude Code 以使用 Amazon Bedrock 和 Google Vertex AI,并通过代理连接。
模型配置
默认情况下,Claude Code 使用 claude-3-7-sonnet-20250219
。您可以使用以下环境变量来覆盖此设置:
您也可以使用全局配置设置这些变量:
查看我们的模型名称参考以了解所有提供商的可用模型。
与第三方 API 一起使用
无论您使用哪个 API 提供商,Claude Code 都需要同时访问 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型。
连接到 Amazon Bedrock
如果您想通过代理访问 Claude Code,可以使用 ANTHROPIC_BEDROCK_BASE_URL
环境变量:
如果您没有启用提示缓存,还需要设置:
需要标准的 AWS SDK 凭证(例如,~/.aws/credentials
或相关环境变量,如 AWS_ACCESS_KEY_ID
、AWS_SECRET_ACCESS_KEY
)。要设置 AWS 凭证,请运行:
联系 Amazon Bedrock 以获取提示缓存,以降低成本并提高速率限制。
用户需要在其 AWS 账户中同时访问 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型。如果您有模型访问角色,且这些模型尚未可用,您可能需要请求访问这些模型。由于推理配置文件需要跨区域功能,因此需要访问每个区域的 Bedrock。
连接到 Google Vertex AI
如果您想通过代理访问 Claude Code,可以使用 ANTHROPIC_VERTEX_BASE_URL
环境变量:
如果您没有启用提示缓存,还需要设置:
Vertex AI 上的 Claude Code 目前仅支持 us-east5
区域。请确保您的项目在此特定区域有配额分配。
用户需要在其 Vertex AI 项目中同时访问 Claude 3.7 Sonnet 和 Claude 3.5 Haiku 模型。
需要通过 google-auth-library 配置标准的 GCP 凭证。要设置 GCP 凭证,请运行:
为获得最佳体验,请联系 Google 以提高速率限制。
通过代理连接
当使用 LLM 代理(如 LiteLLM)与 Claude Code 一起使用时,您可以使用以下环境变量和配置来控制身份验证行为。请注意,您可以将这些设置与 Bedrock 和 Vertex 特定的设置混合使用。
环境变量
ANTHROPIC_AUTH_TOKEN
:Authorization
和Proxy-Authorization
头的自定义值(您在此处设置的值将以Bearer
为前缀)ANTHROPIC_CUSTOM_HEADERS
:您想要添加到请求中的自定义头(采用Name: Value
格式)HTTP_PROXY
:设置 HTTP 代理 URLHTTPS_PROXY
:设置 HTTPS 代理 URL
如果您更喜欢通过文件而不是环境变量进行配置,可以将这些变量中的任何一个添加到全局 Claude 配置(在 ~/.claude.json 中)的 env
对象中。
全局配置选项
apiKeyHelper
:获取 API 密钥的自定义 shell 脚本(在启动时调用一次,并在每个会话期间缓存)