最近在玩 OpenAI 的 Codex CLI，一个跑在终端里的 AI 编程助手。用了一阵子，觉得值得写篇东西分享一下。

先说结论：它不是聊天机器人那种"你问我答"，而是能直接进到你的项目目录里，读文件、改代码、跑命令、一步步帮你把东西做出来。之前写过 Claude Code 的内容，Codex CLI 是 OpenAI 出的同类工具。

这篇就做一件事——从零开始装好 Codex CLI，然后用它做一个能跑的 HTML 小游戏。

环境检查

装之前先确认一下电脑里有没有 Node.js 和 npm。终端里跑：

node --version
npm --version

看到版本号就没问题。要是报 command not found，去 Node.js 官网装个 LTS 版本，装完再来一次。

安装

两种方式，选一个就行。

npm（推荐）：

npm install -g @openai/codex

国内网络慢的话换个镜像源：

npm install -g @openai/codex --registry=https://registry.npmmirror.com

后续升级：

npm install -g @openai/codex@latest

Homebrew（Mac 用户）：

brew install --cask codex

装完跑一下 codex --version，能看到版本号就 OK。

登录

codex login

按提示走完就行。要是直接跑 codex 遇到 account/read failed during TUI bootstrap，就是还没登录，先跑上面那条命令。

进项目，开始用

cd your-project
codex

进去之后直接跟它说话就行。比如问一句"你现在用的什么模型"：

不同账号、不同套餐看到的模型可能不一样，以你界面显示的为准。

想切换模型的话，在会话里输 /model 模型名称。想看配置文件的话 cat ~/.codex/config.toml，不过刚上手不建议改配置，能跑就行。

实战：接水果小游戏

直接上手做个东西。

建个空文件夹：

mkdir fruit-game
cd fruit-game

然后给 Codex 下任务：

codex exec "请帮我写一个单文件 HTML 小游戏：接水果小游戏。要求：
1. 只有一个 index.html 文件；
2. 使用 HTML、CSS、JavaScript、canvas；
3. 玩家用键盘左右键控制篮子；
4. 水果从屏幕上方随机掉落；
5. 接到水果加分；
6. 漏掉水果扣生命；
7. 生命为 0 显示游戏结束；
8. 页面风格可爱、适合新手学习；
9. 代码里加中文注释。"

Codex 生成完代码之后，执行：

codex apply

这步把 Codex 写的改动真正落到你本地文件里。

Mac 用户直接 open index.html 打开看效果，Windows 用户双击文件就行。

跑起来了？好，继续优化。

codex exec "请优化这个接水果小游戏：增加开始按钮、重新开始按钮、难度逐渐提升，并保持代码简单易懂。"

改完再 codex apply，刷新页面看效果。

到这里你已经跑通了整个流程：提需求 → Codex 写代码 → 应用到本地 → 预览 → 再优化。挺顺的。

Codex CLI 的 help 信息

跑 codex --help 会看到一堆子命令：

命令	作用
exec (e)	非交互式执行任务，直接给结果
review	代码审查
login / logout	登录登出
mcp	管理 MCP 服务器配置
plugin	管理插件
apply (a)	把 Codex 生成的 diff 应用到本地
resume	恢复之前的会话
fork	基于之前的会话开个新方向
cloud	浏览 Codex Cloud 上的任务（实验功能）

实际日常用得最多的就是 codex、codex exec、codex apply、codex review 这几个。

一些使用建议

做小 demo 熟悉流程，别一上来就丢大项目上去。先让它改一个小功能，观察它怎么动文件。每次 codex apply 之前看看它改了什么，别盲目接受。

正式项目里用之前，先提交一次 Git：

git add .
git commit -m "before codex changes"

改坏了能回退。

几个适合 Codex CLI 的场景

快速搭小工具——HTML 页面、数据处理脚本、自动化脚本、简单接口。描述清楚需求，它给你出初版。

接手陌生项目的时候问它"帮我分析一下目录结构和主要入口"，比自己翻文件快。

遇到报错直接把错误信息甩给它，让它定位和修复。

codex review . 跑一遍代码审查，看看有没有明显问题。

最后

Codex CLI 好不好用，不取决于它能不能写代码——现在大模型都能写。关键在于它能不能帮你把一个想法快速变成能跑的东西。从"我写代码"到"我说需求，AI 出初版，我来判断和调整"，这个变化比模型本身更重要。

我是赛博李同学大厂写代码的，觉得有用的话，点个赞 + 转发给需要的TA，感谢支持！，我们下期再见！