Claude Code 连接失败怎么办：终端走代理的配置与长连接稳定方法

Claude Code、Codex CLI 这类终端工具的网络问题，九成出在「终端不走系统代理」和「节点撑不住长连接」两点上。

常见报错

为什么终端不走代理

Clash Verge 等客户端的「系统代理」只对读取系统代理设置的应用生效（浏览器、多数桌面软件）。Node.js、Python 等运行时启动的命令行程序默认不读取，流量直接出去。原理见什么是 TUN 模式与系统代理。

方法一：设置代理环境变量

在客户端中查看本地代理端口（Clash Verge 默认 7897），然后在终端设置：

macOS / Linux

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"
$env:HTTP_PROXY="http://127.0.0.1:7897"

设置后在同一个终端窗口运行 Claude Code。想长期生效，把 export 行写入 ~/.zshrc 或 ~/.bashrc。

方法二：开启 TUN 模式

在 Clash Verge「设置」中开启 TUN 模式（Windows 需安装服务并以管理员运行一次）。TUN 接管全部流量，终端无需任何配置。TUN 异常导致断网的处理见 Windows 开启代理后无法上网。

节点要求：长连接稳定性

Claude Code 的每次对话都是持续数十秒到数分钟的流式连接，对节点的要求比网页高：

• 专线优先：IEPL / IPLC 节点抖动小，不易中断；
• 地区：美国、日本、新加坡节点，香港节点多数不可用；
• 固定节点：不要用「自动选择」，自动切换会直接掐断正在进行的流式连接；
• 原生 IP：减少 403 与风控。

本站收录品牌中，二猫云的美西、日本、新加坡专线在 Claude Code 终端长连接测试中通过；无忧链接因美西节点丢包偏高不建议用于 Claude Code。详见二猫云评测与机场排行榜。

分流配置

为 Claude 相关域名固定专线节点，其他流量不受影响：

prepend-proxy-groups:
  - name: AI 专用
    type: select
    proxies:
      - 美西 IEPL 01
prepend-rules:
  - DOMAIN-SUFFIX,anthropic.com,AI 专用
  - DOMAIN-SUFFIX,claude.ai,AI 专用

配置方法见 Clash Verge 规则分流教程。

排查顺序

1. 浏览器能否打开 claude.ai？不能则先解决节点问题；
2. 终端是否设置了 HTTPS_PROXY 或开启了 TUN？
3. 用 curl -I https://api.anthropic.com 测试终端是否走代理；
4. 频繁 socket hang up → 换专线节点并固定。

相关内容

• ChatGPT 提示地区不支持怎么办
• Cursor 代码补全超时怎么办