Blogi

/goal Claude Codessa: autonominen tila ja Agent View vuonna 2026

Markdown

Claude Code 2.1.139:n /goal-komento käynnistää autonomisen tilan: agentti työskentelee, kunnes saavuttaa tavoitteen. Selitän Agent View’n, worktreet ja 5 esimerkkiä.

Lue koko artikkeli

Ailoot-viitedokumentaatio: ailoot.ai/docs/.

Mikä /goal on Claude Codessa?

Keskeiset huomiot

/goal on Claude Code 2.1.139+:n komento (julkaistu 11. toukokuuta 2026), joka käynnistää autonomisen tilan: määrität valmistumisehdon, ja Claude kirjoittaa koodia, suorittaa testejä ja jatkaa seuraavalla vuorolla, kunnes tavoite saavutetaan. Jokaisen vuoron jälkeen pieni malli (oletuksena Haiku) lukee keskustelulokin ja vastaa ehdon perusteella ”kyllä/ei”. Komennon voi aktivoida tavallisessa istunnossa tai headless-tilassa komennolla claude -p.

Aiemmin Claude Code pysähtyi jokaisen vastauksen jälkeen ja odotti seuraavaa kehotettasi. Tämä toimi lyhyissä tehtävissä, mutta pidemmissä alkoi tökkiä: API-siirto, 12 epäonnistuneen testin korjaaminen, 800-rivisen tiedoston uudelleenjärjestely – tällaiset tehtävät vaativat 20–30 iteraatiota, ja jokaisen jälkeen jouduit palaamaan terminaaliin.

/goal ratkaisee ongelman yksinkertaisella ajatuksella: erotetaan ”työn tekijä” siitä, joka päättää, milloin työ on valmis. Pääagentti kirjoittaa koodia. Erillinen arvioija (nopea Haiku-malli) lukee keskustelun jokaisen vuoron jälkeen ja vastaa yhteen kysymykseen: ”Onko ehto täyttynyt?” Jos ei ole, agentti aloittaa uuden vuoron. Jos on, ohjaus palautuu sinulle.

Anthropicin virallinen dokumentaatio määrittelee sen näin:

/goal-komento asettaa valmistumisehdon, ja Claude työskentelee sen eteen odottamatta kehotettasi jokaisessa vaiheessa. Jokaisen vuoron jälkeen pieni ja nopea malli tarkistaa, onko ehto täyttynyt. Jos ei ole, Claude aloittaa seuraavan vuoron sen sijaan, että palauttaisi ohjauksen sinulle. Tavoite tyhjennetään automaattisesti heti, kun ehto täyttyy.

— Anthropic Docs, https://code.claude.com/docs/en/goal

Claude Coden luoja Anthropicilla kuvaili työrutiiniaan haastattelussa 4. toukokuuta 2026:

Tuhansia agentteja yöllä puhelimesta – tämä ei ole markkinointia, vaan Anthropicin insinöörin nykyinen käytäntö. Sen mahdollistaa saman julkaisun yhteydessä 11. toukokuuta 2026 esitelty /goal- ja Agent View -yhdistelmä.

Miksi autonomista tilaa tarvitaan: mitä oli ennen 11. toukokuuta 2026 ja sen jälkeen?

Keskeiset huomiot

Ennen 11. toukokuuta 2026 Claude Codessa ei ollut sisäänrakennettua autonomista tilaa. Kehittäjät kirjoittivat omia bash-skriptejä cron-ajastimilla, mikä johti taloudellisiin katastrofeihin – yksi kehittäjä käytti 6 000 dollaria yön aikana 22. toukokuuta, koska välimuistin TTL muuttui ilman ilmoitusta tunnista 5 minuuttiin. /goal toi autonomian suoraan työkaluun valvojarakenteella, ehtoon lisättävällä vuororajalla ja arviointimallilla, joka pysäyttää silmukkaan jäävät istunnot.

Ajatus ”tekoälyn jättämisestä yöksi töihin” oli ollut olemassa jo syksystä 2025 lähtien, jolloin Cursor Composer ja Clinen automaattinen tila pystyivät jo toimimaan taustalla. Ennen 11. toukokuuta 2026 Claude Code kuitenkin edellytti tähän manuaalista käärettä: cron-tehtävää, joka kutsui claude -p -komentoa N minuutin välein, tai käärettä, joka seurasi git-tilaa ja käynnisti seuraavan kehotteen.

Tämä itse tehty lähestymistapa johti toistuvasti katastrofeihin. Eräs kehittäjä jätti tällaisen skriptin käyntiin yöksi ja heräsi 6 000 dollarin laskuun 22. toukokuuta 2026. Perimmäinen syy: Anthropic muutti hiljaisesti Claude Coden välimuistin TTL:n tunnista viiteen minuuttiin ilmoittamatta siitä. Cron kutsui tuotantoa 30 minuutin välein – välimuisti ehti vanhentua ajokertojen välillä. Jokaisella ajokerralla rakennettiin uudelleen 800 000 tokenin historia alusta. Tuoreen tiedon kirjoittaminen välimuistiin maksaa paljon enemmän kuin aktiivisesta välimuistista lukeminen.

Kehittäjä ei tehnyt mitään erikoista – hän käytti työkalua täsmälleen niin kuin Anthropic sitä mainosti.

/goal ratkaisee ongelman sisäänrakennetulla arkkitehtuurilla:

  1. Valvontaprosessi, joka pitää istunnon terminaalin ulkopuolella ja jatkaa toimintaansa, vaikka ikkuna suljetaan ja kannettava siirtyy lepotilaan.
  2. Haiku-arvioija – edullinen malli tarkistaa jokaisen vuoron; arvioijan tokenit maksavat vain senttejä.
  3. Ehtoon määritettävä kiinteä vuororaja – voit kirjoittaa nimenomaisesti or stop after 20 turns, jolloin istunto varmasti pysähtyy.
  4. Worktree-eristys taustalla toimiville istunnoille – muutokset menevät erilliselle haaralle koskematta työskentelykopioosi.

Ero ”kirjoita oma bash-skripti” -lähestymistapaan on se, että Anthropic tekee kaikista näistä mekanismeista työkalun ensiluokkaisia osia kolmannen osapuolen kiertoratkaisujen sijaan.

/goal-komennon käyttöönotto kolmessa vaiheessa

Keskeiset huomiot

Vähimmäisprosessi: 1) päivitä Claude Code versioon 2.1.139+ komennolla claude update tai npm i -g @anthropic-ai/claude-code, 2) kirjoita istuntoon suoraan /goal ja ehto, 3) seuraa edistymistä reaaliaikaisesta peittonäkymästä (kulunut aika, vuorojen määrä, tokenit). Komento toimii sekä vuorovaikutteisessa istunnossa että headless-tilassa komennolla claude -p. Pysäytä se painamalla Ctrl+C; peruuta tavoite komennolla /goal clear.

Vaihe 1. Päivitä Claude Code versioon 2.1.139 tai uudempaan.

Tarkista versio:

claude --version

Jos versio on vanhempi kuin 2.1.139, päivitä:

claude update
# or force it through npm
npm install -g @anthropic-ai/claude-code@latest

12.–19. toukokuuta 2026 julkaistut versiot korjasivat ensimmäisen version merkittäviä virheitä. Versiossa 2.1.140 korjattiin hiljainen jumiutuminen, jossa disableAllHooks esti arvioijan toiminnan. Versiossa 2.1.143 tulivat worktree.bgIsolation: "none" ja korjaus pysäytyskoukun silmukoihin. Versiossa 2.1.144 (19. toukokuuta) lisättiin taustalla toimivien istuntojen --resume ja agenttien --json-valitsin skriptikäyttöä varten. Vähimmäisversio on 2.1.143.

Vaihe 2. Kirjoita /goal ja ehto.

Avaa tavallinen Claude Code -istunto ja kirjoita komento:

/goal all tests in test/auth pass and the linter is clean, or stop after 15 turns

Sinun ei tarvitse lähettää erillistä kehotetta sen jälkeen – komento käynnistää ensimmäisen vuoron heti. Ehdon voi kirjoittaa suomeksi, englanniksi tai näiden yhdistelmänä; malli ymmärtää molempia kieliä. Pituusraja on enintään 4 000 merkkiä.

Vaihe 3. Seuraa reaaliaikaisesta peittonäkymästä.

Kun /goal käynnistyy, terminaalin alareunaan ilmestyy reaaliaikainen paneeli:

/goal active · 3 turns · 12m elapsed · 18,400 tokens · last: tests in test/auth/login.test.ts still fail

Se näyttää seuraavat tiedot:

  • Vuorot – kuinka monta vuoroa on suoritettu
  • Kulunut aika – kuinka paljon aikaa käynnistyksestä on kulunut
  • Tokenit – kulutettujen tokenien kokonaismäärä (tärkein budjetin seurannan luku)
  • Viimeisin – arvioijan viimeisin syy sanoa ”ei vielä”

Hyödyllinen vinkki: jos arvioija antaa saman syyn kolmella peräkkäisellä vuorolla, kyse voi olla silmukasta. Paina silloin Ctrl+C tai kirjoita /goal clear (synonyymit: stop, off, reset, cancel), muotoile ehto uudelleen ja käynnistä uudestaan. Tämä sääntö esiintyy yhteisöoppaissa /goal-komennon silmukkaan juuttumisen tärkeimpänä merkkinä: ”sama syy kolmesti – kyseessä on silmukka, poistu.”

Hyvän ehdon kirjoittaminen: 5 sääntöä ja 5 esimerkkiä

Keskeiset huomiot

Ehto on todennettava poistumisehto, ei kehote. Hyvässä ehdossa on kolme osaa: mitattava lopputila (testit läpäisty, koonti onnistunut), todennusmenetelmä (npm test exits 0) ja rajoitteet, joita ei saa rikkoa (”tiedostoja ei saa muokata /auth-hakemiston ulkopuolella”). Huonot ehdot ovat epämääräisiä (”tee siitä hyvännäköinen”), mahdottomia todentaa (”optimoi UX”) tai niistä puuttuu vuororaja. Yksi kehittäjä poltti 200 dollaria 14 tunnissa epämääräisellä ehdolla.

Anthropicin dokumentaatiossa kuvataan hyvän ehdon kolme vaadittua osaa:

Monen vuoron ajan toimivassa ehdossa on yleensä yksi mitattava lopputila – testitulos, koonnin poistumiskoodi, tiedostojen määrä tai tyhjä jono; eksplisiittinen todennusmenetelmä – miten Clauden tulisi osoittaa se, esimerkiksi npm test exits 0 tai puhdas git status; sekä tärkeät rajoitteet – mitä ei saa muuttaa työn aikana, kuten no other test file is modified.

— Anthropic Docs, https://code.claude.com/docs/en/goal

Valmis malli kattaa kaikki kolme osaa yhdellä rivillä:

/goal [tee työ] kunnes [mitattava lopputila] rikkomatta [noudatettavat rajoitteet]

Viisi sääntöä, joihin useimmat kompastuvat:

Sääntö 1. Lopputilan on oltava todennettavissa komennolla, ei makuasialla.

Ei ”tee siitä hyvännäköinen”, vaan npm test exits 0. Ei ”paranna UX:ää”, vaan Lighthouse Performance score above 90. Arvioija lukee vain keskustelulokin – se ei suorita komentoja eikä katso kuvakaappauksia. Jos tulosta ei voi kirjata tekstinä, arvioija ei koskaan vastaa ”kyllä”.

Sääntö 2. Rajoitteiden on oltava täsmällisiä ja rajattuja.

Ilman rajoitteita Claude saattaa korjata testit poistamalla itse testit tai kommentoimalla epäonnistuvat väitteet pois. Määritä without modifying any file outside /auth, without removing existing assertions, without bumping major versions of dependencies.

Sääntö 3. Kiinteä vuororaja on välttämätön.

Lisää jokaiseen ehtoon or stop after N turns. Se on turva loputonta silmukkaa vastaan. Ilman rajaa tunnin ajan pyörivä silmukka kuluttaa enemmän tokeneita kuin saman tehtävän manuaalinen suorittaminen. Varaa sille budjetti.

Ilman rajaa tunnin ajan pyörivä silmukka kuluttaa enemmän tokeneita kuin saman tehtävän manuaalinen suorittaminen. Varaa sille budjetti.

Sääntö 4. Kuvaile MITÄ, älä vain MITEN.

Älä käytä /goal-komentoa tehtäviin, joissa ”valmis” tarkoittaa ”näyttää hyvältä”, ”tuntuu oikealta”, ”on hyvin suunniteltu” tai ”on hauska”. Arvioija lukee vain keskustelun — se ei suorita työkaluja eikä pysty arvioimaan, miten tulos toimii.

Jos et maininnut visuaalisuutta ehdossa, Claude ei luo sitä. Jos ehto vaatii vain ”testit menevät läpi”, Claude saattaa kommentoida monimutkaiset testit pois. Kuvaile MITÄ haluat, älä vain MITEN aiot todentaa sen.

Sääntö 5. Pyydä Claudea näyttämään todisteet keskustelussa.

Arvioija ei suorita komentoja – se lukee vain sen, mitä Claude on jo näyttänyt. Jos ehto vaatii, että ”npm test menee vihreäksi”, mutta Claude ei näyttänyt npm test -tulostetta keskustelulokissa, arvioija sanoo ”ei vielä” ikuisesti. Lisää ehtoon ilmaus ”näytä komennon <command> tuloste keskustelussa”.

Viisi toimivaa esimerkkiä yleisiin tehtäviin:

1. API migration:
/goal every call to getUser() has been replaced with fetchUser(), npm test passes, npm run build is green, no other API names have been touched, or stop after 30 turns

2. Fixing tests:
/goal all failing tests in test/auth are now green (npm test shows 0 fails in the chat), without changing assertions or deleting tests, or stop after 20 turns

3. Code quality (file size):
/goal src/legacy/UserService.ts has been split into files under 200 lines each, all imports are updated, npm run build is green, or stop after 25 turns

4. Closing the backlog:
/goal process every issue labeled 'good-first-issue': read the description, implement a fix in a worktree branch, open a PR. Continue until the queue is empty or 6 issues have been processed

5. Security audit:
/goal every npm audit vulnerability with severity >= high is fixed, all existing tests pass, no breaking API changes, or stop after 15 turns

Haluatko tehdä enemmän kuin vain suorittaa /goal-komennon ja rakentaa ympäristön, jossa autonominen tila toimii projektissasi kunnolla? /goal on vasta viimeinen lenkki. Sitä ennen tarvitaan kolme peruspilaria: tekoälyklooni (menetelmäsi Skills- ja Subagents-ominaisuuksissa), toiset aivot (CLAUDE.md ja plans/-kansio) sekä kontekstin suunnittelu (Plan Mode ja /compact). Kaikki kolme osaa kannattaa suunnitella yhdessä – tämä yhdistelmä tukee työskentelyä kontekstin kanssa.

5 esimerkkiä, joissa /goal toimii oikeasti

Keskeiset huomiot

/goal toimii hyvin tehtävissä, joilla on todennettava lopputila: API-siirrot, epäonnistuneiden testien korjaaminen, suurten tiedostojen pilkkominen, tehtäväjonon tyhjentäminen ja tietoturvatarkastukset. Se toimii huonosti subjektiivisissa tehtävissä, kuten suunnittelussa, UX:n viimeistelyssä, oivallusten etsimisessä ja luovassa työssä. Nyrkkisääntö: pystytkö kuvaamaan ”valmis”-tilan bash-komennolla? Jos pystyt, tehtävä sopii siihen. Jos et, palaa tavalliseen istuntoon tai Plan Modeen.

Anthropicin dokumentaatiossa annetaan neljä tehtävätyyppiä, joihin /goal sopii hyvin:

Käytä goal-komentoa merkittävään työhön, jolla on todennettava lopputila: siirrä moduuli uuteen API:in, kunnes kaikki kutsut kääntyvät ja testit läpäisevät; toteuta suunnitteludokumentti, kunnes kaikki hyväksymiskriteerit täyttyvät; pilko suuri tiedosto kohdennetuiksi moduuleiksi, kunnes jokainen pysyy kokorajan sisällä; käsittele tunnisteella merkittyjen tehtävien jono, kunnes se on tyhjä.

— Anthropic Docs, https://code.claude.com/docs/en/goal

Tässä on viisi esimerkkiä valmiine ehtoineen – ota ne käyttöön ja muokkaa omaan projektiisi.

Esimerkki 1. Siirrä moduuli uuteen API:in.

Tilanne: siirryt RESTistä GraphQL:ään tai korvaat vanhan getUser()-funktion uudella fetchUser()-funktiolla. Tehtävä on mekaaninen, mutta koskee 30–50 tiedostoa.

Ehto:

/goal every getUser() in src/ has been replaced with fetchUser(), all calls updated to the new interface (id instead of userId), npm test passes, no files outside src/ touched, or stop after 30 turns

Miksi tämä toimii: lopputilan voi tarkistaa komennolla grep -r getUser src/ | wc -l (tuloksen pitäisi olla 0) ja komennolla npm test exits 0. Rajoite suojaa testitiedostoja.

Esimerkki 2. Korjaa epäonnistuvat testit.

Tilanne: kirjaston päivityksen jälkeen 15 testiä rikkoutui. Tiedät korjauksen olevan mekaaninen – päivitä mockit ja sovita assertionit uuteen muotoon. Et halua tehdä sitä käsin.

Ehto:

/goal all failing tests in test/ are now green, npm test shows the results in the chat with 0 failures, without deleting tests or commenting out assertions, or stop after 25 turns

Toinen esimerkki samantyyppisestä ehdosta:

Korjaa kaikki epäonnistuneet testit, kunnes npm test palauttaa arvon 0 muuttamatta yhtäkään /auth-hakemiston ulkopuolista tiedostoa.

Esimerkki 3. Pilko monoliittinen luokka osiin.

Tilanne: yhdessä 1 200-rivisessä tiedostossa on kaikki – malli, palvelu, apuohjelmat ja API-asiakas. Haluat pilkkoa sen ”yksi tiedosto, yksi vastuu” -periaatteen mukaan, päivittää kaikki tuonnit ja pitää testit läpäisevinä.

Ehto:

/goal src/legacy/UserService.ts has been split into files under 200 lines, each file handles one responsibility (model, repository, api-client, validator), all imports are updated, npm run build is green, existing tests pass, or stop after 25 turns

Esimerkki 4. Tyhjennä tehtäväjono yön aikana.

Tilanne: sinulla on avoimen lähdekoodin repositorio, jossa on 20 good-first-issue-tunnisteella merkittyä issuea. Haluat Clauden työstävän niitä yön aikana.

Ehto:

/goal process every issue labeled 'good-first-issue': read the description, implement a fix in a separate worktree branch worktree-issue-N, open a PR with a description. Continue until the queue is empty or 6 issues have been processed, or stop after 80 turns

Lukua 6 ei valittu sattumalta – se on realistinen enimmäismäärä yhdelle yölle Pro-tilauksella. Jos haluat ajaa useita agentteja rinnakkain, tarvitset Max- tai Enterprise-tilauksen.

Esimerkki 5. Tietoturvatarkastus.

Tilanne: npm audit näyttää 8 vakavaa haavoittuvuutta. Haluat Clauden korjaavan ne päivittämättä pääversioita.

Ehto:

/goal every npm audit vulnerability with severity high+ is fixed, npm audit shows 0 high in the chat, all existing tests pass, no breaking API changes, no major version bumps to packages, or stop after 15 turns

Mitä /goal-komennolla EI pidä tehdä:

TehtävätyyppiMiksi se ei toimi
”Tee kaunis käyttöliittymä”Arvioija näkee vain tekstin, ei suunnittelua
”Etsi datasta oivallus”Ei todennettavaa lopputilaa
”Optimoi sivun UX”Subjektiivinen makuasia; agentti optimoi sitä, mitä mitataan
Tutkimus / selvittelyAvoin tehtävä – arvioija ei tiedä, milloin se on ”tarpeeksi”
Tuotantoon vientiUlkoisia sivuvaikutuksia ei voi perua
Sisällön / markkinoinnin luominenTekstin laatua ei voi tarkistaa komennolla

Croucher muotoilee nyrkkisäännön painokkaasti kenttäoppaassaan: älä käytä /goal-komentoa tehtäviin, joissa ”valmis” tarkoittaa ”näyttää hyvältä”, ”tuntuu oikealta”, ”on hyvin suunniteltu” tai ”on hauska”. Arvioija lukee vain keskustelulokin – se ei käytä työkaluja eikä pysty arvioimaan, miten tulos toimii. Tämän säännön vuoksi /goal ei sovi 80 prosenttiin subjektiivisista tehtävistä, joissa se jää silmukkaan tuottamatta hyödyllistä tulosta.

Milloin /goal kuluttaa rahaa turhaan: 3 sudenkuoppaa

Keskeiset huomiot

Kolme tyypillistä /goal-sudenkuoppaa: epämääräinen ehto ilman vuororajaa (yksi kehittäjä poltti 200 dollaria 14 tunnissa), rekursiivinen silmukka vanhentuneella välimuistilla (6 000 dollaria yön aikana välimuistin TTL:n muututtua) ja luovat tehtävät ilman todennettavaa lopputilaa (peli luotiin ilman grafiikkaa, vaikka arvioija ilmoitti sen olevan ”valmis”). Suojatoimet ovat: lisää aina or stop after N turns, määritä mitattava tulos ja arvioi ensin, sopiiko tehtävä autonomiseen työskentelyyn.

Sudenkuoppa 1. Epämääräinen ehto ilman kiinteää vuororajaa.

Yleisin virhe on ehto kuten ”paranna koodia” / ”tee siitä hyvä” / ”optimoi se”. Ilman vuororajaa agentti jatkaa, kunnes kulutat kiintiösi loppuun.

Findskill kuvasi todellisen tapauksen:

Yksi kehittäjä kertoi käyttäneensä 200 dollaria 14 tunnin istunnossa epämääräisten ehtojen vuoksi. Heikko ehto, joka saa arvioijan vastaamaan jatkuvasti ”ei vielä”, voi johtaa 50, 100 tai 500 vuoroon ennen kuin huomaat sen.

200 dollaria 14 tunnissa epämääräisen ehdon vuoksi vastaa Max-tilauksen koko viikkorajaa. Aamulla heräät ilman kiintiötä ja ilman hyödyllistä tulosta.

Suojatoimi: päätä jokainen ehto ilmaukseen or stop after N turns (15 helpoissa tehtävissä, 50 vaikeissa ja enintään 100 yön yli jatkuvissa ajoissa).

Sudenkuoppa 2. Rekursiivinen silmukka ja rikkoutunut välimuisti.

  1. toukokuuta 2026 kehittäjä jätti tällaisen skriptin käyntiin yöksi ja heräsi 6 000 dollarin laskuun: Anthropic muutti hiljaisesti välimuistin TTL:n tunnista viiteen minuuttiin. Kehittäjä ei käyttänyt suoraan /goal-komentoa, mutta logiikka oli sama: autonominen silmukka 30 minuutin cron-ajastimella rakensi 800 000 tokenin historian uudelleen alusta joka kerta.

Perimmäinen ongelma oli, ettei ulkoinen automaatio tiennyt palveluntarjoajan sisäisistä muutoksista. Sama voisi tapahtua /goal-komennolla, jos ajat sitä 8 tuntia ilman valvontaa: tokenien käyttö kasvaa epälineaarisesti, eikä kehotevälimuisti toimi niin kuin luulet.

Suojatoimet:

  1. Älä aja /goal-komentoa yli 8 tuntia ilman välitarkistuksia.
  2. Ota käyttörajat käyttöön kohdassa Settings → Usage (uusi suojatoimi 6 000 dollarin tapauksen jälkeen).
  3. Avaa claude agents kahdesti yön aikana – vilkaise istuntoa Space-näppäimellä ja tarkista, ettei vuorojen määrä kasva odotettua nopeammin.
  4. Jos käytössä on kallis malliketju (Opus 4.7), aseta tiukempi vuoraraja – enintään 30.

Sudenkuoppa 3. Luovuus /goal-komennon avulla.

Croucher käytti /goal-komentoa pelin rakentamiseen – ehto sisälsi determinismin, invariantit ja tarkistuksen siitä, voiko tason läpäistä. Peli rakennettiin, testit läpäistiin ja arvioija ilmoitti tavoitteen saavutetuksi. Pelissä ei ollut grafiikkaa – ehdossa ei mainittu kuvitusta.

Tämä havainnollistaa yleistä sääntöä: arvioija optimoi täsmälleen sitä, mitä mittaat. Jos ehto ei mainitse visuaalisuutta, sitä ei tule. Jos siinä mainitaan vain testit, se saattaa kommentoida väitteet pois.

Suojatoimi: älä käytä /goal-komentoa mihinkään, mikä perustuu makuun (suunnittelu, tekstit, UX). Palaa tavalliseen istuntoon tai Plan Modeen – niissä pysyt päätöksenteossa mukana.

Mikä Agent View on ja miten hallintapaneeli avataan?

Keskeiset huomiot

Agent View on visuaalinen hallintapaneeli Claude Coden taustalla toimivien istuntojen hallintaan. Avaa se terminaalissa komennolla claude agents. Jokainen taustalla toimiva istunto näkyy rivinä, jolla on tila (Työskentelee, Vaatii syötettä, Jouten, Valmis, Epäonnistui, Pysäytetty). Se on hyödyllinen, kun ajat samanaikaisesti 2–5 autonomista tehtävää – terminaalien välillä vaihtamisen sijaan näet kaiken yhdellä näytöllä. Käytettävissä ovat vilkaisu (Space – pikakatselu ilman istuntoon siirtymistä), liittäminen istuntoon (Enter), irrottautuminen (vasen nuoli) ja kiinnittäminen (Ctrl+T).

Jos /goal on komento ”työskentele, kunnes olet valmis”, Agent View on komentokeskus, jossa voit nähdä kaikki nämä komennot kerralla. Anthropic kuvailee sitä näin:

Agent View avataan komennolla claude agents – se näyttää kaikki taustalla toimivat istuntosi yhdellä näytöllä: mikä työskentelee, mikä tarvitsee syötettäsi ja mikä on valmis. Käynnistä uusia istuntoja, tarkista niiden tila yhdellä silmäyksellä selaamatta keskustelulokeja ja liity istuntoon vain silloin, kun se tarvitsee sinua.

— Anthropic Docs, https://code.claude.com/docs/en/agent-view

Avauskomento:

claude agents

TUI avautuu – terminaalin sisäinen tekstipohjainen hallintapaneeli. Istuntoluettelo on vasemmalla, ja valitun rivin viimeisin viesti näkyy oikeanpuoleisessa vilkaisuikkunassa.

Kuusi istunnon tilaa:

TilaMerkitys
TyöskenteleeClaude työskentelee aktiivisesti – käyttää työkaluja tai luo vastausta
Vaatii syötettäClaude odottaa vastaustasi tiettyyn kysymykseen tai lupaa
JoutenIstunto ei ole aktiivinen ja odottaa seuraavaa kehotetta
ValmisTehtävä on suoritettu onnistuneesti
EpäonnistuiIstunto päättyi virheeseen
PysäytettyIstunto pysäytettiin näppäimillä Ctrl+X tai komennolla claude stop

Tärkeimmät pikanäppäimet:

↑ / ↓             siirry istuntoluettelossa
Space             vilkaisuikkuna (katso ilman istuntoon liittymistä)
Enter / →         liity istuntoon (siirry siihen)
←                 irrottaudu istunnosta (poistu sulkematta sitä)
Ctrl+T            kiinnitä istunto (suojaa automaattiselta pysäyttämiseltä)
Ctrl+X            pysäytä istunto; poista painamalla uudelleen 2 sekunnin sisällä
Ctrl+R            muuta nimeä
Ctrl+S            vaihda ryhmittelyä (tilan ↔ hakemiston mukaan)

Taustalla toimivan istunnon käynnistäminen:

Claude Coden vuorovaikutteisesta käyttöliittymästä:

/bg fix the failing test test/auth/login.test.ts

Tai suoraan komentotulkista:

claude --bg "fix the failing test test/auth/login.test.ts"

Tai nimeämällä istunto, jotta se näkyy Agent View’ssä tunnistettavalla nimellä:

claude --bg --name "flaky-test-fix" "fix test/auth/login.test.ts"

Taustalla toimiva istunto lisätään automaattisesti Agent View’hun – käynnistä se --bg-valitsimella, avaa claude agents, niin näet sen luettelossa.

Tärkein ominaisuus: istunnot säilyvät kannettavan siirtyessä lepotilaan ja ikkunan sulkeutuessa:

Istunnon tila tallennetaan levylle, ja se säilyy automaattisten päivitysten ja valvontaprosessin uudelleenkäynnistysten yli. Istunnot tallentuvat myös, kun tietokone siirtyy lepotilaan. Herätessään niiden prosessit jatkavat toimintaansa ja valvontaprosessi yhdistää niihin uudelleen sen sijaan, että käsittelisi taukoa joutoaikana.

— Anthropic Docs, https://code.claude.com/docs/en/agent-view

Jos kuitenkin sammutat kannettavan tai käynnistät sen manuaalisesti uudelleen, taustalla toimivat istunnot päättyvät epäonnistuneina. Yönaikaiset ajot monilla tausta-agenteilla toimivat vain, jos kannettavaa ei sammuteta.

Workt reet: miten Claude eristää rinnakkaiset istunnot

Keskeiset huomiot

Worktree on repositoriosi erillinen kopio polussa .claude/worktrees/<name>/ ja omalla worktree-<name>-haarallaan. Kun käynnistät taustalla toimivan istunnon komennolla /bg tai Agent View’stä, Claude siirtää sen automaattisesti worktreehen ennen tiedostojen muokkaamista. Rinnakkaiset istunnot voivat lukea samaa checkoutia, mutta kukin kirjoittaa omaan kopioonsa, joten ne eivät ylikirjoita toistensa työtä. Voit poistaa eristyksen käytöstä asetuksella worktree.bgIsolation: "none" tiedostossa .claude/settings.json (ominaisuus versiosta 2.1.143 lähtien).

Worktreet ratkaisevat rinnakkaisen autonomisen työn pääongelman: entä jos kaksi istuntoa yrittää muokata src/auth.ts-tiedostoa samaan aikaan? Ennen versiota 2.1.139 istunnot saattoivat kirjaimellisesti ylikirjoittaa toistensa muutokset. Agent View’n yhteydessä Anthropic esitteli automaattisen eristyksen:

Agent View’stä, `/bg`-komennolla tai komennolla claude --bg käynnistetty taustalla toimiva istunto alkaa työhakemistostasi. Ennen tiedostojen muokkaamista Claude siirtää istunnon eristettyyn Git-worktreehen hakemistossa .claude/worktrees/, joten rinnakkaiset istunnot lukevat samaa checkoutia, mutta kukin kirjoittaa omaan kopioonsa.

— Anthropic Docs, https://code.claude.com/docs/en/agent-view

Näin se toimii käytännössä:

# Launched three background sessions:
claude --bg --name "fix-tests" "fix the failing tests in test/"
claude --bg --name "add-oauth" "add Google OAuth according to the plan in plans/oauth.md"
claude --bg --name "split-userservice" "split UserService.ts into modules"

# File structure after launch:
.claude/worktrees/
├── fix-tests/             # separate repo copy on branch worktree-fix-tests
├── add-oauth/             # separate copy on branch worktree-add-oauth
└── split-userservice/     # separate copy on branch worktree-split-userservice

Kukin istunto työskentelee omassa kopiossaan. Kun tehtävä on valmis, yhdistä tarvittavat haarat main-haaraan.

Vaarallinen ansa – istunnon poistaminen poistaa sen worktreen.

Clauden luomat worktreet poistetaan yhdessä Agent View -istunnon kanssa: yhdistä tai lähetä muutokset ennen sellaisen istunnon poistamista, joka muokkasi tiedostoja omassa worktreessään.

— Anthropic Docs, https://code.claude.com/docs/en/agent-view

Jos päätät istunnon Agent View’ssä (paina Ctrl+X kahdesti), sen worktree katoaa. Kaikki vahvistamattomat muutokset menetetään. Ennen Agent View -istunnon poistamista vahvista muutokset commitilla tai puske ne.

Eristyksen poistaminen käytöstä (harvinaisissa tapauksissa):

Jos sinulla on repositorio, jossa Git-worktreet eivät toimi (esimerkiksi symbolisia linkkejä käyttävä ympäristö tai suuri monorepo, jossa checkout on hidas), voit poistaa eristyksen käytöstä:

// .claude/settings.json
{
  "worktree": {
    "bgIsolation": "none"
  }
}

Tällöin taustalla toimivat istunnot muokkaavat työkopiota suoraan. Tämä käytöstäpoistomahdollisuus tuli versiossa 2.1.143 suuria monorepoja käyttävien tiimien palautteen jälkeen.

Rinnakkaisuus kuluttaa kiintiötä:

Myös taustalla toimiviin istuntoihin sovelletaan käyttörajoja: ne käyttävät tilauskiintiötä kuten vuorovaikutteiset istunnot, joten 10 rinnakkaista agenttia kuluttaa kiintiötä noin 10 kertaa nopeammin kuin yksi.

— Anthropic Docs, https://code.claude.com/docs/en/agent-view

Tämä tarkoittaa, että 20 dollaria kuukaudessa maksava Pro-tilaus riittää 1–2 rinnakkaiseen istuntoon yön aikana, ei kymmeneen. Jos haluat ajaa monia agentteja rinnakkain, tarvitset Max- tai Enterprise-tilauksen.

/goal-, Plan Mode- ja subagents-ominaisuuksien yhdistäminen pitkissä tehtävissä

Keskeiset huomiot

/goal on yksinään ketjun viimeinen lenkki. Käytä sitä ennen Plan Modea vaiheistetun suunnitelman laatimiseen plans/-hakemistoon ja subagents-toimintoja työn jakamiseen. Yhdistelmä toimii näin: 1) Plan Mode laatii yksityiskohtaisen suunnitelman, jossa on todennettavat valintaruudut, 2) subagents voivat työskennellä eri vaiheissa rinnakkain omissa worktree-haaroissaan, 3) /goal ajaa ”työ → arvioija → seuraava vuoro” -kierrosta, kunnes kaikki ruudut on merkitty. Ilman Plan Modea /goal on monimutkaisissa tehtävissä hyödytön.

Tyypillinen epäonnistuminen on kirjoittaa heti /goal build a new feature. Tämä ei toimi, koska arvioija ei tiedä, miltä ”valmis ominaisuus” näyttää. Tarvitset valintaruutuja sisältävän suunnitelman, jonka arvioija voi tarkistaa kohta kohdalta.

Kerros 1. Plan Mode laatii vaiheistetun suunnitelman.

Pyydä Plan Modessa Claudea laatimaan yksityiskohtainen muutossuunnitelma, joka on jaettu 5–7 vaiheeseen ja sisältää todennettavat valintaruudut. Tallenna se nimellä plans/2026-05-24-google-oauth.md. Jokaisessa vaiheessa on 3–7 valintaruutua, joissa on konkreettisia toimia.

Kerros 2. Subagents-toiminnot jakavat työn vaiheittain.

Jos suunnitelman voi jakaa rinnakkaisiin osiin (esimerkiksi jos vaiheet ovat toisistaan riippumattomia – taustapään päätepiste, käyttöliittymän lomake ja tietokantamigraatio), voit käynnistää kunkin vaiheen erillisessä taustalla toimivassa istunnossa komennolla claude --bg --name "<phase>". Jokaisella istunnolla on oma worktree.

Kerros 3. /goal ajaa kierrosta, kunnes valintaruudut on merkitty.

/goal all phases 1–7 in plans/2026-05-24-google-oauth.md are complete and marked [x], all tests in test/auth pass (npm test shows 0 failures), npm run build is green, or stop after 50 turns

Jokaisen vuoron jälkeen arvioija lukee suunnitelman, tarkistaa, mitkä ruudut on merkitty, ja jos jotakin on vielä tekemättä, agentti jatkaa.

Tämä yhdistelmä perustuu kolmeen osaan:

  • kontekstin suunnittelu: oikea sisältö plans/-hakemistossa – arvioija lukee sen
  • toiset aivot: plans/-kansio tallentaa suunnitelman istuntojen välillä
  • tekoälyklooni: CLAUDE.md määrittää agentin noudattamat säännöt

Ilman CLAUDE.md-tiedostoa /goal voi ehdottaa arkkitehtuuria rikkovaa ratkaisua. Ilman plans/-hakemiston suunnitelmaa arvioija ei tiedä onnistumiskriteerejä. Ilman subagents-toimintoja rinnakkaisia vaiheita ei ole, joten kaikki tehdään peräkkäin.

Miten vertaat /goal-komentoa Codexiin, Cursoriin ja muihin agenttitiloihin?

Keskeiset huomiot

Hyödyllinen erottelu koskee tehtävän jatkumista, suorituspaikkaa, oikeuksia ja valmistumisen tarkistusta. Tässä ei ole lähteistettyä samanlaisten kokoonpanojen mittausta, joka tukisi yleistä tokenitehokkuuskerrointa tai kiinteää askelmäärää, jonka jälkeen toinen työkalu menettää johdonmukaisuuden. Vertaa todellista mallia, asiakasta, versiota, suoritustilaa ja tehtävää ennen valintaa.

/goal lisää erillisen valmistumistarkistuksen jokaisen vuoron jälkeen. Muilla tuotteilla on eri tiloja. Paikallinen CLI, ylläpidetty pilvitehtävä ja valvottu editori-istunto eivät ole vaihtokelpoisia vertailuyksiköitä. Älä varsinkaan kuvaa kaikkea Codex CLI -työtä pilvikontiksi tai oleta jokaiselle Codex-ajolle samaa arvioijamallia ja laskutustapaa.

Käytä samaa repositorion tilannekuvaa, tehtävää ja hyväksymistarkistuksia. Kirjaa kustakin ehdokkaasta:

UlottuvuusKirjattavat tiedot
SuoritusAsiakas, versio ja paikallinen tai ylläpidetty ajoympäristö
MalliTäsmällinen malli, päättelyn effort ja kontekstirajat
JatkaminenMikä käynnistää uuden vuoron ja mikä pysäyttää
EristysTyökopio, oikeudet, salaisuudet ja verkkopääsy
TulosHyväksytyt tarkistukset, virheet ja ihmisen korjaukset
KäyttöSyöte, välimuistin luku/kirjoitus, tulostetokenit, aika ja todellinen laskutusmenetelmä

Väite yhden työkalun kiinteästä tokenikertoimesta tarvitsee nämä ehdot ja mitatut määrät samalle onnistuneelle lopputulokselle. Myös benchmark-prosentti tarvitsee benchmark-version, mallin, agentin suoritusympäristön ja ajoasetukset. Terminal-Bench-prosentit ilman näitä tietoja eivät korvaa näyttöä. Artikkeli ei tarjoa riippumatonta työkalujen välistä benchmarkia.

Valitse tarvitsemasi työnkulun perusteella: valvotut muokkaukset, rajattu taustatehtävä tai usean vuoron työ selkeällä valmistumisehdolla. Testaa asennetun tuotteen tukema tila olettamatta kokonaisen kilpailijan puuttuvaa autonomiaa. Pidä käyttöoikeushyväksyntä erillään tehtävän jatkamisesta. Työkalukutsun automaattinen hyväksyntä ei itsessään osoita käyttäjän tavoitteen toteutumista.

/goal verrattuna /loop-komentoon:

/loop on toinen saman julkaisun komento, ja se käynnistää määräajoin toistuvia tehtäviä aikavälein (N minuutin välein). /goal perustuu ehtoon (kunnes se täyttyy). Käytä /loop-komentoa cron-tyyppisiin tehtäviin ja /goal-komentoa yksittäisen tavoitteen saavuttamiseen.

Anthropicin dokumentaatiosta:

LähestymistapaSeuraava vuoro alkaa, kunSe pysähtyy, kun
/goalEdellinen vuoro on päättynytMalli vahvistaa ehdon täyttyneen
/loopAikaväli on kulunutPysäytät sen tai Claude päättää työn olevan valmis
PysäytyskoukkuEdellinen vuoro on päättynytSkriptisi tai kehotteesi päättää

/goal-komennon käynnistystä edeltävä tarkistuslista: 7 kohtaa

Keskeiset huomiot

Tarkista ennen jokaista /goal-ajoa seitsemän asiaa: Claude Code -versio 2.1.139+, ehdossa todennettava lopputila, kiinteä vuororaja, täsmälliset rajoitteet, kaikkien tärkeiden muutosten tallennus, käyttörajojen käyttöönotto Settings-kohdassa ja Agent View’n avaaminen seurantaa varten. Yhdenkin kohdan unohtaminen voi maksaa useita satoja dollareita ja johtaa työn menettämiseen.

Tarkistuslista ennen jokaista /goal-ajoa:

  1. Claude Code -versio 2.1.139+ – tarkista komennolla claude --version ja päivitä, jos versio on vanhempi. Suositeltu vähimmäisversio on 2.1.143 (15. toukokuuta 2026), joka korjaa pysäytyskoukkujen silmukat.

  2. Ehdossa on todennettava lopputila – ”paranna sitä” -ilmauksen sijaan määritä npm test exits 0. Jos et keksi bash-komentoa tuloksen todentamiseen, /goal ei sovi tähän tehtävään.

  3. Kiinteä vuororaja on asetettu – jokaisessa ehdossa on or stop after N turns. Käytä 15:tä helpoissa tehtävissä, 50:tä vaikeissa ja enintään 100:aa yön yli jatkuvissa ajoissa.

  4. Rajoitteet ovat täsmällisiä ja rajattuja – without modifying files outside /auth, without removing existing assertions, without bumping major versions. Ilman niitä Claude saattaa korjata testit poistamalla testit itsessään.

  5. Kaikki tärkeät muutokset on commitoitu tai pusketty – jos et työskentele worktreessä (esimerkiksi kun worktree.bgIsolation: "none"), Claude muokkaa työkopiota. Virhe voi johtaa tallentamattoman työn menettämiseen.

  6. Käyttörajat on otettu käyttöön kohdassa Settings → Usage – uusi suojatoimi 6 000 dollarin tapauksen jälkeen. Aseta raja päivälle, istunnolle ja kuukaudelle.

  7. Agent View claude agents on avattu erilliseen ikkunaan – vilkaise istuntoa pitkissä tehtävissä Space-näppäimellä kerran tunnissa. Jos vuorojen määrä kasvaa odotettua nopeammin tai arvioija toistaa saman syyn kolmella vuorolla, paina Ctrl+C ja muotoile ehto uudelleen.

Lisäksi: älä koskaan aja /goal-komentoa valitsimella --dangerously-skip-permissions jonkun toisen koodilla tai tuntemattomassa koodissa. Tämä yhdistelmä poistaa kaikki tarkistukset käytöstä ja antaa agentin tehdä projektissasi mitä tahansa. Tämän analyysin kirjoittaja käyttää sitä vain uudessa worktreessä, jossa ei ole mitään menetettävää.

/goal on tehokas ominaisuus, mutta ei taikuutta. Se toimii juuri niin hyvin kuin osaat muotoilla ehdon. Jos pystyt kuvaamaan ”valmis”-tilan niin, että komento voi todentaa sen, /goal hoitaa loput. Jos et pysty, palaa tavalliseen istuntoon tai Plan Modeen.

Voit jatkaa Ailootin tutkimista osoitteessa ailoot.ai.

Lisätietoja

Kysymyksiä tästä oppaasta: /goal Claude Codessa: autonominen tila ja Agent View vuonna 2026

Miten kirjoitan arvioijan tarkistettavan valmistumisehdon?

Määritä yksi mitattava tulos, sitä todistava komento tai näyttö ja rajat, kuten väitteiden säilyttäminen tai tietyissä tiedostoissa pysyminen. Lisää nimenomainen pysähtymisraja ja vaadi tarkistustuloste keskusteluun.

Riittääkö kiinteä tokenitehokkuuskerroin agentin valintaan?

Et. Kertoimelle ei ole samanlaisten kokoonpanojen mittausta. Vertaa samaa hyväksyttyä tehtävää ja kirjaa malli, asiakasversio, suoritustila, välimuisti- ja tokenikäyttö, aika sekä ihmisen korjaukset.

Kaikki artikkelit