最新 OpenAI Codex CLI 国内安装配置教程（GPT-5模型、付费升级、全平台配置详解）

编程指北2025年9月24日大约 4 分钟CodexCodex CLIOpenAIGPT-5ChatGPT Plus终端工具编程助手代码生成CLI国内安装付费升级教程

大家好，今天给大家分享一下 OpenAI Codex 和 Codex CLI 安装使用教程，全部是基于 2025-09 最新官方与社区资料整理，适用于 Windows / macOS / Linux 全平台，手把手带你完成「OpenAI Codex CLI」的安装、配置与首次运行。全程约 5-10 分钟，照着做即可。

一周前 OpenAI 突然宣布：ChatGPT Plus 用户无需 API Key，直接登录就能用 Codex CLI，我立刻冲了回去。

并且全网都在说这次 openai 编码能力提升很大，所以安装了一波 Codex Cli，结果越用越上头，于是有了这篇「踩坑 + 对比」流水账，方便大家初次使用。

但是先说目前 Codex 和 Claude Code 一样需要付费才能使用，如果你还是免费用户，可以试试这个一键升级工具:

国内自助升级 ChatGPT Plus 工具： getplus.app , 详细教程 国内升级 ChatGPT 手把手教程

如果你还没 ChatGPT 账户，可以去用谷歌邮箱、微软邮箱等注册一个，或者直接在这里几块钱购买一个成品账号登录都可以:

https://chatgptzh.com.cn/gpt

另外，最近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/codex

macOS/Linux 若报 EACCES，加 sudo 重新执行即可。
Windows 请使用「管理员 PowerShell」。

② 备用方式（包管理器）

系统	命令
macOS + Homebrew	`brew install codex`
Windows + Chocolatey	`choco install codex-cli`
Linux 二进制	下载 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 found`	npm 全局目录未加入 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 更懂你的项目结构。