Claude Code Projects: koordinator, trådar och betabegränsningar

Anthropic har nyligen gjort om Projects i Claude Code. Det är nu en enda samordnande konversation som startar parallella molnsessioner – trådar – för uppgifter och tar emot rapporter från dem. Det är värt att skapa ett projekt när ditt arbete har ett mål som sträcker sig längre än en enda session och ger upphov till nya uppgifter – till exempel att utveckla ett GitHub-repository under flera veckor. Behovet av parallellt arbete räcker inte i sig. Om du snabbt behöver åtgärda en fil här och nu räcker en vanlig session.

Arbetet leds av en koordinator – en långvarig konversation där Claude avgör vad i ditt meddelande som ska omvandlas till en uppgift för en tråd. Trådarna skriver koden: var och en är en separat Claude Code-molnsession på en egen repository-branch. Flera trådar kan köras samtidigt, var och en med sin egen kontext och branch. Koordinatorn ser vad en tråd rapporterar när den är klar, men inte varje steg den tar. Den rapporterar färdiga pull requests (begäranden om att slå samman ändringar) till dig och ber, på din uppmaning, en tråd att revidera eller slå samman dem. Nedan följer en översikt baserad på Anthropics officiella dokumentation: vad du ska konfigurera, hur arbetet organiseras och vilka begränsningar betaversionen har.

Betaversionen blir tillgänglig gradvis, med början för Pro- och Max-konton som redan har använt Claude Code-molnsessioner och inte har skapat ett projekt i vanlig chatt eller Cowork. Om du ännu inte ser avsnittet Projects kan du gå med på väntelistan.

Vad Claude Code Projects är, enkelt uttryckt#

Ett projekt är en enda långvarig konversation med en koordinator, med tillhörande repositories, minne och instruktioner. Du skriver till koordinatorn, som avgör om den ska svara direkt eller starta en tråd. Du behöver inte manuellt öppna en ny session för varje uppgift.

En tråd är en fullständig Claude Code-molnsession: den har sin egen kontext och repository-branch och öppnar en pull request när det behövs. Koordinatorn kan hålla flera trådar öppna samtidigt – till exempel kan en åtgärda ett fel, en annan skriva tester och en tredje uppdatera dokumentationen – samtidigt som den besvarar dina frågor i huvudkonversationen.

Som jämförelse kan du föreställa dig flera flikar med lokala Claude Code-sessioner, var och en i sin egen arbetskopia av ett repository. En sådan kopia kallas en worktree – en separat mapp för en branch, så att lokala sessioner inte stör varandra. Du växlar själv mellan sessionerna och bestämmer vad du ska tilldela var och en. Molntrådar behöver ingen worktree: varje tråd klonar repositories till sin egen isolerade molnmiljö. Projects sköter samordningen och avgör när en ny tråd ska skapas och när den är onödig.

Ett projekt har delat minne och instruktioner som varje ny tråd får. I avsnittet om konfiguration förklaras vad du bör spara där och hur det skickas vidare till trådarna.

Så skiljer det sig från en vanlig session och ett agentteam#

Om du redan kör nästlade underagenter i en enda Claude Code-session är det bra att skilja dem från agentteam och projekttrådar. Ett agentteam är ett annat sätt att delegera arbete: en session startar sessions för teammedlemmar för en specifik uppgift. Du kan köra det både på din egen dator och i en molnsession.

• Agentteam – sessions för teammedlemmar som kan startas lokalt eller i molnet för en specifik uppgift. De är inte separata projekttrådar.
• Ett projekt och dess trådar – arbetet körs i molnet. Varje tråd är en separat session på sin egen branch och fortsätter att köras även efter att du stängt din laptop. En lokal session kan inte ingå i ett projekt.
• Agentvyn – en skärm där du kan observera flera lokala sessioner på din dator. Den har ingen koordinator: du bestämmer vad du ska tilldela var och en.

Anthropics officiella dokumentation lyfter fram en separat poäng: parallellt arbete räcker inte i sig som skäl för att skapa ett projekt. I ett projekt startar Claude sessioner och tar själv emot deras rapporter, och alla sessioner börjar med delade repositories, instruktioner och minne. Arbetet stannar i molnet under hela uppgiften.

Ett liknande arbetssätt – där en koordinator fördelar uppgifter mellan agenter – finns i ett annat verktyg som beskrivs i artikeln om Cursor Projects. Mekanismen är annorlunda, men koordinatorn avgör också vad som ska tilldelas vem.

Vad du ska konfigurera före ditt första projekt#

Kontrollera tre saker innan du skapar ett projekt.

1. GitHub-konto och Claude GitHub App. Om du redan har anslutit GitHub via /web-setup ger den tokenen dina vanliga molnsessioner åtkomst till repositoryt. Det räcker inte för projekttrådar: du behöver ett anslutet GitHub-konto med pushåtkomst till repositoryt och Claude GitHub App installerad för det repositoryt. Utan den kan en tråd varken klona repositoryt eller öppna en pull request.

2. Projektinstruktioner. Projektinstruktionerna är en text på upp till 16 000 tecken som skickas till varje ny tråd och till koordinatorn själv. Lägg information här som du annars skulle behöva förklara på nytt i varje session: repositoryts struktur, kodkonventioner och vilka kontroller som krävs före en pull request.

3. Modell och insatsnivå. Som standard kör ett nytt projekt varje tråd med Opus-modellen och hög insatsnivå, och koordinatorn med låg insatsnivå. Dokumentationen säger att den här inställningen ”förbrukar din planerade användning snabbast” (översättning; original: draws on your plan fastest). Om dina uppgifter är enkla kan du välja en billigare modell eller sänka insatsnivån under Project settings > General. Inställningarna för trådar och koordinator ändras separat; dokumentationen beskriver mer ekonomiska alternativ.

Projektminnet lagras som vanliga filer, med en indexfil som heter MEMORY.md. Varje ny tråd läser den vid start och kommer åt de andra filerna vid behov. Resultat från en tråd som sparats i minnet blir tillgängliga för nästa utan att behöva återberättas.

Vad du ska göra om trådar ändrar samma kod#

Varje tråd arbetar på sin egen branch och öppnar själv en pull request om arbetet kräver det. Koordinatorn garanterar dock inte att uppgifterna aldrig överlappar: om flera trådar hamnar i samma kodområde kan du be den berörda tråden att lösa konflikten via gränssnittet. Det finns en Resolve conflicts-knapp bredvid dess pull request som skickar en instruktion till tråden som ett meddelande från dig.

Den officiella dokumentationen rekommenderar att du anger önskemål om antalet trådar i projektinstruktionerna: be till exempel koordinatorn att starta högst två trådar åt gången eller återanvända en befintlig tråd för nya uppgifter inom samma område. Det är ett önskemål som koordinatorn försöker följa, inte en hård gräns. Det garanterar inte i sig att trådarna inte kolliderar i samma fil – en befintlig konflikt måste lösas separat. För relaterade uppgifter inom samma område kan du återanvända en aktiv eller vilande tråd. Om den har varit vilande i mer än en timme läser den om hela historiken när den får ett nytt meddelande, vilket påverkar användningen av abonnemangets tilldelning.

Ju tydligare uppgifterna delas upp mellan filer eller moduler, desto enklare är det att arbeta parallellt. En separat artikel handlar om att dela upp en stor uppgift i självständiga delar: hur du delegerar kodning till tusentals agenter. Omfattningen är annorlunda, men principen att dela upp arbetet är densamma.

Så länge konversationscachen är aktiv (på Pro- och Max-planer, inom en timme, om planens begränsningar tillåter det) använder en tråd färre av abonnemangets tilldelade tokens för att bearbeta sin historik på nytt. När cachen upphör att gälla läser tråden om hela historiken när den får ett nytt meddelande, innan den börjar arbeta. För en ny, fristående uppgift kan det vara mer ekonomiskt att be koordinatorn skapa en ny tråd: det kan använda färre tokens från samma abonnemangstilldelning än att fortsätta en gammal session med en lång historik efter att dess cache har upphört att gälla.

Betaversionens begränsningar att känna till i förväg#

Kontrollera betaversionens begränsningar innan du skapar ett projekt för en viktig uppgift:

• Endast tillgängligt med Pro och Max. Team och Enterprise stöds ännu inte.
• En gräns på 200 nya trådar per dag för varje konto, sammanlagt för alla projekt.
• Ett projekt tillhör en användare. Du kan inte ge en annan person delad åtkomst till det eller till en enskild tråd, och betaversionen saknar organisationsinställningar för team.
• Åtkomst endast via claude.ai/code, datorappen och mobilappen. Projects fungerar inte i terminalens CLI, via Amazon Bedrock, Google Cloud Agent Platform eller Microsoft Foundry.
• Ett projekt kan inte se lokala filer och verktyg. Trådar arbetar med GitHub-repositories, uppladdade filer och Google Drive-mappar, men inte med sådant som bara finns på din dator.

Om du behöver terminalåtkomst eller åtkomst till verktyg som bara finns på din dator kan du använda en lokal session eller en agentvy för flera sådana sessioner. Om flera personer behöver arbeta tillsammans i en arbetsyta har Anthropic en separat produkt för team på Team och Enterprise: Claude Tag. Den finns i en Slack-kanal; alla medlemmar kan ge Claude en uppgift och alla i kanalen kan se och styra arbetet. Ett projekt fungerar annorlunda: det tillhör bara dig. Om du bara behöver vissa lokala filer kan du ladda upp dem till projektet, så får varje tråd åtkomst till dem. Det ger inte åtkomst till lokala verktyg.

Vad händer nu#

Innan du flyttar ditt arbetsflöde till Projects kan du prova att skapa ett testprojekt i ett oviktigt repository: anslut GitHub App, skriv korta instruktioner, ge koordinatorn en fristående uppgift och se hur den hanterar den. Den första körningen visar om du förstår gränssnittet för koordinatorn och trådarna. Den säger inget om parallellt arbete, konflikter eller hur tilldelningen används över flera uppgifter – det behöver testas separat.