CLI 选项与命令¶
CLI 是 Codex 最适合练基本功的入口。本页按官方教程的逻辑，把交互模式、非交互模式、会话恢复、Slash Commands 和常用启动参数整理成中文实操版。
最后核对
官方资料最后核对日期：2026-05-27。本文参考 Codex CLI features、Codex CLI 官方仓库、CLI getting started、exec 文档 与 slash commands 文档。
三种使用姿势¶
| 模式 | 适合任务 | 典型命令 |
|---|---|---|
| 交互模式 | 学习仓库、逐步改代码、需要随时打断 | codex |
| 一次性任务 | CI、脚本、批量分析、生成摘要 | codex exec "任务说明" |
| 恢复会话 | 延续之前上下文、继续未完成任务 | codex resume |
交互模式¶
进入项目根目录后运行：
建议第一句话先限定边界：
交互模式最适合学习 Codex 的思考过程。你可以在它准备执行命令前停下来，确认命令意图，也可以把任务拆成多轮推进。
截图占位
请补充交互模式启动后的首轮仓库分析截图。建议文件：docs/.vuepress/public/screenshots/cli/03-interactive-start.png。
非交互模式：codex exec¶
codex exec 适合把 Codex 放进脚本、CI 或重复任务里。例如：
适合的场景：
- 批量生成仓库摘要。
- 在 CI 失败后自动收集失败原因。
- 为 release notes 生成初稿。
- 从日志中提取排障建议。
- 为多个模块生成统一格式的文档草稿。
写 exec 任务时要更明确，因为它没有交互追问的空间：
请只读分析当前仓库，不要修改文件。
输出格式：
1. 项目概览：不超过 120 字
2. 技术栈：表格
3. 本地启动：列出命令和前置条件
4. 测试命令：按单元测试、集成测试、类型检查分类
5. 风险提示：最多 5 条
截图占位
请补充 codex exec 只读输出截图。建议文件：docs/.vuepress/public/screenshots/cli/04-exec-readonly.png。
恢复与继续¶
长任务经常需要分段推进。建议在每个阶段结束时让 Codex 输出：
- 已读文件。
- 已改文件。
- 已运行命令。
- 尚未完成的下一步。
- 当前风险。
下次恢复时，把上一段总结作为第一条消息，能显著减少上下文断裂。
示例：
Slash Commands¶
Slash Commands 用于在 CLI 会话中快速查看状态、调整行为或执行常用动作。不同版本命令列表可能会变化，最稳妥的方式是在 CLI 内输入 / 查看当前可用命令。
常见使用方式：
| 命令类型 | 作用 | 使用建议 |
|---|---|---|
| 状态类 | 查看模型、审批、工作区状态 | 每次重要修改前看一次 |
| 上下文类 | 查看或压缩上下文 | 长任务进入下一阶段时使用 |
| Git 类 | 查看 diff 或变更摘要 | 提交前配合人工 review |
| 权限类 | 查看审批策略 | 涉及安装、网络、删除前检查 |
| 会话类 | 退出、恢复、重开 | 任务结束时留下清晰总结 |
截图占位
请补充输入 / 后的命令列表截图。建议文件：docs/.vuepress/public/screenshots/cli/05-slash-commands.png。
启动参数的理解方式¶
官方 CLI 版本更新较快，参数名和默认值请以 codex --help 与官方文档为准。学习时可以按用途理解：
| 参数类别 | 解决的问题 | 例子 |
|---|---|---|
| 模型选择 | 当前任务需要更强推理或更快响应 | 复杂重构用高推理，文档整理用常规设置 |
| 沙盒设置 | 控制文件系统、网络、命令权限 | 只读分析、工作区写入、受限网络 |
| 审批策略 | 控制哪些命令需要人工确认 | 删除、安装依赖、外部网络访问 |
| 配置覆盖 | 临时覆盖 config.toml | 对单次任务使用特殊 profile |
| 输出格式 | 适配脚本或自动化 | exec 输出 Markdown、JSON 或固定结构 |
建议在教程截图中保留两张图：
截图占位
请补充 codex --help 输出截图。建议文件：docs/.vuepress/public/screenshots/cli/06-help.png。
截图占位
请补充 codex exec --help 输出截图。建议文件：docs/.vuepress/public/screenshots/cli/07-exec-help.png。
任务设计模板¶
只读分析¶
小修复¶
请修复 [具体问题]。
范围：
- 允许修改：[目录/文件]
- 避免修改：[目录/文件]
要求：
1. 先复现问题。
2. 修改最小必要代码。
3. 运行 [验证命令]。
4. 总结原因、改动、验证和风险。
自动化摘要¶
学习重点¶
- 交互模式适合探索和校准。
exec适合标准化输出和自动化。- Slash Commands 是观察 Codex 状态的窗口。
- 会话恢复前先写阶段总结。
- 参数变化以当前 CLI 帮助和官方文档为准。