用 Git Worktree 打造 Claude Code 的平行開發工作流

在使用 Claude Code 進行實務開發一段時間後，你很快會遇到一個瓶頸：

「我想同時讓 Claude 幫我做多件互不相關的事情，但它們會互相干擾。」

例如：

• 一邊重構 Authentication Flow
• 另一邊新增完全無關的 Data Visualization
• 或同時修 Bug、跑 Lint、寫測試

如果都在 同一個 Git working directory 進行，不只容易衝突，也會降低 Claude 的效率。

這時候，Git Worktree 就會成為 Claude Code 的最佳拍檔。

為什麼 Git Worktree 非常適合 Claude Code？

Git worktree 允許你從同一個 repo（.git 資料夾）建立多個工作目錄，每個工作目錄都可以 checkout 不同 branch。
它們共用同一份版本歷史，不會佔很多空間。

這是一種比開多個 repo clone 更輕量、也更乾淨的做法。

傳統做法的問題

你現在在 branch feature/A 開發

同事說 production 有 bug，要你馬上修 (hotfix/B)
如果沒有 worktree，你要：

git stash
git checkout hotfix/B

這是後讓Claude繼續執行會造成Context混亂、git status一堆變動

這樣的做法其實是「單工環境，硬做多工」。

Git Worktree × Claude Code 的理想工作流

使用情境

• 多個彼此獨立的任務
• 任務之間幾乎不會改同一批檔案
• 希望 Claude 能「一路跑到底、不被打斷」

例如：

Worktree	任務
feature-auth	重構登入與權限
feature-chart	建立圖表元件
chore-lint	修 ESLint / Prettier

Step 1：建立 Git Worktree

假設你的主專案在：

~/projects/my-app

新增一個 worktree：

git worktree add ../my-app-feature-auth feature-auth

你會得到：

projects/
├─ my-app                (main)
├─ my-app-feature-auth   (feature-auth)

有了 worktree：

你就多了一個資料夾 ../my-app-feature-auth 可以讓多個Cladue跑在不同環境下寫程式，就很像同時跟多個工程師協助一樣的意思，彼此有各自獨立的任務，然後也不會互相干擾。

Step 2：在每個 Worktree 啟動 Claude

cd ../my-app-feature-auth
claude

接著：

• 在 另一個 terminal tab
• 建立另一個 worktree
• 再啟動另一個 Claude

git worktree add ../my-app-feature-chart feature-chart
cd ../my-app-feature-chart
claude

此時你就有：

多個 Claude
各自專注一個 branch
完全平行開發

為什麼這對 Claude 特別重要？

Claude Code 的核心是：

• 讀取目前目錄的檔案
• 建立「對專案的理解」
• 在同一個 context 中推理與修改

Git Worktree = 給 Claude 一個乾淨的大腦

它不需要理解：

• 另一個任務的中間狀態
• 尚未完成的實驗性程式碼
• 一堆暫存但其實無關的修改

結果就是：

• 推理更穩定
• 修改更精準
• 幾乎不會「改錯地方」

實戰建議

命名規則一致

my-app-feature-auth
my-app-feature-payment
my-app-chore-lint

你一眼就知道哪個 Claude 在做什麼。

一個 Worktree = 一個 Terminal Tab

不同 Worktree，用不同 IDE Window

不要共用同一個 VS Code 視窗
否則你會搞混 branch 與檔案狀態。

任務完成後，乾淨收尾

git worktree remove ../my-app-feature-auth

這個動作可以讓：

不會刪 branch
不會影響其他 worktree
環境立刻回收

然後保留已經調整完的feature分支，之後可以回到主要分之把它進行合併。

什麼時候「不」適合用 Worktree？

不建議用在：

• 同一個功能拆成很多小步驟
• 需要頻繁互相修改同一批檔案
• 任務高度耦合

這時候，單一 Claude + 明確指令 反而更有效。

結語：把 Claude 當成你的平行工程團隊

Git Worktree 本來是為了 人類工程師的多工開發 而生，
但在 Claude Code 時代，它的價值被放大了。

每個 Worktree = 一位不會分心的 Claude

如果你常覺得：

• Claude 很聰明，但容易被上下文影響
• 多任務時效率不如預期

那麼，試試這個組合：

Claude Code × Git Worktree

你會發現——
不是 Claude 不夠強，是你的工作流還沒進化。