Windows 命令排查 · 2026 年 7 月更新
claude 不是内部或外部命令
按这三个结果排查
这个提示通常不代表 Claude Code 本身损坏。先不要反复安装，也不需要输入任何 API Key；依次检查 Node.js、Claude Code 版本和 Windows 能找到的命令路径， 就能判断问题停在哪一步。
自检免费，不读取电脑文件，也不要求输入 API Key。自动配置工具一次性 ¥19.9。
- 适用系统
- Windows 10 / 11
- 主要症状
- claude 命令找不到
- 预计时间
- 5–15 分钟
- 安全提醒
- 排查过程不需要 API Key
01
先运行三个检查，不要先改环境变量
在 VS Code 顶部菜单选择“终端 → 新建终端”，或单独打开 PowerShell。按顺序执行：
node -v
claude --version
where.exe claude这三条命令只读取本机状态，不会上传文件，也不会读取或显示 API Key。 截图求助时只保留命令和报错文字，不要把其他环境变量、令牌或账户信息拍进去。
node -v：检查 Node.js
claude --version：检查命令能否运行
where.exe claude：检查命令路径
三条命令都不需要管理员权限
02
根据输出判断问题在哪一层
claude --version 能显示版本号
Claude Code 已安装且当前终端可以找到它。直接运行 claude
即可；如果只有 VS Code 内置终端报错，关闭 VS Code 后重新打开。
where.exe claude 能显示路径，但版本命令失败
Windows 找到了命令文件，但安装可能不完整或存在多个版本。记录输出的全部路径， 再参考 Anthropic 的安装排错文档检查冲突安装，不要同时反复安装多个版本。
where.exe claude 显示“信息: 用提供的模式无法找到文件”
当前 PATH 中没有 Claude Code 命令。若刚完成安装，先彻底重开终端；若仍无结果， 再按下文核对 Node.js 版本并重新执行官方 npm 安装。
node -v 也提示不是命令
npm 安装路径的前置条件尚未满足。先从 Node.js 官方渠道安装当前受支持版本，
完全重开终端，确认 node -v 能显示版本后再继续。
03
安装后必须让新终端重新读取 PATH
已经打开的终端不会自动获得安装程序刚写入的 PATH。仅点击终端里的垃圾桶图标有时还不够， 最稳妥的做法是关闭全部 VS Code 窗口和 PowerShell、CMD 窗口，再重新打开 VS Code， 新建一个终端后重新执行：
claude --version
where.exe claude如果重开后命令恢复，问题只是旧终端没有刷新，不需要重装。以后关闭 VS Code 后不知道从哪里继续， 可查看 关闭 VS Code 后再次打开 Claude Code 的教程。
04
PowerShell 和 CMD 外观相似，安装命令不同
提示符以 PS C:\Users\... 开头的是 PowerShell；只有
C:\Users\...、没有 PS 的通常是 CMD。
本文的三条检查命令可在两者中使用，但不要把两种终端的安装语法混在一起。
CMD 提示 irm 不是内部或外部命令
irm 是 PowerShell 命令。关闭 CMD，打开 PowerShell 后再使用
PowerShell 对应的官方安装命令。
PowerShell 提示 && 不是有效的语句分隔符
当前窗口通常是旧版 PowerShell，却粘贴了 CMD 安装命令。切换到 CMD， 或改用 PowerShell 对应的安装命令。
如果还需要从安装、DeepSeek 接入到启动完整走一遍，可阅读 Windows 配置 Claude Code 接入 DeepSeek 综合指南。
05
选择 npm 路径时，先确认 Node.js 22+
Anthropic 当前优先推荐原生安装程序，同时仍支持把 Claude Code 安装为全局 npm 包。 官方文档说明，自 Claude Code v2.1.198 起，npm 安装包要求 Node.js 22 或更高版本。 先检查版本：
node -v
npm -v
如果 node -v 显示 v22 或更高版本，再执行官方 npm 安装命令：
npm install -g @anthropic-ai/claude-code安装完成后关闭当前终端，打开新终端验证：
claude --version
where.exe claude
不要使用来历不明的安装脚本，也不要为了排查命令而粘贴 API Key。若 npm 显示安装成功但
where.exe claude 仍无结果，可运行 npm config get prefix
查看全局安装目录，并确认该目录已在当前 Windows 用户的 PATH 中。
06
Git for Windows 是可选项，不是命令出现的前提
在原生 Windows 上，Git for Windows 可以提供 Git Bash 和 Bash 工具，但当前 Claude Code 在没有 Git Bash 时可以使用 PowerShell。WSL 环境不需要 Git for Windows。因此， 单纯看到“claude 不是内部或外部命令”时，不要把安装 Git 当作唯一修复方式。
原生 Windows：Git for Windows 可选
未安装 Git：可使用 PowerShell
已安装 Git：可使用 Git Bash
WSL：不需要 Git for Windows
只有出现“Claude Code on Windows requires either Git for Windows (for bash) or PowerShell”时，才需要检查这两个 Shell 是否至少有一个可用。安装 Git for Windows 后， 同样要重开 VS Code 或终端。
07
常见问题
安装后为什么仍提示 claude 不是内部或外部命令？
最常见原因是当前终端仍保留安装前的 PATH。完全关闭 VS Code 和所有终端，
打开新终端后再运行 claude --version 与 where.exe claude。
使用 npm 安装需要什么版本的 Node.js？
Anthropic 当前文档要求 Node.js 22 或更高版本。版本较旧时先升级 Node.js， 再执行官方全局 npm 安装命令。
必须安装 Git for Windows 吗？
不一定。原生 Windows 上可以使用 PowerShell；Git for Windows 主要提供 Git Bash。 WSL 环境不需要 Git for Windows。
排查时需要重新输入 DeepSeek API Key 吗？
不需要。本文所有检查只验证本机命令与路径。不要在截图、聊天或公开页面中展示 API Key。
先免费确认系统、网络和 DeepSeek Key 条件；符合要求后，再决定是否使用 Claude Code Bridge 自动检测和配置环境。
自检不会要求输入 API Key。需要先了解交付内容时，可查看 Claude Code Bridge 产品页。