终端输入 claude 得到 command not found: claude:不是账号问题,是当前 shell 找不到可执行文件。
排查
- 官方安装方式装完后新开一个终端再试。
echo $PATH看有没有 npm 全局目录、或文档写的安装路径。- macOS 默认 zsh,配置写在
~/.zshrc;你若在 bash 里装、zsh 里用,会找不到。 - 用 nvm / fnm 时,全局包在对应 Node 版本下。换了 Node 版本要重装或重链。
- Windows:不要只在 PowerShell 装完就指望 CMD 能用;需要把 npm prefix 加进系统 PATH,或用 WSL。
which claude type claude npm list -g --depth=0
能找到二进制但仍 401,转到 401 排查,那是认证不是 PATH。

AI故障手册