Claude Code 新版不兼容 Windows?两种方法快速修复
2026-04-19 今日踩坑:Claude Code 自动更新后在 Windows 上直接崩溃,claude.exe 变成 1 KB 的残废文件,无法启动。如果你也遇到了同样问题,按本文操作可以快速恢复。
问题现象
今天(4月19日)照常启动 Claude Code,结果直接弹出报错:
程序”claude.exe”无法运行: 指定的可执行文件不是此操作系统平台的有效应用程序。
昨天还好好的,今天突然就废了?第一反应是去看看 exe 文件有没有被杀毒软件误删,打开一看——
C:\Users\你的用户名\AppData\Roaming\npm\node_modules\@anthropic-ai\claude-code\bin\
发现 claude.exe 还在,但大小只有 1 KB,正常的应该有几十 MB。
这显然是自动更新拉回来的文件有问题。
原因分析
查了一下,Anthropic 的新版 Claude Code 已经不再提供 Windows 原生 .exe 可执行文件,改为以其他方式分发,导致 Windows 上的 npm 包里的 claude.exe 变成了一个无效的占位文件(1 KB)。
参考资料:
解决方案
方法一:用 winget 重新安装(推荐)
这是最简单彻底的方法,直接走 Anthropic 官方的 Windows 安装包。
第一步:卸载 npm 版本
npm uninstall -g @anthropic-ai/claude-code第二步:用 winget 安装官方版
winget install Anthropic.ClaudeCodewinget 安装可能需要魔法(访问 GitHub Releases),请确保网络畅通。
安装完成后直接在终端输入 claude 验证是否正常启动。
方法二:降级到兼容版本(临时方案)
如果暂时不想换安装方式,可以把 npm 版本降级到最后一个兼容 Windows 的版本。
第一步:卸载当前版本
npm uninstall -g @anthropic-ai/claude-code第二步:安装指定版本
npm install -g @anthropic-ai/claude-code@2.1.112第三步:验证
claude --version能正常输出版本号就说明恢复正常了。
安装完别忘了:禁用自动更新
不管用哪种方法,装好之后一定要禁用自动更新,不然下次自动更新又给你整回去。
找到你的 .claude 目录下的 settings.json(通常在 C:\Users\你的用户名\.claude\settings.json),添加下面这一行:
{
"DISABLE_AUTOUPDATER": "1"
}如果文件里已经有其他配置,加在对应位置就行,注意 JSON 格式不要写错。
设置完这个之后,Claude Code 就不会再自动更新到不兼容的版本了,可以安心使用。
总结
| 方法 | 适用场景 | 优点 |
|---|---|---|
| winget 重装(方法一) | 推荐所有人 | 官方维护,长期稳定 |
| npm 降级(方法二) | 临时救急 | 快速恢复,无需切换安装方式 |
两种方法都能解决问题,个人更推荐方法一,走官方 winget 包以后更新维护都更稳。
最后提醒:装完记得设 DISABLE_AUTOUPDATER,别又被自动更新坑了。
