Claude Code 连不上,公司网络排查清单文章封面

Claude Code 在公司网络下连不上怎么办?Proxy、CA、VPN 排查清单

Claude Code 在家里能用,到公司网络就连不上,这是很常见的问题。原因通常不是 Claude Code 本身坏了,而是企业网络做了代理、证书检查、DNS 策略或出口限制。

第一步:确认错误类型

  • 如果是 401,先查 API Key 或 Token;
  • 如果是连接超时,先查代理和出口网络;
  • 如果是证书错误,先查企业 CA;
  • 如果只有长任务失败,查超时和流式输出;
  • 如果普通网页能打开但 Claude Code 不行,查 CLI 是否读取到了代理变量。

第二步:检查代理变量

Claude Code 支持 HTTPS_PROXYHTTP_PROXYNO_PROXY。公司网络如果要求所有 HTTPS 请求走代理,就需要在启动 Claude Code 前设置这些变量。

export HTTPS_PROXY=https://proxy.example.com:8080
export NO_PROXY="localhost,127.0.0.1"
claude

第三步:检查证书

如果报错里出现 certificate、self signed、unable to verify 等字样,多半是企业 TLS inspection 或自定义 CA 导致。可以先确认公司的根证书是否已安装到系统证书存储。

export CLAUDE_CODE_CERT_STORE=system
# 或者
export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem

第四步:检查 VPN 和 DNS

有些公司 VPN 会修改 DNS、拦截外部 API 域名,或者只允许访问白名单。如果你设置了中转站,也要确认中转站域名在公司网络里可解析、可连接、证书链正常。

第五步:考虑统一网关

如果团队里很多人都遇到同样问题,最好不要让每个人各自调代理。更稳的做法是部署统一 LLM Gateway 或使用稳定中转站,让所有 Claude Code 请求走一个受控入口。

如果你不想自己维护网关、证书、模型映射、上游兼容和各种错误排查,可以了解 YYLX.IO 鱼鱼连线。它更适合想直接稳定使用 Claude Code、Codex、Gemini CLI、Cline 等 AI 编程工具的用户。

总结

公司网络问题要按层排查:鉴权、代理、证书、DNS、VPN、网关。不要一看到连接失败就重装 Claude Code,配置链路通常才是关键。

参考资料:Claude Code Enterprise network configurationClaude Code environment variables

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注