CLI 是 Codex 里最适合练基本功的入口。终端里没有多余的按钮，每条命令你都能看清它要去做什么，改起来也随时能打断。

这一篇按使用频率排，先弄清三种使用姿势分别适合什么，再看交互和一次性执行的写法。启动参数那部分按用途分类，参数名和默认值会跟着版本变，记住哪一类管哪件事就够了。

三种使用姿势

模式	适合的任务	典型命令
交互模式	学仓库，逐步改代码，需要随时打断	codex
一次性任务	CI 和脚本，批量分析，生成摘要	codex exec “任务说明”
恢复会话	延续之前的上下文继续做	codex resume

交互模式是默认入口，熟悉一个仓库和逐步改代码都走它。重复动作要交给脚本或者流水线的时候用 codex exec，它执行完就退出。一个任务跨了几次还没做完，用 codex resume 把上下文接上。

交互模式：第一句话先限定边界

进入项目根目录再启动 codex，第一句话别急着让它改东西。先让它只读一遍仓库。项目用途，入口文件，安装与测试命令这几项要报回来。然后再要一份建议优先补齐的文档和测试清单。这么做的好处是你能看出它理解到什么程度，后面的任务才有准头。

交互模式真正的价值是能中途停下。它准备执行命令之前，你可以先确认这条命令要干什么，也可以把一个任务拆成几轮慢慢推进。

一次性任务用 codex exec

codex exec 适合放进脚本，CI 或者重复任务里。跑完进程就结束，没有追问的余地，所以任务说明要比交互模式写得更死。

它常被用来批量生成仓库摘要，或者在一个 CI 失败之后自动收集失败原因。为 release notes 生成初稿，从日志里提炼排查建议，也属于这一类。输出格式可以直接写进任务里，例如项目概览控制在一百二十字以内，技术栈用表格呈现，风险提示最多五条。

恢复会话之前，先留一份阶段总结

长任务经常要分段推进。每个阶段结束的时候，让 Codex 留下这几样：

1. 已经读了哪些文件
2. 改了哪些文件
3. 跑过哪些命令
4. 还没完成的下一步
5. 当前的风险

下次恢复时，把上一段的总结原样贴回去当第一条消息，上下文断裂会小很多。

斜杠命令是用来观察状态的

斜杠命令用于在会话里快速查看状态，或者执行一些常用动作。不同版本的命令列表会变，最稳的方式是在 CLI 里打一个斜杠，看当前有哪些。

命令类型	作用	使用建议
状态类	查看模型，审批和工作区状态	每次重要修改之前看一次
上下文类	查看或压缩上下文	长任务进入下一阶段时用
Git 类	查看 diff 或变更摘要	提交前配合人工 review
权限类	查看审批策略	涉及安装，网络和删除之前检查
会话类	退出，恢复和重开	任务结束时留下清晰总结

启动参数按用途记

参数名和默认值更新得快，以 codex –help 和官方文档为准。按用途记会更耐用。

参数类别	它解决的问题	举例
模型选择	这次任务需要更强推理还是更快响应	复杂重构用高推理，文档整理用常规设置
沙盒设置	控制文件系统和网络的权限	只读分析，工作区写入和受限网络
审批策略	哪些命令需要人工确认	删除，安装依赖和外部网络访问
配置覆盖	临时覆盖 config.toml	单次任务使用特殊 profile
输出格式	适配脚本和自动化	exec 输出 Markdown，JSON 或固定结构

第一次跑失败对着这张表改

失败现象	处理方式
改动太大	让它停下，只保留最小修复思路
测试跑不起来	先让它解释环境缺口和命令来源
方向不对	回到只读分析，让它列出文件依据
输出太泛	要求按文件，命令和风险分段输出
误改无关文件	用 git diff 确认，再决定保留还是丢弃

跑完第一次实战，手上应该留下几样东西。diff 要小到一眼能看完，一条验证命令要能重复跑出同样的结果。改动摘要得说得清楚，另外还得留下一份能反复用的任务模板。最省事的一步是先把只读分析固化成习惯，每次拿不准就先让它读，不动手。