Claude Code Projects: koordinator, tråde og betabegrænsninger

Anthropic har for nylig redesignet Projects i Claude Code. Det er nu én koordinerende samtale, der starter parallelle cloudsessioner – tråde – til opgaver og modtager rapporter fra dem. Det kan betale sig at oprette et projekt, når dit arbejde har et mål, der rækker ud over en enkelt session og giver anledning til nye opgaver – for eksempel at udvikle et GitHub-repository over flere uger. Behovet for parallelt arbejde er ikke i sig selv nok. Hvis du hurtigt skal rette én fil her og nu, er en almindelig session tilstrækkelig.

Arbejdet ledes af en koordinator – en langvarig samtale, hvor Claude beslutter, hvad fra din besked der skal omsættes til en opgave for en tråd. Trådene skriver koden: hver tråd er en separat Claude Code-cloudsession på sin egen repository-branch. Flere tråde kan køre på samme tid, hver med sin egen kontekst og branch. Koordinatoren kan se, hvad en tråd rapporterer, når den er færdig, men ikke hvert skridt, den tager. Den rapporterer færdige pull requests (anmodninger om at sammenflette ændringer) til dig og beder på din anmodning en tråd om at revidere eller sammenflette dem. Nedenfor er en oversigt baseret på Anthropics officielle dokumentation: hvad du skal konfigurere, hvordan arbejdet organiseres, og hvilke begrænsninger betaversionen har.

Betaversionen bliver gradvist tilgængelig, begyndende med Pro- og Max-konti, der allerede har brugt Claude Code-cloudsessioner og ikke har oprettet et projekt i almindelig chat eller Cowork. Hvis du endnu ikke kan se Projects-afsnittet, kan du skrive dig på ventelisten.

Hvad Claude Code Projects er, kort fortalt#

Et projekt er én langvarig samtale med en koordinator, som har repositories, hukommelse og instruktioner tilknyttet. Du skriver til koordinatoren, og den beslutter, om den skal svare med det samme eller starte en tråd. Du behøver ikke manuelt at åbne en ny session for hver opgave.

En tråd er en fuld Claude Code-cloudsession: Den har sin egen kontekst og repository-branch og åbner en pull request, når det er nødvendigt. Koordinatoren kan holde flere tråde åbne på samme tid – for eksempel kan én rette en fejl, en anden skrive tests og en tredje opdatere dokumentationen – mens den besvarer dine spørgsmål i hovedsamtalen.

Til sammenligning kan du forestille dig flere faner med lokale Claude Code-sessioner, hver i sin egen arbejdskopi af et repository. En sådan kopi kaldes en worktree – en separat mappe til én branch, så lokale sessioner ikke forstyrrer hinanden. Du skifter selv mellem sessionerne og beslutter, hvad der skal tildeles hver enkelt. Cloudtråde behøver ikke en worktree: hver tråd kloner repositories til sit eget isolerede cloudmiljø. Projects tager sig af koordineringen og beslutter, hvornår der skal oprettes en ny tråd, og hvornår det er unødvendigt.

Et projekt har delt hukommelse og instruktioner, som hver ny tråd modtager. Afsnittet om opsætning forklarer, hvad du skal gemme der, og hvordan det sendes videre til trådene.

Sådan adskiller det sig fra en almindelig session og et agentteam#

Hvis du allerede kører indlejrede underagenter i én Claude Code-session, er det nyttigt at skelne dem fra agentteams og projekttråde. Et agentteam er en anden måde at uddelegere arbejde på: Én session starter sessioner for teammedlemmer til en bestemt opgave. Du kan køre det både på din egen maskine og i en cloudsession.

• Agentteam – sessioner for teammedlemmer til én bestemt opgave, som kan startes lokalt eller i skyen. Det er ikke separate projekttråde.
• Et projekt og dets tråde – arbejdet foregår i skyen. Hver tråd er en separat session på sin egen branch og fortsætter med at køre, selv efter at du lukker din laptop. En lokal session kan ikke være en del af et projekt.
• Agentvisning – en skærm, hvor du kan holde øje med flere lokale sessioner på din maskine. Den har ingen koordinator: Du beslutter, hvad der skal tildeles hver enkelt.

Anthropics officielle dokumentation fremhæver en særskilt pointe: parallelt arbejde alene er ikke en grund til at oprette et projekt. I et projekt starter Claude sessioner og modtager selv deres rapporter, og alle sessioner begynder med delte repositories, instruktioner og hukommelse. Arbejdet foregår i skyen under hele opgaven.

En lignende tilgang – hvor en koordinator fordeler opgaver mellem agenter – er implementeret i et andet værktøj, som omtales i artiklen om Cursor Projects. Mekanismen er anderledes, men koordinatoren beslutter også, hvad der skal tildeles hvem.

Hvad du skal konfigurere, før du opretter dit første projekt#

Kontrollér tre ting, før du opretter et projekt.

1. GitHub-konto og Claude GitHub App. Hvis du allerede har forbundet GitHub via /web-setup, giver det token dine almindelige cloudsessioner adgang til repositoryt. Det er ikke nok til projekttråde: Du skal have en tilknyttet GitHub-konto med pushadgang til repositoryt, og Claude GitHub App skal være installeret til det pågældende repository. Uden det kan en tråd hverken klone repositoryt eller åbne en pull request.

2. Projektinstruktioner. Projektinstruktioner er tekst på op til 16 000 tegn, der sendes til hver ny tråd og til selve koordinatoren. Skriv oplysninger her, som du ellers skulle forklare igen i hver session: repositoryts struktur, kodningskonventioner og de kontroller, der skal gennemføres, før der oprettes en pull request.

3. Model og indsatsniveau. Som standard kører et nyt projekt hver tråd med Opus-modellen og højt indsatsniveau, mens koordinatoren kører med lavt indsatsniveau. Dokumentationen siger, at denne indstilling “bruger din planstildeling hurtigst” (oversættelse; original: draws on your plan fastest). Hvis dine opgaver er enkle, kan du vælge en billigere model eller sænke indsatsniveauet under Project settings > General. Indstillingerne for tråde og koordinator ændres separat; dokumentationen beskriver mere økonomiske muligheder.

Projektets hukommelse gemmes som almindelige filer med en indeksfil, der hedder MEMORY.md. Hver ny tråd læser den ved opstart og åbner de andre filer efter behov. Resultater fra én tråd, der gemmes i hukommelsen, bliver tilgængelige for den næste uden at skulle fortælles igen.

Hvad du skal gøre, hvis tråde ændrer den samme kode#

Hver tråd arbejder på sin egen branch og åbner selv en pull request, hvis arbejdet kræver det. Koordinatoren garanterer dog ikke, at opgaver aldrig overlapper: Hvis flere tråde ender i samme kodeområde, kan du bede den relevante tråd om at løse konflikten via grænsefladen. Ved siden af dens pull request er der en Resolve conflicts-knap, som sender en instruktion til tråden som en besked fra dig.

Den officielle dokumentation foreslår, at du angiver dine præferencer for antallet af tråde i projektinstruktionerne: Du kan for eksempel bede koordinatoren om højst at starte to tråde ad gangen eller om at genbruge en eksisterende tråd til nye opgaver inden for samme område. Det er en præference, koordinatoren forsøger at følge, ikke en fast grænse. I sig selv garanterer det ikke, at tråde ikke støder sammen i den samme fil – en eksisterende konflikt skal løses separat. Til relaterede opgaver inden for samme område kan du genbruge en aktiv eller inaktiv tråd. Hvis den har været inaktiv i mere end en time, læser den hele historikken igen, når den modtager en ny besked, hvilket påvirker forbruget af abonnementets tildeling.

Jo tydeligere opgaverne er fordelt på filer eller moduler, desto lettere er det at arbejde parallelt. En separat artikel handler om at opdele en stor opgave i uafhængige dele: hvordan du uddelegerer kodning til tusindvis af agenter. Omfanget er anderledes, men princippet om at opdele arbejdet er det samme.

Så længe samtalens cache er aktiv (på Pro- og Max-abonnementer, inden for en time, hvis abonnementets grænser tillader det), bruger en tråd færre tokens fra abonnementets tildeling på at genbehandle sin historik. Når cachen udløber, læser tråden hele historikken igen, når den modtager en ny besked, før den begynder at arbejde. Til en ny, uafhængig opgave kan det være mere økonomisk at bede koordinatoren om at oprette en ny tråd: Det kan bruge færre tokens fra den samme abonnementstildeling end at fortsætte en gammel session med en lang historik, efter at dens cache er udløbet.

Betaversionens begrænsninger, du bør kende på forhånd#

Kontrollér betaversionens begrænsninger, før du opretter et projekt til en vigtig opgave:

• Kun tilgængelig på Pro og Max. Team og Enterprise understøttes endnu ikke.
• En grænse på 200 nye tråde om dagen pr. konto, samlet på tværs af alle projekter.
• Et projekt tilhører én bruger. Du kan ikke give en anden person delt adgang til projektet eller en enkelt tråd, og betaversionen har ingen organisationsindstillinger for teams.
• Adgang kun via claude.ai/code, desktopappen og mobilappen. Projects fungerer ikke i terminalens CLI, via Amazon Bedrock, Google Cloud Agent Platform eller Microsoft Foundry.
• Et projekt kan ikke se lokale filer og værktøjer. Tråde arbejder med GitHub-repositories, uploadede filer og Google Drive-mapper, men ikke med ting, der kun findes på din maskine.

Hvis du har brug for terminaladgang eller adgang til værktøjer, der kun findes på din maskine, kan du bruge en lokal session eller en agentvisning til flere sådanne sessioner. Hvis flere personer skal arbejde sammen i ét arbejdsområde, har Anthropic et særskilt produkt til teams på Team og Enterprise: Claude Tag. Det findes i en Slack-kanal; alle medlemmer kan give Claude en opgave, og alle i kanalen kan se og styre arbejdet. Et projekt fungerer anderledes: Det tilhører kun dig. Hvis du kun har brug for bestemte lokale filer, kan du uploade dem til projektet, så får hver tråd adgang til dem. Det giver ikke adgang til lokale værktøjer.

Hvad nu#

Før du flytter dit workflow til Projects, kan du prøve at oprette et testprojekt på et ikke-kritisk repository: Tilslut GitHub App, skriv korte instruktioner, giv koordinatoren én uafhængig opgave, og se, hvordan den håndterer den. Den første kørsel viser, om du forstår koordinator- og trådgrænsefladen. Den afdækker ikke parallelt arbejde, konflikter eller forbrug af tildelingen på tværs af flere opgaver – det skal testes separat.