Claude Code 透過環境變數支援各種企業網路和安全配置。這包括透過企業代理伺服器路由流量、信任自訂憑證授權機構 (CA),以及使用相互傳輸層安全性 (mTLS) 憑證進行驗證以增強安全性。
本頁面顯示的所有環境變數也可以在 settings.json 中配置。

代理配置

環境變數

Claude Code 遵循標準代理環境變數:
# HTTPS 代理(建議)
export HTTPS_PROXY=https://proxy.example.com:8080

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

# 針對特定請求繞過代理 - 空格分隔格式
export NO_PROXY="localhost 192.168.1.1 example.com .example.com"
# 針對特定請求繞過代理 - 逗號分隔格式
export NO_PROXY="localhost,192.168.1.1,example.com,.example.com"
# 針對所有請求繞過代理
export NO_PROXY="*"
Claude Code 不支援 SOCKS 代理。

基本驗證

如果您的代理需要基本驗證,請在代理 URL 中包含憑證:
export HTTPS_PROXY=http://username:password@proxy.example.com:8080
避免在腳本中硬編碼密碼。請改用環境變數或安全憑證儲存。
對於需要進階驗證(NTLM、Kerberos 等)的代理,請考慮使用支援您驗證方法的 LLM Gateway 服務。

自訂 CA 憑證

如果您的企業環境對 HTTPS 連線使用自訂 CA(無論是透過代理還是直接 API 存取),請配置 Claude Code 以信任它們:
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

mTLS 驗證

對於需要用戶端憑證驗證的企業環境:
# 用於驗證的用戶端憑證
export CLAUDE_CODE_CLIENT_CERT=/path/to/client-cert.pem

# 用戶端私鑰
export CLAUDE_CODE_CLIENT_KEY=/path/to/client-key.pem

# 可選:加密私鑰的密碼短語
export CLAUDE_CODE_CLIENT_KEY_PASSPHRASE="your-passphrase"

網路存取需求

Claude Code 需要存取以下 URL:
  • api.anthropic.com - Claude API 端點
  • claude.ai - WebFetch 安全防護
  • statsig.anthropic.com - 遙測和指標
  • sentry.io - 錯誤報告
確保這些 URL 在您的代理配置和防火牆規則中被列入允許清單。這在容器化或受限網路環境中使用 Claude Code 時特別重要。

其他資源