CLI 选项与命令
三种使用姿势
#WcNwTGgHriEA text { white-space: pre; }#WcNwTGgHriEA .fb0 { stroke: var(--N900-FG, 0.15); }#WcNwTGgHriEA .fb0 {stroke: rgba(31,35,41, 0.15)}#WcNwTGgHriEA .fx0 { stroke-miterlimit: 10; }#WcNwTGgHriEA .fx0 {stroke-miterlimit: 10}#WcNwTGgHriEA .fa1 { fill: rgb(187, 191, 196); }#WcNwTGgHriEA .fa1 {fill: rgb(187, 191, 196)}#WcNwTGgHriEA .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#WcNwTGgHriEA .fx1 {font-style: normal}#WcNwTGgHriEA .fx2 { text-anchor: middle; }#WcNwTGgHriEA .fx2 {text-anchor: middle}#WcNwTGgHriEA .fx3 { dominant-baseline: central; }#WcNwTGgHriEA .fx3 {dominant-baseline: central}#WcNwTGgHriEA .fx4 { stroke: none; }#WcNwTGgHriEA .fx4 {stroke: none}#WcNwTGgHriEA .fc0 { fill: var(--text-caption); }#WcNwTGgHriEA .fc0 {fill: #646a73}#WcNwTGgHriEA .fa2 { fill: var(--text-link-disabled); }#WcNwTGgHriEA .fa2 {fill: rgb(187, 191, 196)}#WcNwTGgHriEA .fa3 { fill: rgb(225, 234, 255); }#WcNwTGgHriEA .fa3 {fill: rgb(225, 234, 255)}#WcNwTGgHriEA .fx5 { font: 700 18px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#WcNwTGgHriEA .fx5 {font-style: normal}#WcNwTGgHriEA .fx6 { text-anchor: start; }#WcNwTGgHriEA .fx6 {text-anchor: start}#WcNwTGgHriEA .fx7 { dominant-baseline: alphabetic; }#WcNwTGgHriEA .fx7 {dominant-baseline: alphabetic}#WcNwTGgHriEA .fc1 { fill: rgb(0, 0, 0); }#WcNwTGgHriEA .fc1 {fill: rgb(0, 0, 0)}#WcNwTGgHriEA .fx8 { font: 400 16px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#WcNwTGgHriEA .fx8 {font-style: normal}#WcNwTGgHriEA .fx9 { font: 400 16px LarkHackSafariFont, LarkEmojiFont, "monospace", -apple-system, BlinkMacSystemFont, "Helvetica Neue", Helvetica, "Noto Sans", Tahoma, "Nimbus Sans L", Arial, "Liberation Sans", "PingFang SC", "Hiragino Sans GB", "Noto Sans CJK SC", "Source Han Sans SC", "Source Han Sans CN", "Microsoft YaHei", "Wenquanyi Micro Hei", "WenQuanYi Zen Hei", STHeiti, SimHei, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji", system-ui; }#WcNwTGgHriEA .fx9 {font-style: normal}#WcNwTGgHriEA .fb1 { fill: var(--N900-FG, 0.15); }#WcNwTGgHriEA .fb1 {fill: rgba(31,35,41, 0.15)}#WcNwTGgHriEA .fa4 { fill: var(--bg-body); }#WcNwTGgHriEA .fa4 {fill: #fff}ABC1234模式适合任务典型命令交互模式一次性任务恢复会话学习仓库、逐步改代码、需要随时打断CI、脚本、批量分析、生成摘要延续之前上下文、继续未完成任务codexcodex exec "任务说明"codex resume
交互模式
进入项目根目录后运行：
代码块
YAML
codex
建议第一句话先限定边界：
代码块
YAML
请先阅读当前仓库，不要修改文件。请告诉我：
1. 项目用途
2. 入口文件
3. 安装、构建和测试命令
4. 你建议优先补齐的 5 个文档或测试任务
交互模式最适合学习 Codex 的思考过程。你可以在它准备执行命令前停下来，确认命令意图，也可以把任务拆成多轮推进。
非交互模式：codex exec
codex exec 适合把 Codex 放进脚本、CI 或重复任务里。例如：
代码块
YAML
codex exec "请阅读 README 和 package.json，输出本项目的本地启动命令和测试命令。不要修改文件。"
适合的场景：
•
批量生成仓库摘要。
•
在 CI 失败后自动收集失败原因。
•
为 release notes 生成初稿。
•
从日志中提取排障建议。
•
为多个模块生成统一格式的文档草稿。
写 exec 任务时要更明确，因为它没有交互追问的空间：
代码块
YAML
请只读分析当前仓库，不要修改文件。
输出格式：
1. 项目概览：不超过 120 字
2. 技术栈：表格
3. 本地启动：列出命令和前置条件
4. 测试命令：按单元测试、集成测试、类型检查分类
5. 风险提示：最多 5 条
恢复与继续
长任务经常需要分段推进。建议在每个阶段结束时让 Codex 输出：
•
已读文件。
•
已改文件。
•
已运行命令。
•
尚未完成的下一步。
•
当前风险。
下次恢复时，把上一段总结作为第一条消息，能显著减少上下文断裂。
示例：
代码块
YAML
继续上一次任务。上一阶段已经完成：
- 已定位失败测试：...
- 已修改文件：...
- 已运行命令：...
请现在只处理下一步：补充边界测试，并运行相关测试。
Slash Commands
Slash Commands 用于在 CLI 会话中快速查看状态、调整行为或执行常用动作。不同版本命令列表可能会变化，最稳妥的方式是在 CLI 内输入 / 查看当前可用命令。
常见使用方式：
启动参数的理解方式
官方 CLI 版本更新较快，参数名和默认值请以 codex --help 与官方文档为准。学习时可以按用途理解：
表格加载中...
任务设计模板
只读分析
代码块
Plain Text
请只读分析当前仓库，不要修改文件，不要运行会写入文件的命令。
请输出：
1. 项目结构
小修复
代码块
Plain Text
请修复 [具体问题]。
范围：
- 允许修改：[目录/文件]
- 避免修改：[目录/文件]
要求：
1. 先复现问题。
2. 修改最小必要代码。
3. 运行 [验证命令]。
自动化摘要
代码块
YAML
codex exec "请阅读最近一次测试失败日志，提取失败测试名、关键报错、可能原因和下一步排查建议。不要修改文件。"