AI 编程工具装到一半，屏幕甩出 Permission denied，安装戛然而止——这是 npm 全局安装最经典的坎：npm 想往系统级全局目录写文件，当前账户没有写权限。很多人的条件反射是前面加个 sudo，一加就踏进更深的坑。这篇按排查顺序讲：报错到底在说哪件事、为什么别用 sudo、全局目录怎么挪、nvm 怎么根治，最后给一套干净重装三步，把被污染的环境洗回来。
报错在说：目录不让你写
Permission denied 的含义很字面：npm 尝试写入全局目录（常见于系统级的 node_modules 与 bin 目录），操作系统拒绝了——那个目录归 root 或管理员所有，普通账户没有写权限。报错指向的是目录权限，npm 本身没坏，网络与 Node 版本也不相干。定位清楚这一点，处理方向就两个：要么换一个你有权限的目录当全局目录，要么把 Node 整个搬进你有权限的地方，下文各给一条路。
第一条纪律：别用 sudo
sudo 能让安装「成功」，代价在后面。sudo 装的文件归 root 所有，之后每一次不带 sudo 的 npm 全局操作都会撞上新的 Permission denied；npm 的缓存目录也可能被 root 写入，普通用户连缓存都用不了；更麻烦的是卸载、升级从此都得 sudo，整个工具链被 root 绑架。官方文档同样不建议对 npm 全局安装使用 sudo。忍住这一下，走下面两条正路，才是少折腾的选择。
把全局目录挪到自己家
正路一是改 prefix：用 npm config set prefix 把全局目录指到家目录下（比如 ~/.npm-global），再把对应的 bin 目录补进 PATH。此后 npm 全局安装都写进你自己的地盘，权限天然够用，sudo 彻底退场。改完记得新开终端验证，确认 claude 能被找到——PATH 怎么补、验证怎么做，见命令找不到一篇，两篇正好接得上。
nvm 管 Node 一劳永逸
正路二更彻底：用 nvm 管理 Node 本身。nvm 把 Node 装在家目录下，随 npm 装的全局包也跟着落在你的地盘，权限问题从根上消失，还顺手解决了多版本 Node 共存与切换的需求。已经踩过 sudo 坑的，建议直接换 nvm 重来一遍，比在 root 残留里打补丁干净得多。安装方式怎么选、npm 与原生两条道的差别，见安装教程一篇。
干净重装的三步
如果环境已经被 sudo 污染——缓存目录归了 root、全局目录里躺着 root 的旧文件——按三步洗回来。第一步卸载：sudo 装过的就用 sudo 卸，把 npm 全局里的 Claude Code 移除干净。第二步清缓存：npm cache clean --force 清不掉的，手动删掉缓存目录再重建。第三步重装：在已改 prefix 或已换 nvm 的前提下重新安装，装完跑一遍 claude doctor 看健康报告，确认没有残留冲突，报告怎么读见三命令排查一篇。Codex 侧的同款权限坑与解法思路一致，见Codex 权限报错一篇，两篇可对照着看。
| 步骤 | 具体做什么 | 做完怎么确认 |
|---|---|---|
| 卸载 | sudo 装过的就用 sudo 卸，把 npm 全局里的 Claude Code 移除干净 | 全局目录里不再躺着旧文件 |
| 清缓存 | npm cache clean --force；清不掉的，手动删掉缓存目录再重建 | 缓存目录不再归 root |
| 重装 | 在已改 prefix 或已换 nvm 的前提下重新安装 | 跑 claude doctor 看报告，确认无残留冲突 |
npm 权限速查
- Permission denied 是目录权限问题，不是 npm 坏了
- 别用 sudo：装完全局工具链被 root 绑架
- 正路一：prefix 挪到家目录，bin 补进 PATH
- 正路二：nvm 管 Node，权限问题从根上消失
- 污染环境走卸载、清缓存、重装三步
npm 权限报错怎么办速查
- 已经 sudo 装过了怎么办？：按 sudo 卸载、清缓存、换 nvm 或改 prefix 后重装的顺序洗一遍；残留的 root 文件一次清干净，别留着继续打架。
- 挪了 prefix 还报错怎么办？：先新开终端确认配置生效，再确认 bin 目录已在 PATH 里；两处都核对过仍报错，看报错里的具体路径是不是别的 npm 安装留下的。
- 不想逐条敲命令怎么办？：让豆包解释 prefix、缓存与 bin 三个目录的关系，再让 DeepSeek 按你的系统生成一份重装步骤清单，照着走一遍即可。
