Claude Code 连接失败怎么办?终端代理与长连接稳定性排查
Claude Code 报连接错误或任务中途中断,多数是终端流量没走代理或节点丢包过高。本文给出 curl 诊断、环境变量与 TUN 两种代理配置,以及固定出口的稳定性优化。
直接回答:Claude Code 连接失败,先确认终端流量是否真的走了代理(十有八九没走)。设置 HTTP_PROXY/HTTPS_PROXY 环境变量或开启客户端 TUN 模式;仍不稳定则把 anthropic.com 固定到低丢包专线节点并关闭负载均衡。这两步解决绝大多数问题。
第一步:验证终端代理是否生效
在终端执行:
curl -s ipinfo.io
如果返回的 IP 是你的真实地区(CN),说明终端流量没走代理——这是最常见的原因。浏览器正常不代表终端正常,两者的代理设置是独立的。
第二步:让终端流量走代理
两种方式任选其一。
方式 A:环境变量(以 Clash 默认端口 7890 为例)
export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
写入 ~/.zshrc 或 ~/.bashrc 可长期生效。
方式 B:TUN 模式:在 Clash Verge Rev 等客户端开启 TUN(增强)模式,系统所有流量自动接管,浏览器与终端出口天然一致,一劳永逸。
配置后重新执行 curl -s ipinfo.io,确认出口变为节点地区。
第三步:解决「能连上但不稳定」
Claude Code 的请求是长时间的流式连接,对线路质量敏感:
- 固定出口:把
anthropic.com、claude.ai域名规则指向单一节点,关闭负载均衡和自动测速切换; - 换专线:晚高峰频繁失败基本是中转线路丢包,换 IEPL/IPLC 节点,见高稳定机场推荐与节点丢包严重怎么办;
- 检查地区:确认节点位于 Claude 支持地区(不能用香港节点)。
常见错误
- 只配了浏览器代理,以为终端也跟着走了;
- 把 CLI 域名放进了自动测速 / 负载均衡组;
- 用香港节点(Claude 不支持)。
什么时候是服务端问题
status.anthropic.com 报故障、终端代理验证通过仍全部失败 → 等官方恢复。
网页版同时也连不上,说明问题不在终端而在账号或 IP,先看 Claude 为什么无法使用。完整配置见 Claude Code 网络环境指南。
客户端侧开 TUN 的步骤见 Clash Verge Rev 教程,开关弹回见TUN 模式开启失败;更多 AI 访问问题见网络问题排查 · AI 访问问题。
本文提到的机场
宇宙云
VLESS + IEPL 专线机场,不限速、不限设备、支持流量重置;主打 ¥25/月 120GB,年付小包折合 ¥8/月,AI 能力官方未统一实测、建议自测。
- 最低价格
- ¥25/月 起
- 流量
- 120GB 起
- 线路
- IEPL 专线
- 节点
- 70+ 个 · 5 个地区
- 时长
- 运营约 3 年
- 设备
- 不限
适合:要专线又想控价的用户、需要自研客户端的新手、不同流量档位的用户
常见问题
浏览器能上 Claude,Claude Code 为什么连不上?
浏览器代理不等于终端代理。Claude Code 运行在终端里,需要单独设置 HTTP_PROXY / HTTPS_PROXY 环境变量,或在客户端开启 TUN 模式接管全部系统流量。
Claude Code 用什么节点最稳定?
与 Claude 网页版一致:美国、日本、新加坡的专线节点。额外要求是低丢包与固定出口——把 anthropic.com 相关域名固定到单一节点,不要走自动测速组。
任务跑一半就断?
典型的出口 IP 变化或线路丢包问题。关掉负载均衡改手动选择,晚高峰换专线节点;公司网络则确认防火墙没有拦截长连接。
公司网络下用不了怎么办?
防火墙可能拦长连接或代理协议。换 443 端口的 Trojan 节点(流量特征接近普通 HTTPS),或先用手机热点验证是不是公司网络的问题。