AI Agent / 系统课时
认识运行模式
认识运行模式
Codex 的“模式”并不只表示一个开关:有的决定当前对话要规划、实现还是审查,有的决定任务在本地、Git worktree 还是云环境中执行。把这两类概念分开,才能避免把 Plan 模式误当成沙箱设置,或把 Worktree 误当成一种推理方式。
学习目标
- 区分 Plan、常规实现、Review、Goal 与 Side 等交互方式
- 理解 Local、Worktree、Cloud 决定的是代码运行位置与隔离边界
- 根据任务阶段选择合适模式,而不是始终使用同一种交互方式
先分清两个维度
第一类是交互方式,回答“Codex 此刻应该怎样协作”。例如 /plan 让它先形成多步骤方案,/review 用于检查改动,/side 用于临时旁路问题,Goal 用于持续追踪一个较长目标。日常直接要求修改代码属于常规实现阶段;当前官方命令中并没有一个与 /plan 对称的 /code 命令。
第二类是执行环境,回答“代码在哪里运行、改动是否与当前工作树隔离”。桌面端可选择 Local、Worktree 或 Cloud:Local 直接使用当前项目目录,Worktree 在独立 Git worktree 中隔离修改,Cloud 则在配置好的远程环境中运行。
| 选择 | 主要用途 | 适合场景 |
|---|---|---|
| Plan | 先澄清目标、约束和步骤 | 跨模块改造、迁移、需求尚未收敛 |
| 常规实现 | 读取、修改并验证代码 | 方案明确后的编码与修复 |
| Review | 审查工作树或差异 | 提交前检查缺陷、回归与漏测 |
| Side | 临时追问,不打断主线 | 验证一个局部假设或快速查证 |
| Local | 直接在当前项目工作 | 单人、小改动、无需额外隔离 |
| Worktree | 用独立工作树隔离修改 | 并行方案、较大改动、避免污染主工作树 |
| Cloud | 在远程环境执行 | 需要远程依赖、长时间或独立环境的任务 |
用 Plan 模式先收敛方案
当任务包含多个模块、数据迁移或不可逆步骤时,先让 Codex 给出计划,再决定是否实施。CLI 中可以直接使用 /plan 并附带本轮目标:
/plan 为现有服务设计无停机数据库迁移方案,列出验证点和回滚条件预期结果:
Codex 进入 Plan 模式,并先给出面向该目标的分步执行计划。Plan 的价值不是“让模型写得更多”,而是把依赖、顺序、风险和验收条件暴露出来。对于只改一个变量名或修复明确的一行错误,直接进入常规实现通常更高效。
实现、审查与旁路问题
计划确认后,回到正常任务执行流程,让 Codex 按明确目标修改代码、运行测试并检查结果。这里的“代码模式”更准确地说是常规实现阶段,不要依赖并不存在的 /code 命令。
完成实现后,可以用 /review 把关注点切换到代码审查;需要临时验证一个假设,又不想扰乱主会话时,可以用 /side 创建临时旁路对话。较长任务还可以设置 Goal,让目标在持续执行过程中保持可见和可追踪。
/review预期结果:
Codex 进入代码审查流程,检查当前改动或与指定基线的差异。再选择运行环境
交互方式确定“怎么协作”,Local、Worktree、Cloud 则确定“在哪里执行”。如果你正在当前分支上做一个很小的修复,Local 最直接;如果要让两个方案并行修改相同仓库,Worktree 能降低互相覆盖的风险;如果任务依赖远程环境或适合脱离本机运行,再考虑 Cloud。
因此,实际选择可以组合起来:例如“Plan + Worktree”表示先规划,再在隔离工作树中实施;“Review + Local”表示直接审查当前工作树。把交互模式和执行环境分成两条轴,比记住一串命令更可靠。