iMaeGoo's Blog ·

解决 Claude Code 安装或更新后 claude.exe 无法运行、claude native binary not installed

💡 原文中文，约1500字，阅读约需4分钟。

📝

内容提要

Claude Code 在 2.1.113 版本后改为分发二进制包，导致 Windows 和 macOS 用户安装后出现“claude native binary not installed”错误。原因是国内 npm 镜像未同步大包。解决方法是强制从官方源安装或使用旧版。

🎯

Claude Code 从 2.1.113 版本开始改为分发二进制包，不再分发 JS 源码。
在 Windows 和 macOS 上安装或更新 Claude Code 后，可能会出现 'claude native binary not installed' 的错误。
国内常用的阿里 npm 镜像未同步大包，导致无法找到 Windows 平台的二进制包。
由于 optionalDependencies 是可选依赖，npm 安装时不会报错，导致用户误以为安装成功。
解决方法是强制从官方 npm 源安装或使用旧版 2.1.112。

🔎

Claude Code 从 2.1.113 版本开始转向分发二进制包，这一变化对用户的安装体验产生了显著影响。特别是在国内，常用的 npm 镜像未能同步大包，导致用户在安装时可能会遇到无法找到必要的二进制文件的情况。这意味着用户在更新或安装后，可能会面临无法运行程序的困扰。

由于 npm 的 optionalDependencies 机制，用户在安装时不会收到错误提示，可能误以为安装成功。实际上，缺失的二进制文件会导致程序无法正常运行。这一机制的设计虽然灵活，但在特定情况下可能会给用户带来困惑，尤其是在依赖较大的包时。

针对 'claude native binary not installed' 的问题，用户可以通过强制从官方 npm 源安装来解决，或者选择安装旧版 2.1.112。这些解决方案提供了有效的应对策略，确保用户能够顺利使用 Claude Code，避免因版本更新带来的不便。

❓

因为 Claude Code 从 2.1.113 版本开始改为分发二进制包，而国内常用的 npm 镜像未同步该大包，导致无法找到二进制文件。

可以通过强制从官方 npm 源安装，使用命令 npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org，或安装旧版 2.1.112。

该版本开始分发二进制包，不再提供 JS 源码。

因为 optionalDependencies 是可选依赖，npm 在安装时不会报任何错误，导致用户误以为安装成功。

可能与 2024 年的事件有关，npm 社区因盗版问题暂停服务，因此阿里 npm 镜像默认不同步巨型包。

可以通过运行 claude 命令来确认，如果出现错误 'claude native binary not installed'，则说明未成功安装。

🏷️