Claude Code 网络环境配置：终端代理、TUN 模式与节点选择

Claude Code 是运行在终端里的 Node.js 程序，它不会像浏览器那样自动读取系统代理设置。因此“网页版 Claude 能用，Claude Code 一直连接失败”几乎都是同一个原因：终端进程根本没有经过代理。解决方式有两种，一是给终端设置 HTTPS_PROXY 环境变量指向本地客户端端口，二是在 Clash Verge Rev 中开启 TUN 模式让所有流量自动经过代理。

本文以 Clash Verge Rev 为例，给出两种方式的具体步骤、验证命令与常见报错的处理。节点地区的选择原则与网页版一致，可参考 Claude 网络环境完整指南。

先看结论

开发者日常推荐 TUN 模式，临时排查或多套代理环境切换时用环境变量。

第一步：确认本地代理端口与节点

打开 Clash Verge Rev，在设置页面找到混合端口（Mixed Port），记下数值，常见为 7897 或 7890。这个端口同时提供 HTTP 与 SOCKS5 代理。

然后在代理页面把 AI 分组固定到一个节点。Claude Code 的会话是长连接，自动测速分组在中途切换节点会直接导致连接重置，所以务必手动选定一个：

• 地区优先美国，其次日本、新加坡。
• 线路优先 IEPL / IPLC 专线，丢包率比延迟更重要。
• 避开机房 IP 与香港节点，原因见 Claude 网络环境指南。

第二步：设置终端代理环境变量

macOS / Linux 的 bash 或 zsh：

export HTTP_PROXY=http://127.0.0.1:7897
export HTTPS_PROXY=http://127.0.0.1:7897
export ALL_PROXY=http://127.0.0.1:7897
export NO_PROXY=localhost,127.0.0.1,::1

要长期生效，把这几行追加到 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。

Windows PowerShell：

$env:HTTP_PROXY = "http://127.0.0.1:7897"
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:NO_PROXY = "localhost,127.0.0.1"

要长期生效，可以写入 PowerShell 配置文件（$PROFILE），或在系统“环境变量”中为当前用户新增同名变量。注意变量名大小写混用时，多数工具同时识别大写与小写版本，统一用大写即可。

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

在设置好环境变量的同一个终端窗口中执行：

curl -sS https://api.anthropic.com/ -o /dev/null -w "%{http_code}\n"
curl -sS https://ipinfo.io/json

第一条命令返回任意 HTTP 状态码（如 404 或 401）都说明网络已通，返回 000 或长时间无响应说明代理未生效。第二条命令输出的 country 字段应与你选择的节点地区一致。如果出口 IP 显示为中国大陆，说明这个终端没有走代理。

Windows 用户在 PowerShell 中同样可以使用 curl.exe，注意要写成 curl.exe 而不是 curl，后者在 PowerShell 中是另一个命令的别名。

第四步：启动 Claude Code

在同一终端窗口运行 claude 并发送一条简短消息。首次使用时的登录流程会打开浏览器完成授权，此时浏览器与终端必须走同一地区的节点，否则可能出现授权回调失败。授权完成后回到终端，能正常收到回复就说明配置完成。

替代方案：开启 TUN 模式

如果环境变量在你的环境里不生效（常见于 IDE 内置终端、Windows 下的某些工具链、Docker 容器），直接开启 TUN 模式更省事：

1. 在 Clash Verge Rev 设置中找到服务模式，按提示安装（需要管理员权限）。
2. 打开 TUN 模式开关，栈类型保持默认即可。
3. 关闭系统代理开关，避免两者叠加造成混乱。
4. 重新打开终端，无需环境变量，直接用上一节的 curl 命令验证。

TUN 模式的安装细节、DNS 设置与冲突处理，见 Clash Verge Rev TUN 模式教程。

常见报错与处理

更多排查思路见 Claude Code 连接失败怎么办。

长连接与丢包

Claude Code 的一次任务可能持续数分钟，期间保持流式连接。与网页对话不同，它对丢包非常敏感：延迟 200ms 的专线通常比延迟 60ms 但丢包 3% 的中转更好用。晚高峰频繁断开时，先看客户端的连接日志是否有大量重连，再考虑更换为低倍率的专线节点。

对 Claude Code 重度用户来说，二猫云提供 Claude 专用节点组且全节点 IEPL，长连接表现是它的主要卖点。更多选择见 Claude 机场推荐。

总结

• Claude Code 不读取系统代理，必须用环境变量或 TUN 模式之一。
• 环境变量写 http://127.0.0.1:混合端口，在同一终端中用 curl 验证出口 IP。
• AI 分组固定为单个美国 / 日本 / 新加坡专线节点，不要用自动测速。
• fetch failed 看代理是否生效，ECONNRESET 看丢包与节点切换，超时先验证端口。
• 需要 IDE、Git、Docker 一起走代理时，直接开 TUN 模式最省事。