教程 Claude Code 专题 Clash Verge 专题

Claude Code 网络环境配置：终端代理、TUN 模式与节点固定完整指南

Claude Code 网络环境指南讲清终端为什么不走系统代理、三种让 Claude Code 走代理的方法（环境变量、TUN、规则）、长连接对节点的要求，以及网页可用但 Claude Code 连不上的排查顺序。

机场导航编辑部 发布 更新 约 4 分钟
Claude Code 网络环境配置：终端代理、TUN 模式与节点固定完整指南 封面图
步骤概览
  1. 确认客户端端口 在 Clash Verge 设置中查看混合端口（默认 7897）。
  2. 选择代理方式 环境变量、TUN 模式或规则模式三选一，推荐 TUN。
  3. 固定节点 为 anthropic.com 相关域名建立策略组并固定一个日本或新加坡专线节点。
  4. 验证 在终端执行 curl -I https://api.anthropic.com 看是否返回 HTTP 状态码。
  5. 跑一个长任务 让 Claude Code 执行 10 分钟以上的任务，确认不中断。

Claude Code 在终端里运行，通过长连接与 api.anthropic.com 通信。它和 Claude 网页版最大的区别是：终端不会自动用你的系统代理。这篇把配置方法与稳定性要求讲清楚。

为什么网页能用，Claude Code 不能用

浏览器读取系统代理设置，所以客户端开启「系统代理」后网页就能访问。终端里的程序（Node.js、Python、curl）不读系统代理，它们读环境变量 HTTP_PROXY、HTTPS_PROXY。没设环境变量，Claude Code 就会直连 api.anthropic.com，然后超时。

三种让 Claude Code 走代理的方法

方法一：环境变量

在启动 Claude Code 的终端里设置（端口以你的客户端为准，Clash Verge 默认 7897）：

# macOS / Linux
export HTTPS_PROXY=http://127.0.0.1:7897
export HTTP_PROXY=http://127.0.0.1:7897
claude
# Windows PowerShell
$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
claude

想永久生效，把 export 写进 ~/.zshrc 或 ~/.bashrc，Windows 写进系统环境变量。

方法二：TUN 模式（推荐）

在 Clash Verge 开启 TUN 模式后，系统所有流量都经过虚拟网卡走代理，终端程序无需任何配置。这是最省事的方案，代价是需要管理员权限与服务安装。步骤见 Clash Verge TUN 模式，原理见 TUN 是什么。

方法三：规则模式确保域名走代理

无论用哪种方法，客户端处于规则模式时要确认 anthropic.com、claude.ai 相关域名命中代理规则，而不是直连。在 Clash Verge 的连接面板里看这些域名走的是哪个策略。

长连接对节点的要求

Claude Code 一个任务可能持续几十分钟，期间连接保持打开。对节点的要求：

  1. 专线。 公网中转晚高峰的抖动会让请求超时重试，任务中断。
  2. 固定单节点。 不要用「自动选择」「负载均衡」策略组。出口 IP 中途变化会让会话异常。
  3. 地区。 日本、新加坡延迟低；美国 IP 池大。避免香港。

推荐做法：在客户端配置中为 anthropic.com 建立单独策略组，固定一个日本或新加坡专线节点。适合的品牌见 Claude 机场推荐。

验证配置

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

返回 HTTP 状态码（即使是 4xx）说明网络已通；超时说明代理没生效。再跑一个 10 分钟以上的 Claude Code 任务观察是否中断。

常见错误

  • fetch failed / ECONNREFUSED：代理地址或端口错误，或客户端未运行。
  • ETIMEDOUT：环境变量未设置，或节点不可用。
  • 任务中途断开：节点抖动或策略组自动切换。
  • 登录页打不开：浏览器与终端用的节点地区不同，见 Claude 登录失败。

完整排查见 Claude Code 连接失败。其他开发工具的通用配置见 AI 开发工具网络环境。

下一步 Claude Code 连接失败：按步骤排查
Claude Code网络环境终端代理TUN开发工具