一、Codex 是什么？

先说说 Codex CLI 到底是什么。简单讲，它就是 OpenAI 推出的一个终端编程智能体——能够直接在本地终端里读取你的代码仓库、修改文件、运行命令，还能帮你做代码理解、Bug 修复、重构、测试、Code Review 这些活儿。根据官方文档的描述，Codex CLI 跑在本地终端里，可以在指定目录内读代码、改代码、执行命令，而且它是开源的，底层用 Rust 构建。

说白了，它和 Claude Code 是同类产品——都是“终端里的 AI 程序员”。不过 Codex 跟 OpenAI 生态、ChatGPT 账号、Codex Cloud、MCP、自动化脚本这些搭配起来会更顺手。

二、安装 Codex CLI

安装方式挺友好，支持 npm 和 Homebrew 两种。官方文档给出的 npm 安装命令是：

npm i -g @openai/codex

如果你是 macOS 用户，也可以直接用 Homebrew 装：

brew install --cask codex

GitHub 仓库的 README 里也列了这两种方式，没什么坑。

装完之后，在终端里直接敲：

codex

首次运行时会提示登录，你可以用 ChatGPT 账号或者 API Key。注意，ChatGPT Plus、Pro、Business、Edu、Enterprise 这些计划都包含了 Codex 的使用入口，第一次运行 codex 时会走认证流程。

三、更新 Codex CLI

用 npm 装的话，更新起来也简单：

npm i -g @openai/codex@latest

官方文档说了，Codex CLI 会定期发布新版本，npm 用户通过安装 latest 版本来升级就行。

如果是 Homebrew 安装：

brew upgrade --cask codex

建议定期更新，毕竟 Codex CLI 的命令、模型、权限模式、MCP、Cloud task 这些能力迭代速度还是挺快的。

四、Codex 常用终端命令

1. codex

作用
启动 Codex 的交互式终端界面。

cd your_project
codex

官方文档里说，运行 codex 会启动一个全屏的终端 UI，Codex 可以读取仓库、修改文件、运行命令，并且你可以在旁边实时审查它的每个操作。

使用场景
日常开发中最直接的用法——进入项目目录，然后让 Codex 帮你理解或修改代码。比如：

• “帮我分析这个 Flutter 项目的目录结构”
• “帮我找一下登录页面的入口和状态管理逻辑”
• “帮我检查这个页面是否存在 build 方法过重的问题”

这是最基础也最常用的方式，没什么好说的。

2. codex "你的问题"

作用
启动 Codex 的同时直接带上初始 prompt。

codex "Explain this codebase to me"

官方文档给出的例子就是通过命令行附带初始问题来启动 Codex。

使用场景
当你脑子里已经想好了问题，一行命令直接启动，省掉进入交互界面再打字这一步。比如：

codex "帮我分析这个项目的架构，并指出核心模块"
codex "帮我检查当前 Flutter 项目的 Riverpod 使用是否合理"

适合快速切入一个明确的任务。

3. codex exec

作用
以非交互方式执行一次 Codex 任务，适合写到脚本里、CI 流程里或者自动化链路里。

codex exec "帮我检查当前 diff 中是否存在明显问题"

官方功能页说明，Codex 支持通过 exec 命令来脚本化自动化流程。

使用场景
自动化的 Code Review、CI 检查、批量分析，这些场景最合适。举个例子：

git diff | codex exec "请基于当前 diff 做代码审查，只指出新增代码中的问题"

也可以用来生成 MR 描述：

git diff --stat | codex exec "根据这些变更生成一份简洁的 MR 描述"

如果你想把 Codex 接进 CNB、Jenkins、GitHub Actions、GitLab CI 这些流水线里，codex exec 比交互式 codex 更合适。

4. codex resume

作用
恢复之前的 Codex 会话。

codex resume

官方文档说明，Codex 会把会话记录保存在本地，通过 codex resume 可以重新打开之前的对话，省得重复输入上下文。

使用场景
适合那些跨天的长期任务，比如：一个复杂重构做了好几天，昨天已经分析过项目架构，上次已经生成过迁移方案，今天想接着继续搞。执行命令后选择最近的会话就能续上。

5. codex resume --last

作用
直接恢复当前目录下最近的一次会话。

codex resume --last

官方文档写了，codex resume --last 可以跳过会话选择器，直接回到当前工作目录最近的会话。

使用场景
比如你昨天让 Codex 分析过 Flutter 页面的重构方案，今天一打开终端直接敲这个命令，进去后继续下达任务就行。

6. codex resume --all

作用
显示所有目录下的历史会话。

codex resume --all

官方文档说明，--all 可以列出当前工作目录之外的其他会话。

使用场景
如果你同时在多个项目里用 Codex，想找回某个历史任务，用这个命令就能看到所有项目的历史会话，选对项目继续就行。

7. codex exec resume --last

作用
以非交互方式恢复最近会话，并继续执行任务。

codex exec resume --last "继续修复你上次发现的问题"

官方文档给的例子就是 codex exec resume --last "Fix the race conditions you found"，说明非交互的自动化任务也可以恢复上下文。

使用场景
适合自动化场景下的连续任务，比如流水线里分阶段执行。

8. codex --cd

作用
指定 Codex 的工作目录。

codex --cd /path/to/project

官方 CLI 参考里提到，--cd 或 -C 可以在 Codex 开始处理请求前先设置好工作目录。

使用场景
在脚本里想明确指定项目路径，又不想提前 cd 切换文件夹，就靠它了。

9. codex --add-dir

作用
给 Codex 额外目录的访问权限。

codex --add-dir ../shared_package

官方 CLI 参考说明，--add-dir 可以给主工作区之外的目录授予额外的写访问权限，而且可以重复使用。

使用场景
多仓库项目或者本地依赖场景——比如主项目里依赖了一个本地封装的共享库，用这个参数就能让 Codex 同时读取两个项目的代码。

10. codex --model

作用
指定本次使用的模型。

codex --model gpt-5.5

官方 CLI 参考里写了，--model 或 -m 可以覆盖配置中的模型设置。

使用场景
复杂任务用更强模型，简单任务用更快模型，按需搭配——性价比一下子就上来了。

11. codex --profile

作用
加载指定的配置 profile。

codex --profile work

官方 CLI 参考说明，--profile 或 -p 可以从 ~/.codex/config.toml 中加载对应配置。

使用场景
不同项目、不同使用模式可以配不同的 profile，团队统一开发规范时尤其好用。

12. codex -c key=value

作用
临时覆盖某个配置项。

codex -c model="gpt-5.5"

官方 CLI 参考说明，Codex CLI 默认读取 ~/.codex/config.toml，命令行里的 -c key=value 会临时覆盖本次调用的配置。

使用场景
临时改个参数又不想动全局配置，用这个就很方便。

13. codex --ask-for-approval

作用
控制 Codex 运行命令前是否需要人工审批。

codex --ask-for-approval on-request

官方 CLI 参考说明，--ask-for-approval 或 -a 支持 untrusted、on-request、never 等值，用来控制 Codex 何时暂停并请求人工批准。

使用场景
日常开发建议开启审批模式，自动化的只读场景可以按需关闭审批。

14. codex --dangerously-bypass-approvals-and-sandbox

作用
跳过审批和沙箱限制。

codex --dangerously-bypass-approvals-and-sandbox

官方文档说得非常直白：这个选项会在没有审批和沙箱的情况下执行每个命令，只有在你已经用外部手段加固了环境时才能用。

使用场景
仅限容器、虚拟机、临时测试环境。正式业务项目严禁使用，切记。

15. codex --image

作用
把图片作为初始 prompt 的附件传给 Codex。

codex --image screenshot.png "根据这个截图帮我分析 UI 问题"

官方 CLI 参考说明，--image 或 -i 可以把一个或多个图片文件附加到初始 prompt 中，多个路径可以用逗号分隔，也可以重复传入。

使用场景
前端、Flutter、UI 还原、Bug 截图分析——这些场景下传一张图比描述半天高效多了。

16. codex --oss

作用
使用本地开源模型作为提供方。

codex --oss

官方 CLI 参考说明，--oss 等价于设置 model_provider="oss"，并且会校验 Ollama 是否正在运行。

使用场景
本地模型测试、离线实验、低成本的代码调试——不用联网也能跑。

17. codex app-server

作用
启动 Codex 的远程 app server。

codex app-server --listen ws://127.0.0.1:4500

官方功能页说明，你可以在拥有代码、凭证和执行环境的机器上启动 app server，然后从另一台机器连接 Codex TUI。

使用场景
远程开发机、云端打包机——你可以在本地操控远处的开发环境。

五、Codex 会话内常用操作

进入 Codex 交互界面后，你既可以像聊天一样输入自然语言，也能用一些快捷操作。

1. 输入普通任务

直接输入开发相关的需求就行，日常各种开发调试场景都适配。

2. 使用 /model

作用
切换模型或调整模型相关配置。
官方文档说，Codex CLI 支持通过 /model 在不同模型之间切换，适配架构设计、代码重构、安全审查等高难度开发工作。

3. /clear

作用
清空当前对话，开始新任务。
也可以按 Ctrl + L 只清屏但不开始新对话，适合快速切换开发需求。

4. /copy

作用
复制最近一次 Codex 的输出。
快捷键 Ctrl + O 也能快速复制，适合复制审查报告、优化方案、开发文档等内容。

5. /exit

作用
退出当前 Codex 会话。
当然，Ctrl + C 也能快速关闭交互式会话。

6. Tab 追加后续任务

Codex 正在运行任务时，按下 Tab 键可以提前输入后续需求，排队等待执行——连续开发任务的高效解法。

7. Ctrl + R 搜索历史 prompt

在输入框中按 Ctrl + R 可以快速检索过往输入的指令，复用那些常用的审查或开发提示词。

六、典型使用场景

场景 1：快速理解项目

cd my_flutter_project
codex "帮我分析这个 Flutter 项目的整体架构、主要模块和状态管理方案"

场景 2：查找业务入口

直接输入指令，快速定位项目内的页面、接口、路由等核心业务代码。

场景 3：基于 Git Diff 做 Code Review

git diff | codex exec "请基于当前 diff 做代码审查，只审查新增代码，按 blocker、critical、major、minor、suggestion 分类输出"

场景 4：生成 MR 描述

借助 git 提交记录，快速生成规范简洁的合并请求说明。

场景 5：生成周报

抓取周期内的代码提交记录，自动整理分类生成工作周报。

场景 6：分析构建失败日志

读取打包、编译报错日志，自动定位问题根源并给出修复方案。

场景 7：辅助 Flutter 重构

优先让 AI 输出重构方案，确认无误后再执行代码修改——线上风险可控。

场景 8：根据截图分析 UI 问题

搭配图片指令，快速定位页面样式错乱、布局异常等前端问题。

场景 9：接入自动化 Code Review

在 CI 流水线里配置指令，固定 JSON 格式输出审查结果，对接各类自动化运维平台。

七、Flutter 项目推荐 Prompt

你可以自定义规范审查话术，限定代码编写规范、资源使用规则、代码行数限制等，统一团队的 Flutter 代码风格，然后搭配 exec 命令批量审查项目代码。

八、Codex 安全使用建议

1. 正式项目中绝对不要关闭审批与沙箱限制，避免代码误改或高危命令执行。
2. 严格隔离 .env、密钥、证书、生产配置等敏感文件，限制 Codex 的访问权限。
3. 自动化流水线优先配置只读审查模式，区分代码检查和代码修改的权限。
4. 大型项目重构要分步执行——先出方案核验，再分模块迭代修改。

九、Codex 与 Claude Code 的简单对比

对比项	Codex CLI	Claude Code
所属生态	OpenAI / ChatGPT	Anthropic / Claude
使用方式	终端、IDE、Cloud、App Server	终端、IDE、Claude 生态
自动化能力	codex exec 适配脚本 CI	claude -p 适配脚本 CI
项目规则文件	AGENTS.md 为主	CLAUDE.md 为主
远程能力	支持 app-server 远程连接	支持多端远程使用
适配场景	OpenAI 生态、自动化代码审查	长文本上下文、复杂源码解析

如果团队依托 OpenAI 生态，优先选 Codex；如果深耕 Claude 技术体系，那就适配 Claude Code。

十、常用命令速查表

命令	作用	使用场景
codex	启动交互式 Codex	日常开发调试
codex "问题"	带初始问题启动	快速项目分析
codex exec "任务"	非交互执行任务	脚本、CI 自动化
git diff | codex exec "审查"	增量代码审查	提交代码自检
codex resume	恢复历史会话	长期开发任务续接
codex resume --last	恢复最近会话	快速接续上次工作
codex resume --all	查看全量历史会话	多项目任务查找
codex --cd	指定工作目录	脚本批量执行
codex --add-dir	新增目录访问权限	多依赖库项目
codex --model	指定运行大模型	区分任务难度
codex --profile	加载专属配置	团队规范统一
codex --image 图片路径	传入图片分析	UI 界面调试
codex --oss	调用本地开源模型	离线本地开发
codex app-server	启动远程服务	远程开发机操控

十一、推荐工作流

1. 首次接入项目：进入项目目录启动交互终端，让 AI 通读项目整体结构，录入项目专属开发规范。
2. 日常开发：直接启动交互模式，完成页面开发、逻辑优化、代码纠错等日常需求。
3. 代码提交前：执行 diff 代码审查，结合原生编译检测双重校验代码质量。
4. 流水线自动化：配置非交互审查指令，接入 CI 流程，自动拦截不合规的代码合并。

十二、总结

Codex CLI 的核心价值并不在于简单的问答交互，而在于它能深度融入你的全流程开发体系。日常开发用交互式指令，批量自动化任务用 codex exec，跨场景开发靠会话恢复功能衔接工作内容，再配上目录指定、图片解析、模型切换这些能力——从 Flutter 开发、代码自动化审核到云端运维流水线，几乎都能完美适配。把它打造成团队的专属自动化代码助手，值得花点时间研究。