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.检查网络并重新连接
- 2.在代理环境下正确设置 HTTPS_PROXY / HTTP_PROXY
- 3.在防火墙/VPN 中放行到 api.anthropic.com 的访问
- 4.更换 DNS 或重新连接
- 5.校正系统日期时间
- 6.稍候并重试
- 7.在本页顶部及 Claude API 确认是否有故障
何时该等待 / 等待也无济于事的情况
若是 API 侧故障,会随时间恢复。多数情况是你这边的网络/代理设置问题,等待无济于事,请检查上述项。
Claude Code 宕机时的替代方案
相关报错
常见问题
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 确认是否有故障