Blogi

Rinnakkainen työ Claude Codessa: worktree, agentit ja workflowt

Markdown

Claude Codessa tehtävän rinnakkaisen työn neljä tasoa, git worktree -eristys, tulosten todentaminen, graafiset käyttöliittymätyökalut sekä työmäärän ja tokenien käyttörajat.

Lue koko artikkeli

Tärkeimmät poiminnat

Claude Code tarjoaa neljä tapaa jakaa työtä useiden agenttien kesken: aliagentit yhdessä istunnossa, ohjeita sisältävät skillsit, tiiminvetäjän ja erilliset ikkunat sisältävät agenttitiimit sekä Dynamic Workflows JavaScript-skriptinä, jonka runtime suorittaa. Jos haluat ajaa yhdellä koneella rinnakkain yli viittä Claude Code -instanssia, eristä tiedostot git worktreellä. Virallisen runtime-rajan mukaan agentteja voi olla käynnissä yhtä aikaa enintään 16 ja yhtä ajoa kohden yhteensä 1000. Suurin sudenkuoppa ei ole koodissa. ”Minulla on 50 agenttia töissä” tarkoittaa yleensä sitä, että ”50 agenttia tuottaa rinnakkain järjettömyyksiä eikä kukaan tarkista niitä”. Outcomes ratkaisee tämän kriteerirubriikilla ja riippumattomalla tarkistaja-agentilla.

Käytännön materiaalia agenttien kanssa rinnakkain työskentelyyn: Ailoot-dokumentaatio.

Tässä oppaassa on koottu käytännön kokemusta ja kartta siitä, mihin työkalut sopivat. Mukana ovat Claude Coden neljä virallista perusominaisuutta, kartta niiden käyttökohteista sekä hypeä hillitsevä viitekehys sille, montako rinnakkaista agenttia vibe-koodaaja todella tarvitsee. Kaikki luvut ja lainaukset linkittävät Anthropicin ensisijaisiin lähteisiin.

Mitä Claude Coden multiagenttityö on, ja miksi kyse ei ole ”1000 agentista”

Tärkeimmät poiminnat

Claude Coden multiagenttityö tarkoittaa mitä tahansa tilannetta, jossa tehtävää hoidetaan useissa työvirroissa yhden keskustelun sijaan. Kyse voi olla useista istunnoista eri ikkunoissa, yhdestä johtajasta ja tämän alaisista saman istunnon sisällä tai runtimen orkestroimasta skriptistä. ”1000 agenttia” on yhden Dynamic Workflown tekninen enimmäismäärä. Se on suojaus runtimen hallitsemattomaksi yltyvää silmukkaa vastaan, ei suositus työmääräksi.

Multiagenttiasetelmassa tehtävä jaetaan useisiin itsenäisiin työvirtoihin, joista kukin hoitaa oman osuutensa ja palauttaa tuloksen. Yksinkertaisin esimerkki: kirjoitat frontendin yhdessä Claude Code -ikkunassa ja backendin toisessa samalla koneella, ja niiden käytössä on yhteinen git-repositorio. Se on jo multiagenttityötä, vaikka ”orkestrointi” olisi siitä tarpeettoman juhlallinen sana.

Monimutkaisempi asetelma: käynnistät yhdessä Claude Code -istunnossa viisi eri rooleissa toimivaa aliagenttia (frontend-kehittäjä, backend-kehittäjä, tietoturvatarkastaja, testaaja ja dokumentoija). Kukin palauttaa oman osuutensa tuloksesta yhteiseen keskusteluun. Kyse on samasta multiagenttityöstä, mutta yhdellä ohjauspisteellä.

Vielä monimutkaisempi asetelma: pyydät Claudelta: ”tee joka viikko tietoturvatarkastus projektini kaikille 500 tiedostolle”, ja se kirjoittaa JavaScript-orkestrointiskriptin. Runtime käynnistää taustalla useita kymmeniä agentteja, joista kukin tarkastaa oman osuutensa. Sen jälkeen itsenäiset agentit tarkistavat toistensa löydökset, ja saat yhden raportin. Kyse on Dynamic Workflowsista, jonka Anthropic julkaisi 28. toukokuuta 2026. Ominaisuuden yksityiskohtainen kuvaus on erillisessä Dynamic Workflows -oppaassa.

Näiden kolmen skenaarion ero ei ole agenttien määrä. Ero on siinä, kuka päättää, mitä seuraava agentti tekee. Ensimmäisessä skenaariossa päätät sinä. Toisessa Claude päättää keskustelun edetessä. Kolmannessa päätöksen tekee Clauden kirjoittama JavaScript-skripti.

”1000 agenttia” on muuten todellinen luku. Se on Claude Coden yhden Dynamic Workflown yläraja. Anthropicin virallisessa dokumentaatiossa sanotaan:

Enintään 16 yhtäaikaista agenttia; vähemmän rajallisen CPU:n koneilla. Yhteensä 1000 agenttia ajoa kohden, jotta hallitsemattomaksi yltyvät silmukat estetään.

— Anthropic Claude Code Docs, https://code.claude.com/docs/en/workflows

Toisin sanoen kyseessä on tekninen suojaus hallitsemattomaksi yltyvää toimintaa vastaan, ei suositeltu työmäärä. Käytännössä 95% tehtävistä hoituu 2–8 rinnakkaisella työvirralla. Jos suunnittelet useampaa, kysy ensin itseltäsi, mitä ne tekisivät.

Claude Coden 4 perusominaisuutta: aliagentit, skillsit, agenttitiimit ja workflowt

Tärkeimmät poiminnat

Claude Coden virallisessa dokumentaatiossa kuvataan neljä erillistä multiagenttityön tasoa. Aliagentit ovat yhden istunnon väliaikaisia työntekijöitä. Skillsit ovat ohjeita, joita Claude noudattaa. Agenttitiimit ovat pysyviä ”kollegoita” erillisissä ikkunoissa ja niillä on johtaja. Workflowt ovat runtimen orkestroimia skriptejä. Jokaisella on omat rinnakkaisuuden rajansa ja paikkansa välituloksille.

Claude Codessa on neljä virallista perusominaisuutta yhden tehtävän jakamiseen useille agenteille. Anthropic kokosi ne vertailutaulukkoon Dynamic Workflows -dokumentaatiossa. Tässä vertailu selkokielellä:

AliagentitSkillsitAgenttitiimitWorkflowt
Mitä se onTyöntekijä, jonka Claude käynnistääOhjeet, joita Claude noudattaaJohtaja ja tiimi erillisissä ikkunoissaSkripti, jonka runtime suorittaa
Kuka päättää työvaiheistaClaude keskustelun edetessäClaude ohjeiden perusteellaJohtajaSkripti itse
Missä tulokset ovatClauden konteksti-ikkunassaKonteksti-ikkunassaJaetussa tehtävälistassaSkriptimuuttujissa
Mitä voi käyttää uudelleenTyöntekijän kuvausItse ohjeetTiimin kuvausKoko orkestrointi
MittakaavaMuutama kerrallaanSama määräMuutama pysyvä kollegaKymmeniä tai satoja ajossa
Mitä keskeytyessä tapahtuuVuoro käynnistyy uudelleenVuoro käynnistyy uudelleenKollegat jatkavatJatkuu samassa istunnossa

Jokainen näistä perusominaisuuksista ratkaisee eri ongelman. Aliagentit sopivat 2–3 tarkistuksen delegointiin yhden tehtävän sisällä. Skillsit sopivat tilanteeseen, jossa sinulla on valmis ohje, jota Clauden pitäisi noudattaa (esimerkiksi ”tee PR-katselmus tämän tarkistuslistan avulla”). Agenttitiimit sopivat tilanteeseen, jossa tuotteen useat osat ovat eri ikkunoissa ja tarvitset yhden koordinaattorin. Workflowt sopivat tehtävään, joka on liian suuri yhdelle konteksti-ikkunalle.

Aliagentteja käsitellään yksityiskohtaisesti oppaassa Claude Code Subagents 2026. Päätöspuu sille, ”mitä käyttää tiettyyn tehtävään”, on oppaassa Skills, Subagents, MCP, Plugins. Tämä opas käsittelee niiden kokoamista multiagenttiasetelmaksi git worktreen päälle.

Taso 1: aliagentit yhdessä istunnossa – helpoin paikka aloittaa

Tärkeimmät poiminnat

Aliagentti on väliaikainen ”työntekijä” Claude-istunnon sisällä. Sanot pääagentille: ”käynnistä neljä aliagenttia: frontend-kehittäjä, backend-kehittäjä, testaaja ja dokumentoija”, ja kukin hoitaa oman osuutensa ja palauttaa sitten tuloksen yhteiseen keskusteluun. Rinnakkain: 2–5 aliagenttia, kaikki samassa jaetussa kontekstissa.

Aliagentti on yksinkertaisin tapa jakaa tehtävä. Pääkeskustelu toimii koordinaattorina. Aliagentit ovat väliaikaisia työntekijöitä, joita pääagentti käynnistää työn edetessä.

Konkreettinen esimerkki kuvatusta projektista. Oppaan ensimmäisen luonnoksen jälkeen katselmus järjestetään näin: Claude saa pyynnön: ”käynnistä kuusi aliagenttia rinnakkain – yksi etsii tekoälyyn viittaavia merkkejä, toinen juridista sanastoa, kolmas tarkistaa äänen ja sävyn, neljäs faktat WebFetchin avulla, viides SEO-rakenteen ja kuudes ristiinlinkkien paikkansapitävyyden”. Kukin palauttaa raportin, minkä jälkeen muokkaukset tehdään.

Teknisesti tämä tehdään roolia ja työkaluja kuvaavilla tiedostoilla hakemistossa .claude/agents/[subagent-name].md. Kutsu tehdään pääkeskustelussa Agent-työkalun kautta. Claude päättää, milloin pyyntö lähetetään aliagentille.

Missä toimii. Tehtävät, joissa yhdestä kohteesta (koodista, tekstistä tai suunnittelusta) tehdään 3–7 rinnakkaista tarkistusta. Jokainen tarkistus on itsenäinen. Tulokset mahtuvat pääkonteksti-ikkunaan.

Missä alkaa tökkiä. Jos tiedostoja on yli 50 tai jokainen tarkistus tarvitsee oman 50K tokenin kontekstinsa, pääikkuna täyttyy. Silloin tarvitset workflowta tai agenttitiimejä.

Suurin riski. Kukin aliagentti kuluttaa tokeneita erikseen. Jos käynnistät kuusi aliagenttia 200 tiedoston projektissa ja jokainen lukee kaikki 200 uudelleen, maksat 6×. Sinun ON siis määriteltävä täsmälleen, mitä tiedostoja aliagentin pitää tarkastella. Lisätietoja on oppaassa Mihin Claude Coden tokenit kuluvat.

Taso 2: git worktree – tiedostojen eristäminen rinnakkaisten istuntojen välillä

Tärkeimmät poiminnat

Aliagentit jakavat yhden istunnon ja yhden tiedostojärjestelmän. Jos haluat kahden täysimittaisen Claude Code -instanssin muokkaavan samaa projektia eri päätelaitteissa, tarvitset niille erilliset työkopiot. Git worktree antaa ne ilmaiseksi: yksi totuuden lähde .git-hakemistossa ja kaksi itsenäistä hakemistoa levyllä.

Kun aliagentit eivät riitä ja tarvitset kaksi täysimittaista Claude Code -instanssia eri päätelaitteissa työskentelemään saman repositorion parissa, vastaan tulee klassinen ongelma. Ne alkavat muokata samaa tiedostoa; toinen tallentaa ensin, ja toinen kirjoittaa sen yli. Asiakas kysyi tukitiimiltä viime viikolla: ”5 kirjoittaa toistensa muutokset yli samaan aikaan.”

Ratkaisu on git worktree. Se on gitin sisäänrakennettu ominaisuus, jonka avulla samasta repositoriosta voi olla useita työkopioita, jokainen omalla haarallaan, mutta yhteisen .git-repositorion kanssa. Yksi alkuperä, eri hakemistot levyllä eikä tiedostojen päällekkäisyyttä. Mekanismi kuvataan yksityiskohtaisesti oppaassa Git worktree Claude Codessa.

Komennot viiden minuutin käyttöönottoon:

# From the main project directory
cd ~/projects/my-app

# Create a worktree for feature/auth
git worktree add ../my-app-auth feature/auth

# Create a worktree for feature/billing
git worktree add ../my-app-billing feature/billing

# Open two terminal windows
cd ~/projects/my-app-auth && claude   # first Claude Code
cd ~/projects/my-app-billing && claude # second Claude Code

Kukin kopio on omalla haarallaan. Kukin Claude Code -instanssi kirjoittaa omaan hakemistoonsa. Kun tehtävä on valmis, suorita haarasta git push ja sitten git worktree remove ../my-app-auth.

Tämä on hyvä tietää. Worktree ei kopioi node_modules-, .venv- tai muita .gitignore-tiedostoja. Jos tarvitset erilliset riippuvuudet (eri kirjastoversion kullakin haaralla), suorita npm install uudessa hakemistossa erikseen worktree add -komennon jälkeen.

Worktreeiden määrä henkilöä kohden. Vuoden 2026 tiimikyselyjen perusteella käytännöllinen yläraja on 4–8 rinnakkaista worktreeä kehittäjää kohden. Rajoittava tekijä ei ole Claude vaan ihmisen kyky tarkistaa ja hyväksyä tulokset. Jos worktreeitä on 10, ne odottavat tarkistusta.

Kuvatussa käytännössä ihmiset käyttävät yleensä 2–3 rinnakkaista worktreeä. Yksi ensisijainen worktree aktiiviseen työhön, yksi varalla kiireellisiä hotfixejä varten ja yksi kokeiluun (uusi ominaisuus, jonka suhteen olet epävarma). Enempää ei tarvita.

Taso 3: agenttitiimit – useita ikkunoita, yksi johtava agentti

Tärkeimmät poiminnat

Agenttitiimeissä useat Claude Code -instanssit työskentelevät eri ikkunoissa tiiminä: yksi johtava agentti seuraa yhteistä tehtävälistaa, muut raportoivat sille ja viestivät yhteisen tiedostojärjestelmän kautta. Tämä on orkestroinnin taso ”yhden keskustelun aliagenttien” ja ”koodiksi kirjoitetun Dynamic Workflowsin” välissä.

Agenttitiimit ovat melko uusi perusominaisuus. Ajatuksena on, että yksi johtava agentti pitää yhteistä suunnitelmaa tehtävälistana ja useat rinnakkaiset istunnot erillisissä ikkunoissa hoitavat johtajan niille antamia tehtäviä. Ne kaikki työskentelevät samassa tiedostojärjestelmässä ja näkevät toistensa välitulokset.

Tämä on hyödyllistä, kun tehtävä jakautuu 3–5 suureen työvirtaan, joista kukin kestää tunteja (suuren moduulin siirtäminen, alijärjestelmän uudelleenkirjoitus tai kattava tietoturvatarkastus). Tällöin johtava agentti pitää suunnitelman yhdessä jaetussa tehtävätiedostossa täydellisessä polussa worktree-hakemistojen ulkopuolella. Työntekijät lukevat polun ja raportoivat tulokset. Vain johtaja päivittää tilat ja välttää koordinointitiedoston kilpailevat kirjoitukset.

Teknisesti agenttitiimit tarkoittavat useita git worktreen päällä toimivia ikkunoita, joilla on yhteinen suunnittelupiste. Käytännössä 80% ihmisistä hallinnoi agenttitiimejä käsin (kuten yllä worktreen avulla) eikä käytä erityistä ”tiimikehystä”. Se on aivan toimivaa.

Jos mietit, tarvitsetko kehystä ylipäätään, et todennäköisesti tarvitse. Käytä manuaalista worktreeä ja yhtä pääagenttia pääkansiossa.

Taso 4: Dynamic Workflows – Claude kirjoittaa JS-orkestrointiskriptin

Tärkeimmät poiminnat

Dynamic Workflow on JavaScript-skripti, jonka Claude kirjoittaa tehtävääsi varten ja jonka runtime suorittaa taustalla. Runtime käynnistää enintään 16 agenttia kerrallaan (1000 ajoa kohden), ja istunto pysyy samalla responsiivisena. Sen voi käynnistää promptin avainsanalla workflow, asetuksella /effort ultracode tai sisäänrakennetulla /deep-research-komennolla. Julkaistu 28. toukokuuta 2026; vaatii Claude Code v2.1.154+ -version.

Kaikilla kolmella aiemmalla tasolla suunnitelma pysyy keskustelussa: pääagentin muistissa tai johtavan agentin tehtävälistalla. Dynamic Workflows siirtää suunnitelman koodiin. Claude esittää tehtävän JavaScript-skriptinä, runtime suorittaa sen eristetyssä ympäristössä, välitulokset säilyvät skriptimuuttujissa eivätkä kontekstissasi, ja istunto pysyy responsiivisena agenttien työskennellessä taustalla.

Konkreettinen esimerkki virallisesta dokumentaatiosta. Sanot:

ultracode: audit every API endpoint under src/routes/ for missing auth checks

Claude kirjoittaa JavaScript-skriptin, jonka logiikka on suunnilleen tämä: ”ota kaikki src/routes/-hakemiston tiedostot, jaa ne 30 endpointin ryhmiin, aja jokaiselle ryhmälle agentti tekemään sama tarkistus, aja sitten kaksi riippumatonta grader-agenttia arvioimaan niiden löydökset ja kokoa lopullinen raportti.” Skripti suoritetaan. Saat tulostaulukon ja luettelon endpointeista, jotka on ehdottomasti tarkistettava.

Missä toimii.

  • Koko projektin tarkastaminen yhden ongelman varalta (tietoturva, tyypitys tai vanhentuneet API:t).
  • Suuret migraatiot (500+ tiedostoa, joita koskee sama sääntö).
  • Tutkimuskysymykset, jotka täytyy tarkistaa useasta toisistaan riippumattomasta näkökulmasta (Anthropic käyttää tätä sisäänrakennetussa /deep-research-komennossaan).

Dynamic Workflowsin rajoitusten ja ultracode-toiminnon yksityiskohtainen kuvaus on erillisessä Claude Coden Dynamic Workflows -oppaassa.

Milloin sitä EI pidä käyttää. Kun tehtävä on suoraviivainen ja selkeä. Workflowta ei tarvita esimerkiksi tehtävään ”viimeistele tämä komponentti”. Workflow sopii tilanteeseen, jossa tehtävä jakautuu yli 10 itsenäiseen osatehtävään ja ne täytyy tarkistaa ristiin.

Suurin rajoitus. Workflow kuluttaa huomattavasti enemmän tokeneita kuin tavallinen istunto. Anthropic suosittelee dokumentaatiossaan:

Dynamic workflowt voivat käyttää huomattavasti enemmän tokeneita kuin tyypillinen Claude Code -istunto, joten suosittelemme aloittamaan rajatun laajuisella tehtävällä.

— Anthropic Claude Code Docs, https://code.claude.com/docs/en/workflows

Toisin sanoen aja ensimmäinen workflowsi yhdessä hakemistossa, älä koko projektissa. Katso, mitä se maksoi, ja päätä sitten, kannattaako sitä laajentaa.

Outcomes: kriteerirubriikki ja riippumaton tarkistaja

Tärkeimmät poiminnat

Multiagenttityön suurin ongelma on se, että agenttien tuottamat asiat NÄYTTÄVÄT valmiilta. Lainaus vaikuttaa oikealta, raportti täydelliseltä. Anthropicin Outcomes on toinen agentti uudessa kontekstissa: se lukee kriteerirubriikin ja tarkistaa ensimmäisen agentin työn. Julkaistiin 6. toukokuuta 2026 Code with Claude -tapahtumassa. Se kasvatti tehtävien valmistumisastetta Harveylla 6× ja lyhensi tarkistusaikaa Wisedocsilla 50%.

Vaarallisinta multiagenttityössä on luottaa agenttien tuotoksiin. Jokainen agentti palauttaa tekstiä, joka näyttää valmiilta työltä. Lainaus vaikuttaa oikealta, raportti täydelliseltä, migraatio valmiilta. Yhden agentin tulokset voit tarkistaa itse. Kymmenen agentin tuloksia et – sinulla ei ole aikaa.

Anthropic vastaa tähän ongelmaan Outcomesilla, joka on 6. toukokuuta 2026 julkaistu Managed Agents -ominaisuus. Ajatus on yksinkertainen: istuntoon lisätään TOINEN agentti (grader), jonka ainoa tehtävä on tarkistaa ensimmäisen agentin työ tiukan kriteerirubriikin mukaan.

Näin se toimii teknisesti. Kirjoitat rubriikin – markdown-dokumentin, jossa on yksityiskohtainen luettelo siitä, mitä ”valmis” tarkoittaa, mitkä lähteet tarkistetaan ja mitä tunnisteita käytetään. Alusta luo automaattisesti grader-agentin uuteen konteksti-ikkunaan. Se saa vain rubriikin ja tuloksen, ei mitään muuta. Pääagentin (kirjoittajan) jokaisen yrityksen jälkeen grader lukee tuloksen uudelleen ja joko hyväksyy sen tai palauttaa luettelon puutteista.

Lainaus Anthropic Cookbookista:

Agentit ovat hyviä tuottamaan asioita, jotka NÄYTTÄVÄT valmiilta. Pyydä agenttia laatimaan lähdeviitteellinen tutkimusraportti, niin saat viimeistellyn asiakirjan alaviitteineen. Tarkemmin tarkasteltuna aihetta on käsitelty pintapuolisesti, lainaus on irronnut lähteestään tai viite osoittaa lehdistötiedotteeseen alkuperäisen asiakirjan sijaan.

— Anthropic Cookbook - Outcomes, https://platform.claude.com/cookbook/managed-agents-cma-verify-with-outcome-grader

Todelliset vaikutusluvut: Kun Outcomes integroitiin Claude Managed Agentsiin, tekoäly-yhtiö Harveyn tehtävien valmistumisaste kasvoi noin 6×. Wisedocsilla (lääketieteellinen dokumentointi) asiakirjan tarkistamiseen käytetty aika väheni 50%. Luvut ovat peräisin virallisesta ominaisuusjulkistuksesta.

Vibe-koodaajan kannalta olennaista on, että Outcomes on toimintamalli, ei vain yksittäinen ominaisuus. Voit luoda oman grader-agentin kuvaamalla samat kriteerit tiedostossa .claude/agents/grader.md ja pyytämällä pääagenttia ajamaan sen jokaisen yrityksen jälkeen. Tämä toimii missä tahansa multiagenttiasetelmassa, ei vain Managed Agentsissa.

Cookbookin tärkein rubriikin kirjoittamista koskeva sääntö on määritellä jotain todennettavaa, ei yleisluontoista. Ei ”tarkista, että briefissä käsitellään laskutusta”, vaan ”avaa briefi, etsi laskutusta käsittelevä osio ja varmista, että siinä ilmoitetaan summa $-merkissä tai prosenttiosuutena liikevaihdosta”. Ensimmäisen ohjeen perusteella grader voi silmäillä ja rastittaa kohdan. Toinen saa sen avaamaan asiakirjan ja etsimään tietyn luvun.

Antimalli: ”50 agenttia tekemässä järjettömyyksiä”

Tärkeimmät poiminnat

Rinnakkaisen asetelman suurin virhe on käynnistää paljon agentteja ymmärtämättä, mitä kukin tekee. Käytännössä tekoälyagentin luomisessa oli 3–4 tunnin aikana enintään 2–3 rinnakkaista työvirtaa. Kun vibe-koodaaja kehuskelee ”50 rinnakkaisella agentilla”, se tarkoittaa yleensä ”50 agenttia tuottaa rinnakkain roskaa eikä kukaan tarkista sitä”. Varoitusmerkki on, ettet pysty selittämään 30 sekunnissa, mitä konkreettista tehtävää kukin agentti ratkaisee.

Tämä on multiagenttityön keskeinen antimalli. Joku oppii, että Claude Code voi ajaa yhtä aikaa 16 agenttia ja Dynamic Workflows 1000 agenttia ajoa kohden, joten hän istuu alas ja käynnistää ne. Vaikutus: nolla. Tokenien kulutus: 10× tavalliseen istuntoon verrattuna.

Yksinkertainen testi. Ota paperi ja piirrä laatikko kullekin agentillesi. Kirjoita kuhunkin laatikkoon:

  1. Mitä se tarkalleen tekee (yksi lause).
  2. Mihin tiedostoihin se koskee.
  3. Mitä se palauttaa.
  4. Kuka tarkistaa sen.

Jos et pysty vastaamaan yhteenkään näistä 30 sekunnissa, kyseistä agenttia ei pitäisi olla. Sääntö pätee kaikilla tasoilla: aliagentteihin, agenttitiimeihin ja Dynamic Workflowsiin.

Toinen antimalli on sellaisen työn ajaminen rinnakkain, joka pitäisi tehdä peräkkäin. Jos frontend tarvitsee ensin backendin, koska se lukee API-skeemaa, älä aja niitä rinnakkain. Tee ensin backend ja sitten frontend. Tehtäviä kannattaa ajaa rinnakkain vain, jos ne ovat itsenäisiä.

Kolmas antimalli on multiagenttityön käyttäminen nopeuden vuoksi. Se toimii vain tiettyyn pisteeseen asti. Jos jaat tehtävän neljään itsenäiseen työvirtaan, ne valmistuvat suunnilleen samassa ajassa kuin yksi työvirta yksin (sekä päälle tulee vähäinen koordinointi). Mutta jos yhdellä koneella on 50 työvirtaa, jokainen toimii hitaammin, koska ne jakavat CPU:n. Kannettavan tietokoneen käytännöllinen raja on 4–6 yhtäaikaista Claude Code -instanssia; sen jälkeen suorituskyky alkaa rajoittua.

Paljonko se maksaa, ja miten vältät käyttörajojen kulumisen?

Tärkeimmät poiminnat

Multiagenttiasetelma kuluttaa tokeneita kertoimella. Aliagentit: 2×–4× tavalliseen istuntoon verrattuna. Agenttitiimit: 3×–6×. Dynamic Workflows: 10×–30×. Tärkeimmät säästöohjeet: määritä jokaiselle agentille sen tiedostot, älä aja workflowta koko projektissa kerralla ja tarkista kustannukset pienellä osuudella.

Toukokuussa–kesäkuussa 2026 alalla kohdattiin todellisuus, jossa tekoälyavusteinen koodaus maksoi odotettua enemmän.

Tavallinen Claude Code -keskusteluistunto maksaa suhteellisen vähän. Kun otat Dynamic Workflowsin käyttöön koko repositoriossa, lasku kasvaa 20-kertaiseksi. Anthropicin virallisesta dokumentaatiosta:

Workflow suorittaa monia agentteja, joten yksi ajo voi kuluttaa huomattavasti enemmän tokeneita kuin saman tehtävän suorittaminen tavallisessa keskustelussa. Selvitä kustannukset ennen suurta ajoa kokeilemalla workflowta pienellä osuudella.

— Anthropic Claude Code Docs, https://code.claude.com/docs/en/workflows

Mitä kannattaa tehdä käytännössä? Kuvatun käytännön säästöohjeet.

  1. Määritä tarkasti jokaisen agentin tarkastamat tiedostot. Ei ”katso projekti läpi ja etsi ongelmia”, vaan ”tarkastele tiedostoja src/auth/*.ts ja varmista, että jokainen funktio validoi arvon userId”. Jälkimmäinen prompt antaa juuri sen työn, josta maksat.

  2. Kokeile workflowta ensin yhdessä hakemistossa. Älä koko src/-hakemistossa. Aloita hakemistosta src/auth/. Jos tulokset miellyttävät ja ymmärrät kustannuksen, voit ottaa sen käyttöön laajemmin.

  3. Käytä /effort high -asetusta oletuksena ja ultracode-asetusta vain harkitusti. /effort ultracode tarkoittaa xhigh-asetusta sekä automaattista orkestrointia. Se on erittäin kallista. Käytä sitä, kun tehtävä todella vaatii useita rinnakkaisia työvirtoja.

  4. Vaihda aliagentit pienempään malliin aina kun mahdollista. Jos kuusi aliagenttia tarkistaa yhtä opasta, Opusta ei tarvita sen enempää tekoälyä etsivälle QA-agentille kuin ristiinlinkkien tarkistajallekaan. Sonnet riittää. Tämä vähentää käyttöä 3–5×.

Tokenien säästämistä käsitellään tarkemmin oppaissa Mihin Claude Coden tokenit kuluvat ja Näin et kuluta Claude Coden käyttörajoja loppuun.

Mistä aloittaa tänään: 30 minuutin tarkistuslista

Tärkeimmät poiminnat

Dynamic Workflowsiin ei tarvitse hypätä heti. Perusmuotoinen multiagenttiasetelma syntyy 30 minuutissa: kaksi worktreeä, kaksi päätettä ja johtajan yhteinen tehtävälista tiedostossa tasks.md. Se riittää 80%:iin tilanteista. Muut 20% (suuri tarkastus tai migraatio) tulevat luontevasti eteen parin viikon päästä.

  1. Päivitä Claude Code versioon v2.1.154+

    Tämä on alin versio, joka tukee Dynamic Workflowsia. Suorita päätteessä claude update.

  2. Ota Dynamic Workflows käyttöön kohdassa /config

    Ne on poistettu käytöstä Pro-tilauksessa oletusarvoisesti. Avaa /config, etsi ”Dynamic workflows” -rivi ja ota asetus käyttöön. Max-, Team- ja Enterprise-tilauksissa ne ovat jo käytössä.

  3. Luo ensimmäinen worktree

    Suorita projektin päähakemistossa git worktree add ../<project>-experiment <branch>. Avaa toinen pääteikkuna kyseiseen hakemistoon. Suorita claude.

  4. Lisää yhteinen tehtävälista

    Käytä yhtä täydellistä polkua kaikkien worktree-hakemistojen ulkopuolella. Kunkin worktreen tasks.md on erillinen tiedosto eikä synkronoidu automaattisesti. Anna vain johtavan istunnon kirjoittaa listaa. Työntekijät lukevat ja raportoivat tulokset johtajalle.

    Luo koordinointihakemisto ja tehtävälista kerran:

    mkdir -p "$HOME/projects/my-app-coordination"
    printf '%s\n' '# Tasks' '- Auth: assigned to the auth worktree' '- Billing: assigned to the billing worktree' > "$HOME/projects/my-app-coordination/tasks.md"
    

    Ensimmäisessä terminaalissa:

    cd "$HOME/projects/my-app-auth"
    printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
    claude
    

    Toisessa terminaalissa:

    cd "$HOME/projects/my-app-billing"
    printf 'Shared task list: %s\n' "$HOME/projects/my-app-coordination/tasks.md"
    claude
    

    Anna molemmissa istunnoissa agentille sama yllä tulostettu laajennettu täydellinen polku: ”Lue tämä yhteinen tehtävälista. Tee vain sinulle osoitettu tehtävä ja tiedostot. Älä muokkaa listaa. Raportoi valmistuminen ja esteet johtajalle, joka omistaa päivitykset.” Varmista molempien agenttien lukevan juuri tämän tiedoston ennen aloittamista. Polun lupapyyntö pitää ratkaista. Lista koordinoi tilaa, kun koodimuutokset pysyvät erillisissä worktree-hakemistoissa.

  5. Työskentele näin viikon ajan

    Älä asenna heti graafisen käyttöliittymän wrapperia. Työskentele viikon ajan käsin kahdella worktreellä. Näet, mitä puuttuu; valitse sitten työkalu tiettyyn kipukohtaan.

  6. Ota vasta sitten käyttöön \/effort ultracode\\

    Valitse yksi tehtävä, kuten ”etsi kaikki API-endpointit, joista auth-tarkistukset puuttuvat hakemistossa src/routes/”. Ota /effort ultracode käyttöön. Katso, minkä workflow'n Claude kirjoittaa, paljonko se maksaa ja millaisen tuloksen se tuottaa. Se on ensimmäinen Dynamic Workflowsi.

Mitä seuraavaksi: istuntojen välinen muisti, Code Review ja Multi-Agent v2

Tärkeimmät poiminnat

Perusmuotoinen multiagenttiasetelma hoitaa 80% tehtävistä. Seuraavat kolme odotettavissa olevaa ominaisuutta ovat Managed Agents Dreamingilla (istuntojen välinen muisti), agenttitiimin jokaiselle PR:lle tekemä Code Review sekä Multi-Agent Orchestration v2 Claude Agent SDK:ssa. Kaikki ovat tutkimusennakkoversiossa, julkisessa beetassa tai niistä on ilmoitettu vain rajatulle käyttäjäjoukolle.

Mitä on julkaistu touko–kesäkuussa 2026 ja mihin Claude Coden multiagenttityö on menossa.

Managed Agents ja Dreaming. Julkaistiin 6. toukokuuta 2026 Code with Claude -tapahtumassa. Ajastettu prosessi lukee agentin aiemmat keskustelutallenteet istuntojen välillä, tunnistaa toistuvia malleja ja päivittää sen muistia. Tekoälyyn keskittyvän lakiyhtiö Harveyn tehtävien valmistuminen kuusinkertaistui nimenomaan Dreamingin käyttöönoton jälkeen. Ominaisuus on yhä tutkimusennakkoversiossa.

Outcomes Managed Agents -ominaisuutena. Kuvattu edellä. Saatavilla Claude Agent SDK:n kautta, ei suoraan Claude Code CLI:ssä. Voit käyttää samaa mallia manuaalisesti grader-aliagentilla jo nyt.

Multi-Agent Orchestration v2 Claude Agent SDK:ssa. Johtava agentti delegoi itse aliagentteja ja käyttää yhteistä tiedostojärjestelmää. Siirtymässä ”käynnistä N aliagenttia käsin” -mallista kohti sitä, että ”kuvaat tehtävän, ja johtaja päättää itse, kenelle se delegoidaan ja miten”. Jos olet vasta opettelemassa aliagenttien käyttöä, sinun ei tarvitse vielä huolehtia v2:sta. Opettele klassinen malli – ”yksi pääagentti + 3–5 roolitettua aliagenttia” – ja siirry v2:een luontevasti 3–6 kuukaudessa.

Agenttitiimin tekemä Code Review. Anthropic ilmoitti Code with Claude -tapahtumassa automaattisesta koodikatselmuksesta PR:n avaamisen yhteydessä. Tekoälyagenttitiimi tarkistaa diff-muutokset rinnakkain, etsii bugeja, varmentaa löydökset keskenään ja asettaa ne vakavuusjärjestykseen. Saatavilla Team- ja Enterprise-tilauksissa, ei vielä Prossa.

Plugin Marketplace. Julkaistiin 23. toukokuuta 2026 versioissa v2.1.128-136. Osa marketplace-laajennuksista on valmiita multiagenttiasetelmia (parallel-review, security-audit, migration-helper). Ne voi asentaa komennolla /plugin install <name>@claude-plugins-official, minkä jälkeen voi tarkastella, miten ne on koottu – se on hyvä tapa oppia kirjoittamaan omia laajennuksia.

Claude Coden multiagenttityö näyttää yhä joukolta eri kypsyysvaiheissa olevia perusominaisuuksia. Aliagentit ja git worktree ovat vakaita, koeteltuja ja toimivat kaikkialla. Agenttitiimit ovat puoliksi automatisoituja ja puoliksi manuaalisia. Dynamic Workflows on tutkimusennakkoversiossa ja muuttuu nopeasti. Managed Agents v2 on vain yrityskäyttöön. Siksi vibe-koodaajan optimaalinen asetelma seuraavan vuoden aikana ei ole uusin julkaisu, vaan juuri kyseiseen tehtävään tarvittava vähimmäisasetelma. Kaksi worktreeä ja yksi grader-aliagentti riittävät kuukauden aktiiviseen työhön. Lisää monimutkaisuutta vasta, kun alat tuntea rajoitteet.

Toimiva vibe-koodausasetelma

Tärkeimmät poiminnat

Multiagenttiasetelma toimii vain, jos se perustuu harkittuun kontekstin suunnitteluun. Ilman sitä kaikki rinnakkainen orkestrointi muuttuu antimalliksi, jossa ”50 agenttia tekee järjettömyyksiä”.

Käytännön materiaalia: Ailoot-dokumentaatio.

Lisää materiaaleja ja työkaluja: Ailoot.

Lisätietoja

Kysymyksiä tästä oppaasta: Rinnakkainen työ Claude Codessa: worktree, agentit ja workflowt

Miksi kahdessa worktreessä on eri tasks.md-tiedostot?

Kullakin worktreellä on omat tiedostonsa. Sijoita koordinointilista yhteen täydelliseen polkuun molempien ulkopuolelle, anna sama laajennettu polku kummallekin agentille ja varmista molempien lukupääsy ennen aloittamista.

Kuka päivittää yhteistä tehtävälistaa?

Määritä yksi johtava istunto sen ainoaksi kirjoittajaksi. Työntekijät lukevat listaa, muokkaavat vain omia worktree-tiedostojaan ja raportoivat tulokset tai esteet johtajalle. Jaettu polku ei itsessään estä samanaikaisia muokkauksia.

Kaikki artikkelit