这一节假设你已经有一个能用的 ChatGPT 账号。没有的话先看账号注册与验证。
先决定:你要哪一张面孔
Codex 有四个入口(见Codex 的四张面孔)。第一次上手建议从命令行开始——它最直接,出了问题也最容易看清是哪一步。
不想碰终端的话,桌面应用和命令行能力一样,可以直接装那个。
装命令行版
Codex 命令行通过包管理器安装,装完在终端里敲 codex 就能启动。
如果你从没打开过终端,先读终端基础:打开方式与基本命令——那一节是给 Claude Code 写的,但终端本身是同一个东西,一字不差地适用。
具体的安装命令官方文档会随版本更新,照 developers.openai.com/codex 上当前那一条走,不要照抄任何第三方教程里的旧命令。
登录:两种方式,选第一种
① 用 ChatGPT 账号登录(推荐)
启动后按提示走一遍浏览器授权,用你的订阅额度。这是我们卖的那个订阅该走的路。
② 用 API key
按用量单独计费,和你的订阅额度完全不通。
⚠️ 这两个别混。 用 API key 登录之后,你的订阅额度一点都用不上,花的是另一笔钱。 有人装完发现「怎么还在扣费」,多半就是这里选错了。
验证装好了
启动之后,在里面问一句最没有歧义的话:
把当前目录下的文件列一遍,只列名字,不要做任何修改。
它会请求你同意,然后列出来。看到这一步,就是通了。
第一次用的三个提醒
① 从一个你不心疼的目录开始。 新建一个测试文件夹,把几份文件复制进去,在那里练手。不要第一次就在真实的工作目录里跑。
② 看清楚它要做什么再点同意。 默认设置下,它越出沙箱之前会问你。这道问句不是形式——它是你唯一的刹车。
③ 先只读,再动手。 头几次把权限压到只读(见沙箱和审批),观察它的做事习惯。摸清了再放开。
装不上怎么办
按这个顺序查:
- 网络 —— 装不上和用不了是两个问题,先分清是哪一个
- 权限 —— 安装报权限错误的,多半是装到了需要管理员权限的位置
- 版本 —— 系统和运行环境的版本要求以官方文档为准
Claude Code 那边的安装故障排查里,有一半的条目是环境问题而非工具问题,那些对 Codex 同样成立,可以对照着查。
本节事实查证日期:2026-09-10。 依据:OpenAI 官方 Codex 文档。⚠️ 安装命令与系统要求会随版本变化,以官网为准。