Claude Code "Connection error" / "fetch failed"(连接错误)的原因与解决方法

现在有故障吗?

Claude Code 官方状态正常。若此报错持续出现,多半是实现或你的运行环境问题。

查看 Claude Code 的运行状态

报错含义

Claude Code 无法连接到 Anthropic API(api.anthropic.com)。原因包括网络、企业代理/防火墙、DNS、TLS(时钟偏差),或 API 侧故障。

常见原因

  • 网络不稳定或离线
  • 企业代理/防火墙拦截 api.anthropic.com
  • 经 VPN / 零信任被拦截
  • DNS 解析失败
  • 系统时间偏差导致 TLS 校验失败
  • Anthropic API 侧故障

解决方法

  1. 1.检查网络并重新连接
  2. 2.在代理环境下正确设置 HTTPS_PROXY / HTTP_PROXY
  3. 3.在防火墙/VPN 中放行到 api.anthropic.com 的访问
  4. 4.更换 DNS 或重新连接
  5. 5.校正系统日期时间
  6. 6.稍候并重试
  7. 7.在本页顶部及 Claude API 确认是否有故障

何时该等待 / 等待也无济于事的情况

若是 API 侧故障,会随时间恢复。多数情况是你这边的网络/代理设置问题,等待无济于事,请检查上述项。

Claude Code 宕机时的替代方案

CodexCursorGitHub CopilotClineWindsurfContinue

相关报错

常见问题

Connection error / fetch failed 是什么?

Claude Code 无法连接到 Anthropic API(api.anthropic.com)。原因包括网络、企业代理/防火墙、DNS、TLS(时钟偏差),或 API 侧故障。

Connection error / fetch failed 如何解决?

检查网络并重新连接 / 在代理环境下正确设置 HTTPS_PROXY / HTTP_PROXY / 在防火墙/VPN 中放行到 api.anthropic.com 的访问 / 更换 DNS 或重新连接 / 校正系统日期时间 / 稍候并重试 / 在本页顶部及 Claude API 确认是否有故障

对比查看 Claude Code