Keskitaso20 min

Claude Code: Agenttinen työskentely

Claude Coden suurin ero perinteisiin AI-koodaustyökaluihin on sen agenttinen toiminta. Sen sijaan että antaisit yksittäisiä ohjeita, voit antaa Claude Codelle laajemman tehtävän ja se suunnittelee ja toteuttaa sen itsenäisesti. Tässä oppaassa opit hyödyntämään agenttista työskentelyä tehokkaasti.

Mitä agenttinen toiminta tarkoittaa?

Perinteisessä AI-koodauksessa annat ohjeen ja saat vastauksen. Agenttinen toiminta menee pidemmälle:

Perinteinen AI-koodaus: 1. Sinä: "Lisää validointi lomakkeeseen" 2. AI: Ehdottaa koodia 3. Sinä: Kopioit ja liität 4. Sinä: Testaat, löydät ongelman 5. Sinä: Kysyt taas

Agenttinen Claude Code: 1. Sinä: "Lisää validointi lomakkeeseen" 2. Claude: Lukee nykyisen lomakkeen koodin 3. Claude: Tutkii mitä validointikirjastoja projektissa on 4. Claude: Kirjoittaa validointikoodin 5. Claude: Ajaa testit 6. Claude: Korjaa mahdolliset virheet 7. Claude: Raportoi tuloksen

Claude siis suunnittelee, tutkii, toteuttaa ja varmistaa - kaikki yhdellä pyynnöllä.

Hyvät agenttiset promptit

Agenttinen työskentely toimii parhaiten kun annat selkeän tavoitteen mutta et liikaa rajoita toteutusta:

Hyviä prompteja:

"Lisää käyttäjärekisteröinti tähän sovellukseen. Käytä olemassa olevaa tietokantayhteyttä ja luo tarvittavat API-endpointit."

"Tämä sovellus on hidas. Tutki suorituskykyongelmat ja tee parannuksia."

"Lisää kattavat testit src/lib/ kansioon. Aja testit ja varmista että ne menevät läpi."

Huonoja prompteja:

"Tee sovellus" - liian laaja "Lisää rivi 42 tiedostoon x.ts: const a = 1" - liian tarkka, ei tarvitse agenttia "Tee kaikki" - epämääräinen

# Esimerkki: Monivaiheinen tehtävä

> Refaktoroi autentikaatio käyttämään JWT-tokeneita.
> Nykyinen toteutus on session-pohjainen.
> Varmista että kaikki API-endpointit toimivat muutoksen jälkeen.

# Claude suorittaa:
# 1. Lukee nykyisen auth-toteutuksen
# 2. Analysoi mitä endpointteja on
# 3. Suunnittelee JWT-migraation
# 4. Tekee muutokset tiedostoihin
# 5. Päivittää endpointit
# 6. Ajaa testit
# 7. Korjaa mahdolliset ongelmat
Vinkki: Anna Claudelle tavoite ja konteksti, mutta anna sen päättää toteutuksen yksityiskohdat. Se on usein yllättävän hyvä suunnittelija.

Iteratiivinen työskentely

Agenttinen työskentely ei tarkoita että annat yhden suuren tehtävän ja odotat. Paras tulos tulee iteratiivisesta työskentelystä:

Vaihe 1: Aloita perusrakenteesta "Luo perusrakenne blogiominaisuudelle - tietokantamallit ja API-endpointit"

Vaihe 2: Lisää toiminnallisuutta "Lisää blogille kommenttiominaisuus"

Vaihe 3: Paranna "Optimoi blogin hakutoiminto ja lisää sivutus"

Vaihe 4: Testaa ja viimeistele "Kirjoita testit blogille ja korjaa mahdolliset ongelmat"

Jokaisen vaiheen jälkeen tarkista tulokset ja anna palautetta. Claude oppii projektin konventiot session aikana.

# Interaktiivisessa sessiossa - iteratiivinen flow:

> luo uusi API endpoint käyttäjäprofiileille
# Claude toteuttaa, sinä tarkistat

> hyvä, mutta lisää rate limiting ja input-validointi
# Claude parantaa toteutusta

> aja testit
# Claude ajaa testit, näkee virheet

> korjaa virheet ja lisää puuttuvat edge caset
# Claude korjaa ja täydentää

> /cost
# Tarkista paljonko sessio on maksanut

Työkalujen hyödyntäminen

Claude Code käyttää automaattisesti erilaisia sisäänrakennettuja työkaluja tehtävien suorittamiseen:

Tiedostotyökalut: - Tiedostojen lukeminen (Read) - Tiedostojen muokkaus (Edit) - Tiedostojen kirjoittaminen (Write) - Tiedostohaku (Glob, Grep)

Terminaalityökalut: - Komentojen suoritus (Bash) - Taustaprosessit

Hyvä tietää: - Claude valitsee työkalut automaattisesti tehtävän perusteella - Näet aina mitä työkalua Claude aikoo käyttää - Voit hyväksyä tai hylätä jokaisen toiminnon erikseen - Claude ketjuttaa työkaluja älykkäästi: lukee tiedoston, analysoi, muokkaa, testaa

Vinkki: Jos Claude näyttää tekevän jotain odottamatonta, voit keskeyttää painamalla Ctrl+C ja ohjata sen takaisin oikealle polulle.

Pitkien tehtävien hallinta

Joskus agenttinen tehtävä kestää pitkään. Näin hallitset pitkiä sessioita:

Seuraa etenemistä: Claude kertoo mitä se tekee reaaliajassa. Näet jokaisen tiedoston luvun, muokkauksen ja komennon.

Keskeytä tarvittaessa: Ctrl+C keskeyttää nykyisen toiminnon. Voit antaa lisäohjeita ja jatkaa.

Käytä /compact: Pitkässä sessiossa konteksti-ikkuna täyttyy. /compact tiivistää historian ja vapauttaa tilaa.

Jaa tehtävä osiin: Jos tehtävä on liian suuri yhdelle sessiolle, jaa se pienempiin osiin. Lopeta /clear ja aloita seuraava osa.

Tarkista lopputulos: Kun Claude ilmoittaa olevansa valmis, tarkista muutokset Git-diffillä ennen commitia.

# Pitkän tehtävän hallinta:

> refaktoroi koko src/api/ kansio käyttämään uutta error handling patternia
# Claude työskentelee...
# Voit seurata etenemistä reaaliajassa

# Jos konteksti täyttyy:
> /compact
# Claude tiivistää ja jatkaa

# Tarkista tulokset:
> näytä yhteenveto kaikista tekemistäsi muutoksista

# Tarkista Git-diffillä:
> aja git diff --stat

Yhteenveto

  • Agenttinen toiminta tarkoittaa: Claude suunnittelee, tutkii ja toteuttaa itsenäisesti
  • Anna tavoite ja konteksti - älä rajoita toteutusta liikaa
  • Työskentele iteratiivisesti: perusrakenne, parannukset, testit
  • Käytä /compact pitkissä sessioissa ja tarkista tulokset aina

Usein kysytyt kysymykset

Kuinka isoja tehtäviä Claude Codelle voi antaa?

Periaatteessa hyvinkin isoja, mutta käytännössä paras tulos tulee keskikokoisista tehtävistä (yhden ominaisuuden toteutus, refaktorointi, testien kirjoitus). Liian suuret tehtävät kannattaa jakaa osiin.

Voiko Claude Code rikkoa projektini?

Claude kysyy aina luvan ennen tiedostomuutoksia ja komentoja. Lisäksi Git-versionhallinta suojaa: voit aina palata aiempaan tilaan. Tee commit ennen suuria muutoksia.

Miten agenttinen toiminta eroaa Cursor Agentista?

Molemmat ovat agenttisia, mutta Claude Code toimii terminaalissa ja on itsenäisempi. Se ei vaadi graafista käyttöliittymää ja soveltuu paremmin automatisoituihin työnkulkuihin ja CI/CD-putkiin.

Tutustu kaikkiin Claude Code -oppaisiin

Löydä lisää vinkkejä ja oppaita Claude Coden tehokäyttöön.

Kaikki Claude Code -oppaat