Czym są Git worktrees?
Git worktrees to dodatkowe katalogi robocze jednego repozytorium: każdy ma własne pliki, indeks i bieżący branch lub commit, a wszystkie dzielą jedną historię w .git. Każdy równoległy agent dostaje jeden, więc ich edycje, instalacje i testy nie dotykają tych samych plików. Claude Code uruchamia worktree przez --worktree, Codex przez --worktree lub /worktree, a Cursor opisuje Worktrees jako izolowane checkouty Gita.
- Po angielsku
- Git worktrees
- Pierwsze wdrożenie
- Poziom 3, darmowy przewodnik
- Szukane też jako
- worktree, git worktree
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Dlaczego to ważne.
Trzech agentów w jednym checkoucie zderza się po cichu: formatter jednego przepisuje plik, który edytuje drugi, serwer deweloperski zajmuje następny wolny port, a testy przechodzą na serwerze sąsiada. Worktree na agenta rozdziela pliki. Nie rozdziela portów, baz danych, sekretów ani deployów, więc worktree nie jest sandboxem.
Jeden checkout albo po jednym
Trzech agentów przy trzech zadaniach: w jednym katalogu i w osobnym worktree każdy.
- Wspólne dla agentów
- Rozdzielone przez Git
- Na czym możesz polegać
Jeden checkout Wspólny
-
Układ
Trzej agenci, jeden katalog
Trzy terminale otwarte na tym samym checkoucie.
-
Kolizja
Formatter przepisuje plik, który edytuje inny agent
Serwer deweloperski drugiego agenta po cichu zajmuje następny wolny port.
-
Testy
Przechodzą na serwerze sąsiada
Testy end-to-end trzeciego agenta idą na serwerze drugiego.
-
Na czym możesz polegać
Nie na tym, który kod testowano
Każdy raport mówi „gotowe”. Żaden nie dowodzi, który kod był testowany.
Po jednym worktree Pliki odizolowane
-
Układ
--worktreedla każdego agentaKażdy agent dostaje własny katalog, a wszystkie worktree dzielą jedną historię w
.git. -
Pliki
Własne pliki robocze i indeks
Edycje, instalacje i testy nie dotykają plików innego agenta.
-
Nadal wspólne
Porty, bazy danych, sekrety, deploye
Serwer nadal może przejść na port sąsiada: daj każdemu strumieniowi własny blok portów i własny stan lokalny.
-
Na czym możesz polegać
Pliki nie mogą się zderzyć
Worktree izolują pliki, a nie porty, bazy danych, cache ani wspólny serwer deweloperski.
Jak robi to każde narzędzie.
Cursor, Claude Code i Codex nazywają to po swojemu. Każda notatka ma datę sprawdzenia.
Cursor
Worktrees „let Agent work in isolated Git checkouts”, a równoległych agentów uruchamiasz i obserwujesz w Agents Window. Aktualnych kroków konfiguracji nie sprawdzono ponownie.
Przewodnik po poziomie 3 (dokumentacja Cursora), 2026-08-28
Claude Code
claude --worktree NAME (-w) tworzy .claude/worktrees/NAME/ na nowym branchu worktree-NAME.
Domyślnie startuje od domyślnego brancha zdalnego repozytorium, chyba że worktree.baseRef ma wartość "head". Pliki deweloperskie wypisz w .worktreeinclude: Claude Code kopiuje tylko pliki, które do niego pasują i są w gitignore. Czysty worktree sesji bez nazwy jest usuwany przy wyjściu, a uruchomienia headless claude -p --worktree zostawiają swój worktree.
Przewodnik po worktree, Claude Code 2.1.283, 2026-09-26
Codex
codex --worktree lub /worktree uruchamia zarządzany worktree w $CODEX_HOME/worktrees/ na odłączonym HEAD.
Obsługa worktree jest domyślnie włączona od 0.156.0, ale sesja używa worktree tylko wtedy, gdy się na to zdecydujesz. Zarządzany worktree nie ma niezacommitowanych zmian, plików nieśledzonych ani plików z gitignore, więc utwórz branch, zanim agent zacommituje: commity na odłączonym HEAD nie należą do żadnego brancha.
Izolowane zadania Codex w Git worktrees, Codex 0.157.1, 2026-09-26
Najczęstsze pytania.
Po co agentom AI worktree?
Równolegli agenci w jednym checkoucie nadpisują się nawzajem: formatter przepisuje plik, który edytuje inny agent, a serwer deweloperski przechodzi na następny wolny port. Worktree daje każdemu agentowi własne pliki, więc izolację wymusza Git, a nie pamiętanie o kolejności.
Czy worktree to to samo co klon?
Nie. Wszystkie worktree repozytorium dzielą jego katalog .git: obiekty, refy i git config. Każdy ma własne pliki robocze, indeks i bieżący branch. Ponieważ git config jest wspólny, zapis konfiguracji w jednym worktree zmienia wszystkie.
Czego worktree nie izoluje?
Portów, lokalnych baz danych, cache i kolejek, git config, zgód na uprawnienia zapisywanych przez Claude Code oraz danych produkcyjnych, deployów i sekretów. W nowym worktree brakuje plików z gitignore, takich jak .env i node_modules/. Daj każdemu strumieniowi własny blok portów i własny stan lokalny.
Które narzędzia uruchamiają agentów w worktree?
Claude Code przez claude --worktree, Codex przez codex --worktree lub /worktree oraz Cursor, którego dokumentacja opisuje Worktrees jako izolowane checkouty Gita. W Codex zarządzany worktree startuje na odłączonym HEAD, więc utwórz branch, zanim agent zacommituje.
Czytaj dalej.
Przewodniki, które idą głębiej, oraz hasła i porównania obok tego.
W dokumentacji
Powiązane hasła
Czy ta strona odpowiada na Twoje pytania?
Jedno kliknięcie, bez logowania.
Czego tu szukasz?
Co Cię powstrzymuje?
Jak się to czyta?
Dzięki. Jeśli zostawiasz e-mail, odpisze Ci Michał.
Odpowiada na Twoje pytania?
Każde to jedno kliknięcie. Zamknij, kiedy chcesz.
bez logowania
Czytaj przewodniki w tych samych słowach.
Otwórz wszystkie przewodniki z Toolkitem. Każde hasło jest tu zdefiniowane raz, a przewodniki używają go tak samo.
249,99 zł jednorazowo za 12 miesięcy dostępu. Nic się samo nie odnawia. Zwrot w ciągu 30 dni przy pierwszym zakupie.
Odpisuje Michał, nie automat. Adres służy tylko tej odpowiedzi.