最近在帮同学配置 Codex 时，发现大部分问题都不是模型不会用，而是第一步安装和登录没跑通。尤其是 Windows 用户，最常见的是安装完成以后终端提示找不到 codex 命令。
这篇按“先安装、再验证、最后登录”的顺序整理。
一、先判断你需要 Codex App 还是 CLI
如果你只是想打开桌面项目，Codex App 会更直观。
如果你要在项目目录里让 AI 读代码、改文件、跑测试、排查报错，建议优先安装 Codex CLI。
CLI 更适合下面这些场景：
- VS Code / Cursor 项目目录
- WSL2 / Ubuntu
- SSH 服务器
- 需要自动跑测试、读日志、改代码的工程任务
二、macOS / Linux 安装
打开终端，运行：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
安装完成后验证：
codex --version
如果能看到版本号，说明安装成功。
进入项目目录：
cd your-project
codex
三、Windows PowerShell 安装
打开 PowerShell，运行：
irm https://chatgpt.com/codex/install.ps1 | iex
检查版本：
codex --version
如果提示 codex 不是内部命令，先关闭当前 PowerShell，再重新打开一个新的 PowerShell。很多时候只是环境变量没有刷新。
四、WSL2 用户建议
如果你的代码主要在 WSL2 Ubuntu 里，建议直接在 WSL2 里安装 Linux 版 Codex CLI：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
这样路径、依赖和终端环境更一致。
五、npm / Homebrew 备用方式
如果你已经有 Node.js：
npm install -g @openai/codex
如果你是 Mac 并且习惯 Homebrew：
brew install codex
新手优先推荐官方安装脚本，因为依赖更少。
六、登录 Codex
安装成功后运行：
codex login
它会引导你在浏览器里完成授权。登录完成以后回到终端：
codex
如果你用 ChatGPT Plus/Pro 账号登录 Codex，我整理了更完整的账号登录流程：
https://alphalwb.top/?utm_source=cnblogs&utm_medium=blog&utm_campaign=codex_install_202606#/article/chatgpt-pluspro-codex-login
七、常见报错
1. Windows 找不到 codex
先重新打开 PowerShell。
如果还不行，再检查 PATH。
2. npm 权限错误
不要直接乱改系统目录权限。可以改用官方安装脚本，或者先配置 npm 全局包目录。
3. codex login 打不开网页
先确认浏览器能访问 ChatGPT/Codex 相关页面，然后重新执行：
codex login
4. Plus/Pro 和 API Key 混淆
ChatGPT Plus/Pro 是账号订阅，API Key 是 Platform 计费。使用 codex login 时，走的是账号登录流程，不要把 Plus/Pro 和 API 额度混在一起。
八、后续教程
不同系统的配置教程可以继续看：
- Windows：
https://alphalwb.top/?utm_source=cnblogs&utm_medium=blog&utm_campaign=codex_install_202606#/article/codex-config-windows - Mac：
https://alphalwb.top/?utm_source=cnblogs&utm_medium=blog&utm_campaign=codex_install_202606#/article/codex-config-mac - Ubuntu：
https://alphalwb.top/?utm_source=cnblogs&utm_medium=blog&utm_campaign=codex_install_202606#/article/codex-config-ubuntu
参考
- OpenAI Codex Quickstart：https://developers.openai.com/codex/quickstart
- OpenAI Codex CLI：https://developers.openai.com/codex/cli
- OpenAI Codex Windows：https://developers.openai.com/codex/windows
说明：本文为人工整理并使用 AI 辅助润色，安装命令以 OpenAI 官方文档为准。