Git worktrees w Claude Code — praca równoległa bez konfliktów gałęzi

Klasyczny problem przy pracy z AI w kodzie: jesteś w trakcie dużego zadania, przychodzi pilna poprawka do zrobienia, a Ty masz niezacommitowane zmiany w połowie implementacji. Schowaj to do stasha, przejdź na inną gałąź, zrób fix, wróć — i modlisz się, że kontekst sesji przeżył tę podróż.

Git worktrees rozwiązują ten problem. Całkowicie.

Czym są git worktrees

Worktree to mechanizm samego gita — nie wynalazek Claude Code — który pozwala mieć kilka katalogów roboczych tego samego repozytorium naraz, każdy na innej gałęzi, każdy całkowicie niezależny. Żadnych stashów, żadnego przeskakiwania między gałęziami. Dwa katalogi, dwie gałęzie, dwa niezależne stany plików — jednocześnie.

Claude Code od początku 2026 roku integruje worktrees jako pierwszorzędny mechanizm do sesji równoległych. Aplikacja desktopowa (wydana w kwietniu 2026) automatycznie izoluje każdą sesję przez osobny worktree.

Jak uruchomić Claude Code z worktree

Flaga -w (lub --worktree) tworzy nowy worktree i uruchamia w nim sesję Claude Code:

claude -w feature/auth

Jeśli gałąź feature/auth już istnieje — Claude Code utworzy nowy katalog roboczy na tej gałęzi. Jeśli nie istnieje — gałąź zostanie utworzona automatycznie.

Katalog worktree pojawia się obok głównego repozytorium, zwykle jako:

projekt/
projekt-feature-auth/     ← nowy worktree

Możesz teraz otworzyć drugi terminal i pracować w obu miejscach jednocześnie. Zmiany w worktree nie wpływają na główny katalog roboczy — i odwrotnie.

Praktyczne zastosowania

Pilna poprawka w trakcie dużego zadania. Masz otwartą sesję na feature/payments. Pojawia się krytyczny bug na produkcji. Zamiast przerywać — otwierasz drugi terminal: claude -w hotfix/critical-bug. Dwie sesje, dwie gałęzie, żadnych kolizji.

Research równolegle z implementacją. Jeden worktree dla Claudea pracującego nad kodem, drugi dla Claudea analizującego architekturę lub dokumentację. Każdy w swoim kontekście, żaden nie przeszkadza drugiemu.

Eksperymenty bez ryzyka. claude -w experiment/new-approach — Claude może próbować agresywnego refaktoringu na osobnej gałęzi, podczas gdy główna sesja kontynuuje bezpieczną ścieżkę. Porównujesz wyniki i wybierasz lepsze podejście.

Praca nad kilkoma PR-ami naraz. Każdy PR na osobnym worktree, każdy z własną sesją Claude Code. Koniec z ciągłym przeskakiwaniem między gałęziami.

Worktrees a desktop app

Aplikacja desktopowa Claude Code (kwiecień 2026) poszła o krok dalej: każda nowa sesja otwierana przez GUI automatycznie dostaje własny worktree. Izolacja sesji jest domyślna, nie wymaga ręcznej konfiguracji.

Jeśli używasz CLI — flaga -w robi to samo ręcznie.

Kilka rzeczy wartych zapamiętania

Worktrees współdzielą historię gita i obiekty — nie duplikujesz całego repozytorium, tylko katalog roboczy. Zajmują stosunkowo mało miejsca na dysku.

Sprzątanie po sobie: po zakończeniu pracy worktree usuwa się jedną komendą:

git worktree remove ../projekt-feature-auth

Jedno ograniczenie: ta sama gałąź nie może być aktywna w dwóch worktrees jednocześnie. To oczywiste — gałąź to jeden stan, nie można jej być w dwóch miejscach naraz.

Kiedy warto sięgnąć po worktrees

Krótka odpowiedź: kiedy regularnie przerywasz sesję z powodu pilniejszych zadań, albo kiedy chcesz mieć Claude’a pracującego nad dwoma rzeczami bez wzajemnego wpływu na kontekst. Worktrees to nie funkcja dla każdego — ale kiedy jest potrzebna, zastępuje ją dokładnie nic innego.