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 并附带本轮目标:

text
/plan 为现有服务设计无停机数据库迁移方案,列出验证点和回滚条件

预期结果:

text
Codex 进入 Plan 模式,并先给出面向该目标的分步执行计划。

Plan 的价值不是“让模型写得更多”,而是把依赖、顺序、风险和验收条件暴露出来。对于只改一个变量名或修复明确的一行错误,直接进入常规实现通常更高效。

实现、审查与旁路问题

计划确认后,回到正常任务执行流程,让 Codex 按明确目标修改代码、运行测试并检查结果。这里的“代码模式”更准确地说是常规实现阶段,不要依赖并不存在的 /code 命令。

完成实现后,可以用 /review 把关注点切换到代码审查;需要临时验证一个假设,又不想扰乱主会话时,可以用 /side 创建临时旁路对话。较长任务还可以设置 Goal,让目标在持续执行过程中保持可见和可追踪。

text
/review

预期结果:

text
Codex 进入代码审查流程,检查当前改动或与指定基线的差异。

再选择运行环境

交互方式确定“怎么协作”,Local、Worktree、Cloud 则确定“在哪里执行”。如果你正在当前分支上做一个很小的修复,Local 最直接;如果要让两个方案并行修改相同仓库,Worktree 能降低互相覆盖的风险;如果任务依赖远程环境或适合脱离本机运行,再考虑 Cloud。

因此,实际选择可以组合起来:例如“Plan + Worktree”表示先规划,再在隔离工作树中实施;“Review + Local”表示直接审查当前工作树。把交互模式和执行环境分成两条轴,比记住一串命令更可靠。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识运行模式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通