搜索 codex安装、codex下载安装或 codex安装后怎么使用时，不要先找来路不明的“中文版安装包”。Codex 的安装方式会随平台和版本变化，先从 官方开发者文档确认当前要求。
一、准备工作
打开终端，先执行 node -v 和 npm -v，确认系统能找到 Node.js 和 npm。Windows 用户还要确认当前终端是 PowerShell、命令提示符还是 WSL，因为权限和路径处理可能不同。
安装前把准备使用的官方页面收藏下来，记录系统版本、Node.js 版本和 npm 版本。安装失败时，这三项信息能帮助你区分环境问题、网络问题和包版本问题。
二、执行安装
如果官方文档当前给出的包名仍然是下面这个，可以按文档说明执行。包名和参数发生变化时，以官方页面为准，不要机械照抄旧教程。
npm install -g @openai/codex命令执行期间不要关闭终端。完成后检查终端最后几行是否出现错误，再按照官方文档列出的启动方式运行。首次启动可能会打开浏览器授权页面，跳转时查看最终域名。
三、首次运行和登录
安装成功只代表本地命令可用，不代表账号授权已经完成。命令能启动但登录失败时，优先检查浏览器授权、网络和账号状态，不要立即卸载重装。涉及 API 密钥时，遵循官方文档的存储建议，不要把密钥放进公开仓库或发送给他人。
四、出现错误时怎么排查
- 找不到命令：检查 npm 全局目录是否加入 PATH，重新打开终端后再试。
- 权限错误：确认当前用户对 npm 目录有权限，避免用管理员权限执行陌生脚本。
- 网络错误：保存完整错误信息和失败时间，确认能否打开官方文档。
- 授权错误：记录登录页面最终域名和错误提示，不要把验证码或令牌发给别人。
关键判断：“安装失败”和“登录失败”是两个阶段。先确认命令是否存在，再处理账号授权，排错会快很多。
如果你需要别人协助，提供系统、版本、执行命令和脱敏后的报错即可。不要提供密码、Cookie、验证码或 API 密钥。