Claude Code 在 PowerShell 连不上网怎么办：Windows 用户先查这 6 步

如果你只想先看结论

• 浏览器能上网，不等于 Claude Code 在 PowerShell 里也一定能联网。
• Windows 下最常见的问题往往不是“没开代理”，而是：
  • 命令没装好
  • PATH 还没生效
  • 当前 PowerShell 会话没有拿到 HTTP_PROXY
  • 你把 PowerShell、Git Bash、WSL 三种环境混着试
• 如果你准备长期在终端里用 Claude Code，WSL 或 Git Bash 往往比原生 PowerShell 更稳。

先别急着怪网络，先确认问题真的是“联网问题”

很多人会把下面几件事混在一起：

• 命令不存在
• 登录失败
• 请求超时
• 浏览器能上网但 CLI 不通

但它们其实不是同一层问题。

你在排 PowerShell 联网之前，先执行：

claude --version

如果这条命令都跑不通，当前就还不是“网络问题”，而是：

• 安装没完成
• PATH 没生效
• 终端环境没选清楚

这时先回安装页更省时间：

• Claude Code 安装教程

第一步：确认你到底在哪条终端路线里排障

很多 Windows 用户真正的问题，不是代理本身，而是环境路线没有固定下来。

先问自己 3 个问题：

1. 你准备长期用的是 PowerShell、Git Bash，还是 WSL？
2. 你是不是一会儿在 PowerShell 里试，一会儿又跑去 Git Bash？
3. 你设置代理的那个终端，和你实际运行 claude 的终端，是不是同一个？

如果答案是“混着试”，就很容易出现这种假象：

• 你以为自己已经设置了代理
• 其实代理只在另一个 shell 里生效
• 你以为 PATH 已经好了
• 其实只是另一个会话生效

对这类问题来说，先把“我到底在哪个终端里排”固定下来，比继续换节点更重要。

第二步：直接看 PowerShell 当前会话有没有拿到代理变量

如果浏览器能上网，但 Claude Code 在 PowerShell 里发不出请求，最值得先看的不是系统设置页，而是当前会话：

echo $env:HTTP_PROXY
echo $env:HTTPS_PROXY
echo $env:NO_PROXY

如果这些都是空的，通常说明：

• 浏览器可能在走图形界面代理
• 但 PowerShell 当前会话没有显式拿到 CLI 需要的代理变量

这时最稳的测试方式，是先临时显式设置：

$env:HTTP_PROXY="http://127.0.0.1:10809"
$env:HTTPS_PROXY="http://127.0.0.1:10809"
$env:NO_PROXY="localhost,127.0.0.1"

然后再试：

claude --version
claude

这一轮的重点不是永久配置，而是先确认问题是不是出在会话层。

第三步：不要把浏览器代理和 CLI 代理当成一回事

这一步特别容易误判。

你可能已经做了这些事：

• 开了 v2rayN
• 开了 Clash
• 浏览器能打开外网
• 系统里看起来也像是有代理

但对很多 CLI 来说，它最信任的仍然是：

• HTTP_PROXY
• HTTPS_PROXY
• NO_PROXY

而不是“你系统托盘里看起来开着代理”这件事。

所以 Claude Code 在 PowerShell 里不通时，更应该优先问：

当前会话是不是显式知道该走哪个 HTTP 代理？

第四步：如果你长期做 CLI 工作流，别硬扛 PowerShell

这不是说 PowerShell 一定不能用，而是说：

如果你长期要做这些事：

• 在仓库根目录里工作
• 经常跑脚本
• 频繁切换代理和环境变量
• 做 agent 式终端工作流

那 WSL 或 Git Bash 往往更省心。

什么情况下继续留在 PowerShell

适合继续留在 PowerShell 的情况：

• 你只是偶尔运行 Claude Code
• 当前会话里的代理变量已经能稳定生效
• 你的团队和机器环境本来就以 PowerShell 为主

什么情况下该切到 Git Bash 或 WSL

更适合切换的情况：

• 你经常遇到路径、代理、执行环境混乱
• 你本来就更习惯 Unix 风格命令
• 你准备长期把 Claude Code 当成主要终端工具

如果你现在就在纠结该不该换路线，可以接着看：

• Windows 用户更适合哪种 AI 编程工具

第五步：把“命令存在”和“请求发得出去”拆成两层问题

很多排障卡很久，就是因为把这两层混在一起。

第一层：命令是否可用

这层看的主要是：

• claude --version
• PATH
• 安装是否完整

第二层：请求是否发得出去

这层看的主要是：

• HTTP_PROXY / HTTPS_PROXY
• 当前会话
• 目标域名是否能走通
• 登录和认证流程是否能完成

一旦你把这两层拆开，很多问题就会简单很多：

• 命令不存在：先回安装层
• 命令能跑但联网失败：再回代理和会话层

第六步：最容易浪费时间的 4 种错误思路

1. 命令都还没跑通，就先到处换节点

这通常会把安装问题误判成网络问题。

2. 浏览器能上网，就默认 CLI 也能上网

对 Windows 用户来说，这条非常不可靠。

3. PowerShell、Git Bash、WSL 混着试

这样最容易把“到底哪一步生效了”搞混。

4. 一次改太多设置

如果你同时改了：

• PATH
• 代理
• shell
• 启动方式

最后反而不知道真正起作用的是哪一项。

一套更稳的 PowerShell 排障顺序

如果你现在就卡住了，建议按这个顺序来，不要跳步：

1. 先跑 claude --version
2. 再看 $env:HTTP_PROXY 和 $env:HTTPS_PROXY
3. 临时显式设置 HTTP 代理再试一次
4. 确认你现在排障的就是实际使用的那个终端
5. 如果还不稳，再判断是否切到 Git Bash 或 WSL
6. 最后再怀疑节点、网络策略或更细的目标域名问题

如果你要长期用，什么时候把代理写进 PowerShell Profile

如果你每天都要在 Windows 上用 Claude Code，每次手动敲一遍代理变量会很烦。

这时可以把它放进 PowerShell Profile：

$env:HTTP_PROXY="http://127.0.0.1:10809"
$env:HTTPS_PROXY="http://127.0.0.1:10809"
$env:NO_PROXY="localhost,127.0.0.1"

但前提是：

• 你已经确认这个端口是长期稳定使用的
• 你不是在不同网络环境之间频繁切换

否则把临时配置直接固化进去，后面反而更容易误判。

结语

Claude Code 在 PowerShell 里连不上，最该记住的不是某个魔法命令，而是这件事：

先把终端环境说清楚，再把会话代理说清楚。

只要你把问题拆成下面 3 层：

• 命令是否可用
• 会话是否拿到代理
• 当前是不是合适的终端路线

这类 Windows 排障通常就不会再显得那么玄学。

继续往下读

• Claude Code 安装教程
• Claude Code 在 Windows 和 PowerShell 连不上怎么办
• Windows 用户更适合哪种 AI 编程工具
• AI 工具官方文档与下载入口汇总

参考与延伸阅读

• Claude Code Getting Started
• Claude Code Quickstart
• Claude Code IDE Integrations