Claude Code 代理配置：环境变量、TUN 模式与常见报错

为什么浏览器能用，Claude Code 却连不上

Claude Code 是一个运行在终端里的程序。代理客户端开启的「系统代理」主要服务浏览器这类会主动读取系统设置的软件，终端进程默认不会去读它。于是经常出现这样的局面：claude.ai 网页一切正常，claude 命令却报 fetch failed 或者一直卡在连接中。

解决思路只有两条：让终端进程知道代理地址（环境变量），或者在系统网络层把所有流量接管（TUN 模式）。地区、IP 类型这些通用原则在AI 工具网络环境指南里已经讲过，本文只讲 Claude Code 特有的配置。

官方支持哪些代理变量

根据 Anthropic 的 Claude Code 官方文档（Enterprise network configuration 一页），Claude Code 遵循标准代理环境变量：

• HTTPS_PROXY：官方推荐优先设置；
• HTTP_PROXY：没有 HTTPS 代理时使用；
• NO_PROXY：不走代理的地址，空格或逗号分隔均可；
• 小写形式同样有效，读取顺序为 https_proxy、HTTPS_PROXY、http_proxy、HTTP_PROXY，用第一个有值的。

文档还提到，这些变量只在启动时读取一次。改完变量一定要退出并重新运行 claude。

设置环境变量

下面的示例都使用 127.0.0.1:7897。端口号是代理客户端的本地端口，例如 Clash Verge Rev 默认 7897、v2rayN 默认 10808，以你的设置为准。

macOS / Linux（bash、zsh）

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

只对当前窗口生效。想每次打开终端都自动设置，把前三行追加到 ~/.zshrc 或 ~/.bashrc，然后执行 source ~/.zshrc。

Windows PowerShell

$env:HTTPS_PROXY = "http://127.0.0.1:7897"
$env:HTTP_PROXY = "http://127.0.0.1:7897"
claude

Windows cmd

set HTTPS_PROXY=http://127.0.0.1:7897
set HTTP_PROXY=http://127.0.0.1:7897
claude

cmd 里 set 的等号两边不要加空格，也不要加引号。需要长期生效时可以用 setx HTTPS_PROXY http://127.0.0.1:7897，它只对之后新开的窗口有效。

写进 settings.json

官方文档说明，这一页的环境变量都可以放进 ~/.claude/settings.json 的 env 字段。如果你会用后台会话，官方更推荐这种方式：后台会话由一个独立的常驻进程托管，不一定继承你当前终端的变量。

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:7897"
  }
}

确认配置已生效

1. 先看终端出口

   在同一个窗口执行 curl -s https://ipinfo.io（PowerShell 里写 curl.exe），返回的 country 应该是你所选节点的地区，而不是 CN。

2. 在 Claude Code 里查看

   进入交互会话后运行 /status，官方文档说明 Proxy 一行会显示当前使用的代理地址，无法解析的地址会被标为无效。

3. 需要细节时开调试日志

   用 claude --debug 启动，日志写入 ~/.claude/debug/ 目录，可以看到证书、代理相关的加载记录。

方案二：开启 TUN 模式

TUN 模式在系统网络层创建虚拟网卡，终端、IDE 插件、Git 都会被接管，不用再逐个配置变量。Clash Verge Rev、v2rayN 都支持，一般需要先安装服务模式或以管理员权限运行。开启后建议关掉系统代理开关，避免两层叠加。具体操作可参考 Clash 教程和 v2rayN 教程。

节点与线路怎么选

Claude Code 和网页版共用同一套地区政策，香港不在支持范围内，优先选美国，其次日本、新加坡。与网页聊天不同的是，它会维持长时间的流式连接，一次任务可能持续好几分钟，中途断一次就要重试，所以：

• 丢包比延迟更重要：晚高峰频繁断开时，优先换 IEPL / IPLC 专线节点；
• 固定出口：给 Claude 相关域名建一个手动选择的策略组，不要用自动测速或负载均衡；
• 网页版、终端用同一地区，减少账号风控触发。

线路差异见机场线路完整入门，机场对比见机场推荐。

常见报错与处理

出现证书类错误（例如公司网络做了 TLS 解密）时，官方文档给出的做法是用 NODE_EXTRA_CA_CERTS 指定额外的 CA 证书文件；个人使用机场时一般用不到。

小结

Claude Code 的网络配置可以浓缩成三步：设置 HTTPS_PROXY（或开 TUN）→ 重启 claude 并用 /status 确认 → 固定一个低丢包的支持地区节点。和它同类的 Codex 配置思路相近，但登录方式有所不同，可以对照阅读。