Claude Code 连接失败怎么办：fetch failed、登录卡住、任务中途断开的排查

Claude Code 的连接问题集中在三个环节：启动、登录、任务执行。每个环节的原因不同，但都与「终端怎么走代理」有关。

按环节分类

启动失败

先验证终端能否到达 API：

curl -I https://api.anthropic.com

超时说明终端没走代理。设置：

export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897

Windows PowerShell：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"

端口以客户端设置为准（Clash Verge 默认 7897）。或开启 TUN 模式一劳永逸，见 Clash Verge TUN 模式。TUN 开不了见 TUN 无法启动。

ECONNREFUSED 是端口错误或客户端没运行。

登录卡住

Claude Code 登录会打开浏览器授权，然后回调终端。浏览器走系统代理，终端走环境变量。两者必须指向同一客户端与同一节点：

1. 客户端系统代理已开启。
2. 环境变量端口与客户端混合端口一致。
3. 同一策略组、同一节点。
4. 浏览器不要有其他代理扩展。

登录页提示地区不可用：节点在香港，换日本、新加坡、美国，见 Claude 地区限制。

任务中途断开

一个任务持续几十分钟，连接保持打开。断开的原因：

• 线路抖动： 公网中转晚高峰常见。换专线节点，见 AI 稳定线路怎么选。
• 策略组自动切换： url-test 或负载均衡策略组在延迟波动时换节点，出口 IP 变化导致会话异常。anthropic.com 域名的策略组改为 select，固定节点。
• 529 过载： 与网络无关，Claude Code 会自动重试。

安装卡住

npm 安装需要访问 npm 源与 GitHub，同样需要终端代理。设置环境变量后重试。

完整配置

三件套：TUN 或环境变量、专线、固定节点。详见 Claude Code 网络环境。API 层错误见 Claude API 连接失败。适合的服务见 Claude 机场推荐。