先避开一个坑：包名
Codex CLI 安装失败的第一大原因不是环境问题，是装错了包。 很多人凭直觉敲 npm i -g codex——那是一个 2012 年发布、与 OpenAI 毫无关系的旧包， 它会安安静静装上，然后什么都做不了。
正确的包名带前缀：
npm install -g @openai/codexNode 版本方面不同资料说法不一（18 或 22），直接装 Node 22 最稳。 如果首次运行报 Cannot find module，通常是代理环境下可选依赖没下完， 用 npm install -g @openai/codex --force 重装，或者干脆换下面的一键脚本——它只拉一个二进制，绕开整个可选依赖机制。
四种安装方式
| 方式 | 命令 | 适合 |
|---|---|---|
| npm | npm install -g @openai/codex | 已有 Node 环境 |
| Homebrew | brew install --cask codex | macOS |
| 一键脚本（macOS / Linux） | curl -fsSL https://chatgpt.com/codex/install.sh | sh | 代理环境、不想碰 Node |
| 一键脚本（Windows） | powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" | Windows |
一键脚本默认从 releases.openai.com 下载，失败时回落到 GitHub Releases。 也可以直接去 GitHub Release 下载对应平台的二进制，文件名带平台后缀，解压后改名为 codex 即可。
登录：两种方式，个人用户选前者
终端输入 codex，会出现两个选项：
| Sign in with ChatGPT | API Key | |
|---|---|---|
| 计费 | 走订阅额度，不另收费 | 按 API 用量计费到开发者账户 |
| 功能 | 完整，含依赖工作区与云端的功能 | 部分依赖 ChatGPT 工作区 / 云服务的功能可能受限 |
| 适合 | 个人、有 ChatGPT 订阅 | 团队自建流水线、需要按用量结算 |
选 Sign in with ChatGPT 后会拉起浏览器完成授权。 如果你在远程机器或浏览器跳转失败，用 codex login --device-auth： 终端打印一个 URL 和一次性代码，在任意设备的浏览器里粘贴即可，不依赖本机浏览器。
额度：哪档能用、撞了怎么办
这里有一个 2026 年才变化的事实，很多教程还没跟上：按 OpenAI 帮助中心，Codex 含于所有 ChatGPT 档位，包括 Free 和 Go。GitHub README 里「Plus、Pro、Business、Edu、Enterprise」的写法是较早的口径。
但「能用」和「够用」是两回事：
| 档位 | Codex | 撞到额度后 |
|---|---|---|
| Free / Go | 可用，额度低 | 不能买额度包，只能等重置或升级 |
| Plus（$20） | 可用 | 可购买额度包继续 |
| Pro 5x（$100） | 可用，额度约 Plus 的 5 倍，4 月起专门调高了 Codex 额度 | 可购买额度包 |
| Pro 20x（$200） | 可用，额度约 Plus 的 20 倍 | 可购买额度包 |
三条规则要记住：
- CLI、网页、IDE 扩展共用一份额度。五小时窗口内本地消息和云端任务合并计算，之外可能还有周限额。一个重度 CLI 会话和一个重度网页会话是在抢同一个预算。
- 撞限额时当前这一轮可以跑完（受公平使用限制），之后再看提示里给的选项：加额度、用可用的重置、升级，或等到显示的重置时间。
- OpenAI 客服不会帮你重置额度，别去问。
随时在会话里输入 /status 看剩余额度与重置时间。 如果你在 Plus 上每周都撞限额，先看 套餐对比 里的升级判断法—— Pro 5x 在 4 月之后是专门给重度编码用户定位的档。
模型：gpt-5.4 已退役，默认现在是 Terra
2026 年 8 月 31 日起，gpt-5.4 与 gpt-5.4 mini 已从 Codex（ChatGPT 登录方式）退役，官方替代关系：
- gpt-5.4 → GPT-5.6 Terra
- gpt-5.4 mini → GPT-5.6 Luna
三档的分工和 ChatGPT 里一样：Terra 做日常主力，Sol 留给难题，Luna 跑批量简单活。 默认模型随发布变动，不要把模型名写死进脚本或博客——进会话后用 /model 看当前实际加载的是什么。 三档的能力边界见 GPT-5.6 三档完整指南。
第一个任务：先只读，再计划，再执行
新手最常见的错误是装好就让它「帮我加个功能」。更稳的三步：
第一步：只读探索
在项目目录启动 codex，让它解释代码结构、找出某个功能的入口和调用链，不改任何东西。 这一步的目的是校准它对你仓库的理解——它说错了，你现在就能发现，而不是在改完 20 个文件之后。
第二步：先要计划
描述目标（而不是步骤），让它先输出修改计划：动哪些文件、为什么、风险在哪。你确认后再放行。 这一步能挡掉大部分「方向就错了」的返工。
第三步：执行并自验证
放行后让它跑完，并要求它自己运行测试或至少跑一遍受影响的路径。 默认沙箱是 workspace-write：它能改仓库内的文件，但写家目录、联网的 shell 命令都需要你批准—— 这是安全设计，不要为了省事关掉。
这套流程和 Claude Code 那边的「只读探索 → 方案审查 → 分阶段实现 → 独立复查」是同一个思路， 两个工具怎么分工见 Codex vs Claude Code 实测对比。
三条常用命令
/status：剩余额度、重置时间、当前认证方式。/model：查看或切换当前模型。codex login --device-auth：浏览器跳转失败时的备用登录。
一句话总结
装 @openai/codex、用 ChatGPT 账号登录、进去先敲 /status 和 /model， 第一个任务先只读再计划再执行。Free 也能用但撞了额度只能等；真要拿它干活，Plus 是起点，重度编码看 Pro 5x。