git worktree 管理器
适用于 Claude Code、Codex 和每一个代理 CLI

git worktree 是同一个仓库的第二个检出，有自己的文件夹和自己的分支，与你的主检出共享历史和远程仓库。给每个 AI 编程代理一个 worktree，意味着每个代理都在编辑、构建和提交自己的那份文件副本，所以两个同时工作的代理永远不会互相覆盖，也不会在对方脚下切换分支。我们的博客有一篇更详细讲 git 这一面的指南：Git worktree：让多个 AI agent 并行工作而不互相冲突的基础。

是的。claude --worktree <名称>（或 -w）会在名为 worktree-<名称> 的分支上创建 .claude/worktrees/<名称>，复制 .worktreeinclude 中列出的被 git 忽略的文件，并在你退出时询问保留还是删除这个 worktree；子代理可以通过 isolation: worktree 在自己的 worktree 中运行。它不会安装你的依赖。在 AgentsRoom 中，你可以继续使用它，也可以让工单或代理来请求 worktree，这样还会把它准备好，并显示在「更改」标签页里（已在 Claude Code 2.1.299 上验证）。

Codex 应用支持：它在 $CODEX_HOME/worktrees 中以分离 HEAD 状态创建受管理的 worktree，复制 .worktreeinclude 中列出的被忽略文件，可以运行本地环境的设置脚本，保留最近的 15 个，并通过 Handoff 在 Local 和某个 worktree 之间移动对话。codex-cli 0.162.1 有一个 --worktree 参数，可以在一个新的受管理 worktree 中运行会话。AgentsRoom 给 Codex 代理分配 worktree 的方式和其他任何代理一样，从工单或「添加代理」窗口即可。

全部都可以：worktree 只是代理的工作目录，不管在里面运行的是哪个 CLI，所以 Claude、Codex、GitHub Copilot CLI、Cursor 以及另外 10 个代理 CLI 在其中的工作方式都一样。Kimi Code 和 Antigravity CLI 按确切路径信任文件夹；AgentsRoom 会在启动前把新的 worktree 登记为它们信任的文件夹，这样它们就不会停在信任确认问题上。

不需要。在新的 worktree 里启动第一个代理之前，AgentsRoom 会从主检出中复制与「从此检出复制的文件」匹配的被 git 忽略的文件（默认是所有 .env 文件），并运行根据根目录 lockfile 检测出的安装命令。两者都在「项目设置 > Git > 准备新的工作树」中设置，你可以在那里替换命令，例如 pnpm install && pnpm build:deps。worktree 中已存在的文件永远不会被覆盖。

打开「更改」标签页，在顶部的「工作树」选择器中选中这个 worktree：文件列表、diff、「审查」、「提交」、「拉取」和「推送」随后都作用于那个检出。对于工单，「任务完成后自动合并到当前分支」会在你把它标记为「已完成」时合并它的分支，而「工作完成时自动提交」（设置 > Backlog）会先提交代理留下的内容，让合并带上全部工作。

在项目内的 .worktrees/<branch>/ 下，从远程的默认分支创建，除非你在项目设置中设定了「工作树的基础分支」。这个文件夹会被加入克隆的 .git/info/exclude，而不是你的 .gitignore，所以它不会进入你的提交。worktree 从不会被自动删除：用完后用 git worktree remove 删除即可。

两者都可以。在手机上，「更改」页面有同样的「工作树」选择器；从手机启动一个请求了 worktree 的工单时，它会在 worktree 中运行，和其他工单一样由电脑负责准备。在 SSH 服务器上打开的项目，其 worktree 创建在服务器上，没有安装步骤。代理运行在远程主机上的本地检出不能使用 worktree，工单会告诉你这一点，而不是直接启动。