Claude CLI 安装报错记录（native binary not installed）

三木檾2026-04-21 15:38

Claude CLI 安装报错记录（native binary not installed）

问题现象

安装 @anthropic-ai/claude-code 后执行 claude 报错：

sql 复制代码

Error: claude native binary not installed.                                    
                                                                                
  Either postinstall did not run (--ignore-scripts, some pnpm configs)          
  or the platform-native optional dependency was not downloaded                 
  (--omit=optional).                                                            
                                                                                
  Run the postinstall manually (adjust path for local vs global install):       
    node node_modules/@anthropic-ai/claude-code/install.cjs                     
                                                                                
  Or reinstall without --ignore-scripts / --omit=optional.

原因

npm 使用了国内 registry（如 npmmirror），该源未同步 optional binary，导致 native 依赖未下载。

排查

查看当前 npm registry

arduino 复制代码

npm config get registry

如果返回：

arduino 复制代码

https://registry.npmmirror.com

或：

arduino 复制代码

https://registry.npm.taobao.org

说明正在使用国内镜像源。

解决方法

切换官方源重新安装：

bash 复制代码

npm config set registry https://registry.npmjs.org/

npm uninstall -g @anthropic-ai/claude-code

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

或仅本次使用官方源(推荐)：

bash 复制代码

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

验证

css 复制代码

claude --version

能正常输出版本号即可，Have a try!。