网络诊断网络连接失败

Claude 连接失败怎么办?网页版与 Claude Code 分场景排查

Claude 连不上时,先判断是网页版还是 Claude Code、是完全连不上还是中途断开,再按「本地 → 客户端 → 节点 → 地区 → 服务端」的顺序排查。

作者:机场博客编辑部发布:更新:约 2 分钟阅读

网络连接失败

常见症状

  • 网页 claude.ai 打不开或一直转圈
  • Claude Code 启动后长时间无响应,最终超时
  • 回复写到一半停止,出现重试按钮
  • 提示所在地区不可用或请求被拒绝
  • 出现 529、429 等错误代码

先试这几步

  1. 打开 Anthropic 状态页确认服务是否正常
  2. 网页版:确认代理客户端运行、系统代理已开启
  3. Claude Code:在同一终端设置 HTTPS_PROXY 或开启 TUN 模式
  4. 换一个官方支持地区的节点,并关闭自动切换

核心结论

  • 网页能用而 Claude Code 不能用,几乎都是终端没有走代理。
  • 回复中途断开,多与线路长连接不稳定或出口切换有关。
  • 地区提示、429、529 都不是线路速度问题。

第一步:判断问题类型

网络问题分层排查顺序

先回答两个问题:

  1. 哪个入口出问题? 网页版 / 桌面应用,还是 Claude Code?
  2. 是完全连不上,还是中途断开?
组合 最可能的原因 跳转
网页版完全打不开 代理未生效、节点不可用、DNS 第二步
Claude Code 完全连不上 终端未走代理 第三步
能用,但长回复中断 线路长连接不稳定、出口切换 第四步
有明确的错误提示 地区、用量、服务端 第五步

第二步:网页版打不开

  1. 确认服务状态:先看 Anthropic 状态页,服务端故障时任何网络都无法解决。
  2. 确认代理生效:代理客户端是否在运行?系统代理是否开启?用浏览器打开其他境外网站试试。
  3. 查看命中规则:在客户端「连接」面板中访问 claude.ai,确认没有走 DIRECT。
  4. 换节点:换一个延迟正常、位于官方支持地区的节点。
  5. 清理浏览器状态:禁用代理类浏览器扩展,或用无痕窗口测试。

如果所有境外网站都打不开,问题不在 Claude,请看 机场节点全部超时。

第三步:Claude Code 连不上

这是最常见的情况。Claude Code 不会自动使用系统代理:

# macOS / Linux(端口以客户端为准)
export HTTPS_PROXY=http://127.0.0.1:7897
curl -I https://api.anthropic.com
claude
# Windows PowerShell
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
curl.exe -I https://api.anthropic.com
claude
  • curl 能返回响应头:网络已通,再试 Claude Code;
  • curl 也超时:代理端口错误、客户端未运行或节点不可用。

长期方案是写入 settings.json 或开启 TUN 模式,见 Claude Code 网络连接指南。

第四步:能连上,但经常中途断开

长回复和 Claude Code 任务需要连接保持较长时间,对线路的要求比打开网页高得多。

  • 固定节点:关闭 url-test 自动选择,为 Anthropic 相关域名指定一个节点;
  • 观察时段:只在晚高峰断开,说明线路在拥堵时段不稳定;
  • 换线路类型:同一服务内优先选择标注为专线或优质中转的节点;
  • 排除本地网络:Wi‑Fi 信号差、路由器负载高也会造成中断,有条件时用有线网络对比。

如果更换节点后仍频繁断开,可以参考 Claude 稳定机场 中 Claude 适用性评分较高的服务。

第五步:有明确错误提示

提示 含义 处理
地区不可用 / 请求被拒绝 出口地区不在支持范围或账号受限 换支持地区的节点;账号问题以官方说明为准
429 / 达到使用上限 用量或频率限制 等待重置,与网络无关
529 overloaded 服务端过载 稍后重试
5xx 服务端错误 查看状态页,稍后重试
证书错误 系统时间不准或中间人代理 校准系统时间,检查是否有安全软件拦截 HTTPS

仍然无法解决

把以下信息整理出来,便于向服务商或社区求助:

  • 使用的入口(网页 / Claude Code)、操作系统、客户端名称与版本;
  • 具体错误提示的原文;
  • 是否所有节点都有问题、是否只在特定时段出现;
  • curl -I https://api.anthropic.com 的输出。

注意不要在求助时公开订阅链接、API Key 等凭证信息。

常见问题

Claude 网页版正常,Claude Code 报错 Connection error,怎么办?

先在运行 Claude Code 的同一个终端中设置 HTTPS_PROXY 指向代理端口,或者开启 TUN 模式。设置后用 curl 测试 api.anthropic.com 是否能连通。

Claude 每次都在长回复的中途断开,是什么原因?

常见原因是线路在长连接上不稳定,或者客户端自动切换了节点。固定一个稳定的节点并关闭自动测速切换,再观察是否改善。如果晚高峰尤其明显,考虑更换稳定性更高的线路。

资料来源与数据性质

返回上级专题Claude 稳定机场怎么选Claude 网页版长回复与 Claude Code 终端任务对网络的要求、常见连接错误的成因,以及选择 Claude 稳定机场时应重点比较的指标。