工作树模式是解决并行开发冲突的隔离机制，需先初始化git仓库，再通过codex新建线程时选择“worktree”或对已有线程执行“handoff to worktree”，验证后可安全移除。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你正在本地开发一个功能分支，又想让Codex同时修复另一个紧急bug，直接在当前目录操作会导致文件修改混杂、diff混乱、本地未提交改动被覆盖——工作树模式就是专为解决这类并行任务冲突而设计的隔离机制。
确认项目已初始化为Git仓库
打开终端，进入你的项目根目录，执行 git status。如果返回 “fatal: not a git repository”，说明尚未初始化。
此时必须先运行 git init → git add . → git commit -m "init"，否则 Codex 无法创建工作树。
【未初始化 Git 仓库将导致 Worktree 选项完全不可用，且无任何提示】
在Codex App中启用工作树模式
方法一：新建线程时启用
点击左上角“+ New Thread” → 在输入框下方找到“Run in”下拉菜单 → 选择“Worktree” → 点击右侧分支选择器，挑一个干净的基线分支（推荐 main 或当前稳定的 feature 分支）→ 输入任务描述，例如“修复登录页 404 错误”。
方法二：已有线程切换至工作树
在任意线程右上角点击“⋯” → 选择“Handoff to Worktree” → 确认分支 → Codex 会自动创建新工作树并迁移当前上下文。
注意：Handoff 后原线程仍在 Local 中保留，但后续所有代码修改、命令执行均发生在新工作树内，文件系统完全隔离。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
验证工作树是否生效
第一步：打开终端，cd 到你的项目根目录
第二步：执行 git worktree list
第三步：检查输出中是否包含类似 /path/to/project/worktrees/xxx-hash abc1234 [main] 的条目，其中 worktrees/xxx-hash 是 Codex 自动生成的子目录名，[main] 表示所基于的分支。
第四步：进入该路径，运行 ls -la，确认存在完整项目文件，且 .git 是一个指向主仓库 .git/worktrees/xxx-hash 的文件，而非独立仓库。
这一步能直观验证隔离性：你在工作树里删掉 src/App.tsx，Local 目录中的同名文件毫发无损。
安全退出与清理工作树
当任务完成并确认无需保留改动时，在 Codex 线程界面点击右上角“⋯” → 选择“Remove Worktree”。
Codex 会自动执行 git worktree remove /path/to/worktree，删除整个工作树目录及对应元数据。
若手动删除工作树目录（如 rm -rf），git worktree list 仍会显示残留条目，下次创建工作树可能报错“invalid reference” —— 此时需手动运行 git worktree prune 清理引用。
