course
I storskaliga applikationer eller företagsmiljöer fylls kontext snabbare än du tror. Ett stort designbeslut du tog för en timme sedan finns förmodligen inte längre i kontexten, så du måste fortsätta förklara sådant som modellen redan har arbetat igenom. Du gör i stort sett allt rätt, men problemet är att du ber en enda assistent att göra jobbet för ett helt team.
Claude Code Agent Teams introducerades för att ändra på detta. Tanken är att du i stället för att låta en session göra allt i tur och ordning startar flera specialiserade agenter som delar en uppgiftslista, skickar meddelanden direkt till varandra och utför arbetet parallellt.
I den här artikeln går jag igenom hur Agent Teams fungerar, vad varje specialiserad roll gör och hur du koordinerar dem i riktiga mjukvaruprojekt.
Ny på Claude Code? Spika grunderna på en eftermiddag med vår Claude Code 101-kurs.
Vad är Claude Code Agent Teams?
Claude Code Agent Teams är ett koordineringslager som gör det möjligt för flera Claude Code-sessioner att arbeta på samma projekt samtidigt. En session tar rollen som teamledare och skapar andra sessioner, kallade lagkamrater, för att hantera specifika delar av arbetet.
Varje lagkamrat körs som en fullständig, oberoende Claude Code-instans med sitt eget kontextfönster. De delar en uppgiftslista, tar på sig arbete när det blir tillgängligt och skickar meddelanden direkt till varandra när de behöver koordinera.
Upplägget är mer än att bara öppna ett par terminalflikar och köra Claude i var och en. När du gör det kan separata chattfönster inte se varandras framsteg och kan inte enas om vem som gör vad. Ett agentteam ger däremot varje session en gemensam vy av arbetet och ett sätt att kommunicera. Ledaren håller alla i linje.
I praktiken innebär detta att du inte längre är reläet mellan sessioner. Teamet sköter sin egen koordinering och du kliver in bara för att sätta riktning och granska resultat.
Varför Agent Teams finns
En enda Claude Code-session fungerar bra tills projektet blir för stort.
Varje Claude Code-session har ett kontextfönster, och det fönstret har en gräns. Allteftersom du arbetar fylls sessionen med filinnehåll, kommandoresultat, designdiskussioner och din egen dialog. Förr eller senare finns äldre information inte längre i kontexten, och modellen börjar glömma beslut du tog tidigare i samma uppgift.
Det finns tre vanliga situationer där detta blir tydligt:
- Stora kodförråd: En kodbas med hundratals filer får inte plats i kontexten. Sessionen slutar med att läsa samma filer om och om igen och förbrukar tokens för att återskapa förståelse den redan hade.
- Komplexa projekt: Tvärfunktionella funktioner, som att lägga till autentisering i backend, frontend och tester, kräver att modellen hanterar för många aspekter samtidigt. Varje ny aspekt konkurrerar om utrymme med allt annat.
- Flera samtidiga uppgifter: Att be en session implementera en funktion, refaktorera en modul, skriva tester och uppdatera dokumentation i samma konversation är att be om problem.
Svaret är detsamma som mänskliga team kom fram till för decennier sedan: dela upp arbetet.
Om en session går på knäna vid en refaktorering, ge backend‑ändringarna till en lagkamrat, frontend‑ändringarna till en annan och testuppdateringarna till en tredje. Varje lagkamrat använder bara det den behöver för sin del av arbetet.
Samma idé gäller för research. En uppgift med tre konkurrerande hypoteser går snabbare när tre lagkamrater var och en undersöker en teori parallellt och sedan jämför anteckningar, i stället för att en session går igenom dem sekventiellt.
Specialisering ger djup och parallellism ger fart. Men tillsammans låter de dig göra arbete som en enda session antingen skulle hallucinera kring eller ta alldeles för lång tid att slutföra.
Hur Claude Code Agent Teams fungerar
En teamsession går igenom fem steg, med orkestrering hanterad inuti Claude Code själv.
- Definiera målet: Beskriv vad du vill ha med vardagligt språk, på samma sätt som du skulle briefa en juniorutvecklare. Ledaren läser det och bestämmer hur det ska delas upp.
- Delegera arbetet: Ledaren skapar en delad uppgiftslista och startar lagkamrater, var och en med namn, roll och startprompt. Du kan specificera teamstrukturen eller låta ledaren räkna ut den.
- Utför i parallell: Varje lagkamrat tar uppgifter, markerar dem som pågående, slutför dem och markerar dem som klara. Beroenden respekteras automatiskt; fillåsning förhindrar konflikter. Lagkamrater kan skicka meddelanden direkt till varandra — ingen anledning att gå via ledaren.
- Kombinera resultat: Ledaren samlar in färdigt arbete, löser konflikter och producerar ett enda resultat: en PR, en rapport, en omstrukturerad modul eller vad målet än krävde.
- Granska utfallet: Du granskar slutresultatet som vilken pull request som helst: läs diffen, kör koden, kolla testerna.
Specialiserade roller i Agent Teams
Roller ger ett agentteam dess form. Utan dem slutar du med generiska sessioner som gör överlappande arbete. Claude Code tillhandahåller ingen fast lista — du definierar roller i din brief eller genom att peka ledaren mot en underagentdefinition sparad under .claude/agents/.
Planeringsagent
Planeringsagenten bryter ner målet i uppgifter innan någon kod skrivs. Den utforskar kodbasen, kartlägger beroenden och tar fram en uppgiftslista med självständiga enheter som en enda lagkamrat kan slutföra utan ständiga avstämningar.
I praktiken spelar teamledaren ofta själv den här rollen. Du kan också köra en dedikerad planeringskamrat när arbetet är tillräckligt stort för att motivera det.
Kodningsagent
Kodningsagenten skriver implementationen. De flesta lagkamrater kommer att vara kodningsagenter, var och en som äger en distinkt del av arbetet — backend, frontend, databas, AI-funktioner. Nyckeln är att hålla omfången isär: två lagkamrater som redigerar samma fil kommer att skriva över varandra.
Kodningsagenter fungerar bra på billigare modeller. Många praktiker kör ledaren på Opus och lagkamraterna på Sonnet, eftersom själva utförandet inte kräver samma djup i resonemang som koordineringen.
Testagent
Testagenten skriver och kör tester. Den kan arbeta mot ett överenskommet API‑kontrakt medan kodningskamraten fortfarande bygger endpointen — så när koden landar finns testerna redan på plats.
Du kan också låta en testkamrat vara igång under hela sessionen och köra om sviten varje gång en kodningskamrat markerar en uppgift som klar.
Granskningsagent
Granskningsagenten läser diffs och flaggar buggar, stilfrågor, saknade edgefall och säkerhetsproblem. Att dela upp granskningen mellan två lagkamrater med olika perspektiv — en för säkerhet, en för prestanda — fungerar särskilt bra, med ledaren som sammanställer deras fynd.
Om du redan har skrivit en underagentdefinition för ditt projekt ärver lagkamraten automatiskt dess verktyg och systemprompt.
Dokumentationsagent
Dokumentationsagenten skriver docstrings, README‑uppdateringar och längre dokument som arkitekturnoteringar eller API‑referenser. Den är en bra kandidat som sista lagkamrat — när kodning och testning är klara är den slutliga formen på arbetet tydlig.
Varför specialisering förbättrar resultaten
En generisk session måste hålla implementation, tester, dokumentation och granskningsfeedback i kontext samtidigt. En specialiserad lagkamrat laddar bara det som behövs, håller sitt kontext litet och sitt resonemang fokuserat. Specialisering gör också felsökning enklare: när något går fel vet du exakt vilken session du ska kontrollera.
Parallell utveckling med Agent Teams
Parallellism är hela poängen med ett agentteam.
När ledaren har brutit ner arbetet i uppgifter och startat lagkamraterna körs alla samtidigt. Varje lagkamrat är en separat Claude Code‑session, så arbetet köas inte bakom ett enda kontextfönster. Den totala tiden för att färdigställa en flerdelad funktion sjunker från summan av alla delar till tiden för den långsammaste delen.
Här är tre kombinationer som fungerar särskilt bra i parallell.
- Frontend och backend i parallell: När du bygger en ny funktion som använder båda lagren kan backend‑kamraten bygga API‑endpointen medan frontend‑kamraten bygger komponenten som konsumerar den. De två koordinerar via direktmeddelanden. Så snart backend‑kamraten bestämmer svarstrukturen skickar den den till frontend‑kamraten, och båda fortsätter arbeta utan att vänta på att den andra ska bli helt klar.
- Implementation och testning i parallell: Kodningskamraten skriver implementationen medan testkamraten skriver testerna mot det överenskomna kontraktet. När kodningskamraten markerar uppgiften som klar finns testerna redan där att köra. Detta går mycket snabbare än den vanliga ordningen att skriva koden först och lägga till tester i slutet.
- Dokumentation och kodgranskning i parallell: När en kodningskamrat slutför en del av arbetet kan dokumentationskamraten börja skriva docstrings och README‑uppdateringar medan granskningskamraten läser diffen efter buggar och stilfrågor. Ingen blockerar den andra, och båda levererar sitt underlag till ledaren att sammanfoga.
Begränsningen handlar om filkonflikter. Två lagkamrater som skriver till samma fil samtidigt kommer att skriva över varandra, så ledaren måste dela upp arbetet längs fil- eller modulgränser. Så länge delarna är tydligt separerade kan du köra så många lagkamrater parallellt som din uppgiftslista stödjer.
Claude Code Agent Teams för stora kodbaser
Stora kodbaser är där agentteam är mer ett måste än ett trevligt komplement.
Ett repo med hundratals eller tusentals filer ryms inte i ett enda kontextfönster. En ensam session som arbetar på en stor kodbas spenderar en stor del av sin budget på att återupptäcka koden.
Med agentteam laddar varje lagkamrat bara de filer som är relevanta för sin del av arbetet, så kontextfönstret per lagkamrat förblir litet och fokuserat. Teamet som helhet kan resonera om hela repot, men ingen enskild session behöver göra det.
Detta är viktigast i tre situationer:
- Tvärgående ändringar: En refaktorering som rör dussintals filer över flera moduler är svår för en session att hantera utan att tappa bort sig. Att dela upp den per modul och ge varje modul till en lagkamrat håller var och ens omfång hanterbart.
- Repo-omfattande granskningar: En säkerhetsgranskning eller prestanda‑audit över en stor kodbas gynnas av att köra flera lagkamrater parallellt, var och en som tittar på en annan del av repot. Ledaren sammanställer sedan deras fynd till en enda rapport.
- Långvariga projekt: Ett flerveckorsprojekt ackumulerar kontext som en enda session inte kan hålla. Agentteam låter dig dela upp arbetet i checkpoints, där varje checkpoint ägs av en lagkamrat som inte behöver minnas allt som kom före.
Det finns en kostnad.
Varje lagkamrat är en fullständig Claude Code‑session med sitt eget kontextfönster, så tokenanvändningen skalar linjärt med teamets storlek. Ett team på fyra använder ungefär fyra gånger så många tokens som en enskild session för samma mängd arbete. Vissa uppskattningar anger ännu mer. Avvägningen är snabbare väggklocktid och bättre djup per aspekt, vilket vanligtvis lönar sig för arbete som en enda session inte realistiskt kan slutföra.
Ju större projekt, desto mer vinner du på agentteam. Men överanvänd det inte – för en liten buggfix är en enda session billigare och lika effektiv.
Agent Teams och Claude Tag
Agentteam är inte det enda stället där Anthropic tänker om hur AI passar in i teamarbetsflöden.
Claude Tag är en separat funktion som tar in Claude i Slack som en delad organisatorisk deltagare. Du taggar @Claude i en kanal, och Claude tar sig an arbete med hjälp av din organisations verktyg och kanalens kontext. Den minns vad som har diskuterats, följer upp på egen hand och arbetar under din organisations identitet.
De två funktionerna löser olika koordineringsproblem. Agentteam koordinerar flera Claude Code‑sessioner på en utvecklares dator för en fokuserad uppgift. Claude Tag koordinerar en Claude‑identitet över ett team av människor i Slack under dagar och veckor. Men riktningen är densamma: AI rör sig från ett verktyg som en person använder i isolering till en deltagare som verkar inne i ett teams befintliga arbetsflöde.
Detta förändrar vad AI behöver vara bra på.
En ensam assistent måste vara en stark generalist, men ett koordinerat system måste vara en stark specialist som kan planera, lämna över, be om hjälp och hålla sig i linje med andra agenter och människor. Agentteam gör detta för Claude Code‑arbetsflöden, och Claude Tag gör det synligt i Slack‑arbetsflödet.
Best practices för att bygga Agent Teams
En bra agentteam‑setup handlar mest om förarbete. Själva teamet är snabbt, men tiden du förlorar ligger i dåligt avgränsade uppgifter och otydliga roller.
Här är några bästa metoder:
-
Definiera rollerna tydligt: Varje lagkamrat ska ha ett fokus och en uppsättning filer den äger. När du skapar en lagkamrat, tala om exakt vad den ansvarar för, vad den inte ansvarar för och vilka filer eller moduler den får arbeta med. Otydliga roller ger överlappande arbete och överlappande arbete ger merge‑konflikter.
-
Dekomponera uppgifter innan du parallelliserar: Planera först, parallellisera sedan. Kör ett planeringsvarv för att bryta ner arbetet i uppgifter med tydliga indata, utdata och beroenden, och lämna sedan över planen till teamet för utförande. En plan kostar några tusen tokens, men ett team som går i fel riktning kan kosta hundratusentals.
-
Dela standarder via CLAUDE.md: Varje lagkamrat läser filen
CLAUDE.mdi arbetskatalogen när den startar, så lägg dina gemensamma konventioner där, inklusive kodstil, fillayout, teststrategi och format för commit‑meddelanden. -
Bygg in granskningskontroller: Stäm av lagkamraters framsteg, styr om dem som är ur kurs och granska ledarens resultat innan du accepterar det. För riskfyllda uppgifter, kräv plan‑godkännande innan någon lagkamrat gör ändringar. Detta tvingar lagkamraten att visa sin plan först och vänta på att ledaren godkänner den.
-
Begränsa teamstorleken: Börja med tre till fem lagkamrater för de flesta arbetsflöden. Därutöver växer koordinerings‑overhead snabbare än den parallella hastighetsvinsten.
-
Undvik filkonflikter: Dela upp arbetet längs fil- eller modulgränser så att varje lagkamrat är tydligt avskild. Två lagkamrater som redigerar samma fil kommer att skriva över varandras ändringar. Om en uppgift verkligen kräver att flera lagkamrater arbetar i samma fil, kör den i sekvens i stället för parallellt.
-
Förhandsgodkänn vanliga operationer: Behörighetsförfrågningar från lagkamrater bubblar upp till ledaren, och ett team med fyra lagkamrater kan ge fyra gånger så många prompts. Konfigurera din
permissions.allow‑lista innan du startar teamet så att rutinoperationer som att läsa filer eller köra tester inte avbryter arbetet. -
Matcha modellen med rollen: Kör ledaren på en starkare modell som Opus, eftersom koordinering gynnas av djupare resonemang, och kör lagkamraterna på Sonnet för utförandet.
Och här är kortversionen: skapa en detaljerad arbetsplan, briefa teamet som du skulle briefa en liten grupp juniorutvecklare, ge dem tydliga omfång och gemensamma standarder och kontrollera deras arbete i slutet. Ju närmare din setup ligger hur ett riktigt engineering‑team arbetar, desto bättre kommer agentteamet att prestera.
Claude Code Agent Team i praktiken
Här är allt från början till slut.
Jag går igenom ett litet exempel: ett "hello world"‑REST‑API i FastAPI som läser ett meddelande från en SQLite‑databas, plus en liten HTML‑sida som anropar API:et och visar resultatet. Appen har en backend‑rutt, ett databaslager, en statisk frontend och en readme‑dokumentation, vilket gör den väl lämpad för ett fyrmannateam.
Aktivera agentteam
Agentteam är en experimentell funktion och är avstängd som standard. Du slår på dem genom att sätta en miljövariabel, antingen i ditt skal eller i din Claude Code‑inställningsfil.
Inställningsfilen finns på ~/.claude/settings.json. Öppna den och lägg till:
{
"env": {
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
}
}
Om du hellre inte redigerar inställningsfilen kan du sätta variabeln i ditt skal innan du startar Claude Code:
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
Båda sätten fungerar. När variabeln är satt kommer Claude Code att känna igen teamrelaterade prompts och starta koordineringslagret när du ber om det.
Starta Claude Code och briefa teamet
Skapa en tom katalog för projektet och starta Claude Code inuti den:
mkdir hello-api && cd hello-api
claude
Nu briefar du teamet. Prompten är vanlig naturlig text, men ju mer specifik du är om roller och gränser, desto bättre presterar teamet. Här är prompten för hello world‑API:t:
Create an agent team to build a small "hello world" REST API.
The project is a FastAPI service that returns a greeting from a SQLite
database, plus a tiny HTML page that calls the API and shows the result.
- One teammate on the database: create app/db.py with a sqlite3 connection
to a greetings.db file. Define a get_greeting() function that returns
the message column from the first row. On import, create the table if
it doesn't exist and seed it with "Hello, World!" if empty.
- One teammate on the backend: build a FastAPI app in app/main.py with
a GET /greeting endpoint that calls get_greeting() from app/db.py.
Add permissive CORS and mount the static/ directory at the root so
the HTML page is served from the same origin.
- One teammate on the frontend: build static/index.html as a single page
that fetches /greeting on load, shows a spinner while loading, displays
the greeting in a centered card on success, and shows an error message
on failure. Inline the CSS and JavaScript.
- One teammate on docs: write README.md with installation, run, and
open-in-browser steps, plus an API reference table. Also create
requirements.txt with fastapi and uvicorn[standard].
Use Sonnet for each teammate. Require plan approval before any teammate
makes changes.
Tre saker är värda att notera i den här prompten. Filgränserna (app/db.py, app/main.py, static/index.html, README.md, requirements.txt) förhindrar överlapp. Modellvalet (Sonnet) håller tokenkostnaderna hanterbara. Och plan approval tvingar varje lagkamrat att visa sin plan innan den skriver någon kod, vilket ger dig en kontrollpunkt för att styra om någon som missförstod briefen.
Se teamet göra sitt
Efter att du skickat prompten bryter ledaren ner arbetet i uppgifter och startar lagkamraterna. Du ser en agentpanel längst ned i terminalen med en rad per lagkamrat.
Skapade agenter
Varje rad visar lagkamratens namn och vad den gör just nu. Ledaren fyller den delade uppgiftslistan och tilldelar eller friger uppgifter baserat på beroenden. Backend‑kamraten väntar på databaslagret eftersom den importerar get_greeting() från det. Dokumentationskamraten väntar tills resten har kommit tillräckligt långt för att kunna beskrivas korrekt.
Du kan också se uppgiftslistan. Tryck på Ctrl+T för att växla den. Listan visar varje uppgift, dess status (väntande, pågående eller slutförd) och vilken lagkamrat som äger den.
Växla mellan lagkamrater
Varje lagkamrat är en fullständig Claude Code‑session, och du kan prata med vilken som helst av dem.
I agentpanelen använder du upp- och nedpilarna för att välja en lagkamrat och trycker sedan på Enter för att öppna dess transkript. Du är nu i den lagkamratens session, och allt du skriver går till den lagkamraten, inte till ledaren. Så här ger du en specifik lagkamrat extra kontext eller styr om dess angreppssätt utan att involvera resten av teamet.
Tryck på Esc för att återgå till ledaren.
Styr om en lagkamrat som är ur kurs
Ibland missförstår en lagkamrat briefen eller glider in på arbete den inte ska göra. Du upptäcker detta antingen genom att kontrollera dess plan under plan‑godkännandet eller genom att se dess framsteg avvika i agentpanelen.
Om du använder plan‑godkännande pausar lagkamraten efter planeringen och visar dig sitt förslag innan den skriver några filer. Så här ser det ut för databasagenten:

Godkännande av databasagent
Du kan läsa det föreslagna schemat och angreppssättet och sedan godkänna eller avslå med feedback. Om planen saknar något kan du svara med något i stil med "Använd SQLAlchemy i stället för rå sqlite3", så planerar lagkamraten om.
Om du upptäcker ett problem efter att en lagkamrat redan har börjat arbeta, välj lagkamraten i agentpanelen, tryck på Enter för att öppna dess session och skicka ett meddelande. Du kan också trycka x på en markerad lagkamrat för att stoppa den, eller be ledaren starta en ersättare om den nuvarande har kört fast helt.
Avrunda och granska
När alla lagkamrater är klara med sina uppgifter återkopplar ledaren med en kort sammanfattning och kommandona du behöver för att köra projektet.

Slutinstruktioner från ledaren
Nu granskar du arbetet. Du kan öppna de genererade filerna i din editor och läsa diffs.

Den genererade filen app/main.py
Du kan också inspektera databasen som databasagenten skapade och seedade.

Tabellen greetings
Installera sedan beroendena, kör uvicorn app.main:app --reload och öppna http://localhost:8000 i din webbläsare för att bekräfta att hela stacken fungerar från början till slut.

Slutlig app
Om du vill ha ändringar, tala om för ledaren vad som ska justeras, så fixar den antingen problemet själv eller startar en ny lagkamrat som hanterar det. När du är nöjd med resultatet kan du be ledaren att committa ändringarna. Ledaren stänger ner lagkamraterna när sessionen avslutas och teamkonfigurationen städas upp.
Det var allt!
Slutsats
Claude Code Agent Teams handlar om två saker: specialisering och koordinering. Varje lagkamrat har sin egen del av arbetet och sitt eget kontextfönster. Ledaren håller dem i linje, uppgiftslistan håller dem synkade och direktmeddelanden gör att de slipper vänta på att du ska vidarebefordra information mellan sessioner.
I det större perspektivet rör sig AI‑assisterad utveckling från solo till koordinerad. Agentteam är hur den förändringen syns i Claude Code i dag, och samma mönster syns i Claude Tag för Slack. Utvecklare som blir bekväma med detta nu kommer att lägga mindre tid på att hantera kontextgränser och mer tid på att leverera faktiska funktioner.
Letar du efter certifiering inom generativ AI? Här är de bästa certifieringarna inom generativ AI 2026 inklusive toppkurser, förberedelsetips och vanliga frågor.
FAQs
Vad är Claude Code Agent Teams?
Claude Code Agent Teams är ett koordineringslager som gör det möjligt för flera Claude Code‑sessioner att arbeta på samma projekt samtidigt. En session fungerar som teamledare och skapar andra sessioner, kallade lagkamrater, för att göra specifika delar av arbetet. Lagkamraterna delar en uppgiftslista, skickar meddelanden till varandra och utför sitt arbete parallellt under ledarens koordinering.
Hur skiljer sig agentteam från underagenter?
Underagenter körs inuti en enda Claude Code‑session och kan bara rapportera resultat tillbaka till huvudagenten. Agentteam består av oberoende Claude Code‑sessioner som delar en uppgiftslista och skickar meddelanden till varandra utan att gå via ledaren. Använd agentteam när arbetarna behöver dela fynd eller koordinera kring ömsesidigt beroende uppgifter.
När är det vettigt att använda ett agentteam?
Agentteam passar bra för arbete som gynnas av parallell utforskning, som flerskiktsfunktioner, stora refaktoreringar, felsökning med konkurrerande hypoteser och repo‑omfattande granskningar. De är mindre användbara för små buggfixar eller arbete där flera lagkamrater skulle sluta med att redigera samma filer. En bra tumregel är att om en enda session antingen skulle få slut på kontext eller ta alldeles för lång tid, är ett team värt de extra tokens.
Hur mycket kostar agentteam i tokens?
Varje lagkamrat är en fullständig Claude Code‑session med sitt eget kontextfönster, så tokenanvändningen skalar linjärt med teamstorleken. Ett team med tre eller fyra lagkamrater använder ungefär tre eller fyra gånger så många tokens som en enda session för samma mängd arbete. Du kan hålla kostnaderna hanterbara genom att köra ledaren på en starkare modell som Opus och lagkamraterna på Sonnet, eftersom utförande vanligtvis inte kräver samma djup i resonemang som koordinering.
Hur förhindrar jag att lagkamrater skriver över varandras arbete?
Dela upp arbetet längs fil- eller modulgränser så att varje lagkamrat äger sin egen yta. När du briefar teamet, namnge de specifika filer eller kataloger varje lagkamrat ansvarar för, och undvik att låta två lagkamrater arbeta på samma fil. Om en uppgift kräver ändringar i samma fil, kör den i sekvens som ett beroende i uppgiftslistan i stället för parallellt.