模型配置

默认情况下,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 环境变量:

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

如果您没有启用提示缓存,还需要设置:

DISABLE_PROMPT_CACHING=1

需要标准的 AWS SDK 凭证(例如,~/.aws/credentials 或相关环境变量,如 AWS_ACCESS_KEY_IDAWS_SECRET_ACCESS_KEY)。要设置 AWS 凭证,请运行:

aws configure

联系 Amazon Bedrock 以获取提示缓存,以降低成本并提高速率限制。

用户需要在其 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 环境变量:

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

如果您没有启用提示缓存,还需要设置:

DISABLE_PROMPT_CACHING=1

Vertex AI 上的 Claude Code 目前仅支持 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)与 Claude Code 一起使用时,您可以使用以下环境变量和配置来控制身份验证行为。请注意,您可以将这些设置与 Bedrock 和 Vertex 特定的设置混合使用。

环境变量

  • ANTHROPIC_AUTH_TOKENAuthorizationProxy-Authorization 头的自定义值(您在此处设置的值将以 Bearer 为前缀)
  • ANTHROPIC_CUSTOM_HEADERS:您想要添加到请求中的自定义头(采用 Name: Value 格式)
  • HTTP_PROXY:设置 HTTP 代理 URL
  • HTTPS_PROXY:设置 HTTPS 代理 URL

如果您更喜欢通过文件而不是环境变量进行配置,可以将这些变量中的任何一个添加到全局 Claude 配置(在 ~/.claude.json 中)的 env 对象中。

全局配置选项

  • apiKeyHelper:获取 API 密钥的自定义 shell 脚本(在启动时调用一次,并在每个会话期间缓存)

Was this page helpful?