1. 為什么 Worktree 并行跑 Claude Code 會(huì)翻車如果你同時(shí)推進(jìn)三四個(gè)任務(wù)又習(xí)慣用 Claude Code 幫你寫代碼大概率遇到過(guò)這種場(chǎng)面在feature/perf-opt分支讓 Claude Code 生成了一版 batch 優(yōu)化邏輯還沒(méi)提交運(yùn)維喊你緊急修 master 上的模型加載失敗。你git stash、切分支、改完、切回來(lái)、git stash pop結(jié)果 Claude Code 的上下文已經(jīng)亂了——它看到的文件內(nèi)容和你腦子里的邏輯對(duì)不上甚至把 A 分支的未提交改動(dòng)帶到了 B 分支生成一堆不屬于當(dāng)前任務(wù)的代碼。這不是 Claude Code 的鍋是「單工作目錄 頻繁切分支」這個(gè)組合本身的問(wèn)題。Claude Code 會(huì)記住當(dāng)前工作區(qū)的文件狀態(tài)、對(duì)話里提到的變量名、你讓它改過(guò)的函數(shù)。切分支時(shí)這些上下文不會(huì)自動(dòng)重置未提交的改動(dòng)還會(huì)跟著你跑。Worktree 隔離開發(fā)就是來(lái)解決這個(gè)的每個(gè)分支擁有獨(dú)立的物理工作目錄每個(gè)目錄里跑一個(gè) Claude Code 實(shí)例上下文和文件狀態(tài)天然隔離互不干擾。但這里有個(gè)容易被忽略的環(huán)節(jié)多個(gè) Claude Code 實(shí)例如果各自配 Key、各自填 Base URL管理成本會(huì)爆炸。我試過(guò)在三個(gè) worktree 里分別配不同的 Key結(jié)果月底對(duì)賬時(shí)完全分不清哪個(gè)任務(wù)花了多少。所以這篇的視角是 Agent / Harness——Worktree 負(fù)責(zé)隔離工作目錄和上下文TaoToken 負(fù)責(zé)讓所有實(shí)例共用同一把 Key 和同一個(gè) Base URL調(diào)用統(tǒng)一記在一個(gè)賬戶上。兩者職責(zé)不重疊配合起來(lái)才順。2. 前置準(zhǔn)備一把 TaoToken Key 喂飽所有 worktreeWorktree 本身不改任何隔離邏輯它只是給每個(gè)分支開一個(gè)獨(dú)立目錄。真正需要統(tǒng)一的是 Claude Code 的接入配置。你不需要在每個(gè) worktree 里重復(fù)注冊(cè)、重復(fù)配 Key只需要在 TaoToken 創(chuàng)建一個(gè) Key然后把 Claude Code 的 Base URL 指向https://taotoken.net/api。具體操作打開 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 創(chuàng)建賬號(hào)進(jìn)控制臺(tái)生成一把 API Key。這把 Key 會(huì)被所有 worktree 里的 Claude Code 共用。如果你還沒(méi)生成直接去 API Keys 頁(yè)面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite創(chuàng)建好 Key 之后Claude Code 的配置有兩種方式環(huán)境變量或者配置文件。我推薦環(huán)境變量因?yàn)?worktree 目錄是獨(dú)立的但 shell 環(huán)境是共享的配一次全局生效不用在每個(gè)目錄里重復(fù)寫。# 在 ~/.bashrc 或 ~/.zshrc 里加這兩行 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEYsk-你的TaoTokenKey配完之后source ~/.zshrc生效。這樣無(wú)論你在哪個(gè) worktree 目錄里啟動(dòng)claude它都會(huì)走 TaoToken 的 Base URL用同一把 Key。工作目錄和上下文仍然按 worktree 隔離但調(diào)用入口是統(tǒng)一的。注意Base URL 填https://taotoken.net/api不要多加/v1之類的后綴Claude Code 會(huì)自己拼接路徑。填錯(cuò)了會(huì)報(bào) 404 或者連接被拒。如果你用的是 Claude Code 的配置文件方式可以在~/.claude/settings.json里寫{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoTokenKey } }兩種方式選一種就行別同時(shí)配否則環(huán)境變量?jī)?yōu)先級(jí)更高容易搞混。配好后可以用claude --version確認(rèn) CLI 能正常啟動(dòng)但真正驗(yàn)證接入是否成功要等下一步在 worktree 里發(fā)請(qǐng)求。3. 可復(fù)制配置三個(gè) worktree 的完整搭建流程假設(shè)你的主倉(cāng)庫(kù)叫ml-serving當(dāng)前在 master 分支?，F(xiàn)在要并行處理三個(gè)任務(wù)熱修復(fù)模型加載失敗、性能優(yōu)化、ONNX 格式支持。先創(chuàng)建三個(gè) worktree# 確保主倉(cāng)庫(kù)干凈先提交或 stash 當(dāng)前改動(dòng) cd /path/to/ml-serving git status # 創(chuàng)建三個(gè) worktree路徑用 ../項(xiàng)目名-任務(wù)名 的命名方式 git worktree add ../ml-serving-hotfix hotfix/model-loading git worktree add ../ml-serving-perf feature/perf-opt git worktree add ../ml-serving-onnx feature/onnx-support # 查看所有 worktree確認(rèn)創(chuàng)建成功 git worktree list輸出應(yīng)該類似/path/to/ml-serving e3f2a1d [master] /path/to/ml-serving-hotfix a1b2c3d [hotfix/model-loading] /path/to/ml-serving-perf b4c5d6e [feature/perf-opt] /path/to/ml-serving-onnx c7d8e9f [feature/onnx-support]這里有個(gè)坑worktree 路徑不能和主倉(cāng)庫(kù)重疊否則 git 會(huì)報(bào)fatal: ../ml-serving-hotfix is a main working tree。用../項(xiàng)目名-任務(wù)名的命名方式既避免重疊又一目了然。接下來(lái)在每個(gè) worktree 目錄里啟動(dòng) Claude Code。因?yàn)榍懊嬉呀?jīng)配好了全局環(huán)境變量這里不需要任何額外配置# 終端 1熱修復(fù) cd ../ml-serving-hotfix claude # 終端 2性能優(yōu)化 cd ../ml-serving-perf claude # 終端 3ONNX 支持 cd ../ml-serving-onnx claude三個(gè)終端各跑一個(gè) Claude Code 實(shí)例每個(gè)實(shí)例只看自己 worktree 目錄里的代碼。熱修復(fù)那個(gè)實(shí)例不知道 perf 分支上有什么改動(dòng)perf 實(shí)例也看不到 onnx 分支的代碼。上下文完全隔離但三個(gè)實(shí)例的 API 調(diào)用都走同一把 TaoToken Key。如果你想讓每個(gè) worktree 有自己的任務(wù)說(shuō)明可以在每個(gè)目錄根放一個(gè).claude.md# 當(dāng)前任務(wù)修復(fù)模型加載失敗 - 分支hotfix/model-loading - 目標(biāo)定位 protobuf 版本兼容問(wèn)題并修復(fù) - 約束不改動(dòng)推理核心邏輯只修加載路徑這樣即使隔了一周再回到這個(gè) worktreeClaude Code 也能快速恢復(fù)上下文。這個(gè)文件是 per-worktree 的不會(huì)串到別的分支。4. 驗(yàn)證請(qǐng)求確認(rèn)三個(gè)實(shí)例各看各的代碼配置完不代表接入成功得實(shí)際發(fā)請(qǐng)求驗(yàn)證。驗(yàn)證分兩層第一層確認(rèn) Claude Code 能通過(guò) TaoToken 正常調(diào)用模型第二層確認(rèn)每個(gè) worktree 的上下文確實(shí)隔離。第一層驗(yàn)證在任意一個(gè) worktree 里啟動(dòng) Claude Code 后直接問(wèn)一個(gè)簡(jiǎn)單問(wèn)題cd ../ml-serving-hotfix claude # 在 Claude Code 交互界面里輸入 # 當(dāng)前目錄下有哪些文件列出前 10 個(gè)如果 Claude Code 能正常返回文件列表說(shuō)明 Base URL 和 Key 都配對(duì)了請(qǐng)求成功走到了 TaoToken。如果報(bào)401 Unauthorized檢查 Key 是否復(fù)制完整如果報(bào)404檢查 Base URL 是不是多寫了路徑。第二層驗(yàn)證在三個(gè) worktree 里分別發(fā)起一個(gè)能暴露上下文的請(qǐng)求。比如在每個(gè) worktree 里讓 Claude Code 讀一個(gè)只屬于該分支的文件# 在 hotfix worktree 里 # 讓 Claude Code 讀取 hotfix 分支特有的修復(fù)文件 # 輸入讀取 src/model_loader.py 的前 20 行告訴我它引用了哪個(gè)版本的 protobuf # 在 perf worktree 里 # 輸入讀取 src/batch_processor.py告訴我當(dāng)前的 batch size 是多少 # 在 onnx worktree 里 # 輸入讀取 src/onnx_converter.py告訴我它支持哪些算子關(guān)鍵觀察點(diǎn)hotfix 實(shí)例讀到的model_loader.py應(yīng)該是 hotfix 分支的版本perf 實(shí)例讀到的batch_processor.py應(yīng)該是 perf 分支的版本。如果 hotfix 實(shí)例讀到了 perf 分支才有的 batch 優(yōu)化代碼說(shuō)明 worktree 隔離沒(méi)生效大概率是你cd錯(cuò)了目錄或者 worktree 創(chuàng)建時(shí)分支指定錯(cuò)了。實(shí)測(cè)下來(lái)三個(gè)實(shí)例各自返回自己分支的文件內(nèi)容互不串?dāng)_。同時(shí)打開 TaoToken 控制臺(tái)的用量頁(yè)面能看到三個(gè)實(shí)例的調(diào)用都記在同一個(gè)賬戶下按時(shí)間排列。這就是「隔離 統(tǒng)一」的效果工作目錄和上下文按 worktree 隔離調(diào)用入口和計(jì)費(fèi)按 TaoToken 統(tǒng)一。5. 本篇常見錯(cuò)排查5.1 Claude Code 報(bào) 401 或 403最常見的原因是 Key 沒(méi)配對(duì)。先確認(rèn)環(huán)境變量是否生效echo $ANTHROPIC_API_KEY echo $ANTHROPIC_BASE_URL如果輸出為空說(shuō)明 shell 配置沒(méi) source或者你寫在了錯(cuò)誤的配置文件里。如果你用的是 zsh檢查~/.zshrcbash 檢查~/.bashrc。另外確認(rèn) Key 沒(méi)有多余空格復(fù)制時(shí)容易帶上換行。5.2 worktree 創(chuàng)建失敗路徑已存在git worktree add報(bào)fatal: ../ml-serving-hotfix already exists說(shuō)明目錄已經(jīng)存在。要么換個(gè)路徑名要么先刪掉舊目錄。如果舊目錄是之前創(chuàng)建的 worktree用git worktree remove ../ml-serving-hotfix清理別直接rm -rf否則 git 的 worktree 記錄會(huì)殘留。5.3 在 worktree 里 push 污染遠(yuǎn)程引用原文提到不要在 worktree 里直接git push。正確做法是回到主倉(cāng)庫(kù)用git fetch . worktree/perf-opt:feature/perf-opt把 worktree 的提交拉到主倉(cāng)庫(kù)再正常 push。如果你已經(jīng)在 worktree 里 push 了遠(yuǎn)程分支可能多了一個(gè)引用去遠(yuǎn)程倉(cāng)庫(kù)刪掉對(duì)應(yīng)分支再重新走流程。5.4 三個(gè)實(shí)例的調(diào)用混在一起分不清如果你在 TaoToken 控制臺(tái)看到調(diào)用記錄但分不清哪個(gè)是哪個(gè)任務(wù)可以在每個(gè) worktree 的.claude.md里約定一個(gè)任務(wù)標(biāo)識(shí)讓 Claude Code 在每次對(duì)話開頭帶上這個(gè)標(biāo)識(shí)?；蛘吒?jiǎn)單按時(shí)間順序?qū)嵝迯?fù)通常最先完成perf 和 onnx 耗時(shí)更長(zhǎng)。長(zhǎng)期來(lái)看如果你要跑大量并行任務(wù)可以考慮用 Coding Plan 來(lái)管理調(diào)用配額https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite5.5 worktree remove 失敗有未提交修改git worktree remove在有未提交改動(dòng)時(shí)會(huì)拒絕執(zhí)行。先cd進(jìn)那個(gè) worktreegit status看有什么改動(dòng)提交或 stash 后再 remove。如果確認(rèn)不要了用--force強(qiáng)制刪除但建議先確認(rèn)沒(méi)有重要代碼。6. 把 Key 統(tǒng)一到 TaoTokenWorktree 只管隔離回到最初的問(wèn)題Worktree 解決的是「多任務(wù)并行時(shí)工作目錄和上下文隔離」TaoToken 解決的是「多個(gè) Claude Code 實(shí)例的接入統(tǒng)一」。兩者配合的完整工作流是每個(gè)任務(wù)一個(gè) worktree每個(gè) worktree 一個(gè) Claude Code 實(shí)例所有實(shí)例共用一把 TaoToken Key 和同一個(gè) Base URL。你拿到 Key 后能完整復(fù)現(xiàn)原文的 EnterWorktree / ExitWorktree 流程創(chuàng)建 worktree、在目錄里啟動(dòng) Claude Code、讓每個(gè)實(shí)例只看自己分支的代碼、完成后回主倉(cāng)庫(kù)合并、清理 worktree。區(qū)別只在于原來(lái)在每個(gè) worktree 目錄直接啟動(dòng)claude的那一步現(xiàn)在變成了先配好 TaoToken 的 Base URL 和 Key再啟動(dòng)。多個(gè)實(shí)例的調(diào)用統(tǒng)一記在 TaoToken 賬戶上對(duì)賬和配額管理都省事。如果你還沒(méi)創(chuàng)建 Key去 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 生成一把。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有 Base URL 和參數(shù)的完整說(shuō)明。想先驗(yàn)證模型能不能通可以直接用模型對(duì)話頁(yè)面發(fā)一條測(cè)試請(qǐng)求https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite最后給一個(gè)實(shí)用建議worktree 數(shù)量控制在 3 到 5 個(gè)。超過(guò)這個(gè)數(shù)你的大腦會(huì)開始混淆哪個(gè)目錄對(duì)應(yīng)哪個(gè)任務(wù)。我試過(guò)同時(shí)開 7 個(gè)結(jié)果在錯(cuò)誤的目錄里改了半小時(shí)代碼。給 worktree 目錄名加上任務(wù)關(guān)鍵詞比如../ml-serving-hotfix、../ml-serving-perf比純分支名好認(rèn)。熱修復(fù)永遠(yuǎn)用 worktree這是它最高頻也最救命的場(chǎng)景——線上出問(wèn)題時(shí)你不需要停下手中的工作新建一個(gè) worktree修完刪掉全程不影響主工作區(qū)。