Claude Code 透過環境變數支援標準的 HTTP/HTTPS 代理配置。這允許您將所有 Claude Code 流量透過組織的代理伺服器路由,以達到安全性、合規性和監控目的。

基本代理配置

環境變數

Claude Code 遵循標準的代理環境變數:

# HTTPS 代理(建議)
export HTTPS_PROXY=https://proxy.example.com:8080

# HTTP 代理(如果 HTTPS 不可用)
export HTTP_PROXY=http://proxy.example.com:8080

Claude Code 目前不支援 NO_PROXY 環境變數。所有流量都會透過配置的代理路由。

Claude Code 不支援 SOCKS 代理。

身份驗證

基本身份驗證

如果您的代理需要基本身份驗證,請在代理 URL 中包含憑證:

export HTTPS_PROXY=http://username:password@proxy.example.com:8080

避免在腳本中硬編碼密碼。請改用環境變數或安全的憑證儲存。

對於需要進階身份驗證(NTLM、Kerberos 等)的代理,請考慮使用支援您身份驗證方法的 LLM Gateway 服務。

SSL 憑證問題

如果您的代理使用自訂 SSL 憑證,您可能會遇到憑證錯誤。

確保您設定正確的憑證套件路徑:

export SSL_CERT_FILE=/path/to/certificate-bundle.crt
export NODE_EXTRA_CA_CERTS=/path/to/certificate-bundle.crt

網路存取需求

Claude Code 需要存取以下 URL:

  • api.anthropic.com - Claude API 端點
  • statsig.anthropic.com - 遙測和指標
  • sentry.io - 錯誤報告

確保這些 URL 在您的代理配置和防火牆規則中被列入允許清單。這在容器化或受限網路環境中使用 Claude Code 時特別重要。

其他資源