Claude Code 网络连接失败怎么办？

Claude Code 提示网络连接失败，最常见的原因不是节点不行，而是终端根本没有走代理。浏览器能正常打开 claude.ai，是因为浏览器读取了系统代理；而终端里运行的 Claude Code 默认不会读取系统代理，请求直接发往 api.anthropic.com，自然连不上。解决办法是在终端设置 HTTPS_PROXY 与 HTTP_PROXY 环境变量，或者在客户端开启 TUN 模式接管全部流量。

如果连接能建立但经常中途断开，那是第二类问题：节点丢包。Claude Code 的长任务依赖持续的流式连接，对丢包比网页对话敏感得多，这时需要换低倍率的专线节点。

快速判断

第一步：让终端走代理

先在客户端里确认本地代理端口。Clash Verge Rev 默认混合端口通常是 7897，旧版本或其他客户端可能是 7890，以客户端设置页显示的为准。

macOS / Linux 终端（bash 或 zsh）：

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

Windows PowerShell：

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:ALL_PROXY = "socks5://127.0.0.1:7897"

这些变量只在当前终端会话有效，关闭窗口后失效。需要长期生效的话，把 export 行写入 shell 配置文件，或在 Windows 系统环境变量中添加。注意端口要与客户端一致，协议前缀写 http 而不是 https。

第二步：验证代理是否生效

在同一个终端窗口执行：

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

能收到 HTTP 响应头（状态码是 4xx 也算通，说明请求到达了 Anthropic 的服务器），代表代理已生效。如果依然超时，问题在客户端节点或端口，而不是 Claude Code。

第三步：或者改用 TUN 模式

如果不想每次设置环境变量，可以在 Clash Verge Rev 中开启 TUN 模式（部分版本叫增强模式或虚拟网卡）。TUN 模式在系统网络层接管全部流量，终端、IDE、Git 等工具都会自动走代理。开启后需要授予系统权限，Windows 需要安装服务组件。具体步骤见 Clash Verge TUN 模式教程。

注意：开启 TUN 后，如果仍然保留了环境变量，两者叠加通常不会出错，但排查问题时容易混淆。建议二选一。

第四步：连接不稳定时换节点

Claude Code 执行长任务时会保持流式连接几分钟甚至更久，任何一次明显的丢包都可能导致请求被重置。表现是任务跑到一半报网络错误、需要重试。这与节点地区无关，与线路质量直接相关：

• 中转线路与高倍率线路在晚高峰更容易丢包。
• IEPL / IPLC 专线丢包率低，是长连接场景的首选。
• 节点 IP 仍需满足地区与 IP 类型要求，参考 Claude 使用什么地区节点最稳定。

二猫云提供的 Claude 专用节点组是全 IEPL 且倍率低，在 Claude Code 长连接场景反馈比较稳定；更多选择见 Claude 机场推荐。

排查步骤

1. 在客户端确认本地代理端口号。
2. 在终端设置 HTTPS_PROXY、HTTP_PROXY、ALL_PROXY 三个变量。
3. 执行 curl -I https://api.anthropic.com，确认能收到响应。
4. 在同一终端窗口启动 Claude Code 重试。
5. 若频繁中断，切换到低倍率 IEPL / IPLC 的美国或日本节点。
6. 长期使用建议开启 TUN 模式，避免每次手动设置变量。

总结

• 浏览器能用不等于终端能用，Claude Code 需要单独的代理设置。
• 环境变量与 TUN 模式二选一，环境变量适合临时排查，TUN 适合长期使用。
• 用 curl -I https://api.anthropic.com 验证，先排除代理层问题。
• 能连上但频繁中断是丢包问题，换低倍率专线节点。
• 节点仍需满足 Claude 的地区与 IP 类型要求。