Näin käynnistät satoja agentteja Claude Codessa Dynamic Workflows -ominaisuudella

Löydät lisää materiaalia työkalujen määrittämisestä Ailoot-dokumentaatiosta.

Mitä Dynamic Workflows tarkoittaa ja miksi Anthropic julkaisi ne 28. toukokuuta?#

Aiemmin itse muoto rajoitti mittakaavaa: yksi chat = yksi suunnitelma = yksi konteksti-ikkuna. Aliagenteista oli apua, mutta Claude päätti edelleen pääkeskustelussa, ”mitä ajetaan seuraavaksi”, ja jokainen välitulos kulutti samaa konteksti-ikkunaa. Tästä tuli pullonkaula tehtävissä, joissa käsiteltiin 500 tiedostoa tai kymmentä toisistaan riippumatonta hypoteesia.

Dynamic Workflows siirtää suunnitelman koodiin. Claude muotoilee tehtävän orkestrointiskriptiksi, suoritusympäristö ajaa skriptin eristetyssä ympäristössä, ja välitulokset tallentuvat skriptin muuttujiin kontekstisi sijaan. Istunto pysyy responsiivisena agenttien työskennellessä taustalla.

Mitä vanhaan toimintatapaan verrattuna todella muuttuu: riippumattomat agentit haastavat toistensa löydökset, ja vain ristiintarkistuksen läpäissyt sisältö päätyy tulokseen. Nimen ”dynaaminen” viittaa juuri tähän: jokainen suoritusajo kirjoitetaan kyseistä tehtävää varten. Valmista prosessiluetteloa ei ole.

Miten Workflow eroaa aliagentista ja Skillistä: 3 orkestrointitapaa#

Valitsen Workflow’n, aliagentin ja Skillin välillä kysymällä kaksi asiaa: kenellä suunnitelma on ja missä välitulokset sijaitsevat?

Suurin muutos on suunnitelman siirtyminen koodiin. Aliagenttien ja Skillien kanssa Claude on aina orkestroija: se päättää matkan varrella, mitä käynnistetään seuraavaksi, ja jokainen vastaus päätyy konteksti-ikkunaan. Workflow pitää silmukan, haarautumisen ja välitulokset itsellään; vain lopullinen vastaus saapuu Claudeen.

Voit ajaa saman suunnitelman niin, että riippumattomat agentit purkavat sen osiin eri näkökulmista ja skripti kokoaa yhteen sen, mikä kestää tarkastelun. Tätä ei voi tehdä tavallisessa yhden chatin läpikäynnissä: Claudella ei ole riippumatonta synteesipistettä.

Valitsen näin: rutiininomaiseen, useita vaiheita sisältävään tehtävään sopivat aliagentit tai Skill. Jos tehtävä ei mahdu yhteen keskusteluun tai haluat suorittaa prosessin uudelleen tarpeen mukaan, käytä Workflow’ta. Olen käsitellyt kaikki neljä perusosaa tarkemmin pääoppaassa Skills, Subagents, MCP, or Plugins.

3 tapaa käynnistää Workflow Claude Codessa#

Tapa 1. Avainsana workflow kehotteessa. Yksinkertaisin vaihtoehto; se ei muuta istunnon asetuksia. Lisää vain sana workflow mihin tahansa kehotteeseen, niin Claude Code korostaa sen kirjoittaessasi ja luo tavallisen keskustelun sijaan orkestrointiskriptin.

Run a workflow to audit every API endpoint under src/routes/ for missing auth checks

Jos Claude Code korostaa sanan, vaikka et tarkoittanut käynnistää Workflow’ta, alt+w poistaa laukaisimen käytöstä kyseisessä kehotteessa.

Tapa 2. /effort ultracode -tila. Se ottaa käyttöön mallin suurimman ponnistustason (xhigh) ja antaa Clauden myös päättää itse, milloin tehtävä edellyttää Workflow’ta.

/effort ultracode

Tässä tilassa yksi pyyntö voi johtaa useisiin peräkkäisiin Workflow-suorituksiin: yksi selvittää koodin, toinen tekee muutoksen ja kolmas tarkistaa tuloksen. Jokainen suoritusajo käyttää enemmän tokeneita ja kestää pidempään kuin tavallisella ponnistustasolla. Tila koskee vain nykyistä istuntoa ja nollautuu, kun avaat uuden. Kun palaat rutiinityöhön, /effort high poistaa ultracoden käytöstä.

Tapa 3. Sisäänrakennettu /deep-research-komento. Valmis Anthropic-Workflow verkkotutkimukseen. Seuraavassa osiossa käsitellään tätä tapaa.

Kaikissa kolmessa tavassa Claude Code pyytää ensimmäisellä suoritusajolla vahvistuksen ja näyttää vaiheluettelon. Vastausvaihtoehdot ovat Yes, run it, Yes, and don't ask again for <name> (tallentaa hyväksyntäsi), View raw script (avaa koodin näppäinyhdistelmällä Ctrl+G) ja No. Auto-tilassa vahvistus tarvitaan vain ensimmäisellä kerralla; seuraavat suoritukset jatkuvat kysymättä. claude -p-komennolla ja Agent SDK:lla vahvistusta ei kysytä lainkaan: aliagenttien käyttöoikeudet noudetaan silloin jaetusta sallittujen toimintojen luettelosta.

Valmis /deep-research-Workflow: esimerkki ensimmäisestä ajosta#

Nopein tapa kokeilla Dynamic Workflows -ominaisuutta on ajaa valmista Workflow’ta sen sijaan, että kirjoittaisit oman. Anthropic sisältää Claude Codessa sisäänrakennetun /deep-research-Workflow’n. Se tarkastelee kysymystä useista riippumattomista näkökulmista, hakee lähteitä, äänestää jokaisesta väitteestä ja jättää raporttiin vain ristiintarkistuksen läpäisseet väitteet.

1. Suorita komento

   Kirjoita Claude Code -istunnossa /deep-research ja muotoile kysymys yksityiskohtaiseksi kehotteeksi. Mitä täsmällisemmin kirjoitat sen, sitä vähemmän aikaa skripti tuhlaa käynnistämällä turhia vaiheita.

2. Salli Workflow

   Näkyviin tulee valintaikkuna, jossa on vaiheet ja painikkeet Yes / View raw script / No. Hyväksyntä tallennetaan projektille, jos valitset vaihtoehdon, jossa on don't ask again.

3. Seuraa edistymistä komennolla /workflows

   Suoritus siirtyy taustalle, ja istunto vapautuu käyttöön. /workflows-komento näyttää luettelon käynnissä olevista ja valmiista suoritusajoista. Valitse vaihe nuolinäppäimillä, laajenna se ja katso sen agentteja painamalla Enter, selaa tietoja näppäimillä j/k, keskeytä painamalla p, pysäytä suoritusajo painamalla x, käynnistä agentti uudelleen painamalla r ja tallenna skripti painamalla s.

4. Lue raportti

   Kun suoritusajo päättyy, raportti linkkeineen ilmestyy istuntoon. Väitteet, jotka eivät läpäisseet ristiintarkistusta, suodatetaan automaattisesti pois.

Toisin kuin tavallisessa chatissa, jossa tehdään yksi verkkohaku, /deep-research suorittaa haut rinnakkain ja sovittaa lähteiden väliset ristiriidat yhteen. Käytän sitä aiheen tutkimiseen ennen oppaan kirjoittamista: se on kätevä tapa tutustua tokenien käyttöön ennen Workflow’n laajentamista.

Ultracode: tila, jossa Claude päättää, milloin Workflow käynnistetään#

Ultracode yhdistää kaksi asiaa: suurimman päättelytehon ja luvan käynnistää Workflow’ita itsenäisesti. Oletuksena jopa /effort xhigh käynnistää tavallisen keskustelun: Claude ajattelee pidempään, mutta pitää vaiheet yhä omassa kontekstissaan. Ultracode antaa Claudelle luvan muuttaa tehtävän itsenäisesti Workflow’ksi heti, kun se huomaa, ettei yksi istunto riitä.

/effort ultracode

Kun tila on käytössä, yksi pyyntö voi käynnistää kaksi tai kolme Workflow’ta peräkkäin: yksi tutkii koodikantaa, toinen tekee muutoksen ja kolmas suoritusajo yrittää erikseen osoittaa muutoksen vääräksi. Kyseessä on sama malli, jossa ”useista riippumattomista yrityksistä ⇒ lopulliseen synteesiin”, mutta ilman että sinun tarvitsee käynnistää jokaista vaihetta käsin.

Kustannus on ilmeinen: jokainen pyyntö kestää kauemmin ja maksaa enemmän kuin /effort high -tilassa. Konepellin alla suoritetaan useita omilla rajoituksillaan toimivia ajoja, eikä Anthropic suosittele ultracodea oletustilaksi. Se koskee vain nykyistä istuntoa ja nollautuu seuraavassa istunnossa.

Kun palaat rutiinityöhön, /effort high poistaa ultracoden käytöstä ja istunto palaa tavalliseksi aliagentteja käyttäväksi chatiksi. Malleissa, jotka eivät tue xhigh-tasoa, ultracode-vaihtoehto ei yksinkertaisesti näy /effort-komennon yhteydessä.

Rajoitukset, tokenit ja ensimmäisen ajon sudenkuopat#

Suoritusympäristö asettaa seuraavat ehdottomat tekniset rajat:

• Enintään 16 agenttia toimii rinnakkain kerrallaan. Vähemmän koneilla, joissa on vähän ytimiä. Tämä on paikallinen resurssiraja.
• 1 000 agenttia suoritusajoa kohti. Suoja hallitsemattomilta silmukoilta: jos skripti alkaa käynnistää loputtomasti agentteja, suoritusympäristö sammuttaa sen.
• Suorituksen aikana ei voi odottaa käyttäjän syötettä. Vain työkalujen käyttöoikeudet voivat keskeyttää sen. Jos sinun täytyy hyväksyä vaiheet yksi kerrallaan, jaa työ erillisiksi Workflow-suorituksiksi.
• Skriptillä itsellään ei ole suoraa pääsyä tiedostoihin tai komentorivikuoreen. Tiedostojen lukeminen ja kirjoittaminen sekä komentojen ajaminen kuuluvat sen käynnistämille agenteille. Skripti vain koordinoi niitä.
• Claude Code v2.1.154 tai uudempi vaaditaan. Saatavilla Pro-, Max-, Team- ja Enterprise-tilauksissa (Pro otetaan käyttöön komennolla /config) sekä Claude API:n, Amazon Bedrockin, Vertex AI:n ja Microsoft Foundryn kautta.

Tärkein varoitus koskee kustannuksia.

Kaikki suoritusajon agentit käyttävät istunnon mallia, ellei skripti ohjaa jotakin vaihetta toiselle mallille. Tarkista /model ennen suurta suoritusajoa: jos vaihdat tavallisesti halvempaan malliin rutiinitehtävissä, ultracode ja /deep-research voivat kasvattaa laskua, jos ohitat tämän tarkistuksen. Voit pyytää Claudelta kehotteessa nimenomaisesti, että se ”käyttää halvempaa mallia vaiheissa, jotka eivät vaadi suurinta suorituskykyä”—se on kelvollinen tapa hallita kustannuksia.

Jos suoritusajo ajautuu sivuraiteille, avaa /workflows, valitse suoritusajo ja paina x. Jo valmistuneet agentit säilyttävät tuloksensa. Voit jatkaa pysäytettyä ajoa siinä samassa painamalla p tai pyytää Claudea käynnistämään skriptin uudelleen samasta kohdasta: välimuistissa olevat agentit palauttavat tuloksensa, ja muut jatkavat työskentelyä. Tämä toimii yhden istunnon sisällä: kun poistut Claude Codesta, seuraava istunto aloittaa Workflow’n alusta.

Jos suunnittelet pitkiä suoritusajoja, aloita käytön hallinta oppaan How Not to Burn Through Claude Code Limits ja Second Brain avulla: oikean projektirakenteen ansiosta Workflow ei lataa koko tietovarastoa jokaiseen agenttiin.

Workflow’n tallentaminen projektiin#

Jos Claude on koonnut Workflow’n toistuvaa tehtävää varten (esimerkiksi jokaisen haaran tarkistamiseen tai säännölliseen tietoturva-auditointiin), voit tallentaa skriptin, eikä tehtävää tarvitse enää kuvailla joka kerta sanallisesti.

1. Avaa /workflows

   Komento näyttää luettelon viimeaikaisista suoritusajoista. Valitse tarvitsemasi nuolinäppäimillä.

2. Paina s

   Näkyviin tulee tallennusvalintaikkuna. Tab vaihtaa tallennussijaintia.

3. Valitse kansio

   .claude/workflows/ sijaitsee projektissa, ja kaikki tietovaraston kloonanneet näkevät sen. ~/.claude/workflows/ sijaitsee kotihakemistossasi, on käytettävissä kaikissa projekteissasi ja näkyy vain sinulle.

4. Kutsu sitä komentona

   /[script_name] käynnistää Workflow’n samalla skriptillä kuin ensimmäisellä kerralla. Jos projektin ja kotihakemiston kansioissa on samannimiset Workflow’t, projektin kansiossa oleva tulee ensin.

Tästä syntyy kiinnostava toimintatapa: yksi tiimin jäsen saa Workflow’n toimimaan kerran, tallentaa sen kansioon .claude/workflows/, ja sen jälkeen kukin tiimin jäsen suorittaa saman orkestroinnin komennolla. Skripti on luettavaa JavaScriptiä, joten voit tarkastella sitä, muokata sitä ja commitoida uuden version.

Kun ajat projektiin tallennetun Workflow’n ensimmäisen kerran, Claude Code näyttää edelleen käyttöoikeusvalintaikkunan, joten skriptin tallentaminen ei automaattisesti hyväksy sen käyttöä. Hyväksyntä annetaan erikseen valitsemalla Yes, and don't ask again.

Millaisiin tehtäviin Workflow’t todella kannattavat?#

Anthropic luettelee nimenomaisesti tilanteet, joita varten suoritusympäristö on rakennettu:

• Koko koodikannan auditoinnit—tarkista jokainen päätepiste, tiedosto ja funktio tarkistuslistaa vasten. Etsi esimerkiksi puuttuvia käyttöoikeustarkistuksia, toistuvaa logiikkaa tai tietoturvapuutteita OWASP-sääntöjen perusteella. Jokaiselle tarkistuslistan osa-alueelle käynnistetään oma agentti.
• Laajat migraatiot—vaihda kehys, siirry pois vanhentuneesta API:sta tai siirrä tuhansia tiedostoja toiseen ohjelmointikieleen. Workflow seuraa edistymistä, agentit työskentelevät rinnakkain tiedostoissa ja ristiintarkistavat agentit etsivät huomaamatta jääneitä asioita.
• Ristiintarkistettava tutkimus—kysymys, joka vaatii lähteitä eri näkökulmista ja arvion siitä, mitkä väitteet kestävät ristiintarkistuksen. Tämä on perusskenaario, jota varten sisäänrakennettu /deep-research luotiin.
• Monimutkainen suunnitelma, jonka haluat hahmotella useista riippumattomista näkökulmista—Workflow tuottaa useita toisistaan riippumattomia suunnitelmaluonnoksia, eri mieltä olevat agentit arvioivat niitä ja tuloksena toimitetaan synteesi. Tämä sopii tilanteisiin, joissa ”virheen hinta on korkea eikä yksi läpikäynti riitä”.

Tehtävissä, kuten ”korjaa yksi virhe” tai ”lisää yksi funktio”, Dynamic Workflows häviää tavalliselle istunnolle: tokenien käyttö ei ole ajankäytön arvoista. Anthropicin dokumentaatio sanoo tämän selvästi: ”aloita rajatusta tehtävästä, jotta saat käsityksen käytöstä”. Nyrkkisääntöni: jos riippumattomia alitehtäviä on alle 5 tai tiedostoja alle 50, tavallinen chat parin aliagentin kanssa hoitaa työn edullisemmin.

Jos johdat Enterprise-tilauksen tiimiä, ylläpitäjä on saattanut poistaa Workflow’t käytöstä hallituilla asetuksilla tai Claude Coden hallintasivun valitsimella. Ennen kuin pidät Workflow’ta ”ratkaisuna kaikkeen”, tarkista, että se on ylipäätään käytössä: /config → Dynamic workflows -asetus.

Löydät lisää materiaalia