Codex Worktree怎么用？独立任务、起始分支与Handoff交接核对

你正在本地修改页面，同时又想让Codex尝试另一种实现，直接让两个聊天改同一目录容易互相覆盖。Worktree为同一Git仓库提供独立工作副本。本教程用一个练习按钮文案任务说明如何选择起点、核对隔离效果、检查成果，再决定留在副本还是交接回本地，不把创建副本当成自动合并。

第一步：确认是Git项目并记录现状

官方说明Worktree依赖Git仓库，代码和命令运行在项目所在电脑或远程开发环境。手机只是控制连接电脑上的Codex，并不会在手机内创建本地仓库。开始前保存文件，确认当前分支和未提交改动，给重要修改留一份可恢复备份。

普通同目录多聊天共享文件，Worktree则有独立检出和工作区，但共享仓库的提交、分支等Git元数据。隔离工作文件不代表隔离一切外部资源；两个任务若连接同一个测试数据库或线上服务，仍可能互相影响，因此练习先限定只改本地文件。

第二步：选择起始分支与任务范围

在桌面新聊天输入区下方选择Worktree，再选起始分支。官方可从主分支、功能分支，或带当前本地改动的状态开始。先确认自己想包含哪些未提交修改，不要凭默认分支名称猜测起点。提交任务后，Codex创建工作副本，默认可能处于detached HEAD状态。

在新worktree内仅调整练习页面的按钮文案，不修改接口、数据库和部署设置。开始前报告工作目录、起始提交、是否含已有未提交改动。完成后列出改动文件与验证结果，先保留在worktree，不推送、不合并，也不覆盖我原目录中的修改。

第三步：核对副本和环境可用性

先查看报告的工作目录，确保与原检出不同，再打开两边同一个练习文件，确认只有副本发生预期变化。依赖和本地配置可能没有随Git文件一起准备好，先用项目约定的安装与启动方法，不要把启动失败直接解释成代码有错。

官方支持通过本地环境设置脚本准备依赖。被Git忽略的配置不会一般性地自动随交接移动；本地托管worktree可按.worktreeinclude规则复制指定忽略文件。只选择确实需要的配置，不把包含真实密钥的所有文件无差别复制到每个实验副本。

第四步：选定保留或交接方式

若准备一直在worktree验证，可以通过聊天顶部Create branch here建立分支，再按团队流程提交与审阅。若希望回自己的常用环境测试，选择Hand off移动到Local，由应用处理所需Git操作。交接包含聊天和代码状态，不等于代码已被审核或推送。

交接前请给出摘要：起始提交、当前分支或detached状态、已修改文件、未跟踪文件、验证方式，以及需要另外准备的忽略配置。不要删除任何副本。交接后重新确认本地目录中的差异，与这份清单逐项比较。

第五步：处理分支占用和清理

Git不允许同一分支同时在两个worktree检出。若看到already used by worktree，先检查该分支所在副本，不要强制删除目录或重置分支。准备转回本地时优先使用Handoff；确需手工操作时先保存成果，再按实际Git状态处理。

完成后审查最终差异，确认原本未提交内容没有丢失，再归档不需要的任务。Codex托管worktree清理前有恢复快照机制，但忽略文件和环境仍需单独留意。验收标准是任务在独立目录执行、起点明确、成果可检查、交接后变化一致，且没有因清理而丢掉未保存资料。

官方资料

资料核对日期：2026年10月31日。

• OpenAI：Worktrees与Handoff