Codex 安装与登录完整教程
从环境确认、命令行安装到账号授权和首次运行，完整走通 Codex CLI。
- 预计用时
- 约 5–15 分钟
- 适合人群
- 入门 / 开发工具
- 更新说明
- 界面以官方实际显示为准
- 电脑已安装受支持版本的 Node.js 与 npm
- 拥有可正常登录且具备 Codex 权益的 ChatGPT 账号
- Windows 用户建议使用 PowerShell 或 Windows Terminal
- 关闭来源不明的代理脚本和第三方登录工具
详细操作步骤
确认 Node.js 和 npm 可用
打开终端，分别输入 node -v 和 npm -v。两条命令都能显示版本号，才可以继续。如果提示命令不存在，请先安装 Node.js 的长期支持版本，安装完成后重新打开终端。
安装 Codex CLI
在终端执行 npm install -g @openai/codex。安装期间保持网络稳定，不要关闭终端。Windows 如果出现权限错误，建议用管理员身份打开 PowerShell 后重试；macOS / Linux 不建议随意修改系统目录权限。
确认安装成功
安装完成后输入 codex --version。终端能显示 Codex 版本号，说明命令已经安装。如果仍提示找不到命令，请先关闭并重新打开终端，让环境变量重新加载。
启动 Codex 并登录
进入准备操作的项目文件夹，在终端输入 codex。首次启动会出现登录或授权引导，请选择使用 ChatGPT 账号登录，并在浏览器中完成官方授权。授权完成后返回终端等待自动确认。
进行第一次安全测试
先让 Codex 执行只读任务，例如“解释当前项目结构”或“检查这个文件的作用”。确认它识别到了正确目录后，再逐步尝试修改任务。执行前阅读变更摘要，重要项目请先提交 Git 版本。
完成后这样核验
✓检查项 1codex --version 能显示版本号
✓检查项 2浏览器授权后终端不再要求登录
✓检查项 3Codex 能识别当前项目目录
✓检查项 4退出终端后再次运行 codex 仍可正常使用
常见问题与处理方法
提示 codex 不是内部或外部命令？+
通常是 npm 全局命令目录尚未加入环境变量。先重启终端；仍失败时检查 npm config get prefix 所在目录是否已加入 PATH。
浏览器授权成功，但终端一直等待？+
先等待片刻，不要重复点击授权。确认浏览器和终端在同一台电脑上，检查防火墙、代理和系统时间后重新运行 codex。
登录后提示没有权限或额度？+
先确认登录的是购买订阅的同一个账号，再到 ChatGPT 套餐页核对订阅状态。刚开通时可退出账号后重新登录一次。