首页 / 教程中心 / Claude Code 排错

// 报错排查

Claude Code 提示“命令不存在”怎么办

先确认你采用的是当前安装方式，再检查终端与 PATH。多数问题不需要反复重装，更不需要使用来历不明的安装脚本。

2026-07 更新约 8 分钟Windows / macOS / WSL
先纠正一个旧认知：当前 Claude Code 官方文档优先推荐原生安装，Windows 也可原生运行。Node.js/npm 已经不是所有用户都必须经过的安装路线。

一、先确认具体是哪种“找不到”

下面几种提示看起来相似，原因并不完全相同：

# macOS / Linux / WSL
zsh: command not found: claude
bash: claude: command not found

# Windows PowerShell
The term 'claude' is not recognized...

# Windows CMD
'claude' is not recognized as an internal or external command

它们共同表示：当前终端无法从 PATH 中定位到 Claude Code 可执行文件。

二、使用与终端匹配的官方安装方式

macOS、Linux 或 WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

PowerShell 提示符通常以 PS C:\ 开头；CMD 则没有 PS。不要在一个终端里复制另一个终端的命令。

如果你明确选择 npm 安装，当前官方文档注明 npm 包要求 Node.js 22 或更高版本：

node --version
npm install -g @anthropic-ai/claude-code

不要使用 sudo npm install -g，它可能制造新的权限问题。

三、安装后完全重开终端

安装器可能更新了 PATH，但已经打开的终端不会自动读取新环境。完成安装后：

  1. 关闭所有 PowerShell、CMD、Terminal、VS Code 集成终端窗口；
  2. 重新打开终端；
  3. 运行下面的验证命令。
claude --version
claude doctor

claude doctor 会进行只读的安装与配置诊断，适合确认安装健康状态。

四、检查当前终端是否能找到命令

macOS、Linux 或 WSL

command -v claude
echo "$PATH"
ls -la ~/.local/bin/claude

原生安装通常把启动器放在 ~/.local/bin。如果文件存在但 command -v 没有输出，说明该目录没有进入当前 shell 的 PATH。

Windows PowerShell

Get-Command claude -ErrorAction SilentlyContinue
$env:Path -split ';'

如果刚修改过用户环境变量，请重新打开终端或重新登录系统，不要只在旧窗口里继续测试。

五、排除重复安装冲突

最常见的复杂情况是：以前用 npm 安装过，后来又使用原生安装，终端仍然命中旧路径。先查看实际命中了哪个文件：

# macOS / Linux / WSL
type -a claude

# Windows PowerShell
Get-Command claude -All

确认保留哪一种安装方式后，再按照官方对应的卸载步骤清理旧版本。不要直接删除整个 ~/.claude，那里可能包含设置与会话记录。

六、命令恢复后完成首次验证

cd 你的项目目录
claude

按照浏览器提示登录，然后先让 Claude Code“总结当前项目，不修改文件”。确认目录正确后，再进行一处小改动并查看 diff。

官方资料

仍然找不到命令？

把终端类型、安装命令和完整输出一起提交，通常能很快定位。

提交报错