Claude Code käynnistää tiimityötilan! Sinun täytyy käyttää Agent Teams -toimintoa!

Claude Code on taas julkaissut uuden ominaisuuden: Agent Teams, jota voidaan pitää Sub Agents -toiminnon supertehostettuna versiona. Alla on vertailu Agent Teams:n ja Subagents:in välillä:

Minä olen jo "käyttänyt ensin"! (Todella hyvä! Todella hyvä! Todella hyvä!)

Agent Teams:n käyttöönoton ehdot: 
1. Päivitä Claude Code uusimpaan versioon (claude update) 

2. Lisää settings.json-tiedostoon seuraava rivi:

"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" 

3. Käynnistä Claude Code uudelleen～  

4. Käytä sitten luonnollista kieltä pyytääksesi Claude Code:a luomaan Agent Teams -tiimin (tietenkin selittäen selvästi, mitä Agent Teams:n pitää tehdä)  

Lisäksi muut mallit eivät vaikuta Agent Teams:n työhön (käytin KIMi for coding -mallia)

Lisätietoja Agent Teams:stä löytyy alla (Anthropicin virallinen artikkeli)!

Agent Teams mahdollistaa useiden Claude Code -instanssien yhteistyön. Yksi istunto toimii pomona, koordinoiden työtä, jakamalla tehtäviä ja yhdistäen tulokset. Alaiset työskentelevät itsenäisesti omissa konteksti-ikkunoissaan ja voivat suoraan keskustella keskenään.

Toisin kuin ala-agentit (Subagents) (jotka toimivat yhdessä istunnossa ja voivat raportoida vain pääagentille), voit myös suoraan olla vuorovaikutuksessa yksittäisten alaisten kanssa ilman pomon välitystä.

Tämä dokumentti kattaa:

• • Milloin käyttää Agent Teams:iä, mukaan lukien parhaat käyttötapaukset ja vertailu ala-agenteihin

• • Tiimin käynnistäminen

• • Alaisten hallinta, mukaan lukien näyttötilat, tehtävien jakaminen ja delegointi

• • Parhaat käytännöt rinnakkaistyölle

Milloin käyttää Agent Teams:iä

Agent Teams on tehokkain tehtävissä, joissa rinnakkaistutkimus lisää todellista arvoa. Vahvimmat käyttötapaukset sisältävät:

• • Tutkimus ja tarkastus —— Useat alaiset voivat samanaikaisesti tutkia ongelman eri näkökulmia ja jakaa sekä haastaa toistensa löydöksiä

• • Uudet moduulit tai toiminnot —— Alaiset voivat omistaa itsenäisiä osia toisistaan riippumatta

• • Vianetsintä kilpailevine hypoteeseineen —— Alaiset testaavat rinnakkain eri teorioita löytääkseen vastauksen nopeammin

• • Kerrosten ylittävä koordinointi —— Muutokset etu-, taka- ja testauspuolella, joista jokaisen hoitaa eri alainen

Agent Teams lisää koordinaatiokuormaa (Uskallatko käyttää Opus4.6:ta Agent Teams:n kanssa🤣), mikä kasvattaa merkkiaineiston (token) kulutusta huomattavasti verrattuna yksittäiseen istuntoon. Ne toimivat parhaiten, kun pienet ryhmät voivat toimia itsenäisesti. Sekvenssitehtäville, saman tiedoston muokkauksille tai työlle, jossa on paljon riippuvuuksia, yksittäinen istunto tai ala-agentit ovat tehokkaampia.

Vertailu ala-agenteihin

Agent Teams ja ala-agentit mahdollistavat molemmat rinnakkaistyön, mutta toimivat eri tavoin. Valitse sen perusteella, tarvitsevatko työntekijäsi kommunikoida keskenään:

Ala-agentit

Agent Teams

Konteksti

Oma konteksti-ikkuna; tulokset palautetaan kutsujalle

Oma konteksti-ikkuna; täysin itsenäinen

Kommunikaatio

Raportoi tulokset vain pääagentille

Alaiset lähettävät suoraan viestejä toisilleen

Koordinointi

Pääagentti hallinnoi kaikkea työtä

Jaettu tehtävälista, itsekoordinointi

Sopii parhaiten

Keskittyneet tehtävät, joissa vain tulokset kiinnostavat

Monimutkainen työ, joka vaatii keskustelua ja yhteistyötä

Merkkiaineiston (token) kustannus

Alempi: tulokset kootaan takaisin pääkontekstiin

Korkeampi: jokainen alainen on itsenäinen Claude-instanssi

Käytä ala-agenteja, kun tarvitset nopeita, keskittyneitä työntekijöitä raportoimaan tuloksia. Käytä Agent Teams:iä, kun ryhmän täytyy jakaa löydöksiä, haastaa toisiaan ja koordinoida itseään.

Agent Teams:n käyttöönotto

Agent Teams on oletusarvoisesti poissa käytöstä. Ota se käyttöön asettamalla CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS ympäristömuuttujan arvoksi 1 , joko kuorissa (shell) tai settings.json-tiedoston kautta:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Ensimmäisen Agent Team -tiimisi käynnistäminen

Kun Agent Teams on otettu käyttöön, kerro Claudelle luoda Agent Team -tiimi käyttäen luonnollista kieltä kuvaamaan tehtävää ja haluamaasi tiimirakennetta. Claude luo tiimin, generoi alaisia ja koordinoi työtä kehotteesi perusteella.

Tämä esimerkki toimii hyvin, koska kolme roolia ovat itsenäisiä ja voivat tutkia ongelmaa odottamatta toisiaan:

Create an agent team to explore this from different angles: one teammate on UX, one on technical architecture, one playing devil's advocate.
(Luo Agent Team -tiimi tutkimaan tätä eri näkökulmista: yksi tiimiläinen UX:stä, yksi teknisestä arkkitehtuurista, yksi esittämään pirun asianajajaa.)

Sieltä Claude luo tiimin jaetulla tehtävälistalla, generoi alaisen jokaiselle näkökulmalle, antaa heidän tutkia ongelmaa, yhdistää löydöksiä ja yrittää siivota tiimin valmistuttua.

Pomon terminaali listaa kaikki alaiset ja heidän työnsä. Käytä Shift+Up/Down valitaksesi alaisen ja lähettääksesi heille suoraan viestejä.

Agent Team -tiimisi hallinta

Kerro pomolle luonnollisella kielellä mitä haluat. Se käsittelee tiimikoordinaatiota, tehtävien jakamista ja delegointia ohjeidesi perusteella.

Näyttötilan valinta

Agent Teams tukee kahta näyttötilaa:

• • Prosessinsisäinen tila —— Kaikki alaiset toimivat pääterminaalissasi. Käytä Shift+Up/Down valitaksesi alaisen ja kirjoittaaksesi suoraan viestin lähettämiseksi. Sopii mille tahansa terminaalille, ei tarvita lisäasetuksia.

• • Jaettu näyttötila —— Jokaisella alaisella on oma ruutu. Voit nähdä kaikkien tulosteen samanaikaisesti, napsauta ruutua ollaaksesi suorassa vuorovaikutuksessa. Vaatii tmux:n tai iTerm2:n.

Oletus on "auto", joka käyttää jaettua näyttötilaa, jos olet jo tmux-istunnossa, muuten prosessinsisäistä tilaa.

Pakota prosessinsisäinen tila yksittäiselle istunnolle välittämällä lippu:

claude --teammate-mode in-process

Alaisten ja mallien määrittäminen

Claude päättää, kuinka monta tiimiläistä generoidaan tehtävän perusteella, tai voit tarkasti määrittää, mitä haluat:

Create a team with 4 teammates to refactor these modules in parallel. Use Sonnet for each teammate.
(Luo 4-henkinen tiimi refaktoroidakseen nämä moduulit rinnakkain. Käytä Sonnet-mallia jokaiselle tiimiläiselle.)

Tiimiläisten suunnitelman hyväksynnän vaatiminen

Monimutkaisille tai riskialttiille tehtäville voit vaatia tiimiläisiä suunnittelemaan ennen toteutusta. Tiimiläinen työskentelee vain luku -suunnittelutilassa, kunnes pomo hyväksyy heidän menetelmänsä:

Spawn an architect teammate to refactor the authentication module. Require plan approval before they make any changes.
(Generoi arkkitehti-tiimiläinen refaktoroidakseen tunnistusmoduulin. Vaatii suunnitelman hyväksynnän ennen kuin he tekevät muutoksia.)

Kun tiimiläinen suorittaa suunnitelman, se lähettää pomolle suunnitelman hyväksyntäpyynnön. Pomo tarkastaa suunnitelman ja hyväksyy tai hylkää sen ja antaa palautetta.

Delegointitilan käyttö

Ilman delegointitilaa pomo voi joskus aloittaa tehtävien toteuttamisen itse odottamatta alaisten valmistumista. Delegointitila estää tämän rajoittamalla pomon vain koordinaatiotyökaluksi. Vaihda delegointitilaan painamalla Shift+Tab.

Suora keskustelu alaisten kanssa

Jokainen alainen on täysi, itsenäinen Claude Code -istunto. Voit suoraan lähettää viestejä mille tahansa alaiselle:

• • Prosessinsisäinen tila: Käytä Shift+Up/Down valitaksesi alaisen, kirjoita sitten viesti lähettääksesi sen. Paina Enter nähdäksesi alaisen istunnon, paina sitten Escape keskeyttääksesi heidän nykyisen kierroksensa. Paina Ctrl+T vaihtaaksesi tehtävälistaa.

• • Jaettu näyttötila: Napsauta alaisen ruutua ollaaksesi suorassa vuorovaikutuksessa heidän istuntonsa kanssa.

Tehtävien jakaminen ja ottaminen

Jaettu tehtävälista koordinoi tiimin työtä. Pomo luo tehtäviä, alaiset suorittavat ne. Tehtävillä on kolme tilaa: odottava, käynnissä, valmis. Tehtävillä voi olla myös riippuvuuksia muihin tehtäviin.

Pomo voi nimenomaisesti jakaa tehtäviä, tai alaiset voivat ottaa tehtäviä itsenäisesti valmistuttuaan.

Alaisten sulkeminen

Sulkeaksesi tiimiläisen istunnon siististi:

Ask the researcher teammate to shut down
(Pyydä tutkija-tiimiläistä sulkemaan)

Pomo lähettää sulkemispyynnön. Tiimiläinen voi hyväksyä ja poistua siististi tai kieltäytyä ja selittää syyn.

Tiimin siivoaminen

Valmistuttua, pyydä pomoa siivoamaan:

Clean up the team
(Siivoa tiimi)

Tämä poistaa jaetut tiimiresurssit. Kun pomo suorittaa siivouksen, se tarkistaa aktiiviset alaiset ja epäonnistuu, jos jotkut ovat vielä käynnissä, joten sulje heidät ensin.

Kuinka Agent Teams toimii

Arkkitehtuuri

Agent Team -tiimi sisältää:

• • Pomo: Pää-Claude Code -istunto, joka luo tiimin, generoi alaisia ja koordinoi työtä

• • Alaiset: Itsenäiset Claude Code -instanssit, jotka käsittelevät jaettuja tehtäviä

• • Tehtävälista: Jaettu lista työkohteista, joita alaiset ottavat ja suorittavat

• • Sähköpostilaatikko: Viestijärjestelmä agenttien väliseen kommunikaatioon

Järjestelmä hallinnoi automaattisesti tehtäväriippuvuuksia. Tiimi ja tehtävät tallennetaan paikallisesti:

• • Tiimikonfiguraatio: ~/.claude/teams/{team-name}/config.json

• • Tehtävälista: ~/.claude/tasks/{team-name}/

Konteksti ja kommunikaatio

Jokaisella alaisella on oma konteksti-ikkuna. Generoitaessa alainen lataa saman projektikontekstin kuin tavallinen istunto: CLAUDE.md, MCP-palvelimet ja taidot. Pomon keskusteluhistoriaa ei siirretä.

Kuinka alaiset jakavat tietoa:

• • Automaattinen viestinvälitys: Kun alainen lähettää viestin, se välitetään automaattisesti vastaanottajalle

• • Tyhjäkäynnillä olevan ilmoitus: Kun alainen valmistuu ja pysähtyy, se ilmoittaa automaattisesti pomolle

• • Jaettu tehtävälista: Kaikki agentit voivat nähdä tehtävien tilan ja ottaa saatavilla olevaa työtä

Merkkiaineiston (token) käyttö

Agent Teams kuluttaa merkittävästi enemmän merkkiaineistoa (tokens) kuin yksittäinen istunto. Jokaisella alaisella on oma konteksti-ikkuna, ja merkkiaineiston käyttö kasvaa aktiivisten alaisten määrän mukana. Tutkimukselle, tarkastukselle ja uusille toiminnoille ylimääräinen merkkiaineisto on yleensä sen arvoista. Tavallisille tehtäville yksittäinen istunto on kustannustehokkaampi.

Käyttötapausesimerkkejä

Rinnakkaisen koodin tarkastuksen suorittaminen

Yksittäinen tarkastaja keskittyy yleensä kerrallaan yhteen ongelmatyyppiin. Jakamalla tarkastuskriteerit itsenäisiin alueisiin tarkoittaa, että turvallisuus, suorituskyky ja testikattavuus saavat samanaikaisesti perusteellista huomiota.

Create an agent team to review PR #142. Spawn three reviewers: one focused on security implications, one checking performance impact, one validating test coverage. Have them each review and report findings.
(Luo Agent Team -tiimi tarkastamaan PR #142. Generoi kolme tarkastajaa: yksi keskittyen turvallisuusvaikutuksiin, yksi tarkistaen suorituskykyvaikutuksen, yksi vahvistaen testikattavuuden. Anna heidän jokaisen tarkastaa ja raportoida löydöksiä.)

Tutkiminen kilpailevine hypoteeseineen

Kun juurisyy on epäselvä, yksittäinen agentti taipuu löytämään yhden näennäisesti uskottavan selityksen ja lopettamaan etsimisen.

Users report the app exits after one message instead of staying connected. Spawn 5 agent teammates to investigate different hypotheses. Have them talk to each other to try to disprove each other's theories, like a scientific debate. Update the findings doc with whatever consensus emerges.

Parhaat käytännöt

Anna alaisille riittävästi kontekstia

Alaiset lataavat automaattisesti projektikontekstin, mutta eivät peri pomon keskusteluhistoriaa. Sisällytä generointikehotteeseen tehtäväkohtaiset yksityiskohdat.

Tehtävien koon oikea säätäminen

• • Liian pieni: Koordinointikuorma ylittää hyödyn

• • Liian suuri: Alaiset työskentelevät liian kauan ilman tarkistusta, lisäten hukkatyön riskiä

• • Sopiva: Itsenäinen yksikkö, joka tuottaa selkeän toimituksen

Odota alaisten valmistumista

Joskus pomo aloittaa tehtävien toteuttamisen itse odottamatta tiimiläisten valmistumista. Jos huomaat tämän:

Wait for your teammates to complete their tasks before proceeding
(Odota tiimiläistesi suorittavan tehtävänsä ennen kuin jatkat)

Vältä tiedostoristiriitoja

Kahden alaisen muokkaaminen samaa tiedostoa voi johtaa ylikirjoittamiseen. Jaa työ niin, että jokaisella alaisella on eri tiedostojoukko.

Seuranta ja ohjaus

Tarkista alaisten edistyminen, uudelleenohjaa toimimattomia menetelmiä ja yhdistä löydöksiä edetessä.

Rajoitukset

Agent Teams on kokeellinen. Nykyiset rajoitukset:

• • Prosessinsisäiset tiimiläiset eivät tue istunnon palautusta: /resume ja /rewind eivät palauta prosessinsisäisiä alaisia

• • Tehtävätila voi viivästyä: Alaiset eivät aina pysty merkitsemään tehtävää valmiiksi

• • Sulkeminen voi olla hidasta: Alaiset suorittavat nykyisen pyynnön ennen sulkemista

• • Yksi tiimi per istunto: Yksi pomo voi hallita vain yhtä tiimiä kerrallaan

• • Pesästetyt tiimit eivät ole tuettuja: Alaiset eivät voi generoida omia tiimejään

• • Pomo on kiinteä: Istunto, joka luo tiimin, on pomo sen elinkaaren ajan

• • Jaettu näyttötila vaatii tmux:n tai iTerm2:n: VS Code -integroidut terminaalit, Windows Terminal tai Ghostty eivät ole tuettuja