解决 Claude Code 安装或更新后 claude.exe 无法运行、claude native binary not installed
·
问题:运行 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 |

更多推荐

所有评论(0)