Claude Code WSL 代理：NO_PROXY 设置

最常见的三个原因

原因 1：变量设错了地方。在 WSL 终端里启动的 Claude Code 是 Linux 进程，在 Windows PowerShell 里设的变量传不到它，除非用 WSLENV 传过去；反过来也一样。在 shell 里 export 的变量只在启动时读一次，后台代理又由同一个守护进程启动，所以 settings.json 是最稳妥的位置。

原因 2：地址只在 Windows 上有效。WSL 默认是 NAT 模式，WSL 里的 127.0.0.1 指的是 WSL 自己，所以跑在 Windows 上、监听 127.0.0.1 的代理客户端它够不到。要用 Windows 主机的 IP，或者把 WSL 切到镜像模式，这时 127.0.0.1 就能访问 Windows 上的服务。

原因 3：URL 不是 Claude Code 接受的写法。它不支持 SOCKS，而且 URL 少了 http:// 会让启动报错，并指出是哪个变量。

• Claude Code 代理指南

• 来源：
• Claude Code 文档：企业网络配置
• Microsoft Learn：WSL 网络应用访问

变量该设在哪

来自 Claude Code 的网络和设置页面，以及 Microsoft 的 WSL 网络页面，2026 年 11 月 15 日阅读。新版本的行为可能变化。

• 来源：
• Claude Code 文档：企业网络配置
• Claude Code 文档：设置文件与优先级
• Microsoft Learn：WSL 网络应用访问
• Microsoft 开发博客：在 WSL 与 Windows 之间共享环境变量

按这个顺序排查

1. 第 1 步：先不用 Claude Code，单独测代理

   在你启动 claude 的同一个终端里，用 curl -x 加代理 URL 请求 https://ipinfo.io/json。这一步失败，说明地址、端口、协议或账号密码有问题，Claude Code 也一定连不上。

   • 代理地址、端口和登录

2. 第 2 步：用 HTTP 写法

   写成 http://USERNAME:PASSWORD@HOST:PORT。Claude Code 不支持 SOCKS。密码里有特殊字符时，要做百分号编码。

3. 第 3 步：在 claude 运行的地方设变量

   按下面的命令，WSL 用 bash，Windows 用 PowerShell。再加上 NO_PROXY，写上你的工具会访问的本地地址，比如 localhost 和 127.0.0.1。

4. 第 4 步：写成长期有效

   把同样的值写进那个系统里 settings.json 的 env 块。如果启动环境里已经设置了同名变量，settings 里的值会被忽略，所以别在两处设不同的值。

5. 第 5 步：确认 Claude Code 实际用的是什么

   启动 claude，运行 /status：Proxy 一行显示正在使用的代理 URL。想看更多细节，用 claude --debug 启动再读日志。

WSL：设置变量并检查代理

# Inside the WSL terminal, before you start claude
export HTTPS_PROXY="http://USERNAME:PASSWORD@HOST:PORT"
export HTTP_PROXY="$HTTPS_PROXY"
export NO_PROXY="localhost,127.0.0.1"

# What does the proxy show? (a wrong login or port fails here, not in Claude Code)
curl -sS -x "$HTTPS_PROXY" https://ipinfo.io/json

claude

仅为示例。把 USERNAME、PASSWORD、HOST、PORT 换成你自己的。

Windows PowerShell

# Windows PowerShell, native Claude Code on Windows
$env:HTTPS_PROXY = "http://USERNAME:PASSWORD@HOST:PORT"
$env:HTTP_PROXY  = $env:HTTPS_PROXY
$env:NO_PROXY    = "localhost,127.0.0.1"
claude

仅为示例。只对当前 PowerShell 窗口有效。

两个系统通用的 settings.json

{
  "env": {
    "HTTPS_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
    "HTTP_PROXY": "http://USERNAME:PASSWORD@HOST:PORT",
    "NO_PROXY": "localhost,127.0.0.1"
  }
}

仅为示例。文件是 ~/.claude/settings.json；在 Windows 上是 %USERPROFILE%\.claude\settings.json。

镜像模式与 Windows 代理信息

# C:\Users\<you>\.wslconfig   (Windows 11 22H2 or later)
[wsl2]
networkingMode=mirrored
autoProxy=true

仅为示例，来自 Microsoft 的 WSL 页面。修改后重启 WSL。

用 WSLENV 从 Windows 传变量

# PowerShell: pass variables from Windows into a WSL process
$env:HTTPS_PROXY = "http://USERNAME:PASSWORD@HOST:PORT"
$env:NO_PROXY    = "localhost,127.0.0.1"
$env:WSLENV      = "HTTPS_PROXY:NO_PROXY"
wsl claude

# WSL in the default NAT mode: the Windows host as seen from WSL
ip route show | grep -i default | awk '{ print $3}'

示意代码。最后一行是 Microsoft 给出的、在 WSL 里查 Windows 主机 IP 的命令。

• 来源：
• Microsoft 开发博客：在 WSL 与 Windows 之间共享环境变量
• Microsoft Learn：WSL 网络应用访问

症状与处理

在 Claude Code 里用 Proxy302

Claude Code 需要的是 HTTP 代理 URL，Proxy302 的 HTTP 代理可以提供：主机 proxy.proxy302.com，端口 2222，账号密码在「我的资产」里。静态 ISP IP 在整个租期内固定不变、不轮换，一个账号就一直用同一个地址。代理不会改变 Anthropic 的条款：请只在 Claude 支持的地区使用，因为政策限制人员在不受支持的地区实际所在时使用。如果出现验证，请如实完成；页面打不开，先检查网络和 IP 本身，再带订单号提交工单。

静态 ISP IP 一天 US$0.50，30 天 US$7.99，所有国家价格相同，协议在购买时按每个 IP 选择。自动续费是可选的，可以在「我的资产」里关闭。没有免费试用，最小购买单位是一个 IP 一天。

• 静态 ISP 页面
• Claude 设置

• 来源：
• Proxy302 产品信息与价格表
• Anthropic：支持的地区

常见问题

延伸阅读

Claude Code 怎么设置代理

Claude Code 在 HTTP 代理后的设置：HTTPS_PROXY、NO_PROXY、后台代理用的 settings.json，以及确认生效的检查。

Claude 账号环境

网站能读到你的时区、浏览器语言和付款信息吗：怎么自查，以及 Anthropic 明确写了什么。

代理的地址、端口、账号和密码怎么填

每个可用的代理都由五个基本字段构成：协议、地址、端口、账号和密码。

静态住宅 IP（ISP 代理）

静态 ISP 代理：一条固定的住宅级 IP，整个租期内保持不变。适合社媒账号、店铺和 AI 工具。支持 HTTP / SOCKS5。

查看配置与价格

代理 IP 怎么查：IP 地址、国家、运营商

30 秒查清代理的 IP、国家和运营商；为什么不同查询网站城市对不上、纯净度分数看什么。附我们对三家查询服务的实测。