必须使用独立工作树——它是防止文件覆盖、状态污染和CI误触发的安全前提；当任务需修改代码、隔离开发或并行验证分支逻辑时，New worktree模式不可替代。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在 Codex 中启动一个新任务，且该任务可能修改代码、需与当前开发工作隔离、或要并行验证多个分支逻辑时，就必须使用独立工作树——它不是可选项，而是防止文件覆盖、状态污染和 CI 误触发的安全前提。
正在本地主分支上调试关键功能
第一步：确认当前终端 pwd 所在目录下 git status 显示有未提交改动，且你正专注修复一个阻塞上线的 bug。
第二步：此时若新建任务（如“给登录接口加埋点”），必须选 【New worktree】 模式，否则 Codex 会直接在你正在编辑的 src/api/auth.ts 上写入代码，导致未完成的调试逻辑被混入埋点逻辑，diff 失控。
第三步：切到 New worktree 后，Codex 自动从当前分支（如 main）创建新分支 feature/tracking-202610，并在 ../my-repo-feature-tracking-202610 目录下检出——这个路径完全独立于你当前终端所在目录。
要同时运行两个 AI 任务
方法一：第一个任务用 Local 模式重构 utils/date.ts，第二个任务必须用 New worktree 模式生成测试用例。因为两个任务都会读写同一文件，Local + Local 组合必然引发内容覆盖，Git 无法自动合并语义级修改。
方法二：两个任务都设为 New worktree，但基础分支不同——比如一个基于 main，一个基于 staging。这样即使都改了 package.json 的 scripts 字段，也不会互相干扰，各自构建产物输出到不同 dist/ 目录。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
任务涉及自动构建或清理操作
如果 Prompt 中包含“执行 npm run build:prod”“清空 dist 目录”“重装 node_modules”等指令，【绝对不可选 Current checkout】。这类命令不识别 Git 分支，只认物理路径。你在 main 分支上跑构建，却把 staging 分支正在调试的 dist 文件删光，第二天晨会将无法演示。
这一步操作起来很简单，直接在新建任务时点开模式下拉框，选 ? 新工作树(worktree) 即可。Codex 会在任务启动瞬间同步创建 worktree，不支持草稿保存后补选。
需要复现他人提交的 CI 失败环境
① 复制失败流水线的 commit hash（如 a1b2c3d）；
② 新建任务 → 模式选 New worktree → 基础分支手动输入 a1b2c3d（不选任何已有分支名）；
③ Codex 会创建 detached HEAD 状态的工作树，精准复现该次构建的代码快照。此时你运行 npm test 或 ./scripts/lint.sh，结果与 CI 完全一致；
④ 若用 Current checkout 切到该 commit，则整个工作区进入游离状态，后续任何 git checkout 都需先 git restore . 清理脏文件，极易误操作提交。
