Claude Code (Windows) 安装过程与问题解决
1. 环境准备
- 操作系统：Windows 10
- Node.js：v24.13.1
- npm：11.8.0
- Git：2.53.0.windows.2
2. 安装操作
执行全局安装命令：
cmd
npm install -g @anthropic-ai/claude-code结果：安装成功（新增了 2 个包），但 npm 提示有新版本可更新（11.8.0 -> 11.18.0）。
3. 遇到的问题
执行检测命令时，系统报错：
cmd
claude --version
'claude' 不是内部或外部命令，也不是可运行的程序或批处理文件。现象 ：包明明安装成功了，但系统死活不认 claude 命令。
4. 排查过程
| 步骤 | 操作 | 发现问题 |
|---|---|---|
| 1 | 尝试 npm bin -g 查看全局目录 |
新版 npm（11.x）已废弃该命令，提示 Unknown command。 |
| 2 | 改用新命令 npm prefix -g |
成功获取全局安装目录：D:\nodejs\npm_global。 |
| 3 | 查看该目录下的文件：dir D:\nodejs\npm_global |
确认存在 claude.cmd、claude.ps1 和 claude 文件。结论 ：命令名没有错，就是 claude。 |
| 4 | 检查系统环境变量：echo %PATH% |
发现 D:\nodejs\npm_global 并不在系统 PATH 中。这是导致命令无法识别的根本原因。 |
5. 解决办法
将 npm 全局可执行文件目录添加到系统 PATH 环境变量中。
最终采用方案（临时或永久均可，此处成功实现）：
- 方式 ：通过
setx命令或图形界面将D:\nodejs\npm_global添加至 PATH。 - 验证 ：添加后重新打开终端 ，执行
claude --version。
6. 最终结果
cmd
C:\Users\ceoxie>claude --version
2.1.204 (Claude Code)✅ 安装成功，命令正常运行！
7. 补充说明（FAQ）
Q：是否需要升级 npm（从 11.8.0 到 11.18.0）？
- 非必须：不升级不影响 Claude Code 使用，当前版本稳定。
- 建议 ：如果有空，升级可以获得更快的安装速度和安全性修复。执行
npm install -g npm@11.18.0即可（需重新打开终端生效）。
Q：以后安装其他全局包还会遇到这个问题吗？
- 只要
D:\nodejs\npm_global已常驻在 PATH 中，以后通过-g安装的任何包（如vue、vite等）都会自动识别为系统命令，不会再出现"不是内部或外部命令"的错误。
总结要点 ：npm install -g 只是把文件下载到硬盘，系统必须要能找到这些文件（即目录在 PATH 中）才能执行。本次问题的核心就是 PATH 缺失导致系统找不到可执行文件，修复 PATH 后一切正常。