Oppaan sisällysluettelo

• Claude Coden asennus

  • Järjestelmävaatimukset

  • Asennusmenetelmät

  • Claude Coden asennusasetukset

    • API-avaimen konfigurointi

    • Vaihtoehtoinen tapa: Ympäristömuuttuja

  • Claude Max -tilaus

  • Mallin valinta ja konfigurointi

  • Alustakohtaiset asennusohjeet

    • Windows-asennus

    • VS Code -integrointi

  • Asennuksen varmistaminen

  • Vianetsintä ja ongelmat

  • Seuraavat askeleet

• Käytön aloitus eli näin pääset liikkeelle

  • Ensimmäinen käynnistys

  • Ensimmäiset komennot testattavaksi

  • CLAUDE.md -tiedoston luominen

  • Luonnollisen kielen komennot

    • Git-komennot

    • Tiedosto-operaatiot

    • Dokumentaation haku

  • Työnkulun perusteet

    • 1. Tiedostojen lukeminen ja muokkaus

    • 2. Koodin analysointi

    • 3. Testien kirjoittaminen

  • Interaktiivinen työskentely

    • Auto-accept -tila

    • Keskeyttäminen ja ohjaaminen

    • Suunnittelutila (plan mode)

  • Hyödyllisiä vinkkejä aloittamiseen

  • VS Code / Cursor -integraatio

  • Seuraavat askeleet

  • Yleisimmät ongelmat

• Clauden konfigurointi ja räätälöidyt asetukset

  • Konfiguraatiohierarkia

  • Käyttöoikeuksien hallinta

  • Ympäristömuuttujat

  • Ohitettavat tiedostot

  • MCP-palvelinten konfigurointi

  • Mukautetut slash-komennot

  • Monikansiokonfiguraatio

  • Suorituskyvyn optimointi

  • Debuggaus ja vianetsintä

  • Esimerkkikonfiguraatio

  • Turvallisuuskäytännöt

  • Konfiguraation siirtäminen toiseen projektiin

  • Vianetsintä

• Edistyneille käyttäjille: Mekaniikka

  • Perusteet

    • Sinä olet tärkeimmässä roolissa

    • Järkevyystarkistus

      • Automaattiset tarkistukset

      • Manuaalinen järkevyystarkistus

    • CLAUDE.md:n tärkeys

      • Noudattamishierarkia

      • Käyttäytymiserot

      • Strateginen käyttö

      • Modulaarinen CLAUDE.md-suunnittelu

    • Opi rajoitteista

      • Konteksti-ikkunan rajoitukset

      • Suorituskykyrajoitukset

      • API-rajoitukset

    • Dynaaminen muisti

      • Muistityypit

      • Muistin optimointi

      • Muistinhallintakomennot

    • Automaattinen lupien hyväksyntä

    • Vaarallinen ohittaminen

    • Kokeile aina

    • Poison.md

    • Hooks

  • Suorituskyky

    • Bash-skriptit

    • Task/Agent Tools

    • Kontekstin ehtyminen

    • Hybridi-työnkulut eri malleilla

      • Mallinvalinta-heuristiikka

      • Kustannusten optimointi

Claude Coden asennus

Tämä osio opastaa sinut asentamaan Claude Coden järjestelmääsi ja käyttämään sitä tehokkaasti muutamassa vaiheessa Opas kattaa latauksen, asennuksen, konfiguroinnin ja mallin valinnan Windows-, Mac- ja Linux-järjestelmille.

Järjestelmävaatimukset

Tuetut käyttöjärjestelmät

Claude Code toimii seuraavissa käyttöjärjestelmissä:

• macOS 10.15 (Catalina) tai uudempi

• Windows 10 tai uudempi

• Linux (Ubuntu 18.04+, CentOS 7+ tai vastaava)

Laitteistovaatimukset

• Muisti: 4 GB RAM vähintään (suositus: 16 GB)

• Tallennustila: 500 MB vapaata levytilaa

• Internet-yhteys: API-kommunikaatiota varten

Ennen Claude Coden asentamista varmista, että sinulla on:

• Node.js versio 18.0 tai uudempi

• Anthropic API-avain (hae osoitteesta console.anthropic.com) tai Claude Max -tilaus

• Pääte tai komentokehote

Asennusmenetelmät

Vaihtoehto 1: npm (Suositeltu)

Avaa pääte ja suorita seuraava komento:

npm install -g @anthropic-ai/claude-code

Vaihtoehto 2: Suora lataus

Lataa uusin binääritiedosto GitHubin releases-sivulta.

Claude Coden asennusasetukset

API-avaimen konfigurointi

Asennuksen jälkeen määritä Claude Code API-avaimellasi:

claude config

Suoritat kertaluonteisen OAuth-prosessin Claude Max- tai Anthropic Console -tililläsi verkkoselaimen kautta.

Vaihtoehtoinen tapa: Ympäristömuuttuja

Voit myös asettaa API-avaimesi ympäristömuuttujan avulla:

export ANTHROPIC_API_KEY="sinun-api-avaimesi-tähän"

Lisää tämä shell-profiiliisi (.bashrc, .zshrc jne.) tehdäksesi siitä pysyvän.

Claude Max -tilaus

Claude Max tarjoaa korkeammat käyttörajat kiinteällä kuukausimaksulla, mikä tekee siitä ihanteellisen kehittäjille, jotka käyttävät Claude Codea laajasti.

Harkitse Claude Maxia, jos aiot:

• Käyttää Claude Codea useita tunteja päivässä

• Työskennellä suurten koodikantojen kanssa

• Suorittaa säännöllisesti monimutkaisia useita tiedostoja koskevia operaatioita

Mallin valinta ja konfigurointi

Claude Code tukee useita LLM-malleja. Voit määrittää käytettävän mallin optimaalista suorituskykyä varten:

Claude 4 Sonnet: Uusin tasapainotettu malli

export ANTHROPIC_MODEL="claude-sonnet-4-20250514"

Claude 4 Opus: Maksimaalinen suorituskyky monimutkaisiin tehtäviin

export ANTHROPIC_MODEL="claude-opus-4-20250514"

Claude 3.5 Haiku: Nopein ja kustannustehokkain

export ANTHROPIC_MODEL="claude-3-5-haiku-20241022"

Vaihtoehtoinen mallin määritys

Voit myös määrittää mallin suoraan käynnistäessäsi Claude Codea:

claude --model claude-sonnet-4-20250514
claude --model claude-opus-4-20250514
claude --model claude-3-5-haiku-20241022

Alustakohtaiset asennusohjeet

Windows-asennus

Parhaan Claude Code -kokemuksen saamiseksi Windowsissa seuraa näitä optimointivaiheita:

WSL2:n asennus ja konfigurointi

1. Asenna WSL2 (jos ei vielä asennettu):

   wsl --install
   

2. Asenna Linux-jakelu (Ubuntu suositeltu):

   wsl --install -d Ubuntu
   

3. WSL2:n suorituskyvyn optimointi:

   Luo .wslconfig-tiedosto Windows-käyttäjäkansioon:

   # Windows: %USERPROFILE%\.wslconfig
   [wsl2]
   memory=8GB              # Rajoita WSL2:n muistinkäyttöä
   processors=4            # Rajoita CPU-ytimiä
   swap=2GB               # Aseta swap-koko
   localhostForwarding=true
   

4. Päivitä WSL2 uusimpaan versioon:

   wsl --update
   

Terminaalisuositus

Windows Terminal on erinomainen valinta Claude Code -kehitykseen. Voit ladata sen Microsoft Storesta tai GitHub-julkaisuista.

VS Code -integrointi

1. Asenna VS Code -laajennukset:

   • WSL-laajennus: ms-vscode-remote.remote-wsl

   • Remote Development Extension Pack: ms-vscode-remote.vscode-remote-extensionpack

2. Yhdistä VS Code WSL:ään:

   # WSL-terminaalista projektikansiossasi
   code .
   

3. Asenna Claude Code VS Code -laajennus:

   Etsi "Claude Code" VS Coden laajennuspaneelista tai asenna VS Code Marketplacesta.

4. Käynnistä VS Code uudelleen laajennuksen aktivoimiseksi.

5. Käytä Claude Codea VS Codessa:

   # VS Coden integroidussa terminaalissa (WSL)
   claude
   
   # Tai käytä /ide-komentoa mistä tahansa ulkoisesta terminaalista
   

6. VS Code -integraation ominaisuudet:

   • Avaa Claude Code suoraan: Cmd+Esc (Mac) tai Ctrl+Esc (Windows/Linux)

   • Tiedostoviittaukset: Cmd+Option+K (Mac) tai Alt+Ctrl+K (Windows/Linux)

   • Näe ehdotetut muutokset VS Coden diff-näkymässä

Asennuksen varmistaminen

Varmista Claude Code -asennuksesi suorittamalla:

claude --version

Sinun pitäisi nähdä Claude Coden nykyinen versio tulostettuna terminaaliin.

Vianetsintä ja ongelmat

Ongelma: "command not found" virheilmoitus

• Varmista, että Node.js on asennettu: node --version

• Tarkista npm:n globaali asennuspolku: npm config get prefix

• Lisää npm:n bin-kansio PATH-ympäristömuuttujaan

Ongelma: API-avain ei toimi

• Varmista, että avain on kopiotu oikein ilman välilyöntejä

• Tarkista, että sinulla on aktiivinen Anthropic-tili

• Kokeile avaimen asettamista ympäristömuuttujan kautta

Ongelma: WSL2 suorituskykyongelmat Windowsissa

• Varmista, että virtualisointi on käytössä BIOS:ssa

• Päivitä Windows ja WSL2 uusimpiin versioihin

• Säädä .wslconfig-asetuksia järjestelmäsi mukaan

Seuraavat askeleet

Kun Claude Code on asennettu ja konfiguroitu onnistuneesti, siirry Aloittaminen-osioon oppiaksesi:

• Claude Code -projektin perustaminen

• Peruskomentojen käyttö

• Työnkulun optimointi

• Ensimmäisen projektisi luominen

Käytön aloitus eli näin pääset liikkeelle

Claude Code on agenttipohjainen koodaustyökalu, joka toimii suoraan terminaalissasi, ymmärtää koodikantaasi ja auttaa sinua koodaamaan nopeammin luonnollisen kielen komentojen avulla. Tämä opas vie sinut läpi ensimmäiset askeleesi Claude Coden kanssa.

Claude Code eroaa perinteisistä koodausassistenteista merkittävästi:

• Terminaalipohjainen: Toimii suoraan komentorivillä, ei editori-integraation kautta

• Agenttimainen: Voi suorittaa tehtäviä itsenäisesti, ei vain ehdota koodia

• Projektin laajuinen ymmärrys: Ymmärtää koko koodipohjasi kontekstin

• Luonnollinen kieli: Kommunikoit sille tavallisella kielellä, ei komennoilla

Ensimmäinen käynnistys

1. Siirry projektikansioon tai luo sellainen

cd polku/projektikansioon

2. Käynnistä Claude Code

claude

Näet Claude Coden kehotteen, joka on valmis auttamaan kehitystehtävissäsi.

3. Vaihtoehtoinen nopea käyttö

Voit myös käyttää Claude Codea ilman interaktiivista tilaa:

claude -p "Näytä tämän kansion tiedostot"
claude -p "Millainen projekti tämä on?"

Ensimmäiset komennot testattavaksi

Projektin ymmärtäminen ja yhteenveto

Aloita tutustumalla projektiisi Claude Coden avulla:

> yhteenveto tästä projektista
> mikä on pääasiallinen teknologia tässä projektissa?
> näytä projektin rakenne

Claude analysoi projektiasi ja selittää, mitä se löytää. Tämä on hyödyllistä esim. jos aloitat valmiista avoimen lähdekoodin projektista.

Koodin tutkiminen

> selitä miten autentikointi toimii tässä projektissa
> etsi kaikki API-päätepisteet ja kuvaile mitä ne tekevät
> tunnista mahdolliset tietoturvaongelmat

Ensimmäinen muutos

Kokeile luoda yksinkertainen tiedosto:

> luo uusi README.md tiedosto, joka kuvaa tämän projektin

Claude Code:

1. Luo tiedoston

2. Näyttää mitä se kirjoitti

3. Vahvistaa luonnin

Tämä demonstroi Clauden kykyä ymmärtää luonnollista kieltä ja tehdä todellisia toimenpiteitä projektissasi.

CLAUDE.md -tiedoston luominen

Yksi tärkeimmistä asioista aloittaessa uuttta projektia on luoda ns. CLAUDE.md-tiedosto, joka toimii pysyvänä tietokantana projektistasi:

> luo CLAUDE.md tiedosto tälle projektille

Tai voit luoda sen manuaalisesti:

# CLAUDE.md

## Projektin yleiskatsaus
Lyhyt kuvaus projektistasi, sen tarkoituksesta ja pääteknologioista.

## Kehitysohjeet
- Koodausstandardit ja käytännöt
- Tiedostorakenteen preferenssit
- Testausperiaatteet

## Tärkeät komennot
- Build-komennot
- Testikomennot
- Kehityspalvelimen komennot

## Projektispesifiset huomiot
- Vanhassa käyttäjäautentikointijärjestelmässä on erityiskäsittelyä vaativia osia
- Tietokantamigraatiot pitää ajaa manuaalisesti tuotannossa
- Joillakin kolmannen osapuolen API:eilla on erilaiset avaimet sandboxissa vs tuotannossa

Claude Code lukee tämän tiedoston automaattisesti käynnistyessään ja käyttää sitä kontekstina eli joka ikinen kerta kun sanot mitä tahansa Claudelle, se käyttää mukana tätä antamaasi ohjetekstiä.

Luonnollisen kielen komennot

Claude Code ymmärtää luonnollisen kielen pyyntöjä, mikä tekee siitä helpomman kuin perinteiset kehitystyökalut:

Git-komennot

# Monimutkaisten git-komentojen sijaan:
"Luo commit kaikilla muutoksilla, jotka tein käyttäjäautentikointiin"

Tiedosto-operaatiot

# Manuaalisten tiedosto-operaatioiden sijaan:
"Päivitä kaikki komponentit käyttämään uutta teemajärjestelmää"

Dokumentaation haku

# Dokumentaation läpikäymisen sijaan:
"Miten teen tietokantamigraatiot tässä projektissa?"

Työnkulun perusteet

1. Tiedostojen lukeminen ja muokkaus

# Lue tiedosto
> näytä src/components/Button.js

# Muokkaa tiedostoa
> lisää PropTypes-validointi Button-komponenttiin

# Luo uusi tiedosto
> luo uusi React-komponentti nimeltä UserProfile

2. Koodin analysointi

> analysoi tämän funktion suorituskykyä
> etsi mahdolliset muistivuodot
> ehdota parannuksia tähän algoritmiin

3. Testien kirjoittaminen

> kirjoita yksikkötestit UserService-luokalle
> luo integraatiotesti API-päätepisteelle /api/users

Interaktiivinen työskentely

Auto-accept -tila

Voit aktivoida auto-accept-tilan painamalla Shift+Tab. Tässä tilassa Claude toimii autonomisesti ilman vahvistuspyyntöjä. Huomio: Käytä tätä harkiten!

Keskeyttäminen ja ohjaaminen

• Escape: Keskeytä Claude milloin tahansa (ajattelu, työkalujen käyttö, tiedostomuokkaukset)

• Kaksois-Escape: Hyppää takaisin historiassa ja muokkaa aiempaa kehotetta

Suunnittelutila (plan mode)

Voit aktivoida Plan moden tab-painikkeella. Itse suosittelen tämän suunnittelutilan käyttöä aina ennen muutoksia.

Pyydä Claudea tekemään suunnitelma ennen koodausta:

> suunnittele miten lisäisit käyttäjäprofiilitoiminnon tähän sovellukseen, mutta älä vielä koodaa mitään

Hyödyllisiä vinkkejä aloittamiseen

1. Ole spesifinen ja tarkka komennoissa

Hyvä:

"Tarkista UserAuth.js tietoturva-aukkojen varalta, keskittyen JWT-käsittelyyn"

Huono:

"tarkista koodini"

2. Käytä kontekstia laajasti

Claude muistaa aiemmat keskustelut istunnon aikana. Voit viitata aiempiin keskusteluihin:

> muistatko sen ongelman autentikoinnissa? Korjaa se nyt

3. Pyydä selityksiä toteutuksien jälkeen

Mikäli et ole koodaaja, tästä toiminnosta on erityisesti hyötyöä. Pyydä Claudea selittämään mitä se teki ja opit samalla kun koodaat!

> selitä mitä juuri teit
> miksi valitsit tämän lähestymistavan?
> mitä vaihtoehtoja harkitsit?

4. Iteroi ja paranna

Jos Claude tekee jotain, mistä et pidä:

1. Korjaa se kerran

2. Pyydä päivittämään CLAUDE.md-tiedosto

> päivitä CLAUDE.md muistamaan, että käytämme aina TypeScriptiä JavaScript:n sijaan

VS Code / Cursor -integraatio

Jos käytät VS Codea tai Cursoria:

1. Avaa integroitu terminaali

2. Navigoi projektiisi

3. Käynnistä Claude Code:

claude

Tai käytä /ide-komentoa mistä tahansa ulkoisesta terminaalista yhdistääksesi editoriin.

Seuraavat askeleet

Nyt kun olet oppinut perusteet, voit:

1. Tutustua projektiisi syvemmin

   > analysoi koko sovelluksen arkkitehtuuri
   > tunnista tekninen velka ja parannuskohteet
   

2. Aloittaa todellisen kehitystyön

   > auta minua toteuttamaan uusi ominaisuus: [kuvaus]
   > refaktoroi tämä legacy-koodi
   

3. Oppia edistyneempiä tekniikoita

   • MCP-palvelinten käyttö

   • Mukautetut slash-komennot

   • Automaattiset työnkulut

Yleisimmät ongelmat

"Claude ei ymmärrä projektiasi"

→ Luo tai päivitä CLAUDE.md-tiedosto projektikohtaisilla tiedoilla

"Muutokset eivät ole sitä mitä halusin"

→ Keskeytä Escapella ja anna tarkemmat ohjeet

"Konteksti täyttyy pitkissä istunnoissa"

→ Käytä /clear-komentoa tehtävien välillä tyhjentääksesi kontekstin

Clauden konfigurointi ja räätälöidyt asetukset

Claude Coden konfigurointi mahdollistaa työkalun mukauttamisen juuri sinun tarpeisiisi. Tämä opas kattaa kaikki konfigurointitasot, asetustiedostot ja parhaat käytännöt.

Tilaa AI-Sanomien Plus-jäsenyys niin näet loput sisällöstä