Claude Code subagentit – näin tekoäly jakaa työn osiin

Kuvittele, että pyydät yhtä ihmistä tekemään kymmenen asiaa peräkkäin. Ensin hän tutkii koodipohjan, sitten etsii bugeja, sitten refaktoroi, sitten kirjoittaa testit... Joka vaiheessa hän unohtaa vähän siitä, mitä oppi edellisessä. Ja koko homma kestää ikuisuuden.

Kuvittele sitten, että sinulla on tiimi. Yksi tutkii koodipohjan, toinen etsii bugeja, kolmas refaktoroi. He tekevät töitä samanaikaisesti ja raportoivat takaisin sinulle. Tämä on subagentit. Ja Claude Code osaa tehdä tämän automaattisesti.

Mitä subagentit ovat?

Subagentit ovat Claude Coden tapa jakaa iso tehtävä pienempiin osiin, jotka se delegoi erillisille "alagenteille". Jokainen subagentin saa oman rajatun tehtävän ja oman kontekstin. Ne toimivat itsenäisesti ja palauttavat tuloksen takaisin pääagentille.

Ajattele sitä kuin projektipäällikköä, joka ei tee kaikkea itse. Hyvä projektipäällikkö jakaa työn tiimiläisille heidän osaamisensa mukaan. Claude Coden pääagentti toimii samalla tavalla -- se arvioi mitä pitää tehdä, päättää mitkä osat voi hoitaa rinnakkain ja lähettää subagentit hoitamaan homman.

Tämä ei ole pelkkä teoreettinen ominaisuus. Jos olet käyttänyt Claude Codea isommassa projektissa, olet todennäköisesti nähnyt subagentit toiminnassa. Ne näkyvät terminaalissa erillisinä "Task"-lohkoina, jotka pyörivät samaan aikaan kun pääagentti jatkaa omaa työtään.

Miten subagentit toimivat käytännössä?

Kun annat Claude Codelle monimutkaisen tehtävän, pääagentti käy läpi kolmivaiheisen prosessin:

1. Arviointi. Pääagentti analysoi tehtävän ja päättää, kannattaako se jakaa osiin. Yksinkertaisen yhden tiedoston muutoksen se tekee itse. Mutta jos tehtävä vaatii tiedon keräämistä useista lähteistä tai muutoksia moneen tiedostoon, se delegoi.

2. Delegointi. Pääagentti luo subagentit ja antaa jokaiselle selkeän tehtävänannon. Subagentit eivät näe koko keskusteluhistoriaasi -- ne saavat vain sen kontekstin, jonka pääagentti niille antaa. Tämä on tarkoituksellista: rajattu konteksti pitää subagentit fokusoituneina.

3. Yhdistäminen. Kun subagentit palauttavat tuloksensa, pääagentti kokoaa ne yhteen. Se voi käyttää tuloksia seuraavan vaiheen suunnitteluun tai yhdistää ne suoraan lopulliseen vastaukseen.

Tärkeä yksityiskohta: subagentit eivät puhu toisilleen. Ne eivät tiedä toistensa olemassaolosta. Kaikki koordinointi tapahtuu pääagentin kautta. Tämä pitää arkkitehtuurin yksinkertaisena ja ennustettavana.

Milloin Claude Code käyttää subagenteja?

Subagentit eivät aktivoidu joka promptilla. Claude Code käyttää niitä silloin, kun se tunnistaa tilanteen, jossa rinnakkaisuus nopeuttaa työtä tai rajattu konteksti parantaa tulosta. Tyypillisiä tilanteita:

Koodipohjan tutkiminen

Kun pyydät Claude Codea ymmärtämään isoa projektia, se voi lähettää subagentit tutkimaan eri osia samanaikaisesti. Yksi tutkii tietokantakerrosta, toinen API-routeja, kolmas frontend-komponentteja. Pääagentti saa kokonaiskuvan nopeammin kuin tutkimalla kaiken peräkkäin.

Testien ajaminen ja analysointi

Subagentit voivat ajaa eri testitiedostoja rinnakkain ja raportoida tulokset takaisin. Jos testit epäonnistuvat, pääagentti saa nopeasti kuvan siitä, mitkä osat toimivat ja mitkä eivät.

Usean tiedoston muokkaaminen

Jos refaktoroit esimerkiksi komponentin nimeä koko koodipohjan läpi, subagentit voivat etsiä kaikki viittaukset eri hakemistoista samanaikaisesti. Pääagentti tekee muutokset tulosten perusteella.

Tiedon kerääminen

Kun Claude Code tarvitsee tietoa monesta lähteestä -- konfiguraatiotiedostot, tyypit, olemassa olevat toteutukset -- subagentit hakevat tietoa rinnakkain. Tämä on erityisen hyödyllistä isoissa projekteissa, joissa tiedostoja on satoja.

Käytännön esimerkki: refaktorointi subagentein

Katsotaan konkreettinen tilanne. Sinulla on Next.js-projekti, jossa käyttäjädata haetaan kymmenessä eri komponentissa suoraan API-kutsulla. Haluat siirtää kaiken React Queryn taakse.

Kirjoitat Claude Codelle:

Refaktoroi kaikki suorat fetch-kutsut käyttämään React Querya.
Luo uusi hooks-kansio, johon tulee custom hookit jokaiselle
API-endpointille. Päivitä kaikki komponentit käyttämään uusia
hookeja. Älä riko mitään olemassa olevaa toiminnallisuutta.

Tämän jälkeen Claude Code käynnistää subagentit:

Subagentin 1: "Etsi kaikki tiedostot, joissa tehdään fetch-kutsuja API-endpointteihin. Listaa jokainen tiedosto, endpointin URL ja miten dataa käytetään."

Subagentin 2: "Tutki projektin olemassa oleva React Query -konfiguraatio. Onko QueryClient jo asetettu? Mikä versio on käytössä? Onko olemassa olevia custom hookeja?"

Subagentin 3: "Lue projektin tyyppimäärittelyt. Mitä tyyppejä API-vastaukset käyttävät?"

Kun subagentit palauttavat tuloksensa, pääagentti tietää tarkalleen:

• Mitkä 10 komponenttia tarvitsevat muutoksen
• Minkälaiset fetch-kutsut niissä on
• Onko React Query jo konfiguroitu
• Mitä tyyppejä hookien pitää palauttaa

Sitten pääagentti tekee itse muutokset -- tai delegoi nekin subagentein, jos muutoksia on paljon. Lopputulos: kymmenen komponentin refaktorointi, joka olisi voinut kestää tunnin, on valmis minuuteissa.

Subagentien hyödyt

Nopeus

Tämä on ilmeisin hyöty. Rinnakkainen suoritus on nopeampaa kuin peräkkäinen. Kun viisi subagenttiä tutkii koodipohjaasi samanaikaisesti, saat tulokset murto-osassa siitä ajasta, joka menisi kaiken tutkimiseen peräkkäin.

Parempi kontekstin hallinta

Tämä on vähemmän ilmeinen mutta yhtä tärkeä hyöty. Jokaisella tekoälymallilla on rajallinen konteksti-ikkuna -- se määrä tekstiä, jonka se pystyy pitämään "mielessään" kerralla. Kun pääagentti yrittää tehdä kaiken itse, konteksti täyttyy nopeasti ja laatu heikkenee.

Subagentit ratkaisevat tämän. Jokainen subagentin saa vain sen kontekstin, jonka se tarvitsee omaan tehtäväänsä. Tuhat rivin tiedosto ei vie tilaa sellaiselta subagentilta, joka tutkii toista osaa koodista. Lopputulos on tarkempi ja luotettavampi.

Erikoistuminen

Rajattu tehtävänanto tuottaa parempia tuloksia. Subagentin, joka keskittyy pelkästään tyyppimäärittelyjen etsimiseen, tekee sen paremmin kuin agentti, joka samalla yrittää refaktoroida koodia, ajaa testejä ja kirjoittaa dokumentaatiota. Sama periaate pätee ihmisiin -- ja tekoälyyn.

Rajoitukset ja huomiot

Subagentit eivät ole hopealuoti. Tässä rehellinen lista asioista, jotka kannattaa tietää.

Tokenit maksavat. Jokainen subagentin kuluttaa tokeneita. Viisi subagenttiä, jotka kukin lukevat suuria tiedostoja, voi maksaa huomattavasti enemmän kuin yksi agentti, joka tekee saman työn peräkkäin. Jos käytät Claude Codea API-avaimella, seuraa tokenien kulutusta.

Yksinkertaisiin tehtäviin subagentit ovat ylilyönti. Jos muutat yhden rivin yhdessä tiedostossa, subagentien käynnistäminen on turhaa. Claude Code osaa yleensä arvioida tämän itse, mutta joskus se delegoi tarpeettomasti. Se ei ole virhe -- se on vain tehotonta.

Subagentit eivät jaa kontekstia keskenään. Jos subagentin A löytää jotain, mikä olisi hyödyllistä subagentille B, tieto kulkee vasta pääagentin kautta. Tämä voi joskus johtaa päällekkäiseen työhön.

Tulokset eivät ole aina deterministisiä. Sama prompti voi tuottaa eri subagenttijaon eri kerroilla. Tämä on normaalia -- tekoäly arvioi joka kerta erikseen, miten työ kannattaa jakaa.

Vinkit: näin saat subagentit toimimaan parhaiten

Subagentit toimivat automaattisesti, mutta voit vaikuttaa siihen, kuinka tehokkaasti Claude Code niitä käyttää.

Anna monivaiheisia tehtäviä

Jos kirjoitat "muuta tämän napin väriä", subagentit eivät aktivoidu. Mutta jos kirjoitat "tutki miten värit on toteutettu tässä projektissa, yhtenäistä ne design-tokenien taakse ja päivitä kaikki komponentit", Claude Code ymmärtää, että työ kannattaa jakaa osiin.

Ole tarkka lopputuloksesta, älä askelista

Älä kerro Claude Codelle "käynnistä ensin subagentin, joka tutkii tiedostot". Se osaa itse päättää milloin delegoida. Kerro sen sijaan mitä haluat lopputulokseksi. Pääagentti hoitaa delegoinnin.

Hyödynnä CLAUDE.md-tiedostoa

Hyvä CLAUDE.md-tiedosto auttaa subagenteja ymmärtämään projektisi kontekstin nopeammin. Kun projektin rakenne, konventiot ja teknologiapino on dokumentoitu, subagentit eivät tuhlaa tokeneita perusasioiden selvittelyyn.

Isot projektit hyötyvät eniten

Jos projektissasi on kymmeniä tiedostoja ja selkeä modulaarinen rakenne, subagentit pääsevät oikeuksiinsa. Pienissä yhden tiedoston projekteissa niistä ei ole juuri hyötyä.

Subagentit ja agenttisen koodauksen tulevaisuus

Subagentit ovat esimerkki siitä, miten agenttinen koodaus kehittyy. Ensin tekoäly oppi ehdottamaan koodia. Sitten se oppi toteuttamaan tehtäviä itsenäisesti. Nyt se oppii delegoimaan ja koordinoimaan työtä -- aivan kuten ihmistiimi.

Tämä on suunta, johon koko ala on menossa. Tulevaisuuden tekoälykoodaustyökalut eivät ole yksittäisiä agentteja, jotka tekevät kaiken itse. Ne ovat orkestraattoreita, jotka johtavat tiimejä erikoistuneita agentteja. Claude Coden subagentit ovat tämän kehityksen eturintamassa.

Vibekoodaajalle tämä tarkoittaa käytännössä sitä, että tehtävät, jotka ennen vaativat tuntien työtä ja tarkkaa ohjausta, hoituvat yhdellä promptilla. Mitä isompi ja monimutkaisempi projekti, sitä enemmän subagentit auttavat.

Yhteenveto

Subagentit ovat Claude Coden tapa skaalata. Sen sijaan, että yksi agentti tekisi kaiken peräkkäin ja unohtaisi puolet matkalla, pääagentti jakaa työn erikoistuneille subagentein, jotka toimivat rinnakkain.

Käytännössä tämä tarkoittaa nopeampia tuloksia, parempaa kontekstin hallintaa ja tarkempaa työtä -- erityisesti isoissa projekteissa. Rajoituksetkin on hyvä tietää: tokenikustannukset kasvavat ja yksinkertaisiin tehtäviin subagentit ovat turhia.

Jos haluat oppia lisää Claude Coden käytöstä, aloita Claude Code -oppaasta. Jos agenttinen koodaus kiinnostaa laajemmin, lue agenttinen koodaus käytännössä. Ja jos haluat tietää, miten Claude Code vertautuu muihin työkaluihin, siihenkin löytyy opas.

Subagentit eivät ole tulevaisuutta. Ne ovat tätä päivää. Ja ne tekevät vibekoodauksesta nopeampaa kuin koskaan.