原创文章遵循 CC 4.0 BY-SA 版权协议引言最近在 Windows 上折腾 Claude Code 时遇到了一个非常迷惑的问题claude --version能正常输出2.1.78说明命令已安装成功、PATH 配置正确但只要输入claude或claude hello终端就会一直卡住没有任何报错输出更诡异的是执行几条命令后偶尔能恢复正常但重新打开终端后问题再次复发。一开始我怀疑过各种可能Claude Code 没装好、PowerShell 版本太低、Node.js/nvm 环境有问题、Windows 终端兼容性不好……但最终定位下来真正的问题其实非常简单PowerShell 中残留了无效的代理环境变量导致 Claude Code 的网络请求被阻塞。关键还在于我一开始的“修复”只是清掉了当前终端会话里的变量并没有删除用户级的全局环境变量所以每次重开终端这些代理变量又会自动回来Claude 就再次卡住。这篇文章把完整的排查过程和最终解决方案整理出来希望能帮助遇到同样问题的朋友。一、问题现象执行以下命令claude--version输出正常2.1.78 (Claude Code)这说明Claude Code 已经安装成功命令已经注册到 PATHnpm 全局安装没有问题可执行文件本身没有损坏但是执行claude或者claudehello终端就会一直卡住没有输出也没有报错看起来“死掉了一样”。这种问题很容易被误判成安装问题但它实际上已经不是“安装阶段”的问题而是“运行阶段”的问题。二、初步判断安装没问题问题出在运行时为什么可以先排除安装问题因为如果安装真的有问题常见表现通常是claude命令找不到claude --version报错PATH 没配好npm 全局安装失败而我的情况是claude --version完全正常。结论很明确Claude Code 本体是好的问题出在启动后的初始化过程。三、开启调试日志定位卡点为了进一步定位我开启了调试输出$env:DEBUG*claude日志中能看到类似这样的内容节选2026-03-18T13:22:33.650Z [DEBUG] Watching for changes in setting files C:\Users\JumsZHU\.claude ... 2026-03-18T13:22:33.673Z [DEBUG] [init] configureGlobalMTLS starting 2026-03-18T13:22:33.673Z [DEBUG] [init] configureGlobalMTLS complete 2026-03-18T13:22:33.673Z [DEBUG] [init] configureGlobalAgents starting ...然后没有后续进展从这段日志里能看出几个关键信息Claude Code 已经成功启动了– 它已经开始监听配置文件变更也在正常写入本地配置。本地配置文件写入没有问题–.claude.json被正常原子写入说明文件权限和磁盘不是问题。卡在网络初始化阶段– 日志显示执行到configureGlobalAgents starting后基本没下文了。这通常意味着Claude Code 并不是一启动就崩溃而是在网络代理/全局 agent 初始化的环节卡住了。四、怀疑方向转向代理环境变量到了这一步怀疑重点从“安装问题”转移到了“网络配置问题”。我检查了 PowerShell 当前会话中的代理环境变量echo$env:HTTP_PROXYecho$env:HTTPS_PROXYecho$env:ALL_PROXY这一步非常关键。因为很多命令行工具包括 Claude Code、npm、git、curl 以及一些 Node.js CLI 工具都会优先读取这些环境变量。只要这些变量存在CLI 工具就会默认“所有网络请求都走代理”。问题在于代理变量存在不代表代理真的可用。常见坑包括代理软件没开代理端口变了以前设过的代理值已经失效浏览器能上网但 CLI 走的是另一套代理逻辑Windows 系统代理和环境变量代理冲突于是就会出现一个诡异现象浏览器可以正常打开网页但 Claude Code 一直卡住不动。五、临时解决方案清除当前终端中的代理变量为了验证是不是代理问题我先执行了以下命令Remove-ItemEnv:HTTP_PROXY-ErrorAction SilentlyContinueRemove-ItemEnv:HTTPS_PROXY-ErrorAction SilentlyContinueRemove-ItemEnv:ALL_PROXY-ErrorAction SilentlyContinue然后重新执行claudeClaude Code立刻恢复正常。问题已经定位得非常清楚并不是 Claude Code 坏了而是它启动时读取到了一个无效的代理配置导致请求被卡在了代理那一层。六、为什么删除变量后就好了原理很简单当环境中存在HTTP_PROXY、HTTPS_PROXY、ALL_PROXY这些变量时Claude Code 启动后会默认将网络请求转发给这些代理地址。如果这些地址对应的代理服务没开或者端口已经失效就会变成Claude Code → 请求走代理 → 代理地址不可用 → 请求一直阻塞 → 表现为终端卡住而执行Remove-Item命令本质上是在告诉 Claude Code“不要走代理直接联网”。于是请求恢复正常Claude Code 也就正常启动了。七、为什么重新打开终端又会复发这个问题才是最坑的地方。我一开始也很疑惑明明刚刚已经修好了当时执行完删除命令后 Claude 也确实恢复正常了但只要关闭终端再重新打开 PowerShell 输入claude又卡住了。还得重新执行一次删除代理变量的命令。后来才意识到我删掉的只是“当前 PowerShell 会话里的环境变量”并没有删除 Windows 用户级的持久化环境变量。八、Windows 环境变量有三层这里最容易踩坑Windows 下环境变量大致可以分成三个层级层级作用范围说明当前终端会话变量仅当前窗口在当前 PowerShell 窗口里临时设置或删除关闭窗口后丢失用户级环境变量当前登录用户持久化存储每次打开新终端自动加载系统级环境变量整台机器更高层级的全局变量对所有用户生效如果你的HTTP_PROXY、HTTPS_PROXY、ALL_PROXY是存在于“用户环境变量”里的那么每开一个新终端Windows 就会自动把这些变量重新加载进来。这就是为什么你会感觉“明明删掉了怎么重新打开终端又复活了”九、真正的根因删掉的只是临时变量全局变量还在整个问题的完整链路如下表面现象claude卡住无响应。直接原因当前终端里存在无效的代理环境变量。更深层原因这些代理变量不是临时出现的而是已经被持久化到了用户级环境变量中。为什么每次重开终端又坏了因为新开的 PowerShell 会自动重新加载用户级环境变量无效代理又回来了。十、永久解决方案删除用户级环境变量方案一使用 PowerShell 命令删除[Environment]::SetEnvironmentVariable(HTTP_PROXY,$null,User)[Environment]::SetEnvironmentVariable(HTTPS_PROXY,$null,User)[Environment]::SetEnvironmentVariable(ALL_PROXY,$null,User)执行完之后关闭当前终端重新打开 PowerShell验证是否删除成功echo$env:HTTP_PROXYecho$env:HTTPS_PROXYecho$env:ALL_PROXY如果三个值都是空的说明已删除成功。此时再执行claude就不会再复发了。方案二使用图形界面删除如果你不想用 PowerShell也可以用 Windows 图形界面操作打开“开始菜单”搜索“环境变量”点击“编辑系统环境变量”点击“环境变量”按钮在“用户变量”列表里查找HTTP_PROXYHTTPS_PROXYALL_PROXY选中它们点击删除如果你怀疑系统级环境变量里也有相同的值也可以顺便检查“系统变量”区域十一、为什么这个坑特别隐蔽这个问题隐蔽在几个地方没有直接报错– 很多时候并不会明确输出ECONNREFUSED或ETIMEDOUT而是单纯卡住。claude --version正常– 这会让人误以为 Claude 已经完全没问题了。实际上版本命令和真正进入会话是两回事。浏览器正常不代表 CLI 正常– 浏览器走的是系统代理逻辑而命令行工具往往更依赖环境变量。容易误判成别的问题– 尤其在 Windows 下大家第一反应通常是 PowerShell 版本、Node.js 版本、nvm 配置、PATH、终端兼容性……但这次真正的问题跟这些都没关系。十二、以后如何避免再踩这个坑最简单的建议是不要长期把代理环境变量写死在系统里。更稳妥的做法是“按需开启按需关闭”。例如可以在 PowerShell 里定义两个函数functionproxy-on{$env:HTTP_PROXY http://127.0.0.1:7890$env:HTTPS_PROXY http://127.0.0.1:7890}functionproxy-off{Remove-ItemEnv:HTTP_PROXY-ErrorAction SilentlyContinueRemove-ItemEnv:HTTPS_PROXY-ErrorAction SilentlyContinueRemove-ItemEnv:ALL_PROXY-ErrorAction SilentlyContinue}需要代理时proxy-on不用代理时proxy-off这样比长期写死在用户环境变量里安全得多。十三、完整排查流程总结如果你也遇到以下情况claude --version正常claude卡住不动没有任何明显报错重新打开终端问题又复发可以按下面的顺序排查步骤操作1确认安装没问题claude --version2打开调试日志$env:DEBUG*; claude3检查代理环境变量echo $env:HTTP_PROXY等4临时清掉当前会话中的代理变量验证是否为代理问题5如果临时清除后问题解决删除用户级全局环境变量临时清除命令Remove-ItemEnv:HTTP_PROXY-ErrorAction SilentlyContinueRemove-ItemEnv:HTTPS_PROXY-ErrorAction SilentlyContinueRemove-ItemEnv:ALL_PROXY-ErrorAction SilentlyContinue永久删除用户级变量[Environment]::SetEnvironmentVariable(HTTP_PROXY,$null,User)[Environment]::SetEnvironmentVariable(HTTPS_PROXY,$null,User)[Environment]::SetEnvironmentVariable(ALL_PROXY,$null,User)十四、结论问题的本质不是 Claude Code 安装失败也不是 PowerShell 坏了而是用户级环境变量里残留了无效的代理配置导致 Claude Code 在网络初始化阶段被卡住。而之所以“执行完删除命令就好了但重开终端又坏”是因为你删掉的只是当前 PowerShell 会话里的变量没有删除 Windows 用户级的持久化环境变量。希望这篇博客能帮你快速解决claude卡住的问题也希望能帮你理解 Windows 环境变量的层级逻辑避免以后再踩类似的坑。 本文为博主原创遵循 CC 4.0 BY-SA 版权协议。欢迎转载但请保留原文链接和作者信息。