解决 Claude Code 安装报错：claude native binary not installed 的坑

最近想试试 Claude 的 CLI 工具，结果在安装的时候就踩坑了。跟大家分享一下这次折腾的经历，希望能帮到遇到同样问题的朋友。

遇到的问题

我是按照官方文档来的，直接执行：

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

结果安装完成后一运行就报错：

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.

尝试的各种方法

看到报错信息，我第一反应就是按照提示去运行那个 install.cjs 脚本。结果发现根本找不到这个文件，路径都不对。

然后我又怀疑是不是 npm 的脚本被跳过了，于是尝试去掉 --ignore-scripts 重新安装。但我压根就没加这个参数啊，所以也不是这个问题。

接着又想是不是可选依赖没有下载，于是尝试 --include=optional，结果还是不行。

折腾了半天，都快放弃了。心想这玩意儿怎么这么难装，是不是跟我的环境有关系？

真正的解决方案

后来查了一下才发现，原来是淘宝源的问题！2026-04-18 这个时间点（2.1.114 版本），淘宝镜像源存在一些问题，导致 claude-code 的原生二进制文件下载不下来。

知道了原因就好办了，把 npm 源换一下就行了：

npm install -g @anthropic-ai/claude-code --registry=https://mirrors.cloud.tencent.com/npm/

用腾讯云的镜像源安装，一下子就成功了！

经验总结

这次踩坑让我意识到几个点：

1. 镜像源不是永久的

平时习惯了用淘宝源，觉得快又稳定，但这次确实翻车了。镜像源偶尔也会出问题，遇到奇怪的情况不妨换个源试试。

2. 错误信息要仔细看

虽然这次错误信息没有直接告诉我镜像源的问题，但提到了 "optional dependency was not downloaded"，这其实是个重要线索。如果当时顺着这个思路去想想，可能早点就发现问题了。

3. 多查查社区

这种问题一般不止一个人遇到，社区里大概率已经有讨论了。多搜索一下能少走很多弯路。

其他可选方案

除了腾讯云的镜像源，你也可以试试其他的：

• 官方源：https://registry.npmjs.org/（最稳定，但可能慢）
• 华为云：https://mirrors.huaweicloud.com/repository/npm/
• 或者直接临时切换：npm config set registry https://registry.npmjs.org/

最后的唠叨

安装工具这种看似简单的事情，有时候也会踩坑。遇到问题不要慌，多试几种方案，总能解决的。

Claude Code 这个工具本身还是挺好用的，值得折腾一下。装好了之后，你可以直接在命令行里用 Claude 来帮你写代码、查 bug，还是挺方便的。

希望这篇博客能帮到同样遇到这个问题的朋友，如果还有其他问题欢迎交流讨论～