一個人的工程團隊:Claude Code 平行作業完整指南
2026 年初,Boris Cherny——Claude Code 的創造者——分享了一套讓開發者社群關注的工作流:他在終端機同時跑 5 個 Claude Code session,搭配瀏覽器和行動裝置上的額外 session,總計可達 10-15 個並行工作流。這套做法揭示了一個多數人從未想過的可能性。
大多數人用「單線程」思維在使用 Claude Code,等同於雇了一個工程師卻只讓他一次做一件事。如果你每天等 Claude 完成一個任務才開始下一個,你浪費的不是時間,是整個工作流的槓桿。這篇指南從決策框架到實際設定,完整拆解平行作業工作流,讓一個開發者發揮小型工程團隊的吞吐量。
TL;DR
- 平行 3-5 個 worktree 是 Boris 本人的直接建議,加上網頁 session 可達 10-15 個
- 決策原則:只有任務之間完全獨立、不共用核心檔案,才適合平行
claude --worktree [name]一行指令建立完全隔離的工作環境- CLAUDE.md 三層架構(全局 / 專案 / 任務)是平行作業保持一致性的大腦
- Claude Code hooks 搭配 iTerm2 通知,讓你不需要盯著每個 terminal tab,Claude 完成或卡住時自動提醒
為什麼 Claude Code 的創造者同時跑 15 個 session?
Boris Cherny 在 X 分享的原文是這樣描述的:他在終端機透過 5 個 Git checkouts 同時跑 5 個 Claude Code session,同時透過 claude.ai/code 網頁版跑 5-10 個附加 session,加上手機上的 session,總計接近 10-15 個並行工作流。這條貼文在開發者社群廣泛流傳。
他把這個做法稱為「最大的單一生產力解鎖(single biggest productivity unlock)」,而且這是整個 Claude Code 開發團隊票選的第一名技巧,不是他個人偏好。
核心哲學只有一句話:「減少干預 + 更好的工具使用 = 更快的整體結果」。
傳統開發思維是序列的——完成 A,再做 B,再做 C。但 Claude Code 不是一個會累的工程師,它可以同時在多個獨立問題上全力推進,而你只需要在關鍵節點介入。Boris 的另一個核心做法是搭配 Plan Mode:先用 Plan Mode 細化每個任務的策略和邊界,確認方向後再啟動多個 session 平行執行,而非反覆來回修正。這讓他能夠「放心讓 Claude 跑,不需要隨時盯著」。
我在 Shareuhack 自己的 autonomous content system 中也驗證了同樣的模式:同時跑 scout、research、writer、social 四個獨立 worker,每個負責完全不同的任務,整體吞吐量提升了 3-4 倍。
哪些任務值得平行?四象限決策框架
平行作業不是「越多越好」,而是「對的任務才平行」。我整理了一個判斷框架:
問三個問題:
- 這個任務完成的前提,是否仰賴另一個進行中的任務?(有相依性 → 不適合)
- 多個任務是否需要修改同一組核心檔案?(有共用狀態 → 不適合)
- 每個任務的邊界是否清楚到可以用一句話說明?(邊界模糊 → 先拆分再平行)
三題都通過才啟動平行。
適合平行的任務:
- 多個獨立的功能開發(Feature A 和 Feature B 用不同檔案)
- 單元測試撰寫(幾乎不相依)
- 文件生成(完全獨立)
- 分散在不同模組的 bug 修復
- 大規模程式碼遷移(按目錄分批)
不適合平行的任務:
- 任務 B 需要任務 A 的輸出(例如:先重構 API,再更新前端)
- 多個 agent 同時修改
config.ts或共用的核心 utility - 整體架構層級的設計決策(需要人類保持主控視角)
incident.io 的工程團隊實際案例是很好的參考:他們同時跑 4-5 個 agent,分別負責 UI 改善、build 工具優化、測試規格撰寫、後端 feature——每個任務都在自己的檔案領域,沒有交疊。
一鍵建立隔離環境:git worktree + --worktree flag 實戰
為什麼需要 worktree?
平行跑多個 Claude Code session,最大的風險是多個 session 在同一個 working directory 上互相覆蓋。git worktree 的作用是讓每個任務在自己的目錄裡工作,有自己的 branch,完全隔離。
官方 --worktree flag(推薦)
Claude Code CLI 有內建的 --worktree 支援,一行指令搞定:
# 建立名為 feature-auth 的隔離 worktree 並啟動 Claude
claude --worktree feature-auth
# 同時開另一個 session
claude --worktree bugfix-payment
# 不指定名稱,Claude 自動產生(如 bright-running-fox)
claude --worktree
這行指令會:
- 在
<repo>/.claude/worktrees/<name>/建立新的工作目錄 - 建立 branch
worktree-<name>,從預設 remote branch 分支 - 在隔離目錄裡啟動 Claude Code session
Session 結束時:若 worktree 沒有任何修改,自動清除;若有 commit,Claude 會詢問你是否保留。
建議在 .gitignore 加入:
.claude/worktrees/
避免主 repo 出現大量 untracked files。
手動 git worktree(需要更精細控制時)
# 建立新 branch + worktree
git worktree add ../project-feature-a -b feature-a
# 在 worktree 啟動 Claude
cd ../project-feature-a && claude
# 完成後清除
git worktree remove ../project-feature-a
Plan Mode 搭配使用
啟動多個 worktree session 之前,先進入 Plan Mode(Shift+Tab 切換,或 claude --permission-mode plan)為每個任務確認方向。Plan Mode 下 Claude 不會執行任何檔案修改,只規劃策略,確認 scope 清晰後再切換到執行模式——這樣你就能放心讓多個 session 在背景跑,不用擔心未授權的修改。
CLAUDE.md 三層架構:讓每個平行 session 都懂規則
多個 worktree 同時跑,每個 session 都需要理解「這個專案的規則是什麼」。CLAUDE.md 的三層架構就是解決這個問題的核心設計。
第一層:全局層(~/.claude/CLAUDE.md)
這是你的個人設定,所有 session 都載入,不進 git。適合放:
- 個人程式碼風格偏好
- 個人常用工具和快捷指令
- 個人工作習慣
重要:保持極度精簡,每個 session 都會完整載入這個檔案,太長會消耗 context。我個人建議不超過 50 行。
第二層:專案層(./CLAUDE.md 或 ./.claude/CLAUDE.md)
這是團隊共享的規範,進 git,讓所有協作者和所有 worktree 共享:
- 架構決策和設計原則
- Build 指令、測試指令
- 命名慣例、目錄結構
- 常用 workflow 的說明
Shareuhack 的專案層 CLAUDE.md 放的就是整個內容 pipeline 的規則:每個 Agent 做什麼、禁止事項、frontmatter 規範——讓每個平行跑的 agent 都清楚邊界。
第三層:任務層(.claude/rules/ 目錄)
這是最細粒度的設定,可以把規則綁定到特定檔案路徑:
---
description: API 路由層規範
paths:
- "src/api/**/*.ts"
---
# API 路由規則
- 所有端點必須有 Zod 驗證
- 錯誤回應格式統一用 { error: string, code: string }
這個規則只在 Claude 開啟 src/api/**/*.ts 路徑的檔案時才載入,避免污染其他任務的 context。
跨 worktree 的記憶:所有 worktree 共享同一個 auto memory 目錄(~/.claude/projects/<git-repo>/memory/),所以 Claude 在一個 worktree 學到的東西,在另一個 worktree 也能用。
實用建議:官方建議每個 CLAUDE.md 盡量保持在 200 行以內,超過這個長度遵循度會下降。詳細說明建議拆成 agent_docs/ 子目錄的獨立 .md 檔案,主 CLAUDE.md 用 @agent_docs/api-rules.md 語法按需引入。
不在 10 個 Tab 裡迷失:Session 管理與通知機制
同時管理多個 session,最大的挑戰不是技術設定,而是「我要怎麼知道哪個完成了,哪個卡住需要我介入」。
Claude Code hooks 通知機制
Claude Code 的 hooks 功能可以在 session 完成或需要確認時自動執行指令,搭配系統通知即可解決多 session 管理問題。在 ~/.claude/settings.json 設定:
{
"hooks": {
"Stop": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e \"display notification 'Claude 完成任務' with title 'Claude Code'\" && afplay /System/Library/Sounds/Glass.aiff",
"async": true
}
]
}
],
"PermissionRequest": [
{
"matcher": "",
"hooks": [
{
"type": "command",
"command": "osascript -e \"display notification '需要你的確認' with title 'Claude Code 等待'\" && afplay /System/Library/Sounds/Ping.aiff",
"async": true
}
]
}
]
}
}
Stophook:Claude 完成一個回應時觸發,用來通知「任務完成」PermissionRequesthook:Claude 需要人工確認時觸發,用來通知「有 session 卡住等你」
設定 "async": true 避免 hook 阻塞 session 的執行。
命名和狀態追蹤
worktree 命名即任務描述:用有意義的名稱,例如 feature-auth、bugfix-payment,而不是 worktree-1、worktree-2。這樣在終端機分頁上一眼就能看出每個 session 在做什麼。
自訂 /worktree-status 指令:jackle.pro 的做法是在 CLAUDE.md 定義一個 slash command,一次列出所有 worktree 的 git 狀態:
# 在 CLAUDE.md 或 slash command 中定義
git worktree list && for wt in $(git worktree list --porcelain | grep worktree | awk '{print $2}'); do echo "=== $wt ==="; git -C $wt status --short; done
Boris 的 iTerm2 做法:用 iTerm2 的編號分頁管理多個 session,並在 iTerm2 設定「需要輸入時鳴響」。--name flag 可以給 session 命名便於識別:
claude --worktree feature-auth --name "auth-worker"
決定何時介入
我的個人原則:啟動 session 後,在第一個 5 分鐘 checkpoint 看一下進展,確認 Claude 的方向正確再讓它繼續跑。之後每 15-20 分鐘掃描一次,依賴 hooks 通知處理完成或卡住的情況。不要在 Claude 執行中途不斷打斷,這反而會降低整體品質。
立刻試試看:今天就打開你的第二個 session
平行作業不是 power user 的特技,而是讓 Claude Code 物盡其用的正確姿勢。如果你已經在用 Claude Code,你現在已經有所有需要的工具了。
最快的上手方式:找一個你手邊可以拆成 3 個獨立任務的專案,用上面的決策框架驗證這 3 個任務彼此獨立,然後:
claude --worktree task-a # 第一個 terminal tab
claude --worktree task-b # 第二個 terminal tab
claude --worktree task-c # 第三個 terminal tab
給每個 session 清楚的任務說明,啟動,然後去喝杯咖啡。等 hooks 通知響了再回來。
如果你同時管理多個 AI Agent,可以參考 herdr 終端機多工器指南,在一個視窗裡看到所有 Agent 的狀態。
這就是 Boris 工作的方式,也可以是你工作的方式。
FAQ
Claude Code Max 方案適合平行作業嗎?token 成本怎麼算?
Max 方案有更高的 token 配額和速率限制,非常適合同時跑多個 session。以每月固定費率換取高用量配額,平行作業讓單位時間產出大幅提升,整體 CP 值比 Pro 方案更高。如果你每天用 Claude Code 超過 2 小時,Max 幾乎是必然的選擇。
平行 worktree 開發容易造成 git 合併衝突嗎?
如果每個 worktree 負責完全獨立的功能或檔案,衝突機率很低。關鍵是在拆分任務時就確保邊界清晰,避免多個 session 同時修改同一個核心模組。官方 --worktree flag 自動為每個 worktree 建立獨立 branch,天然隔離合併風險。
什麼時候用平行 session + worktree?什麼時候用 Agent tool 的 subagent?
worktree 適合需要持久化代碼變更的長時間任務(幾十分鐘到數小時);subagent 適合在單一 session 內執行短暫的研究、搜尋或分析任務(幾分鐘內完成)。兩者可以結合:每個 worktree 內的 session 也可以使用 Agent tool 啟動子任務處理輔助工作。
這篇文章對你有幫助嗎?



