Keskeiset asiat
- Terminaalipohjainen, ei chatti-botti: Claude Code toimii suoraan paikallisilla tiedostoillasi, indeksoi koko projektisi rakenteen ja toimii käyttöoikeusjärjestelmän kautta, jossa hyväksyt jokaisen tiedostomuutoksen ja komennon suorituksen.
- Plan Mode monimutkaisiin tehtäviin: Käske Claudea suunnittelemaan lähestymistapansa ennen muutosten tekemistä -- se analysoi ongelman, hahmottelee vaiheet, näyttää päättelynsä ja odottaa hyväksyntääsi ennen suoritusta.
- Sonnet 80 %:iin, Opus 20 %:iin: Käytä Sonnet 4.6 -mallia arkipäiväisiin tehtäviin (nopea, kustannustehokas); vaihda Opus 4.6 -malliin monimutkaisissa usean tiedoston refaktoroinneissa, arkkitehtuuripäätöksissä tai Agent Teams -käytössä.
- CLAUDE.md parantaa johdonmukaisuutta: Luo projektikohtainen CLAUDE.md-tiedosto, joka sisältää koodauskäytännöt, teknologiavalinnat ja testausvaatimukset, jotka Claude lukee automaattisesti jokaisessa istunnossa.
Claude Code -opas aloittelijoille: Täydellinen aloitusopas
Claude Code on terminaalissasi toimiva AI-koodausavustaja.
Anthropicin rakentamana se yhdistyy suoraan koodikantaasi, ymmärtää projektisi rakenteen ja kirjoittaa oikeaa koodia koneellasi — kaikki luonnollisen kielen keskustelun kautta. Siitä lähtien, kun se tuli yleisesti saataville toukokuussa 2025, Claude Code on kasvanut yhdeksi laajimmin käytetyistä AI-kehitystyökaluista, ja se on auttanut Anthropicia saavuttamaan yli $1 billion dollarin vuotuisen liikevaihdon marraskuuhun 2025 mennessä.
Tämä opas vie sinut nollapisteestä tuottavuuteen. Aikaisempaa kokemusta AI-työkaluista ei vaadita.
Sisällysluettelo
- Mikä on Claude Code?
- Esivaatimukset ja asennus
- Ensimmäinen istuntosi
- Tärkeimpien komentojen viiteopas
- Plan Mode: Ajattele ennen koodaamista
- CLAUDE.md-tiedoston määrittäminen
- Esimerkkejä todellisista työprosesseista
- Valinta Sonnet 4.6:n ja Opus 4.6:n välillä
- Vinkkejä Claude Code -työkalun hyödyntämiseen
Mikä on Claude Code?
Claude Code on Anthropicin terminaalipohjainen AI-koodausavustaja. Toisin kuin selainpohjaiset chatti-botit tai IDE-laajennukset, se toimii suoraan terminaalissasi ja käsittelee paikallisia tiedostojasi.
Tässä on se, mikä tekee siitä erilaisen:
- Syvä tietoisuus koodikannasta — Claude indeksoi koko projektisi ja ymmärtää, miten tiedostot liittyvät toisiinsa
- Interaktiivinen päättely — se näyttää ajatusprosessinsa ja kysyy mielipidettäsi päätöksentekovaiheissa
- Paikallinen suoritus — muokkaa tiedostoja ja ajaa komentoja koneellasi, ei etäpalvelimella
- Käyttöoikeusjärjestelmä — jokainen tiedostomuutos ja komennon suoritus vaatii hyväksyntäsi
Claude Code hyödyntää Claude Opus 4.6- ja Claude Sonnet 4.6 -malleja, jotka ovat Anthropicin kyvykkäimmät mallit. Se tukee vakiona 200K context window -ikkunaa, ja Opus 4.6 -mallille on saatavilla 1M token beta.
"Claude Code ei ole chatti-botti. Se on koodausagentti, joka sattuu viestimään keskustelun välityksellä."
Esivaatimukset ja asennus
Mitä tarvitset
Ennen asennusta varmista, että sinulla on:
- Claude-tilaus — vähintään Claude Pro ($20/month)
- Terminaalisovellus — Terminal.app (macOS), haluamasi Linux-terminaali tai Windows Terminal
- Tuettu käyttöjärjestelmä — macOS, Linux tai Windows 11
- Node.js — vaaditaan npm-asennustapaa varten
Vaihe 1: Asenna Claude Code
Avaa terminaali ja aja:
npm install -g @anthropic-ai/claude-code
Vaihtoehtoisesti voit asentaa virallisen skriptin kautta:
curl -fsSL https://claude.ai/install.sh | sh
Vaihe 2: Varmista asennus
claude --version
Sinun pitäisi nähdä nykyinen versionumero. Jos saat "command not found" -virheen, varmista, että Node.js bin-hakemisto on mukana PATH-ympäristömuuttujassasi.
Vaihe 3: Siirry projektiisi
Claude Code toimii parhaiten, kun se käynnistetään projektin juuresta:
cd ~/projects/my-app
claude
Siinä kaikki. Claude skannaa projektisi ja olet valmis aloittamaan.
Ensimmäinen istuntosi
Kun käynnistät claude-komennon ensimmäistä kertaa projektin sisällä, tapahtuu seuraavaa:
- Claude indeksoi projektitiedostosi ja rakenteen
- Se avaa interaktiivisen kehotteen, johon kirjoitat luonnollista kieltä
- Kysyt kysymyksiä tai annat ohjeita, ja Claude vastaa koodilla, muokkauksilla tai selityksillä
Yksinkertainen ensimmäinen vuorovaikutus
Kokeile aloittaa esimerkiksi näin:
> What does this project do? Summarize the tech stack and folder structure.
Claude skannaa tiedostosi ja antaa sinulle jäsennellyn erittelyn projektistasi — frameworkit, aloituspisteet ja keskeiset moduulit.
Jatka tämän jälkeen varsinaisella tehtävällä:
> Add input validation to the signup form. Email should be validated and password needs at least 8 characters.
Claude tulee:
- Etsimään asianmukaisen lomakekomponentin
- Näyttämään suunnitelmansa muutoksista
- Pyytämään lupaa ennen tiedostojen muokkaamista
- Tekemään muokkaukset ja vahvistamaan, mitä on muutettu
Pysyt koko ajan kontrollissa. Mitään ei tapahdu ilman hyväksyntääsi.
Tärkeimpien komentojen viiteopas
Nämä ovat komentoja, joita käytät useimmiten Claude Code -istunnon aikana:
| Komento | Mitä se tekee |
|---|---|
claude | Aloita uusi Claude Code -istunto |
/help | Näytä kaikki käytettävissä olevat komennot |
/plan | Siirry Plan Mode -tilaan — Claude suunnittelee ennen suoritusta |
/clear | Tyhjennä keskustelukonteksti ja aloita alusta |
/cost | Näytä istunnon token-kulutus ja arvioidut kustannukset |
/compact | Pakkaa keskustelu säästääksesi tilaa context window -ikkunassa |
Sinun ei tarvitse opetella ulkoa slash-komentoja ollaksesi tuottava. Suurimman osan ajasta kirjoitat pyyntösi luonnollisella kielellä ja Claude hoitaa loput.
Plan Mode: Ajattele ennen koodaamista
Plan Mode on yksi Claude Code:n tärkeimmistä ominaisuuksista, erityisesti aloittelijoille.
Kun siirryt Plan Mode -tilaan komennolla /plan, Claude muuttaa toimintatapaansa:
- Se analysoi ongelman — lukee asiaankuuluvat tiedostot, seuraa riippuvuuksia ja tunnistaa vaikutusalueet
- Se hahmottelee vaiheittaisen suunnitelman — mitä se muuttaa, missä järjestyksessä ja miksi
- Se näyttää päättelynsä — näet, miten Claude ajattelee ongelman läpi
- Se odottaa hyväksyntääsi — mitään ei suoriteta ennen kuin annat luvan
Milloin käyttää Plan Mode -tilaa
- Monimutkainen refaktorointi — moduulin nimeäminen uudelleen, kun se on importattu kymmeniin tiedostoihin
- Usean tiedoston ominaisuudet — uuden API endpointin lisääminen, joka koskettaa reittejä, kontrollereita, malleja ja testejä
- Vieraat koodikannat — kun haluat ymmärtää vaikutukset ennen muutosten tekemistä
- Oppiminen — Clauden päättelyn lukeminen auttaa sinua ymmärtämään omaa koodikantaasi paremmin
Esimerkki: Plan Mode käytössä
> /plan
> Refactor the authentication module to use JWT tokens instead of session cookies.
Claude vastaa suunnilleen näin:
Tässä on suunnitelmani:
- Päivitä
auth/middleware.jsvarmistamaan JWT tokens sen sijaan, että tarkistettaisiin istuntovarasto- Muokkaa
auth/login.jsluomaan ja palauttamaan JWT onnistuneen kirjautumisen yhteydessä- Päivitä
auth/logout.jskäsittelemään tokenin mitätöinti- Säädä API-asiakas tiedostossa
frontend/src/api.jslähettämään tokens Authorization-headerissa- Päivitä 3 testitiedostoa käyttämään JWT-pohjaisia testiasetuksia
Jatketaanko?
Sinä tarkistat, kysyt kysymyksiä, säädät suunnitelmaa tarvittaessa ja hyväksyt sen.
CLAUDE.md-tiedoston määrittäminen
CLAUDE.md on erikoistiedosto, jonka Claude lukee automaattisesti jokaisen istunnon alussa. Ajattele sitä konfiguraatiotiedostona sille, miten Clauden tulisi toimia projektissasi.
Luo CLAUDE.md
Sijoita se projektisi juureen:
# Project: My SaaS App
## Tech Stack
- Next.js 14 with App Router
- TypeScript (strict mode)
- Tailwind CSS
- PostgreSQL with Prisma ORM
## Coding Conventions
- Use functional components with hooks (no class components)
- All functions must have TypeScript return types
- Use named exports, not default exports
- Write tests for all new utility functions
## Testing
- Run tests with: npm run test
- Use Vitest for unit tests
- Test files go in __tests__ directories next to source files
## Git
- Conventional commits: feat(), fix(), refactor()
- Always create a new branch for features
Miksi CLAUDE.md on tärkeä
Ilman CLAUDE.md-tiedostoa Claude tekee järkeviä arvauksia käytännöistäsi. Sen avulla Claude noudattaa tarkkoja standardejasi heti ensimmäisestä kehotteesta lähtien. Tämä on erityisen arvokasta tiimeissä, joissa johdonmukaisuus on tärkeää.
Esimerkkejä todellisista työprosesseista
Tuotanto-ongelman debuggaus
> Users are reporting that the dashboard takes 15 seconds to load.
> Check the API calls on the dashboard page and identify any performance bottlenecks.
Claude käy läpi dashboard-komponentin, etsii API-kutsut, tarkistaa mahdolliset N+1-kyselyt tai puuttuvat indeksit ja ehdottaa tarkkoja korjauksia.
Uuden ominaisuuden lisääminen
> Add a dark mode toggle to the app. It should persist the user's preference
> in localStorage and apply on page load without a flash of unstyled content.
Claude tunnistaa, mihin toggle-komponentti lisätään, määrittää teemakontekstin, lisää localStorage-logiikan ja käsittelee ensimmäisen renderöinnin oikein.
Perinteisen koodin refaktorointi
> /plan
> This file uses callback-based async patterns. Refactor it to use async/await
> while keeping the same external API.
Claude suunnittelee refaktoroinnin, näyttää mitkä funktiot muuttuvat ja varmistaa, ettei mikään rikkoudu ulkoisesti ennen jatkamista.
Git-integraatio
Claude Code toimii suoraan Gitin kanssa. Voit pyytää sitä:
> Create a new branch called feat/dark-mode, commit the changes we just made,
> and open a pull request with a description of what was changed.
Claude luo branchin, lisää tiedostot stage-alueelle, kirjoittaa commit-viestin ja käyttää GitHub CLI:tä PR:n avaamiseen — kaikki terminaali-istuntosi sisällä.
Valinta Sonnet 4.6:n ja Opus 4.6:n välillä
Claude Code antaa sinulle pääsyn kahteen malliin. Oikean valitseminen säästää aikaa ja rahaa.
| Sonnet 4.6 | Opus 4.6 | |
|---|---|---|
| Nopeus | Nopea | Hitaampi |
| Kustannus (API) | $3 / $15 per 1M tokens | $15 / $75 per 1M tokens |
| Sopii parhaiten | Useimpiin arkipäivän koodaustehtäviin | Monimutkaiseen arkkitehtuuriin, usean tiedoston refaktorointiin |
| Context window | 200K tokens | 200K vakio, 1M beta |
| Agent Teams | Ei saatavilla | Saatavilla (vain Opus) |
80/20-sääntö
Käytä Sonnet 4.6 -mallia noin 80 %:iin työstäsi: funktioiden kirjoittamiseen, bugien korjaamiseen, ominaisuuksien lisäämiseen, testien kirjoittamiseen ja koodin selittämiseen. Se on nopea, edullinen ja enemmän kuin riittävä.
Vaihda Opus 4.6 -malliin vaikeimmissa 20 %:ssa: laajan mittakaavan refaktoroinneissa useiden tiedostojen välillä, monimutkaisissa arkkitehtuuripäätöksissä, Agent Teams -käytössä rinnakkaiseen työskentelyyn tai kun tarvitset 1M token context window -ikkunaa laajan koodikannan analysointiin.
Vinkkejä Claude Code -työkalun hyödyntämiseen
1. Aloita jokainen projekti kontekstilla. Ennen kuin hyppäät tehtäviin, pyydä Claudea tiivistämään, mitä projekti tekee. Tämä auttaa Claudea rakentamaan tarkan mentaalisen mallin ja tuottamaan parempaa koodia heti ensimmäisestä kehotteesta alkaen.
> What does this project do? Walk me through the architecture.
2. Käytä Plan Mode -tilaa kaikkeen monimutkaiseen.
Jos tehtävä koskettaa useampaa kuin kahta tiedostoa, käytä /plan. Suunnittelun alkuvaiheen panostus säästää sinut virheellisiltä muutoksilta, joita on vaikeampi perua.
3. Ole tarkka pyynnöissäsi.
Sen sijaan, että sanoisit "tee koodista parempi", kokeile: "refaktoroi processPayment-funktio käsittelemään epäonnistuneet Stripe-veloitukset ja yrittämään uudelleen enintään 3 kertaa eksponentiaalisella viiveellä."
4. Käytä /compact-komentoa, kun context-rajat tulevat vastaan.
Pitkät istunnot kerryttävät kontekstia. Kun Claude alkaa menettää otettaan aiemmista keskusteluista, aja /compact tiivistääksesi historian ja vapauttaaksesi tilaa.
5. Luo ja ylläpidä CLAUDE.md-tiedostoa.
Tämä on tehokkain yksittäinen asia, jonka voit tehdä. Hyvä CLAUDE.md poistaa toistuvat korjaukset ja pitää Clauden linjassa tiimisi standardien kanssa.
6. Tarkista diffs ennen hyväksymistä. Clauden käyttöoikeusjärjestelmä on olemassa syystä. Lue ehdotetut muutokset, erityisesti vieraissa koodikannoissa. Claude on tehokas, mutta ei erehtymätön.
7. Käytä Git-integraatiota selkeisiin työprosesseihin. Anna Clauden hoitaa Gitin mekaaniset osat — branchien luominen, committien tekeminen, PR-kuvausten kirjoittaminen — jotta voit keskittyä varsinaisten koodimuutosten tarkistamiseen.
8. Ketjuta tehtäviä yhdessä istunnossa. Claude muistaa kontekstin istunnon sisällä. Ominaisuuden rakentamisen jälkeen jatka heti: "kirjoita nyt testit juuri lisäämällemme asialle" — Claude tuntee jo koodin.
Mitä seuraavaksi?
Sinulla on nyt kaikki tarvittava aloittaaksesi Claude Code -työkalun tuottavan käytön. Oppimiskäyrä on lyhyt: useimmat kehittäjät löytävät rytminsä jo ensimmäisten istuntojen aikana.
Kun tunnet olosi mukavaksi, tutustu näihin edistyneempiin ominaisuuksiin:
- Agent Teams — käynnistä useita Claude-instansseja rinnakkaiseen työhön suurissa projekteissa (vain Opus 4.6)
- 1M token context window — analysoi valtavia koodikantoja yhdessä istunnossa (Opus 4.6 beta)
- Mukautetut slash-komennot — automatisoi toistuvia työvaiheita projektikohtaisilla komennoilla
- CI/CD-integraatio — aja Claude Code osana build- ja review-putkeasi
