Claude Code (cc) 升级 2.1.121 报错“Native Binary”全记录

🚀 省流助手（速通结论）

升级后报错 Error: claude native binary not installed，主因是 pnpm v10 默认禁用了构建脚本，导致核心二进制文件未下载。

三行命令修复：

1. 删旧部：rm -rf $(npm config get prefix)/lib/node_modules/@anthropic-ai/claude-code
2. 切官方：nrm use npm (或在安装时指定官方 registry)
3. 强行装：pnpm add -g @anthropic-ai/claude-code --allow-build=@anthropic-ai/claude-code

---

一、 现象：为什么 2.1.100 之前没事，现在报错？

在 2.1.100 之前（如 2.1.85）安装体验通常很顺滑，但近期升级到 2.1.121 频繁卡死，核心原因如下：

1. 架构转向原生化：从 2.1.100 左右开始，Claude Code 为了性能强化了 Native Binary 分发。npm 包主体只是个壳，核心逻辑需要在 postinstall 阶段通过 install.cjs 实时下载对应系统的二进制文件。
2. 包管理工具策略变更：如果你最近升级了 pnpm v10，它出于安全考虑默认跳过了所有构建脚本。结果就是"壳装上了，灵魂（二进制文件）没下来"，敲命令必崩。

二、 排雷：那些看似正确的"假动作"

• 假方案 A：直接 npm install -g。

  • 坑点：在 NVM 环境下，如果之前安装残留过损坏文件，常报 ENOTEMPTY: directory not empty, rename...。npm 试图备份旧目录但因目录非空锁死。

• 假方案 B：使用淘宝源/私有源安装。

  • 坑点：install.cjs 脚本在下载底层二进制时，可能存在路径同步延迟或对官方 Registry 路径的硬编码，导致脚本虽然跑了但下不到东西。

三、 修复 SOP：彻底清理 + 授权构建

遇到 ENOTEMPTY 报错或原生文件缺失，按此流程操作：

1. 物理清理（解决 90% 的重命名报错）

不要指望 uninstall 能删干净，直接暴力删除 Node 全局 lib 下的残留目录：

# 自动获取全局路径并清理
rm -rf "$(npm config get prefix)/lib/node_modules/@anthropic-ai/claude-code"

2. 指定官方源并"授权"构建

安装时，必须显式声明允许执行构建脚本，并确保下载流指向官方源：

pnpm add -g @anthropic-ai/claude-code --allow-build=@anthropic-ai/claude-code --registry=https://npmjs.org

3. 验证

$ claude -v
2.1.121 (Claude Code)  # 看到版本号，说明二进制文件已挂载成功

四、 总结

• 版本分水岭：2.1.100 后的架构更依赖环境构建，不要用旧版本的经验套新版本。
• 物理删除胜过卸载：在 NVM 环境下遇到全局包升级冲突，手动 rm -rf 永远是最稳的。