下载安装 Codex 常见报错

1. node 或 npm 不是命令

先执行：

如果两个命令都找不到，说明 Node.js 没安装或 PATH 没生效。安装 Node.js LTS 后关闭终端，重新打开一个窗口再试。不要只在当前窗口里重复输入安装命令。

2. codex 不是命令

先确认 npm 安装过程没有报错，再执行：

如果 npm 显示安装成功但系统找不到 codex，常见原因是全局 npm bin 目录没有加入 PATH。Windows 可以先重启终端，仍然不行时再检查 npm 的全局安装路径。

3. npm 权限错误

Windows 用户不要把“管理员运行”当成唯一解决方案，先看错误指向哪个目录。macOS 和 Linux 用户也不要直接复制陌生网站给出的权限命令。把完整报错保留下来，确认目录归属后再处理。

4. 下载超时或网络失败

先确认浏览器能访问 npm registry 和 OpenAI 官方文档，再重试。公司网络、代理、DNS 和安全软件都可能影响 npm。频繁切换多个镜像源会让问题更难定位，先记录你当前使用的 registry：

5. 登录页面打不开

检查浏览器是否能正常打开官方登录页，确认系统时间没有明显错误，并阅读终端给出的具体提示。不要把登录链接复制给陌生人，也不要把验证码发到 QQ 群或论坛。