大家好，今天给大家分享一下 OpenAI Codex 和 Codex CLI 安装使用教程，全部是基于 2025-09 最新官方与社区资料整理，适用于 Windows / macOS / Linux 全平台，手把手带你完成「OpenAI Codex CLI」的安装、配置与首次运行。全程约 5-10 分钟，照着做即可。
codex 入口一周前 OpenAI 突然宣布：ChatGPT Plus 用户无需 API Key，直接登录就能用 Codex CLI，我立刻冲了回去。
并且全网都在说这次 openai 编码能力提升很大，所以安装了一波 Codex Cli，结果越用越上头，于是有了这篇「踩坑 + 对比」流水账，方便大家初次使用。
但是先说目前 Codex 和 Claude Code 一样需要付费才能使用，如果你还是免费用户，可以试试这个一键升级工具:
国内自助升级 ChatGPT Plus 工具： getgpt.pro , 详细教程 国内升级 ChatGPT 手把手教程
如果你还没 ChatGPT 账户，可以去用谷歌邮箱、微软邮箱等注册一个，或者直接在这里几块钱购买一个成品账号登录都可以:
https://chatgptzh.com.cn/gpt
codex 使用场景另外，最近codex 新用户较多，建了一个 codex 的交流群，大家可以互相交流经验：
一、安装前准备Node.js ≥ 18（必须） 终端执行 node -v 检查，若低于 18 或提示未找到，先去 nodejs.org 下载 LTS 版并安装。Git ≥ 2.0（建议） 用于后续拉取示例项目，执行 git --version 确认。可用网络 国内若遇到 registry 超时，可临时切换 npm 镜像：npm config set registry https://registry.npmmirror.com二、一键安装 Codex CLI① 通用方式（npm 全局）npm install -g @openai/codexmacOS/Linux 若报 EACCES，加 sudo 重新执行即可。Windows 请使用「管理员 PowerShell」。② 备用方式（包管理器）系统命令macOS + Homebrewbrew install codexWindows + Chocolateychoco install codex-cliLinux 二进制下载 GitHub Release 赋予可执行权限后放 /usr/local/bin。③ 验证codex --version
# 输出版本号即安装成功三、配置 API 密钥Codex 需要 OpenAI 兼容格式的密钥，支持官方 key 或第三方中转。
拿到密钥 • 官方：OpenAI 后台生成 sk-xxx（需绑定付款方式）。 • 国内中转：尽量避免使用这些平台，大多数都是降智的号且隐私得不到保证，尽量自己的号或者官网的 key
写入环境变量（任选其一）
临时（当前窗口有效）# macOS / Linux
export OPENAI_API_KEY="sk-你的key"
# Windows PowerShell
$env:OPENAI_API_KEY="sk-你的key"永久（推荐） 把上面 export 语句追加到 ~/.zshrc 或 ~/.bashrc，重开终端即可。（可选）修改默认模型 新建文件 ~/.codex/config.toml：
model = "gpt-3.5-turbo-instruct" # 或 gpt-4o-codex四、首次运行codex若弹出浏览器认证，按提示登录 ChatGPT 账号（Plus/Pro 可用）。认证完成后回到终端，出现 > 提示符即进入交互模式。快速体验
codex "用 Python 写一段快速排序，并加测试"Codex 会流式输出代码，完成后自动停止。
五、常见问题速查现象解决command not foundnpm 全局目录未加入 PATH，可执行 npm bin -g 查看并把路径加到系统变量。403 / No active subscription免费账号无法使用 Codex，需升级 Plus/Pro，或改用支持中转的 key。流式输出乱码/断流检查终端是否支持 UTF-8；国内网络建议加代理或中转站。六、卸载 / 更新# 更新
npm update -g @openai/codex
# 卸载
npm uninstall -g @openai/codex恭喜！到此你已经拥有「命令行里的 AI 编程搭档」。 下一步可以：
在 VS Code 装同名插件，实现「边写边生成」；
把 codex 写进 Makefile，一键自动补全单元测试；
阅读官方 AGENTS.md 规范，让 Codex 更懂你的项目结构。