内容提要
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 后会出现 'claude native binary not installed' 错误？
因为 Claude Code 从 2.1.113 版本开始改为分发二进制包，而国内常用的 npm 镜像未同步该大包，导致无法找到二进制文件。
如何解决 Claude Code 安装后无法运行的问题？
可以通过强制从官方 npm 源安装，使用命令 npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org，或安装旧版 2.1.112。
Claude Code 2.1.113 版本有什么变化？
该版本开始分发二进制包，不再提供 JS 源码。
为什么 npm 安装时不会报错？
因为 optionalDependencies 是可选依赖，npm 在安装时不会报任何错误，导致用户误以为安装成功。
国内 npm 镜像为什么不同步大包？
可能与 2024 年的事件有关，npm 社区因盗版问题暂停服务，因此阿里 npm 镜像默认不同步巨型包。
如何确认 Claude Code 是否成功安装？
可以通过运行 claude 命令来确认，如果出现错误 'claude native binary not installed'，则说明未成功安装。
