Claude Code连接失败、超时与中途断开排查

先说结论

Claude Code 的连接问题可以用一条命令分流：在运行 Claude Code 的同一个终端里执行 curl -I https://api.anthropic.com。

• 不通：问题在本机到代理这一段——代理变量没设、端口写错、TUN 没开或被其他软件冲突；
• 通了，但任务经常中途断开：问题在节点质量——丢包、晚高峰拥堵、自动切换节点；
• 报证书错误：问题在中间设备——公司网络或安全软件在检查 HTTPS 流量。

网络的整体要求可以先读 Claude Code 网络环境配置指南，本文专门处理“已经配置过，但还是连不上或不稳定”的情况。

问题现象

常见提示如：

• API Error: Connection error 或 Request timed out；
• fetch failed、ETIMEDOUT、ECONNREFUSED、ECONNRESET；
• 任务执行到一半停止，提示连接中断后重试；
• self signed certificate in certificate chain 或 unable to get local issuer certificate；
• 登录授权完成后终端一直等待，没有反应。

具体文字会随版本变化，以实际输出为准。

原因对照表

原因	判断方法	解决方法
终端没有走代理	浏览器正常，终端 curl 超时	设置 HTTPS_PROXY 或开启 TUN 模式
代理端口写错	报 ECONNREFUSED	在客户端核对混合端口并改正
TUN 与代理变量冲突	关掉其中一种后恢复	排查阶段只保留一种方式
本机回调被发往代理	登录授权后终端无响应	设置 NO_PROXY=localhost,127.0.0.1
节点丢包或拥堵	延迟波动大，晚高峰断开更多	换同地区低丢包专线节点
自动测速切换节点	客户端日志显示节点在变化	改为手动选择并固定节点
SSL 检查	报证书链相关错误	配置 NODE_EXTRA_CA_CERTS

快速自查

1. 当前终端里 HTTPS_PROXY 的值是否存在、端口是否正确？
2. 编辑器内置终端是否和外部终端一样设置了代理？
3. 代理客户端是否处于规则或全局模式，节点是否在支持地区？
4. Claude 相关流量是否落在自动测速组里？
5. 是否在公司网络、或安装了会检查 HTTPS 的安全软件？

逐步排查

第一步：确认代理变量

Windows PowerShell：

Get-ChildItem Env: | Where-Object Name -match 'proxy'

macOS / Linux：

env | grep -i proxy

如果没有任何输出，说明当前终端没有设置代理。注意大小写变量可能同时存在，例如 https_proxy 和 HTTPS_PROXY 指向不同端口，应统一改为正确值。

第二步：检查本地端口

Windows PowerShell：

Test-NetConnection 127.0.0.1 -Port 7897

macOS / Linux：

nc -vz 127.0.0.1 7897

7897 是 Clash Verge Rev 常见的默认混合端口，以你客户端中的设置为准。端口不通，说明客户端没运行或端口不对。

第三步：用代理直接测试 API

Windows PowerShell：

curl.exe -x http://127.0.0.1:7897 -I https://api.anthropic.com

macOS / Linux：

curl -x http://127.0.0.1:7897 -I https://api.anthropic.com

带 -x 能通、不带不通，就是代理变量问题；带 -x 也不通，就是节点或客户端问题。返回 403 通常说明出口地区不受支持。

第四步：处理 TUN 与 NO_PROXY

• 使用 TUN 模式时，可以先清空当前终端的代理变量，只靠 TUN 接管，确认能用后再决定保留哪种方式；
• 使用代理变量时，建议同时设置 NO_PROXY=localhost,127.0.0.1，避免本机回调和本地服务被发往代理。

第五步：稳定节点，消除中途断开

1. 在客户端中为 Claude 相关域名建立手动选择的代理组，不放进“自动选择 / URL 测试”组；
2. 选择美国、日本或新加坡的专线节点，避开香港节点；
3. 晚高峰断开明显时，在同一地区内换一个专线节点，而不是跨地区切换；
4. 避免同一台电脑同时进行大流量下载。

节点超时的通用排查见节点超时解决方法。

第六步：处理公司网络的证书问题

向 IT 部门获取公司根证书（通常为 .pem 或 .crt 文件），然后指定给 Node.js：

$env:NODE_EXTRA_CA_CERTS = "C:\certs\company-root.pem"

export NODE_EXTRA_CA_CERTS=/path/to/company-root.pem

证书文件路径改成实际存放位置。请先确认公司是否允许在办公网络中使用此类工具。

第七步：检查编辑器内置终端

很多人在外部终端里测试一切正常，回到 VS Code 等编辑器的内置终端就连不上。原因是编辑器启动时继承的是当时的环境变量，之后在别处设置的代理不会自动同步进去。处理方法：

1. 在内置终端里重新执行第一步，确认代理变量确实存在；
2. 如果变量写在 $PROFILE、~/.zshrc 等配置文件中，完全退出编辑器后重新打开；
3. 仍不生效时，可以直接在内置终端中临时设置一次代理变量再运行 claude。

另外，Claude Code 支持在其设置文件中通过 env 字段为自身指定环境变量，可以把代理变量写在那里，只对 Claude Code 生效而不影响其他程序。设置文件的位置与字段写法以官方文档为准。

判断是网络问题还是节点问题

排查到最后，经常需要回答一个问题：到底是本机配置不对，还是节点本身不行？可以用下面的方法对比：

测试方式	结果	结论
同一终端，换同地区另一个节点	恢复正常	原节点有问题，向机场反馈或更换
同一终端，换多个节点都失败	仍然失败	本机代理配置问题，回到第一至第四步
白天正常、晚上频繁断开	时好时坏	线路晚高峰拥堵，考虑专线节点
网页版和 Claude Code 同时异常	均失败	先查看 status.anthropic.com 是否有故障

丢包的直观判断方法是：在客户端中对同一节点连续测速多次，如果延迟忽高忽低、偶尔出现超时，基本可以确认线路不稳定。Claude Code 一次任务往往持续数分钟，对这种波动远比网页浏览敏感。

仍然无法解决

• 执行 claude doctor 检查安装与环境（以当前版本为准），并把 Claude Code 升级到最新版本；
• 暂时关闭其他 VPN、加速器和安全软件，排除端口占用与流量拦截；
• 在 WSL 中运行时，代理地址不能直接使用 127.0.0.1，需要按 Windows 与 WSL 代理设置改用宿主机 IP 或镜像网络模式；
• 把排查过程记录下来：使用的节点与地区、代理变量的值、curl 的返回结果和 Claude Code 的原始报错，向机场客服或同事求助时能大大缩短沟通时间；
• 如果节点长期丢包，考虑更换线路。本站实测中，二猫云是唯一 Claude Code 实测可用的品牌，美国、日本、新加坡节点可用，专线丢包 0.3%；光速云 IPLC + 原生 IP，家宽丢包 0.2%，Claude 实测可用，Claude Code 暂未单独实测。

请遵守所在地法律法规以及 Anthropic 的使用条款和支持地区政策。

相关问题

• Claude Code 安装与登录教程
• Windows 与 WSL 中 Claude Code 的代理设置
• Claude API 请求超时、529 与连接错误排查
• Claude 稳定机场推荐
• Clash Verge 使用教程