安装

修复 Claude Code 报错

报错原文

command not found: claude

含义 / 原因

安装成功了,但安装目录不在 shell 的 PATH 里。native 安装器把 claude 放在 macOS/Linux 的 ~/.local/bin/claude、Windows 的 %USERPROFILE%\.local\bin\claude.exe。不同平台报错文案略有差异:zsh 是 "command not found: claude",CMD 是 "'claude' is not recognized as an internal or external command"。VS Code 扩展自带私有 CLI 副本,不会把 claude 加进 PATH。

修复步骤

1确认安装目录在 PATH 里:macOS/Linux 跑 echo $PATH | tr ':' '\n' | grep -Fx "$HOME/.local/bin"。
2若无输出,Zsh 加 echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc 后 source ~/.zshrc;Bash 改 ~/.bashrc。或直接关掉重开终端。
3Windows PowerShell:用 [Environment]::SetEnvironmentVariable 把 $env:USERPROFILE\.local\bin 加进 User PATH,再重启终端。
4改完跑 claude --version 验证。