Claude Code 在 Windows 切换 Node.js 版本后命令失效的排查与解决

问题描述

通过 npm 全局安装 Claude Code 后，claude 命令在 PowerShell 中可以正常使用。但某天切换了 Node.js 版本之后，突然出现以下报错：

claude : 无法将"claude"项别为 cmdlet、函数、脚本文件或可运行程序的名称。
请检查名称的拼写，如果包括路径，请确认路径正确，然后再试一次。
所在位置 行:1 字符: 1
+ claude
+ ~~~~~~
    + CategoryInfo          : ObjectNotFound: (claude:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

---

根本原因

切换 Node.js 版本后，全局安装的 npm 包不会自动迁移。

每个 Node.js 版本都有自己独立的全局包目录。当你从版本 A 切换到版本 B 时，原来在版本 A 下通过 npm install -g 安装的所有包（包括 Claude Code），在版本 B 的目录下是不存在的，因此系统找不到 claude 命令。

---

排查过程

第一步：确认 npm 全局目录

npm config get prefix

输出示例：

D:\Program Files\nodejs

第二步：查看全局目录中是否存在 claude 文件

ls $(npm config get prefix)

正常情况下 应该能看到 claude、claude.cmd、claude.ps1 三个文件。

问题复现 ：执行后发现目录中只有 cline、npm、npx、pnpm 等文件，没有任何 claude 相关文件，确认是 Claude Code 没有安装在当前 Node.js 版本下。

---

解决方案

在当前 Node.js 版本下重新安装 Claude Code：

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

安装完成后验证：

claude --version

再次检查全局目录，确认 claude 文件已存在：

ls $(npm config get prefix) | Where-Object { $_.Name -like "claude*" }

应该能看到如下输出：

claude
claude.cmd
claude.ps1

此时 claude 命令即可恢复正常使用。

---

总结

操作	影响
切换 Node.js 版本	全局包目录切换，原有全局包失效
重装 Node.js	同上，全局包需要重新安装
升级 Node.js	同上，部分情况下全局包失效

核心结论：每次切换或重装 Node.js 版本后，需要重新执行一遍全局包的安装命令。

如果你同时安装了多个全局工具（如 cline、pnpm 等），切换 Node.js 版本后都需要重新安装一遍。

---

相关命令速查

# 查看当前 Node.js 版本
node -v

# 查看 npm 全局目录
npm config get prefix

# 查看已安装的全局包
npm list -g --depth=0

# 重新安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装
claude --version

---

环境：Windows 11，PowerShell，Node.js，Claude Code