近期在使用命令行安装 Claude Code 时,执行 npm install -g @anthropic-ai/claude-code 后,运行版本检查命令 claude --version 却显示 zsh: command not found: claude。即使多次尝试安装或卸载,该问题依然存在。
此问题通常由环境变量配置不当导致。可通过以下步骤修复:
- 创建专用的 npm 全局安装目录:
mkdir -p ~/.npm-global
- 配置 npm 使用该目录:
npm config set prefix ~/.npm-global
- 将路径添加到 zsh 配置文件:
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
- 使配置生效:
source ~/.zshrc
- 重新安装:
npm install -g @anthropic-ai/claude-code
完成上述操作后,再次检查版本即可正常输出。
补充:可使用以下命令检查环境变量是否正确:
echo $PATH
若配置正确,步骤 2 中的目录地址应包含在输出结果中。

