跳转到主要内容
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 网关服务。

自定义 CA 证书

如果您的企业环境使用自定义 CA 进行 HTTPS 连接(无论是通过代理还是直接 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:claude.ai 账户身份验证
  • platform.claude.com:Anthropic 控制台账户身份验证
确保这些 URL 在您的代理配置和防火墙规则中被列入白名单。这在容器化或受限网络环境中使用 Claude Code 时尤为重要。 Claude Code on the webCode Review 从 Anthropic 管理的基础设施连接到您的存储库。如果您的 GitHub Enterprise Cloud 组织按 IP 地址限制访问,请启用 已安装 GitHub Apps 的 IP 允许列表继承。Claude GitHub App 注册了其 IP 范围,因此启用此设置允许访问而无需手动配置。要 手动将范围添加到您的允许列表,或配置其他防火墙,请参阅 Anthropic API IP 地址

其他资源