Päivitetty 20.7.2026. Alkuperäisen oppaan Node.js 18 -vaatimus, npm-painotus ja vanhat malliviittaukset on korvattu Anthropicin nykyisillä ohjeilla.

Claude Code oli aluksi ennen kaikkea terminaalissa toimiva koodausagentti. Vuonna 2026 sama moottori toimii myös Claude Desktopissa, selaimessa, VS Codessa, JetBrains-ympäristöissä, mobiilin kautta ja CI/CD-työnkuluissa.

Nimi voi silti johtaa harhaan. Claude Code ei ainoastaan täydennä koodirivejä. Se lukee projektia, etsii tiedostoja, suunnittelee muutoksia, muokkaa useita tiedostoja, ajaa testejä ja käyttää luvallasi ulkoisia työkaluja.

Se tekee työkalusta tehokkaan. Samasta syystä ensimmäinen käyttökerta kannattaa tehdä hallitusti.

Mikä Claude Code on?

Claude Code on agenttinen työympäristö, joka yhdistää Claude-mallin projektisi tiedostoihin ja työkaluihin.

Tavallinen chat näkee sen, minkä kopioit keskusteluun. Claude Code voi luvallasi tutkia koko työkansion ja toimia siellä. Se pystyy esimerkiksi:

  • selittämään vieraan projektin rakenteen

  • etsimään virheen useasta tiedostosta

  • toteuttamaan ominaisuuden ja kirjoittamaan testit

  • päivittämään dokumentaation

  • tarkistamaan muutokset Gitistä

  • käyttämään komentorivin työkaluja

  • yhdistämään ulkoisiin palveluihin MCP:n kautta

  • tekemään ei-teknistä tiedostotyötä, jos tehtävä perustuu paikallisiin aineistoihin

Claude Code ei poista ihmisen vastuuta. Se tekee ehdotuksia ja toimenpiteitä siinä laajuudessa, jonka sille annat.

Missä Claude Codea voi käyttää?

Käyttötapa

Sopii parhaiten

Huomio

CLI eli terminaali

täydet ominaisuudet, skriptit, palvelimet

vaatii perustason komentoriviosaamista

Claude Desktop

visuaalinen katselmointi ja rinnakkaiset tehtävät

hyvä aloitus, jos terminaali tuntuu vieraalta

VS Code

työ suoraan editorissa

näyttää muutokset koodin yhteydessä

JetBrains

IntelliJ, PyCharm, WebStorm ja muut

sopii olemassa olevaan JetBrains-työhön

Selain

pitkät pilvitehtävät

tehtävä jatkuu Anthropicin ympäristössä yhteyden katketessa

Mobiili ja etäohjaus

tehtävän käynnistys ja seuranta liikkeellä

soveltuu paremmin ohjaamiseen kuin tarkkaan muokkaukseen

CI/CD

automaattinen katselmointi ja ylläpito

vaatii rajatut oikeudet ja hyvän testauksen

Aloittelijalle Desktop tai editorilaajennus on usein helpoin. Terminaali tarjoaa edelleen laajimman hallinnan.

Mitä Claude Code maksaa?

Claude Code sisältyy kaikkiin maksullisiin Claude-paketteihin. Ilmainen Claude-paketti ei sisällä Claude Codea.

Anthropicin 20.7.2026 hinnoittelusivulla:

  • Pro maksaa 20 Yhdysvaltain dollaria kuukaudessa kuukausilaskutuksella

  • vuosilaskutuksen keskimääräinen Pro-hinta on 17 dollaria kuukaudessa, 200 dollaria etukäteen

  • Max alkaa 100 dollarista kuukaudessa

  • Team- ja Enterprise-paketeissa hinnoittelu ja hallinta määräytyvät organisaatiotason mukaan

Hintoihin voi tulla veroja, ja paketit voivat muuttua. Tarkista aina Claude-hinnoittelusivu ennen ostopäätöstä.

Tilauksen käyttöraja on yhteinen Clauden verkko-, työpöytä-, mobiili- ja Code-käytölle. Jos käytät Claude Codea API-avaimella, käyttö laskutetaan erikseen tokenien perusteella. Tarkista siis kirjautumistapa ennen pitkää työrupeamaa.

Claude Coden asennus vuonna 2026

Anthropic suosittelee natiiviasennusta. Node.js:ää ei tarvita tätä asennustapaa varten.

macOS, Linux ja WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Homebrew macOS:lle

brew install --cask claude-code

WinGet Windowsille

winget install Anthropic.ClaudeCode

Windowsissa Claude Code toimii natiivisti tai WSL 2:ssa. WSL 2 sopii erityisesti Linux-työkaluihin ja hiekkalaatikointiin. Natiivissa Windowsissa Git for Windows on hyödyllinen, jos haluat käyttää Bash-työkaluja.

Tarkista asennus:

claude --version
claude doctor

claude doctor tarkistaa asennuksen ja asetusten kunnon muuttamatta projektia.

Siirry sitten projektikansioon ja käynnistä Claude Code:

cd /polku/projektiin
claude

Ensimmäisellä kerralla selain avautuu kirjautumista varten. Voit käyttää Pro-, Max-, Team-, Enterprise- tai Console-tiliä sekä tuettuja pilvipalveluntarjoajia.

Ensimmäinen turvallinen käyttökerta

Älä aloita komennolla "paranna koko projekti". Aloita niin pienestä, että pystyt itse arvioimaan lopputuloksen.

1. Varmista palautusmahdollisuus

Jos kyseessä on koodiprojekti, käytä Gitiä ja varmista, että nykyinen tila on tallessa. Tee erillinen työhaara, jos projekti on tärkeä.

Älä aloita tuotantopalvelimen ainoasta kopiosta tai kansiosta, jossa on korvaamattomia tiedostoja ilman varmuuskopiota.

2. Pyydä ensin selitys

Tutki tämä projekti muuttamatta mitään. Kerro, mitä se tekee, missä tärkeimmät tiedostot ovat, miten testit ajetaan ja mitä riskejä muutoksiin liittyy. Merkitse epävarmat havainnot erikseen.

Tämä kertoo samalla, ymmärtääkö Claude projektin oikein.

3. Käytä Plan-tilaa isossa tehtävässä

Plan-tilassa Claude voi tutkia ja suunnitella, mutta ei muokkaa lähdetiedostoja. Tila sopii tehtävään, jonka laajuutta et vielä tunne.

Pyydä suunnitelmaan:

  • muutettavat tiedostot

  • tavoiteltu käyttäytyminen

  • testit

  • riskit

  • palautustapa

4. Anna yksi rajattu tehtävä

Hyvä ensimmäinen tehtävä voi olla:

  • korjaa yksi tunnettu virhe

  • lisää yksi pieni validointi

  • kirjoita testit yhdelle funktiolle

  • päivitä vanhentunut README-kohta

  • selitä yksi epäselvä moduuli

5. Tarkista muutos ja aja testit

Pyydä Claudea näyttämään, mitä se muutti ja miksi. Aja projektin omat testit ja tarkista Git-diffi ennen hyväksymistä.

6. Tee vasta sitten seuraava muutos

Pienet, tarkistetut vaiheet tuottavat yleensä paremman tuloksen kuin yksi valtava tehtävä. Samalla huomaat aikaisin, jos Claude tulkitsi tavoitteen väärin.

CLAUDE.md antaa pysyvät projektiohjeet

CLAUDE.md on tavallinen Markdown-tiedosto, johon tallennetaan ohjeet, jotka Clauden pitää tietää projektista joka kerta.

Hyvä aloitusversio voi olla näin lyhyt:

# Projektiohjeet

## Tavoite
Tämä palvelu käsittelee asiakkaiden ajanvarauksia.

## Työtapa
- Käytä olemassa olevia kirjastoja ja rakenteita.
- Kirjoita testi ennen käyttäytymistä muuttavaa korjausta.
- Älä muuta tietokantarakennetta ilman erillistä hyväksyntää.
- Älä lisää riippuvuuksia ilman perustelua.

## Tarkistukset
- Aja testit komennolla: npm test
- Aja tarkistukset komennolla: npm run lint

## Turvallisuus
- Älä tulosta tai tallenna salaisuuksia.
- Älä koske tuotantoympäristöön.

Kirjoita tiedostoon projektin todelliset komennot. Väärä pysyvä ohje on pahempi kuin puuttuva ohje.

Claude Coden ohjaustiedostojen rakennetta käsittelee tarkemmin AI-Sanomien .claude-kansio-opas. Jos haluat opetella toistettavia työnkulkuja, jatka Claude Skills -oppaaseen.

Toimiva kuusivaiheinen työnkulku

1. Tavoite

Kerro, mitä käyttäjän pitäisi voida tehdä muutoksen jälkeen. Vältä epämääräistä "siivoa koodi" -tehtävää.

2. Tutkimus

Pyydä Claudea löytämään projektin nykyinen toteutustapa ja kolme lähintä esimerkkiä. Tämä vähentää turhia uusia rakenteita.

3. Suunnitelma

Sovi tiedostot, rajaukset ja testit ennen muokkausta.

4. Toteutus

Anna tehdä pienin muutos, joka täyttää tavoitteen.

5. Varmennus

Aja testit, tarkistukset ja tarvittaessa sovellus. Pyydä Claudelta myös lyhyt itsearvio siitä, mitä jäi epävarmaksi.

6. Katselmointi

Lue diffi itse. Erityisesti tietoturvaa, maksuja, henkilötietoja, käyttöoikeuksia ja tuotantoa koskevat muutokset tarvitsevat ihmisen tarkistuksen.

Sama ajattelu toimii myös ei-teknisessä työssä. Claude Code voi esimerkiksi muokata paikallisia Markdown-tiedostoja, analysoida taulukoita tai ylläpitää dokumentaatiota, kun aineisto ja hyväksymisrajat ovat selvät.

Oikeudet: pidä voimakkaat asetukset viimeisenä vaihtoehtona

Claude Code erottaa lukemisen, tiedostojen muokkauksen ja komentojen ajamisen.

Tila

Käyttö

Manual tai default

pyytää luvan työkalujen ensimmäiseen käyttöön

acceptEdits

hyväksyy tiedostomuokkauksia tavallista vapaammin

plan

tutkii ja suunnittelee ilman lähdetiedostojen muokkausta

auto

käyttää taustalla turvallisuustarkistuksia, saatavuus vaihtelee

dontAsk

hylkää työkalut, joita ei ole ennalta sallittu

bypassPermissions

ohittaa lähes kaikki tavalliset lupakysymykset

bypassPermissions ei ole aloittelijan mukavuusasetus. Anthropicin dokumentaatio suosittelee sitä vain eristettyihin ympäristöihin, kuten kertakäyttöiseen konttiin tai virtuaalikoneeseen.

Tavalliseen työhön parempi malli on vähimmän oikeuden periaate:

  • anna lukuoikeus ennen kirjoitusoikeutta

  • salli vain tarvittavat komennot

  • rajaa työ projektikansioon

  • älä anna tuotantotunnuksia paikalliseen kokeiluun

  • pidä salaisuudet ympäristömuuttujissa tai salaisuuksien hallinnassa

  • tarkista kolmannen osapuolen MCP-palvelimet ja lisäosat ennen asennusta

Mallin valinta ilman nopeasti vanhenevia mallinimiä

Claude Codessa mallin voi valita /model-komennolla. Anthropicin päivittyvät aliakset ovat käytännöllisiä:

  • sonnet sopii useimpiin päivittäisiin koodaustehtäviin

  • opus sopii vaikeaan suunnitteluun, laajoihin korjauksiin ja hankaliin virheisiin

  • haiku sopii nopeisiin ja yksinkertaisiin tehtäviin

  • opusplan käyttää Opusta suunnitteluun ja Sonnetia toteutukseen

Aliakset voivat siirtyä uuteen malliversioon automaattisesti. Organisaatio, joka tarvitsee toistettavuutta ja hallittuja muutoksia, voi pinnata tarkan malliversion ylläpitäjän asetuksissa.

Käytännössä tärkeämpää kuin jatkuva mallin vaihtaminen on hyvä tehtävänanto, oikea konteksti ja toimivat testit.

Skills ja MCP laajentavat Claude Codea

Skills

Skill on uudelleenkäytettävä ohjepaketti. Se sopii esimerkiksi julkaisun tarkistuslistaan, tietoturvakatselmointiin tai yrityksen omaan toimitusprosessiin.

Aloita Skillistä vasta, kun sama työohje toistuu. Yhden projektin pysyvät perussäännöt kuuluvat yleensä CLAUDE.md-tiedostoon.

Käytännön esimerkkejä löydät oppaasta 10 valmista Claude Code -taitoa luovalle toimistolle.

MCP

Model Context Protocol yhdistää Claude Coden ulkoisiin työkaluihin ja tietolähteisiin. MCP-palvelin voi tuoda agentille esimerkiksi projektinhallinnan, tietokannan tai yrityksen oman API:n.

MCP-yhteydet voivat olla:

  • paikallisia, vain yhdessä projektissa toimivia

  • projektitasoisia ja tiimin kanssa jaettavia

  • käyttäjätasoisia, kaikissa omissa projekteissa toimivia

Projektitasoinen .mcp.json voidaan tallentaa versionhallintaan. Älä tallenna siihen salaisuuksia. Claude Code pyytää hyväksynnän projektin MCP-palvelimille, koska tiedosto voi tulla ulkopuolisesta repositoriosta.

Yrityskäyttöä varten lue MCP-palvelimen implementointiopas yrityksille.

Kolme kopioitavaa aloituskehotetta

1. Tutki projekti muuttamatta mitään

Tutki tämä projekti muuttamatta mitään.

Kerro:
1. mitä projekti tekee
2. mitkä ovat tärkeimmät kansiot ja tiedostot
3. miten sovellus käynnistetään ja testit ajetaan
4. mitä käytäntöjä nykyinen koodi noudattaa
5. mitkä kolme riskiä minun pitää ymmärtää ennen ensimmäistä muutosta

Perustele havainnot tiedostoviitteillä. Merkitse oletukset ja puuttuvat tiedot erikseen.

2. Tee toteutussuunnitelma ennen muokkausta

Haluan toteuttaa seuraavan muutoksen: [kuvaa käyttäjän tavoite].

Älä muokkaa vielä tiedostoja. Etsi nykyinen toteutustapa ja lähimmät esimerkit projektista. Tee suunnitelma, jossa ovat muutettavat tiedostot, tavoiteltu käyttäytyminen, testit, riskit ja palautustapa. Ehdota pienintä toimivaa muutosta. Kysy vain sellaiset kysymykset, joiden vastaus muuttaa toteutusta olennaisesti.

3. Katselmoi valmis muutos

Katselmoi nykyinen Git-diffi muuttamatta tiedostoja.

Tarkista käyttäytymisvirheet, puuttuvat testit, tietoturva, tietosuoja, virheenkäsittely ja poikkeamat projektin nykyisistä käytännöistä. Jaa havainnot vakavuuden mukaan. Kerro jokaisesta tarkka tiedosto ja kohta, miksi asia on ongelma ja pienin turvallinen korjaus. Jos et löydä ongelmaa, sano se suoraan ja kerro, mitä et pystynyt varmistamaan.

Yleisimmät ongelmat

claude: command not found

Sulje ja avaa terminaali uudelleen. Tarkista sitten claude --version. Natiiviasennus lisää käynnistimen tavallisesti käyttäjän paikalliseen bin-kansioon.

Kirjautuminen käyttää väärää tiliä

Jos ympäristössä on ANTHROPIC_API_KEY, Claude Code voi käyttää API-laskutusta tilauspaketin sijaan. Tarkista kirjautumistapa /status-komennolla ja vaihda tiliä /login-komennolla.

Käyttöraja loppuu nopeasti

Pitkät keskustelut, suuret projektit, vaativampi malli ja korkea päättelytaso kuluttavat enemmän käyttökiintiötä. Pidä tehtävä rajattuna, tyhjennä tarpeeton konteksti ja käytä Sonnetia tavalliseen toteutukseen.

Claude yrittää muuttaa liikaa

Palaa Plan-tilaan. Rajaa tehtävä yhteen käyttäytymiseen, nimeä tiedostot joita saa muuttaa ja pyydä ensin pienin toimiva toteutus.

Claude Code vai Codex?

Molemmat ovat agenttisia työympäristöjä. Valinta riippuu käyttötavasta, käytettävistä malleista, ympäristöstä, integraatioista ja organisaation hallintatarpeista.

Claude Code on vahva valinta, jos käytät jo Claudea, arvostat CLAUDE.md- ja Skills-ekosysteemiä tai haluat saman moottorin terminaaliin, Desktopiin ja IDEen. OpenAI Codex taas sopii luontevasti OpenAI-ympäristöön ja sen agenttisiin työnkulkuihin.

Tutustu vertailun toiselle puolelle oppaassa OpenAI Codex tietotyöläiselle.

Tiivistelmä

Claude Coden turvallinen aloitus mahtuu seitsemään sääntöön:

  1. Asenna natiivisti tai virallisella paketinhallinnalla.

  2. Tarkista asennus claude doctor -komennolla.

  3. Anna Clauden tutkia projekti ennen muokkausta.

  4. Käytä Plan-tilaa epäselvässä tai suuressa tehtävässä.

  5. Tee pienet muutokset Gitin suojassa.

  6. Aja testit ja lue diffi itse.

  7. Lisää Skills- ja MCP-yhteydet vasta todelliseen tarpeeseen.

Claude Code ei korvaa kehittäjän tai vastuuhenkilön harkintaa. Se tekee hyvän työprosessin nopeammaksi ja huonon työprosessin nopeammin näkyväksi.

Viralliset lähteet

Lisää tekoälyoppaita ja -uutisia: aisanomat.fi

Keep Reading