Claude Code 代理设置教程

为什么浏览器能用，Claude Code 不行

代理客户端勾选「系统代理」后，浏览器会按系统设置把请求交给客户端。终端程序不同，它们通常只认环境变量里的代理配置，对系统代理设置视而不见。于是请求直接发往 Anthropic 的服务器，在国内网络下自然会超时或连接失败。

除此之外，出口节点同样需要在 Anthropic 支持的地区，香港节点用不了。

方法一：开 TUN 模式（最省事）

上图为星岛梦在珠海联通骨干网下的全节点测试，落地 IP 纯净度高，无 Cloudflare 人机阻断，完美适配 ChatGPT 与 Claude。

TUN 模式通过虚拟网卡接管电脑上所有程序的流量，终端自然也包括在内，不需要额外配置。

1. 在 Clash Verge Rev 等客户端里打开 TUN 模式（Windows 需要先安装服务模式）；
2. 确认 AI 相关策略组选的是支持地区的节点；
3. 重新打开终端，启动 Claude Code。

详细步骤见 TUN 模式怎么开。

方法二：设置终端环境变量

不想开 TUN，或者公司电脑开不了 TUN 时，用环境变量。先在客户端里查看「混合端口」或「HTTP 端口」，常见是 7890 或 7897，以你自己客户端显示的为准。

macOS / Linux

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890

在同一个终端窗口里启动 Claude Code 即可。这种写法只对当前窗口有效，关掉就失效。

Windows PowerShell

$env:HTTP_PROXY="http://127.0.0.1:7890"
$env:HTTPS_PROXY="http://127.0.0.1:7890"

同样只对当前 PowerShell 窗口有效。

让设置永久生效

每次打开终端都要输入一遍很麻烦，可以写进 shell 配置文件。macOS 默认使用 zsh：

echo 'export HTTP_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
echo 'export HTTPS_PROXY=http://127.0.0.1:7890' >> ~/.zshrc
source ~/.zshrc

使用 bash 的 Linux 用户改成 ~/.bashrc。需要注意：写进配置文件后，代理客户端没开时，终端里所有走 HTTP 的命令都会失败。如果你经常关代理，可以改成定义两个快捷命令按需开关：

alias proxy_on='export HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890'
alias proxy_off='unset HTTP_PROXY HTTPS_PROXY'

验证是否生效

启动 Claude Code 前，先在同一个终端窗口测试：

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

能很快返回 HTTP 状态码（即使是 404 之类也说明网络通了），说明终端已经可以连到 Anthropic；如果长时间卡住或超时，说明代理没生效，回头检查端口和客户端状态。

两种方法怎么选

两种方法不冲突，但同时使用没有额外好处。个人电脑推荐 TUN，省去逐个排查“哪个程序没走代理”的麻烦；不方便装虚拟网卡时再用环境变量。

常见问题

设置了环境变量还是连不上？ 确认变量是在启动 Claude Code 的同一个窗口里设置的；用 echo $HTTPS_PROXY 检查是否存在；再确认节点地区不是香港。

在 VS Code 等编辑器的内置终端里用？ 内置终端同样读取 shell 配置文件，写入 ~/.zshrc 后重新打开终端即可；开 TUN 则完全不用管。

能登录但用一会儿就断？ 多半是节点不稳或 AI 策略组设成了自动切换，参考 Claude 用什么节点最稳定 固定一个节点。