Worktrees — równoległe sesje bez kolizji
Worktree to osobny katalog roboczy z własnymi plikami i gałęzią, który współdzieli z głównym checkoutem historię repozytorium oraz zdalne repozytorium. Dzięki temu jedna sesja może pracować nad funkcją, a druga naprawiać błąd, bez edytowania tych samych kopii plików. Flaga --worktree tworzy izolowany worktree; domyślnie trafia on do .claude/worktrees/<name>/ i dostaje gałąź worktree-<name>.
Uruchom claude --worktree z nazwą, aby rozpocząć sesję w nowym worktree. Aby uruchomić kolejną odizolowaną sesję, powtórz polecenie w innym terminalu, podając inną nazwę. Jeśli pominiesz nazwę, Claude wygeneruje ją automatycznie. Sesja interaktywna wymaga wcześniejszego zaakceptowania zaufania do katalogu, natomiast uruchomienie nieinteraktywne z -p pomija tę kontrolę.
Po zakończeniu sesji interaktywnej Claude sprawdza, czy usunięcie worktree skasowałoby zmiany, nieśledzone pliki, niezacommitowaną pracę w submodułach lub nowe commity. Jeśli worktree zawiera pracę, Claude pyta, czy go zachować, czy usunąć; zachowanie pozostawia katalog i gałąź do późniejszego wznowienia. Wznowienie zachowanej sesji odbywa się poleceniem claude --worktree <name> --resume, które Claude Code wypisuje przy wyjściu. Uruchomienia nieinteraktywne nie wyświetlają pytania przy wyjściu i same nie sprzątają worktree.
Izolacja blokuje edycje kierowane do głównego checkoutu, polecenia uruchamiane w jego katalogu oraz polecenia przekierowujące operacje gita do głównego checkoutu. Claude blokuje też polecenia, których tekstu nie potrafi zweryfikować pod kątem operacji gita w worktree, i nie można wyłączyć tej kontroli. Ograniczenie nie śledzi jednak plików zapisywanych przez polecenia powłoki, więc zapis do głównego checkoutu bez uruchomienia tam gita nie zostanie przez te kontrole odrzucony. Możesz też izolować subagentów we własnych worktree, prosząc Claude o użycie worktree dla agentów albo ustawiając isolation: worktree w konfiguracji subagenta.
feature-auth i rozpocznij w nim sesję Claude.claude --worktree feature-auth
# w cudzysłowie.claude --worktree "#1234"
--resume.claude --worktree <name> --resume
Zastosowanie w praktyce
Użyj osobnych nazw worktree, gdy chcesz prowadzić równolegle pracę nad funkcją i naprawą błędu w oddzielnych sesjach. Wskaż numer pull requestu lub adres pull requestu albo merge requestu, gdy nowy worktree ma bazować na konkretnej zmianie. Dla subagentów wykonujących równoległe edycje ustaw własne worktree, aby ich zmiany nie kolidowały. Jeśli sesję w worktree przeniesiesz do tła, pamiętaj, że okresowe sprzątanie może usunąć jej worktree, gdy nie ma w nim pracy do zachowania.
.claude/worktrees/ do .gitignore, aby zawartość worktree nie pojawiała się w głównym checkoutcie jako nieśledzone pliki.