claude: command not found：命令找不到怎么办
Claude Code 安装后命令不可用的排查：PATH 没生效、npm 全局目录不对、nvm 版本切换丢失。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
claude-code安装path
30 秒结论
装完了但 shell 找不到 claude，是 PATH 没包含 npm 的全局 bin 目录。
报错原文对照
bash: claude: command not found
zsh: command not found: claude原因排序
| 概率 | 原因 |
|---|---|
| 60% | npm 全局 bin 目录不在 PATH |
| 25% | 用 nvm 切了 Node 版本，全局包没跟着走 |
| 15% | 装到了别的用户/别的前缀下 |
修法
先在自己这边查
npm config get prefix看全局目录，把它加进 PATH- 用 nvm 时执行
nvm reinstall-packages <version> - 直接
npm i -g @anthropic-ai/claude-code重装
再往服务方查
- 确认安装日志里没有权限报错
责任判定表
| 现象 | 责任方 |
|---|---|
| 所有终端都找不到 | 你的环境变量 |
| 只有某个终端找不到 | 那个 shell 的配置没加载 |
| 换用户就好 | 装在了另一个用户下 |
什么时候该换
重装两次都不行，换 Node 版本管理器（nvm → fnm 或 volta）。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证