模型配置

預設情況下,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?