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.

Ostatnia aktualizacja
Autor:
Opublikowano
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.

Na tej stronie Dlaczego to ważneJak robi to każde narzędziePytania

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

  1. Układ

    Trzej agenci, jeden katalog

    Trzy terminale otwarte na tym samym checkoucie.

  2. Kolizja

    Formatter przepisuje plik, który edytuje inny agent

    Serwer deweloperski drugiego agenta po cichu zajmuje następny wolny port.

  3. Testy

    Przechodzą na serwerze sąsiada

    Testy end-to-end trzeciego agenta idą na serwerze drugiego.

  4. 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

  1. Układ

    --worktree dla każdego agenta

    Każdy agent dostaje własny katalog, a wszystkie worktree dzielą jedną historię w .git.

  2. Pliki

    Własne pliki robocze i indeks

    Edycje, instalacje i testy nie dotykają plików innego agenta.

  3. 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.

  4. Na czym możesz polegać

    Pliki nie mogą się zderzyć

    Worktree izolują pliki, a nie porty, bazy danych, cache ani wspólny serwer deweloperski.

Worktree to nie sandbox: każdy worktree nadal sięga do tego samego konta chmurowego, bazy danych i magazynu sekretów. Źródło: Przewodnik po worktree, 2026-09-26.

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.

Czy ta strona odpowiada na Twoje pytania?

Jedno kliknięcie, bez logowania.

wcale w pełni

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.