Home
avatar

YEYUbaka

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.ClaudeCode

winget 安装可能需要魔法(访问 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,别又被自动更新坑了。

Claude Code Windows 踩坑记录 2026