企业网络配置

是什么

network-config 描述 Claude Code 在企业网络环境中的配置方法，包括代理服务器、自定义 CA 证书和 mTLS 双向认证。所有配置均通过环境变量实现，也可写入 settings.json。

核心机制

代理配置

export HTTPS_PROXY=https://proxy.example.com:8080
export HTTP_PROXY=http://proxy.example.com:8080
export NO_PROXY="localhost,192.168.1.1,.example.com"
# 带认证的代理
export HTTPS_PROXY=http://username:password@proxy.example.com:8080

注意：不支持 SOCKS 代理。NTLM/Kerberos 等高级认证推荐使用 LLM Gateway。

CA 证书配置 默认信任 Mozilla CA 集合（bundled）+ 操作系统证书库（system）。企业 TLS 检查代理（CrowdStrike Falcon、Zscaler 等）只要根证书安装在 OS 信任库中即可自动工作。

# 仅信任 bundled Mozilla CA
export CLAUDE_CODE_CERT_STORE=bundled
# 仅信任 OS 证书库
export CLAUDE_CODE_CERT_STORE=system
# 添加自定义 CA
export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

mTLS 客户端证书

协议	客户端证书变量	CA 信任变量
http/protobuf, http/json	CLAUDE_CODE_CLIENT_CERT, CLAUDE_CODE_CLIENT_KEY	NODE_EXTRA_CA_CERTS
grpc	OTEL_EXPORTER_OTLP_CLIENT_KEY, OTEL_EXPORTER_OTLP_CLIENT_CERTIFICATE	OTEL_EXPORTER_OTLP_CERTIFICATE

网络访问需求 Claude Code 需要访问的端点：

• api.anthropic.com：API 调用
• claude.ai：认证（OAuth）
• statsig.anthropic.com：功能标志
• 安装/更新：distribution server

关键细节

• CLAUDE_CODE_CERT_STORE 接受逗号分隔的值，如 bundled,system（默认）
• 代理密码避免硬编码在脚本中，使用环境变量或安全凭证存储
• 所有网络配置变量也可在 settings.json 的 env 块中配置，通过 managed settings 统一下发

与其他概念的关联

• llm-gateway - 单一入口代理多提供商，支持高级认证
• server-managed-settings - 通过 managed settings 统一下发网络配置
• monitoring-usage - OTel 的 mTLS 配置

实践要点

• 企业 TLS 检查代理：确保根证书在 OS 信任库，通常无需额外配置
• 离线/隔离环境：设置 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 减少非必要外部连接
• 防火墙白名单：至少需要放行 api.anthropic.com 和 claude.ai