【Claude Code】安装

Claude Code (Windows) 安装过程与问题解决1. 环境准备操作系统Windows 10Node.jsv24.13.1npm11.8.0Git2.53.0.windows.22. 安装操作执行全局安装命令npm install -g anthropic-ai/claude-code结果安装成功新增了 2 个包但 npm 提示有新版本可更新11.8.0 - 11.18.0。3. 遇到的问题执行检测命令时系统报错claude --version claude 不是内部或外部命令也不是可运行的程序或批处理文件。现象包明明安装成功了但系统死活不认claude命令。4. 排查过程步骤操作发现问题1尝试npm bin -g查看全局目录新版 npm11.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. 最终结果C:\Users\ceoxieclaude --version 2.1.204 (Claude Code)✅安装成功命令正常运行7. 补充说明FAQQ是否需要升级 npm从 11.8.0 到 11.18.0非必须不升级不影响 Claude Code 使用当前版本稳定。建议如果有空升级可以获得更快的安装速度和安全性修复。执行npm install -g npm11.18.0即可需重新打开终端生效。Q以后安装其他全局包还会遇到这个问题吗只要D:\nodejs\npm_global已常驻在 PATH 中以后通过-g安装的任何包如vue、vite等都会自动识别为系统命令不会再出现“不是内部或外部命令”的错误。总结要点npm install -g只是把文件下载到硬盘系统必须要能找到这些文件即目录在 PATH 中才能执行。本次问题的核心就是PATH 缺失导致系统找不到可执行文件修复 PATH 后一切正常。