Codex CLI 安装失败：npm 报错怎么办
Codex CLI 安装时的常见错误：权限、Node 版本、镜像源。，附环境检查步骤与常见失败原因。
更新 2026-10-28
核验 2026-10-28 · 码农阿风
codex安装
30 秒结论
装不上的原因基本都在 Node 环境：版本太低或没权限写全局目录。
报错原文对照
npm ERR! code EACCES
npm ERR! engine Unsupported原因排序
| 概率 | 原因 |
|---|---|
| 45% | 全局目录没写权限 |
| 35% | Node 版本低于要求 |
| 20% | 镜像源没有这个包 |
修法
先在自己这边查
- Node 升到 20+
- 避免 sudo，改 npm prefix 到用户目录
- 换回官方源或换镜像
再往服务方查
这一项不是你这边能解决的。
责任判定表
| 现象 | 责任方 |
|---|---|
| EACCES | 权限 |
| Unsupported engine | Node 版本 |
| 404 | 镜像源 |
什么时候该换
装不上就先 npm config get prefix，看看是不是在 /usr 下。
你在这个站点上遇到过这个问题？
认领站点后可补充证据、申请公开核验；认证不改榜单排序，只对应可复核的检测与复测。
认领 / 申请认证