问题:运行 claude 命令却报错 :Host Claude Code binary not available. Check that the download completed.

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

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

 

1
2
3
4
5
6
7
8
9
10
"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 包,导致找不到该包。

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

解决方案

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

 

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

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

 

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

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐