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，工單會告訴你這一點，而不是直接啟動。