Claude Code Windows 代理配置常见错误与排查顺序
Claude Code 在 Windows 上常见联网问题，通常和 PowerShell、Git Bash、PATH、代理变量和网络路径有关。本文按排查顺序整理。
Find related content
Search the site for tools, terms, comparison pages, or related troubleshooting notes without going back to the blog index.
Main answer
Claude Code 在 Windows 上的代理问题，最稳的排查顺序不是反复重装，而是先确认命令可用，再确认当前 Shell，再确认代理变量，最后确认 CLI 联网路径。
Who should read this
适合在 Windows 上用 Claude Code，并卡在 PowerShell、Git Bash、PATH 或代理问题上的开发者。
Key check
浏览器能上网，不代表 CLI 能上网；某个 Shell 里代理生效，也不代表另一个 Shell 自动生效。
Next step
如果你还没完成基础安装，先回 Claude Code 安装教程；如果已经能运行但还是连不上，再看 PowerShell 联网排障。
很多人遇到 Claude Code 在 Windows 上连不上网，第一反应都是：
- 反复重装
- 换模型
- 换代理软件
但多数时候，问题并不在“工具坏了”，而在下面几层被混到了一起：
- 命令有没有装好
- 你现在到底在哪个 Shell 里跑
- 代理变量有没有在当前会话里生效
- CLI 走的联网路径和浏览器是不是同一条
先按这个顺序排，不要乱跳
1. 先确认命令是不是能运行
先别急着测联网，先确认命令本身有没有安装成功。
如果这一步都不稳，后面所有代理排查都会歪掉。
2. 再确认你当前用的是哪个 Shell
Windows 上最常见的混乱之一是：
- 你以为自己在排 Claude Code
- 实际上是在不同 Shell 里来回切
PowerShell、Git Bash、WSL 的环境变量、PATH 和代理行为都可能不同。
所以排查前先钉死一件事：你现在到底在哪个 Shell 里执行。
3. 再看 PATH，不要把“找不到命令”误判成“代理问题”
如果命令根本没被正确识别，后面任何联网排查都没意义。
很多“好像连不上”的问题，其实是命令路径没配对。
4. 再确认代理变量是不是在当前会话里真的生效
这一步最容易出错。
常见情况是：
- 你在一个终端里配了变量
- 另一个终端里并没有继承
- 浏览器和代理软件能用，但 CLI 没走那条路径
所以你要确认的不是“我有没有开代理”，而是：
当前这个 Claude Code 运行的终端，会不会真的带着代理变量出网。
5. 最后再判断是不是网络层问题
如果前面几层都已经确认无误，再去判断：
- 当前网络是不是限制了 CLI 请求
- 某些地址是不是走不通
- 代理软件是不是只代理浏览器，不代理命令行
Windows 上最常见的 5 个错误
错误 1：把安装问题当成代理问题
命令没装好、PATH 没配对，结果一直在查网络。
错误 2：在 A Shell 里配变量，却在 B Shell 里测试
这是最常见也最浪费时间的一类错误。
错误 3：浏览器能用，就以为 CLI 一定能用
这两条路径并不总是一样。
错误 4：一次同时改太多东西
一边换 Shell，一边重装，一边改代理，一边改 PATH，最后会越来越乱。
错误 5：只看报错字面，不拆问题层次
很多报错表面像联网问题，实际根因在环境层。
更稳的做法
我更建议你把问题拆成这三层：
- 安装与命令层
- Shell 与 PATH 层
- 代理与联网层
只有这样，排障才不会一直绕回起点。
站内更适合接着看的几篇
- Claude Code 安装教程
- Claude Code 在 PowerShell 连不上网怎么办
- Claude Code 在 Windows 和 PowerShell 连不上怎么办
- Windows 用户更适合哪种 AI 编程工具
我的判断
Claude Code 在 Windows 上最该先排的，不是“代理开没开”，而是：
- 命令是否正确
- Shell 是否统一
- PATH 是否对
- 当前会话里代理是否真的生效
顺序对了，很多问题会比你想的简单得多。
继续阅读
Continue exploring
Use a tool first
If you need to format JSON, XML, YAML, or prompts, start with the online tools.
See implementation projects
If you want to see how these methods enter real builds and experiments, continue with projects.
Get checklists and templates
If you need checklists, resource entries, or SOP starter packs, continue with resources.
Download reusable skills
If you want repeatable judgment, search, and cleanup actions, continue with the skill market.
常见问题
为什么代理已经开了，Claude Code 还是连不上？
因为 Windows 上最常见的问题是代理只在某个终端里生效，或者 PATH、Shell、网络路径根本不是同一层问题。
