codex工作树是基于git worktree创建的独立项目副本，共享.git元数据但文件物理隔离，用于并行开发且不干扰本地调试环境。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你在本地开发一个 Web 项目，正调试着热更新服务，突然想让 Codex 帮你写个新 API 接口——但又怕它修改 src/utils 下的共享工具函数，导致你当前的调试环境崩溃。这时候你需要的不是分支切换，而是一份完全隔离、可并行操作的项目副本，且不干扰你 IDE 里开着的所有进程和未提交改动。
确认项目已初始化为 Git 仓库
打开终端，进入你的项目根目录，执行：git status。如果返回 fatal: not a git repository，说明尚未初始化。
运行 git init → git add . → git commit -m "init"。这一步【必须完成】，因为 Codex Worktree 底层依赖 Git worktree 机制，非 Git 项目无法创建 worktree。
注意：不要跳过首次提交。空仓库或只有 untracked 文件的仓库，git worktree add 会报错“invalid reference”。
用命令行创建独立工作树副本
在终端中执行以下命令（替换 my-api-worktree 为你想要的文件夹名）：
git worktree add ../my-api-worktree feature/api-v2
这条命令会：在上层目录创建 my-api-worktree 文件夹 → 基于当前仓库新建一个名为 feature/api-v2 的分支 → 将该分支检出到新目录中。新目录拥有完整文件副本，但 .git 指向原仓库的 .git 目录，不重复存储对象。
如果你不想新建分支，只想基于当前分支（如 main）创建副本，改用：git worktree add ../my-api-worktree main。此时新目录与原项目处于同一分支，但文件修改互不影响。
在 Codex App 中关联并启用该 worktree
方法一：通过 Codex App 界面导入
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
启动 Codex macOS 应用 → 点击左上角 Projects → + New Project → 在弹窗中点击 Open Folder → 导航至你刚创建的 ../my-api-worktree 目录 → 选中并打开。
方法二：直接拖入 Dock 图标
这一步操作起来很简单，直接把 my-api-worktree 文件夹拖到 Codex 的 Dock 图标上，App 会自动识别为新 Project 并加载。
方法三：终端快速 Handoff（适用于已有线程）
如果你已在 Codex 中开启了一个线程，且想将当前任务“移交”到新 worktree 中处理：先在原 project 的线程界面点击右上角 ⋯ → 选择 Handoff to Worktree → 在列表中选中 my-api-worktree → 确认。Codex 会自动切换上下文，并在新 worktree 中重建相同线程状态。
验证隔离性与并行能力
第一步：在原项目目录中启动开发服务器（如 npm run dev），保持运行。
第二步：进入 my-api-worktree 目录，修改 src/api/user.ts 并保存。
第三步：回到 Codex App，打开该 worktree 对应的线程 → 点击底部 Terminal 标签页 → 输入 git status。你会看到只有 user.ts 被标记为 modified，且该状态【不会出现在原项目 git status 输出中】。
第四步：在 Codex 中对该线程执行 codex fork --last。命令将在 my-api-worktree 环境中运行，所有文件读写、命令执行、diff 生成均限定在此副本内，与前台开发环境彻底解耦。
