Claude Code 怎么设置代理（Mac）

01

先判断你的情况：终端、桌面版、VS Code 还是已装 Clash

02

终端里怎么设置 Claude Code 代理（CLI 与 env 代理）

小写变量也有效。官方写明 Claude Code 按 https_proxy、HTTPS_PROXY、http_proxy、HTTP_PROXY 的顺序，用第一个已设置的。

代理需要账号密码时，写成 http://用户名:密码@地址:端口，不要把密码硬写进会被提交的脚本。

# 当前终端有效
export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
export NO_PROXY="localhost,127.0.0.1"

# 要长期生效，把上面几行写进 ~/.zshrc，然后新开一个终端
claude

1. 确认代理客户端的 HTTP 端口

   在你的代理客户端里找 HTTP 端口或混合端口，下面以 127.0.0.1:7890 为例，以你自己的为准。官方文档不支持 SOCKS，所以不要填 SOCKS 端口。

2. 在终端里导出变量

   变量要在启动 claude 之前设置。官方说明 shell 里的变量只在启动时读取一次，运行中的会话不会感知后面的修改。

3. 启动 claude 并确认

   运行 claude，进入会话后输入 /status，看 Proxy 一行是不是你设置的地址。官方写明地址解析失败时（例如缺少 http://），Claude Code 会在启动时报错并指出是哪个变量。

03

用 settings.json 的 env 块设置代理配置，所有项目通用

把变量写进 ~/.claude/settings.json 的 env 块，Claude Code 直接从文件读取，不管你从哪里启动它。这个文件对你机器上的每个项目都有效，官方文档说明 VS Code 扩展、桌面版和终端读的是同一组设置文件。

同一个变量在 shell 和 env 块里都设置时，官方写明大多数会话里以 settings.json 的值为准，但桌面版本地会话会保留启动环境里已有的值。文件必须是严格 JSON，不能有注释和多余的逗号。

后续改动在你保存后会同步到运行中的会话。代理变量保险起见建议改完重新启动 claude，再用 /status 核对。

{
  "env": {
    "HTTPS_PROXY": "http://127.0.0.1:7890",
    "HTTP_PROXY": "http://127.0.0.1:7890",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

04

Claude Code 全局代理：TUN 模式不需要任何配置

TUN 是在系统里创建一块虚拟网卡，把流量接进代理核心。sing-box 的 TUN 入站在 Linux、Windows 和 macOS 上可用，打开 auto_route 后会把默认路由指向这块虚拟网卡。

因为接管发生在网络层，Claude Code 进程不需要读取任何代理变量，终端、VS Code、桌面版里启动的 claude 都会经过它。代价是它接管整台 Mac 的流量，哪些走代理、哪些直连要靠规则决定。

如果你说的全局代理是让整个 Claude Code 在所有项目里都用同一个代理，上一节的 ~/.claude/settings.json 就够了，不必开 TUN。

07

验证与排查：怎么确认 Claude Code 走了代理

最直接的是 Claude Code 里的 /status，Proxy 一行显示生效的代理地址，解析不了的地址会被标为无效并忽略。想看更详细的日志，用 claude --debug 启动，日志写在 ~/.claude/debug/<会话 ID>.txt。

如果用的是 Pax，再对照「流量监控 → 概览」：Claude Code 的连接应出现在你选的线路下。两边结果一致才算数；网络通了不等于账号能用，401、403 之类的错误要从账号和中转地址上排查。