Tee agentti - oman äpin teko Claude Coden avulla

Netti on täynnä menestystarinoita, miten vibe-koodauksella on noustu ryysyistä rikkauksiin. Vibe-koodauksessa kielimallille kerrotaan omin sanoin, mistä on kyse ja mitä halutaan tehdä. Toisin sanoen laaditaan prompt eli komentokehote. Tekoäly rakentaa äpin eli sovelluksen. Se laatii tiedostorakenteen, tekee tiedostot, kirjoittaa koodin ja kehittää käyttöliittymän, kuvat ja äänet.
Hyvät puolet: kuka tahansa voi olla sovelluskehittäjä, prototyypit valmistuvat testattavaksi tunneissa ja omien työkalujen kehittäminen maksaa murto-osan siitä mitä aiemmin. Riskit: tekoälyn koodissa voi olla tietoturva-aukkoja, jos sitä ei valvota ja koodia tarkasteta. Koodi muuttuu spagetiksi, kun sovellus kasvaa suureksi. Ja kun (ei jos) äppiin tulee bugi eli virhe, sen korjaaminen voi olla vaikeaa ilman ohjelmointitaitoa.

Näytän seuraavaksi, miten teet oman sovelluksen. Tarkoitus tällä on demota, miten vibe-koodaus sopii nopeaan kehitykseen. Omien pienien apuäppien ja skriptien, kuten sähköpostin organisoijan, teko ja käyttö poistaa riippuvuuden teknojättien alustoista tai maksullisista palveluista. Oikea lisäarvo uudesta teknologiasta syntyy sen avustamisesta omaan työhön, ei siitä, että työssä on taas uusi softa tai muu tekniikkakilke opeteltavana, kun siihen ei edes ole koulutusta saati aikaa.

Minun tietokoneen ympäristö:

Valmis Muistipaikka-sovellus: vasemmalla sivupalkki, oikealla Aloitusopas-sivu, jossa on tehtävälista ja Markdown-pikanäppäimiä.

Tältä valmis sovellus näyttää. Sivut, kuvakkeet, kansikuvat, tehtävälistat, Tiedosto-valikko ja tumma tila kuuluvat mukaan.

Mitä tarvitset

Et tarvitse ohjelmointikokemusta, Gitiä, GitHub-tiliä, komentorivin (CLI) osaamista, API-avainta tai palvelinta. Näistä kaikista on apua ja etua, mutta käsitellään ne erikseen. Keskeinen asia nyt: kaikki toimii omalla koneellasi + nettiyhteys.

Asennus- ja työjärjestys

On mahdotonta tietää, mitä koneellasi on asennettu. Niinpä asennusjärjestys menee sen mukaan, että kaikki tässä esitetty asennetaan.

  1. Asenna VS Code. Koodieditori, jossa työ tehdään. Älä säikähdä "koodi" sanaa. Ei tarvitse koodata.
  2. Asenna Node.js. Ohjelma, jolla sovellus pyörii.
  3. Asenna Claude Code. Tekoälyavustaja VS Coden laajennuksena. Claude hoitaa koodauksen.
  4. Kirjaudu Claudeen. Yhdistä laajennus Claude-tiliisi.
  5. Tee kansio. Sovelluksen tiedostot tulevat yhteen kansioon.
  6. Tallenna prompti eli rakennusohje. PROMPT.md kertoo tekoälylle, mitä tehdään.
  7. Pyydä Claudea rakentamaan. Tekoäly kirjoittaa koodin.
  8. Avaa ja kokeile. Muistipaikka aukeaa selaimessa.
  9. Kerro tekoälylle, mitä apua tarvitset. Missä tahansa vaiheessa voit kysyä apua. Tekoäly ei tunne, häpeä tai ilku. Se ei myöskään ymmärrä turhautumistasi. Sille ei tarvitse sanoa: "ole hyvä" tai "kiitos". Suomalainen, faktuaalinen ja asiakeskeinen esitystapa puree parhaiten. Esimerkiksi: "yritin tehdä ohjeen X mukaisen toimenpiteen Y. Sain virheilmoituksen Z. Opasta läpi ongelmasta, vaihe vaiheelta. En tiedä tästä asiasta mitään."

1. Asenna Visual Studio Code

VS Code on ilmainen koodieditori. Siinä näet tiedostot, joita tekoäly kirjoittaa, ja siinä keskustelet tekoälyn kanssa. Keskustelu on samanlainen web- tai työpöytäsovelluksen kanssa, mutta tässä rakennetaan paikallinen ohjelmistokehitysympäristö.

  1. Mene osoitteeseen code.visualstudio.com ja lataa oman käyttöjärjestelmäsi versio.
  2. Asenna ohjelma oletusasetuksilla. Windowsissa jätä rasti kohtaan Add to PATH.
  3. Avaa VS Code. Ensimmäisen käynnistyksen esittelyikkunat voit sulkea.

2. Asenna Node.js

Muistipaikka on verkkosovellus, joka pyörii omalla koneellasi Node.js-ohjelman avulla. Ilman sitä sovellus ei käynnisty.

  1. Mene osoitteeseen nodejs.org ja lataa LTS-versio (pitkäaikaisesti tuettu versio).
  2. Asenna oletusasetuksilla. Windowsin asennuksen kohtaa Automatically install the necessary tools ei tarvitse valita.
  3. Sulje VS Code ja avaa se uudelleen, jotta se löytää juuri asennetun Node.js:n.

3. Asenna Claude Code VS Codeen

Claude Code on tekoälyavustaja, joka osaa luoda tiedostoja, ajaa komentoja ja korjata virheitä. Se asennetaan VS Codeen laajennuksena.

  1. Avaa VS Coden laajennukset: paina Ctrl + Shift + X (Macissa ⌘ + Shift + X).
  2. Kirjoita hakuun Claude Code.
  3. Valitse laajennus, jonka julkaisija on Anthropic, ja paina Install.

Tarkista julkaisija. Asenna vain Anthropicin julkaisema laajennus.

4. Kirjaudu Claudeen

  1. Napsauta VS Coden vasemmasta reunasta Claude Coden kuvaketta (oranssi tähtimäinen kuvake). Claude-paneeli avautuu.
  2. Paina Sign in. Selain avautuu.
  3. Kirjaudu Claude-tililläsi ja hyväksy yhteys. Palaa sitten VS Codeen.

Kirjautumisen jälkeen paneeliin voi ilmestyä Learn Claude Code -tarkistuslista. Voit käydä sen läpi tai sulkea sen rististä.

5. Tee sovellukselle kansio

Claude tallentaa kaikki sovelluksen tiedostot yhteen kansioon. Tee sille uusi, tyhjä kansio.

  1. Tee esimerkiksi Tiedostot-kansioon uusi kansio nimeltä muistipaikka.
  2. Valitse VS Codessa File → Open Folder… ja avaa juuri tekemäsi kansio.
  3. Jos VS Code kysyy Do you trust the authors of the files in this folder?, vastaa Yes, I trust the authors. Kansio on oma ja tyhjä.

6. Tallenna rakennusohje kansioon

Rakennusohje eli kehote kertoo tekoälylle tarkasti, millainen sovelluksesta tehdään: kaikki ominaisuudet, ulkoasu ja suomenkieliset termit. Se on englanniksi, koska tekoäly lukee sen. Sovelluksesta tulee silti suomenkielinen.

  1. Lataa kehote: PROMPT.md. Jos selain avaa tiedoston tekstinä, tallenna se nimellä PROMPT.md (Ctrl + S, Macissa ⌘ + S).
  2. Siirrä PROMPT.md vaiheessa 5 tekemääsi kansioon.
  3. Tarkista, että tiedosto näkyy VS Coden vasemmassa reunassa kansion sisällä.

Kehotteen uusin versio on myös GitHubissa: github.com/klyytine/notion-clone. Siellä Download raw file -painike lataa sen valmiina tiedostona.

7. Pyydä Claudea rakentamaan sovellus

Nyt tekoäly tekee varsinaisen työn. Kopioi alla oleva viesti Claude-paneelin tekstikenttään ja paina Enter.

Windows

Lue tiedosto PROMPT.md ja rakenna sen kuvaama Muistipaikka-sovellus tähän kansioon. Etene vaihe kerrallaan ja tarkista lopuksi, että sovellus käynnistyy ilman virheitä. Kun olet valmis, käynnistä sovellus ja kerro minulle, mistä osoitteesta avaan sen selaimessa.

Mac

Lue tiedosto PROMPT.md ja rakenna sen kuvaama Muistipaikka-sovellus tähän kansioon. Käytän Macia, joten jätä Windows-käynnistin (kohta 12) pois. Etene vaihe kerrallaan ja tarkista lopuksi, että sovellus käynnistyy ilman virheitä. Kun olet valmis, käynnistä sovellus ja kerro minulle, mistä osoitteesta avaan sen selaimessa.

Mitä seuraavaksi tapahtuu: Claude lukee ohjeen, suunnittelee työn ja alkaa luoda tiedostoja. Näet ne VS Coden vasemmassa reunassa sitä mukaa kuin niitä syntyy. Työ kestää tavallisesti kymmeniä minuutteja.

Haluatko nähdä suunnitelman ensin? Vaihda tekstikentän alareunasta tilaksi Plan ennen viestin lähettämistä. Claude kertoo ensin, mitä aikoo tehdä, ja aloittaa vasta, kun hyväksyt suunnitelman.

8. Avaa ja kokeile Muistipaikkaa

Kun Claude kertoo olevansa valmis, se on käynnistänyt sovelluksen. Avaa selaimessa osoite, jonka Claude antaa. Yleensä se on http://localhost:5173.

localhost tarkoittaa omaa konettasi. Sovellus ei ole internetissä, eikä kukaan muu näe sitä. Muistiinpanosi tallentuvat selaimeesi.

Kokeile näitä:

Kokeile Näin
Uusi sivu Paina sivupalkista + Uusi sivu ja kirjoita otsikko.
Komentovalikko Kirjoita tyhjälle riville / ja valitse esimerkiksi Tehtävälista.
Kuvake ja kansikuva Vie hiiri otsikon yläpuolelle ja valitse Lisää kuvake tai Lisää kansi.
Tiedosto-valikko Tallenna sivu tiedostoksi: Tiedosto → Tallenna nimellä.
Kieli Asetukset → Kieli vaihtaa suomen ja englannin välillä.
Tumma tila Paina Ctrl + Shift + L.

Kun haluat käyttää sovellusta myöhemmin

Sovellus pysyy käynnissä niin kauan kuin VS Code on auki. Myöhemmin saat sen auki näin:

Jos jokin menee pieleen

Paras keino on lähes aina sama: kopioi virheilmoitus Claudelle ja pyydä korjaamaan. Se osaa lukea virheet ja korjata koodin itse.

”npm” tai ”node” ei ole tunnettu komento. Node.js puuttuu, tai VS Code avattiin ennen sen asennusta. Asenna Node.js (vaihe 2) ja käynnistä VS Code uudelleen.

Selaimessa näkyy tyhjä sivu. Kirjoita Claudelle: Sovellus näyttää tyhjää sivua osoitteessa localhost:5173. Etsi ja korjaa vika.

”Port 5173 is already in use”. Sovellus on jo käynnissä toisessa ikkunassa, tai portti on toisen ohjelman käytössä. Sulje ylimääräiset VS Code -ikkunat tai pyydä Claudea käynnistämään sovellus toiseen porttiin.

Claude ilmoittaa käyttörajasta. Tilauksesi käyttöraja tuli täyteen. Odota ilmoitettu aika ja kirjoita jatka. Työ ei katoa.

Jokin ominaisuus puuttuu tai toimii eri tavalla. Tekoäly ei tee joka kerta täsmälleen samaa. Kerro Claudelle, mitä odotit, esimerkiksi: Asetuksista puuttuu kielen valinta. Lisää se PROMPT.md:n kohdan 13 mukaan.

Tee siitä omasi

Nyt sinulla on toimiva sovellus ja tekoälyavustaja, joka tuntee sen koodin. Kokeile pyytää muutoksia omin sanoin, esimerkiksi:

Pyydä yksi muutos kerrallaan ja kokeile sitä ennen seuraavaa. Jos muutos ei miellytä, pyydä Claudea perumaan se.

Lähteet

Asennusohjeet ja vaatimukset tarkistettu Claude Coden virallisesta ohjeesta 7.10.2026.