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

今天在 Windows 或 macOS 上安装或更新 Claude Code 后，运行 claude 命令却报错 claude native binary not installed（macOS）、程序 claude.exe 无法运行（Windows）。折腾了一番终于搞清楚了原因。

原因分析

Claude Code 自 2.1.113 版本开始改为分发二进制包，不再分发 JS 源码。

用 npm 安装 claude 时，它会通过 optionalDependencies 来安装不同平台的二进制包。

"optionalDependencies": {
  "@anthropic-ai/claude-code-darwin-arm64": "2.1.114",
  "@anthropic-ai/claude-code-darwin-x64": "2.1.114",
  "@anthropic-ai/claude-code-linux-x64": "2.1.114",
  "@anthropic-ai/claude-code-linux-arm64": "2.1.114",
  "@anthropic-ai/claude-code-linux-x64-musl": "2.1.114",
  "@anthropic-ai/claude-code-linux-arm64-musl": "2.1.114",
  "@anthropic-ai/claude-code-win32-x64": "2.1.114",
  "@anthropic-ai/claude-code-win32-arm64": "2.1.114"
},

然而 Windows 平台的二进制包有足足 234MB 大，国内常用的阿里 npm 镜像站（https://npmmirror.com）默认不会同步这种巨大的 npm 包，导致找不到该包。

为什么阿里不同步巨型包？我猜跟 24 年的这次事件有关——《庆余年2》遭遇“开源”盗版，npm社区“被迫”暂停服务

又因为 optionalDependencies 是可选依赖，npm 在安装时不会报任何错误，看起来安装成功了，实则二进制文件根本没有装上。

解决方案

安装时指定强制从官方 npm 源下载即可：

npm install -g @anthropic-ai/claude-code --registry=https://registry.npmjs.org

或者不安装最新版，安装最后一个使用 js 的版本：

npm install -g @anthropic-ai/claude-code@2.1.112