Git worktree i Claude Code: parallelle sessioner

Praktiske oplysninger om at arbejde med Ailoot findes i dokumentationen.

Hvad er en git worktree i Claude Code#

At starte flere agenter parallelt i samme mappe er den grundlæggende udfordring ved vibe-kodning i 2026-tempo. AI-agenter skriver kode hurtigere, end en person kan holde styr på, hvem der arbejder med hvad. Uden filisolering ender to parallelle Claude Code-sessioner i samme mappe med, at den ene session overskriver den andens arbejde.

Git worktree løser dette på filsystemniveau. Du har én hovedmappe, hvor du arbejder. Kommandoen claude --worktree feature-auth opretter mappen .claude/worktrees/feature-auth/ på en separat gren og starter Claude Code der. Filerne er isolerede. Ændringer i den ene session er ikke synlige for den anden, før du udtrykkeligt fletter dem sammen.

Anthropics officielle dokumentation beskriver det sådan:

Et tip til selvkontrol: Hvis du nogensinde har fået et commit, hvor halvdelen af filerne var en andens arbejde, har du brug for en worktree.

Hvordan git worktree adskiller sig fra en almindelig gren#

Det almindelige Git-flow: Du står på grenen main og kører git checkout feature-x—Git overskriver arbejdskopiens filer. En kørende npm run dev går i stykker, fordi package.json blev ændret under den. Du gemmer dine ucommittede ændringer med stash og venter på, at IDE'en genindekserer. Du skifter tilbage, og det hele bliver overskrevet igen, så du må stash og pop igen.

Git worktree giver dig en anden mulighed: I stedet for at skifte én mappe mellem grene opretter du en anden mappe til en anden gren. Kommandoen git worktree add ../project-feature-x feature-x opretter mappen ../project-feature-x/ med filerne fra grenen feature-x. Din main bliver i den oprindelige mappe, og udviklingsserveren fortsætter med at køre.

Tidligere skulle worktree-tilstand i Claude Code konfigureres manuelt: git worktree add, derefter cd, derefter claude—og det skulle gentages i hver terminal. Flaget --worktree (også -w) klarer alle tre ting med én kommando.

Start den første parallelle session: flaget --worktree#

Minimalt eksempel. Åbn den første terminal i projektets rodmappe:

claude --worktree feature-auth

Claude Code gør tre ting:

1. Opretter .claude/worktrees/feature-auth/ med et øjebliksbillede af origin/HEAD (som regel din standardgren).
2. Opretter en ny gren worktree-feature-auth.
3. Starter sessionen i denne mappe.

Åbn en anden terminal i den samme rodmappe for repositoryt:

claude --worktree bugfix-123

Færdig. To Claude Code-sessioner, forskellige filer på disken, forskellige Git-grene. Hvis du skriver autentificering i den første og retter en fejlet test i den anden, kan de fysisk ikke komme i vejen for hinanden.

Hvis du ikke vil skrive et navn, finder Claude på et:

claude --worktree
# → opretter noget i stil med .claude/worktrees/bright-running-fox/

Et tip til Git-begyndere: Føj .claude/worktrees/ til .gitignore. Ellers ser du indholdet af alle worktrees som ikke-sporede filer, når du kører git status i hovedmappen:

# .gitignore
.claude/worktrees/

En faldgrube, du bør undgå: Før den første --worktree-start i en ny mappe skal du åbne den med en almindelig claude (uden flaget) og acceptere dialogen om tillid til arbejdsområdet. Hvis du ikke gør det, fejler flaget med fejlen “trust not accepted”—også hvis du kombinerer det med -p til headless-tilstand.

Hvor worktrees ligger, og hvordan du finder dem#

Standardplaceringen er fast: .claude/worktrees/<value>/ i repositoryts rodmappe. Hvis dit projekt ligger i ~/dev/my-app/, ligger feature-auth-worktreen i ~/dev/my-app/.claude/worktrees/feature-auth/.

Til ikke-standardiserede mappestrukturer (for eksempel hvis du vil have worktreen uden for repositoryt) findes hooken WorktreeCreate—mere om den nedenfor i afsnittet om SVN og Mercurial.

I én Claude-session kan du skifte til en anden eksisterende worktree. Skriv blot i chatten: “skift til .claude/worktrees/bugfix-123,” så kalder Claude værktøjet EnterWorktree. Den aktuelle mappe forbliver urørt—du kan vende tilbage på samme måde.

Standardkommandoen i Git viser en liste over alle worktrees, inklusive hovedarbejdskopien og dem, der er oprettet manuelt:

git worktree list

Outputtet ser sådan ud:

/home/user/dev/my-app                  abc1234 [main]
/home/user/dev/my-app/.claude/worktrees/feature-auth  def5678 [worktree-feature-auth]
/home/user/dev/my-app/.claude/worktrees/bugfix-123    9876fed [worktree-bugfix-123]

Kopiér .env og hemmeligheder: filen .worktreeinclude#

Når --worktree opretter en ny mappe, får den kun det, der er committet til Git. .env med API-nøgler og .env.local med lokal konfiguration står i .gitignore, så de findes ikke i worktreen. Og den allerførste npm run dev fejler med “MISSING DATABASE_URL”.

Hjemmeløsningen er at kopiere .env manuelt efter hver --worktree. Det virker én gang og bliver derefter glemt. Anthropics løsning er en fil med navnet .worktreeinclude i projektets rodmappe, som opremser de Git-ignorerede filer, der automatisk skal kopieres til hver ny worktree.

Opret filen .worktreeinclude i repositoryts rodmappe:

.env
.env.local
config/secrets.json

Syntaksen er den samme som i .gitignore. Du kan bruge glob-mønstre:

.env*
*.local
config/*.json
.vscode/settings.json

Anthropic giver en tydelig regel for at forhindre uheld:

Med andre ord kan du ikke komme til at kopiere package.json via .worktreeinclude—den findes ikke i .gitignore. Det er sikkert at indsætte vilkårlige mønstre dér.

Den samme .worktreeinclude fungerer i tre tilstande: manuel --worktree, automatiske worktrees til subagenter (se nedenfor) og sessioner fra Claude-desktopappen.

Worktree fra en pull request til kodegennemgang#

Et typisk scenarie for kodegennemgang: En kollega har sendt en PR; du skal undersøge koden, køre tests og skrive en kommentar. Med en almindelig git checkout pull/1234/head skifter du arbejdskopien igen og afbryder din aktive session.

Med flaget --worktree klares det med én kommando:

claude --worktree "#1234"

Det sker der: Claude Code kører git fetch origin pull/1234/head, opretter en worktree i .claude/worktrees/pr-1234/ og checker PR-grenen ud. Sessionen starter. Du kan straks bede den om at “læse diffen, køre testene og finde logiske fejl”—mens Claude arbejder, fortsætter din hovedsession på main.

Alternativ syntaks er den fulde pull request-URL:

claude --worktree https://github.com/OWNER/REPO/pull/1234

I et rigtigt projekt kan du kombinere claude --worktree "#N" med din egen kodegennemgangssubagent for at få en automatisk gennemgang på et minut eller to. Start den i baggrunden, fortsæt arbejdet i hovedvinduet, og vend tilbage til resultatet via claude agents.

Basisgren: worktree.baseRef for fresh eller head#

Standardindstillingen betyder, at hver ny worktree starter fra origin/HEAD. Fordelen er en ren start, som med sikkerhed svarer til det, CI vil se. Ulempen er, at ucommittede ændringer eller flere lokale commits ud over fjernserverens version af din aktuelle gren ikke kommer med i den nye worktree.

Føj dette til .claude/settings.json eller globale indstillinger for at starte et worktree fra dit aktuelle lokale HEAD-commit:

{
  "worktree": {
    "baseRef": "head"
  }
}

Nu starter claude --worktree experimental-feature fra den aktuelle lokale HEAD. Det er nyttigt, når funktionen allerede har lokale commits, som ikke er pushed. Det medtager ikke sporede ændringer, der stadig mangler commit. Bevar og overfør de nødvendige ændringer udtrykkeligt, hvis subagenten skal bruge dem, og undersøg derefter destinationens diff. Forveksl ikke overførslen med .worktreeinclude, som håndterer ignorerede lokale filer.

Indstillingen accepterer præcis to værdier: "fresh" (= origin/HEAD) og "head" (= lokal HEAD). Ingen vilkårlige refs som "feature-branch" eller en commit-hash—det er en bevidst begrænsning, der skal forhindre en kombinatorisk eksplosion af muligheder.

Isolér subagenter automatisk: isolation: worktree#

Når du beder Claude om at “starte tre subagenter: én læser databasen, den anden undersøger API'et, og den tredje kontrollerer testene”, arbejder alle tre som standard i din arbejdskopi. Hvis bare to af dem skriver i den samme fil på samme tid, opstår der en konflikt. Løsningen er automatisk at give hver enkelt sin egen worktree.

Metode 1: Bed om det med ord. Skriv til Claude i samtalen:

Brug worktrees til dine agenter.

Claude anvender isolering på alle efterfølgende subagenter i denne session.

Metode 2: Angiv det eksplicit i selve subagenten. Føj et felt til frontmatter i subagentens fil (for eksempel .claude/agents/code-reviewer.md):

---
name: code-reviewer
description: Reads the diff and writes code review comments
isolation: worktree
---

Du er en omhyggelig reviewer. Læs diffen, og se efter logiske fejl...

Nu får hver start af denne subagent en midlertidig worktree i .claude/worktrees/. Hvis subagenten ikke skrev noget, slettes mappen automatisk, når den er færdig. Hvis der er ucommittede ændringer, spørger Claude, om de skal beholdes eller fjernes.

Basisgrenen for subagent-worktrees er den samme som for --worktree: som standard origin/HEAD; med worktree.baseRef: head bruges lokal HEAD.

Beslutningsmatrix: worktree, /bg, subagent eller Agent View#

Typiske kombinationer:

• “2 funktioner parallelt, manuelt” — to terminaler, der hver kører claude --worktree. Det enkleste tilfælde.
• “Start en refaktorering natten over; jeg lukker appen” — /bg + /goal med en afslutningsbetingelse. Sessionen kører uafhængigt af dit vindue.
• “Én prompt, tre parallelle undersøgelser” — tre subagenter med isolation: worktree. Hver i sin egen sandkasse.
• “Hvad kører lige nu?” — claude agents. Et dashboard over alle sessioner med filtrene “running”, “blocked” og “done”.

5 faldgruber ved arbejde med worktrees#

1. Du startede en worktree, .env mangler, og intet virker. Det mest almindelige problem. En worktree er en frisk checkout uden Git-ignorerede filer. Løsningen er at føje en .worktreeinclude-fil med .env* og de nødvendige lokale konfigurationer til, så snart du sætter worktree-tilstanden op. Kontrollér, at filen ligger i repositoryts rodmappe, ikke i .claude/.

2. Du vil skifte til hovedgrenen, kører cd til rodmappen og mister dine ucommittede ændringer i worktreen. Rodmappen og worktreen er to forskellige arbejdskopier. Du gik tilbage med cd; ændringerne i worktreen blev, hvor de var—de forsvandt ikke. Men hvis du blev forvirret og kørte git stash i hovedmappen, fordi du troede, du var i worktreen, oprettes stashen på hovedgrenen, ikke på den gren, du forventede.

3. Du startede 5 parallelle sessioner og kan ikke huske, hvad hver enkelt laver. Anthropics dokumentation advarer udtrykkeligt om, at de fleste udviklere ikke mentalt kan håndtere mere end 2–3 sessioner. Et tegn på overbelastning er at åbne Agent View og ikke straks kunne sige, hvad hver agent laver. Begræns dig til to samtidige sessioner. Hvis opgaven kræver flere, bør den orkestreres via /goal + subagenter, ikke manuelt.

4. Worktrees fra -p (headless) ryddes ikke automatisk op. Kommandoen claude --worktree feature-x -p "do thing" viser ikke en interaktiv afslutningsprompt, så der kommer ikke et tidspunkt, hvor Claude spørger “fjern worktreen?”. Disse worktrees hober sig op. Ryd dem manuelt op: git worktree remove .claude/worktrees/feature-x. Eller brug et cron-script, der fjerner alt, der er ældre end 7 dage.

5. Tillidsdialog i en ny mappe. Hvis du åbner repositoryt for første gang og straks kører claude --worktree, fejler kommandoen. Kør claude uden flag, acceptér tillid til arbejdsområdet, og afslut—derefter virker --worktree. Det er tilsigtet, så Claude ikke får adgang til en andens projekt uden brugerens samtykke.

Oprydning: hvad slettes automatisk#

Oprydningslogikken afhænger af, hvad du har gjort i worktreen, og hvordan du startede sessionen. Anthropics dokumentation beskriver tre scenarier:

Scenarie 1: Du gik ind, gjorde ingenting og afsluttede—worktreen blev fjernet.

Scenarie 2: Du arbejdede lidt uden at committe—Claude spørger “behold eller fjern?”, når du afslutter. “Behold” gemmer mappen og grenen til senere. “Fjern” sletter mappen sammen med ucommittede ændringer og nye commits. Det er destruktivt—klik ikke på “fjern” af vane.

Scenarie 3: Du startede med -p (headless), og kommandoen blev færdig og afsluttet. Worktreen bliver liggende. Ryd den manuelt op:

git worktree remove .claude/worktrees/feature-x

Derudover fjernes worktrees fra subagenter og /bg-sessioner automatisk af baggrundsoprydningen, hvis de er ældre end cleanupPeriodDays dage (en indstilling, som normalt er 30 dage som standard) og ikke indeholder arbejde, der ikke er gemt. Worktrees fra --worktree berøres ikke af automatisk oprydning—du har selv ansvaret for dem.

Alternativer til SVN, Perforce og Mercurial: hooken WorktreeCreate#

Hvis repositoryt bruger Subversion eller Mercurial, virker flaget --worktree ikke direkte. Anthropic tilbyder et udvidelsespunkt via to hooks: WorktreeCreate (opretter en isoleret kopi) og WorktreeRemove (fjerner den).

Eksempel på SVN-hook fra den officielle dokumentation:

{
  "hooks": {
    "WorktreeCreate": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "bash -c 'NAME=$(jq -r .name); DIR=\"$HOME/.claude/worktrees/$NAME\"; svn checkout https://svn.example.com/repo/trunk \"$DIR\" >&2 && echo \"$DIR\"'"
          }
        ]
      }
    ]
  }
}

Hooken læser worktree-navnet fra stdin ({ "name": "feature-auth" }), kører svn checkout til en forudberegnet mappe og udskriver stien på stdout—Claude Code bruger den som arbejdsmappe til den nye session.

En vigtig bemærkning: Når du bruger din egen hook, bruges .worktreeinclude ikke. Hvis du har brug for .env eller andre Git-ignorerede filer i den nye mappe, skal du kopiere dem i selve hook-scriptet.

Hvad nu: tre nært beslægtede mekanismer til parallelisme#

Worktree giver filisolering. /bg giver kontekstisolering. Subagenter giver opgaveisolering. Hver mekanisme løser ét problem for sig. Sammen gør de det muligt at arbejde på tre til fem parallelle opgaver uden kognitivt sammenbrud. Det er værktøjskassen bag avanceret vibe-kodning i 2026.

Emnet fortsætter naturligt med tre relaterede emner: sådan opsætter du en autonom agent med /goal og Agent View, sådan bygger du dine egne subagenter til dine opgaver og sådan starter du hundredvis af agenter via Dynamic Workflows.

Åbn Ailoot.