Keskeiset asiat
- Kaksi asennustapaa: Käytä natiivia asennusohjelmaa (
curl -fsSL https://claude.ai/install.sh | bash) nollariippuvuus-asennukseen, tai npm-pakettia (npm install -g @anthropic-ai/claude-code), jos tarvitset version lukitsemista. - Järjestelmävaatimukset ovat minimaaliset: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+) tai Windows 10+ varustettuna WSL-ominaisuudella. Vähintään 4GB RAM. GPU-yksikköä ei tarvita.
- Tili vaaditaan: Tarvitset Claude Pro, Max, Teams, Enterprise tai Console (API) -tilin. Ilmainen Claude.ai-tilaus ei sisällä Claude Code -pääsyä.
- Käyttöönotto vie alle viisi minuuttia: Asenna, todenna selaimessasi ja aloita Claude Code -sovelluksen käyttö missä tahansa projektihakemistossa välittömästi.
Kuinka asentaa Claude Code: Täydellinen asennusopas (2026)
Claude Code on Anthropic-yhtiön tekoälypohjainen koodausavustaja, joka toimii suoraan terminaalissasi. Se lukee koodikantaasi, kirjoittaa koodia, ajaa komentoja ja hallitsee monimutkaisia usean tiedoston muokkauksia – kaikki yhdestä CLI-käyttöliittymästä.
Toisin kuin selainpohjaiset AI-chat-työkalut, Claude Code toimii varsinaisen kehitysympäristösi sisällä. Se näkee tiedostorakenteesi, ymmärtää projektisi kontekstin ja tekee muutoksia koneellasi oleviin oikeisiin tiedostoihin.
Tämä opas opastaa sinut läpi jokaisen Claude Code -asennusvaiheen vuonna 2026, esivaatimusten tarkistamisesta ensimmäisen tekoälyavusteisen koodausistunnon suorittamiseen. Käytitpä sitten macOS-, Linux- tai Windows-käyttöjärjestelmää, saat Claude Code -sovelluksen käyntiin alle viidessä minuutissa.
Mitä tarvitset (Esivaatimusten tarkistuslista)
Ennen kuin asennat Claude Code -sovelluksen, varmista, että sinulla on seuraavat:
- Käyttöjärjestelmä: macOS 13.0 (Ventura) tai uudempi, Ubuntu 20.04+ tai Debian 10+, tai Windows 10 (versio 1809+) varustettuna WSL-ominaisuudella
- RAM: Vähintään 4GB (8GB suositellaan laajemmille koodikannoille)
- Internet-yhteys: Claude Code ottaa yhteyden Anthropic-yhtiön pilvi-API-rajapintaan, joten aktiivinen yhteys vaaditaan
- Anthropic-tili: Claude Pro ($20/kuukausi), Claude Max ($100-200/kuukausi), Teams, Enterprise tai Console (API) -tili
- Terminaali: Bash, Zsh tai PowerShell
- Node.js 18+ (vaaditaan vain npm-asennustapaa käytettäessä)
Et tarvitse GPU-yksikköä. Kaikki AI-prosessointi tapahtuu Anthropic-yhtiön palvelimilla. Koneesi tarvitsee vain ajaa CLI-asiakasohjelmaa ja lähettää pyyntöjä verkon yli.
Vaihe 1: Asenna Node.js (jos sinulla ei vielä ole sitä)
Jos aiot käyttää npm-asennustapaa, tarvitset Node.js-version 18 tai uudemman. Jos sinulla on jo Node.js asennettuna, tarkista versiosi:
node --version
Jos tuloste näyttää v18.0.0 tai uudemman, siirry vaiheeseen 2. Jos ei, asenna tai päivitä Node.js käyttämällä nvm-ohjelmaa (Node Version Manager), mikä on suositeltu tapa, koska se välttää käyttöoikeusongelmat ja mahdollistaa helpon vaihtamisen eri Node-versioiden välillä.
Asenna nvm macOS- tai Linux-käyttöjärjestelmään:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Sulje ja avaa terminaalisi uudelleen, ja asenna sitten Node.js:
nvm install 22
nvm use 22
node --version
Sinun pitäisi nähdä versionumero, joka alkaa v22. Node.js 22 on nykyinen LTS-julkaisu ja toimii täydellisesti Claude Code -sovelluksen kanssa.
Asenna Node.js Windows-käyttöjärjestelmään (WSL-ympäristössä):
Varmista ensin, että WSL on asennettu (katso Windows-osio alta). Avaa sitten WSL-terminaalisi ja aja samat nvm-komennot kuin yllä.
Vaihe 2: Asenna Claude Code
Sinulla on kaksi vaihtoehtoa Claude Code -sovelluksen asentamiseen. Natiivi-asennusohjelma on nykyään suositeltu menetelmä, mutta npm on edelleen täysin tuettu.
Vaihtoehto A: Natiivi-asennusohjelma (Suositeltu)
Natiivi-asennusohjelma ei vaadi lainkaan riippuvuuksia – ei Node.js-ohjelmistoa, ei npm-paketteja. Se päivittyy automaattisesti taustalla ja on ensisijainen menetelmä, jota Anthropic testaa ja tukee.
macOS ja Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, järjestelmänvalvojana):
irm https://claude.ai/install.ps1 | iex
Asennusohjelma lataa Claude Code -binäärin, asettaa sen PATH-ympäristömuuttujaan ja määrittää automaattiset päivitykset. Koko prosessi vie alle minuutin.
Vaihtoehto B: npm-asennus
Jos käytät mieluummin npm-pakettien hallintaa – esimerkiksi lukitaksesi tietyn version tai koska npm kuuluu vakiotyönkulkuusi – aja:
npm install -g @anthropic-ai/claude-code
Tärkeää: Älä käytä sudo-komentoa npm-asennuksen kanssa. Jos saat käyttöoikeusvirheitä, oikea korjaustapa on käyttää nvm-ohjelmaa (joka asentaa Node.js-version kotihakemistoosi) sen sijaan, että ajaisit npm-komentoja pääkäyttäjänä.
Vahvista asennus
Riippumatta valitsemastasi menetelmästä, varmista, että Claude Code on asennettu:
claude --version
Sinun pitäisi nähdä versionumero. Voit myös ajaa sisäänrakennetun diagnostiikan:
claude doctor
Tämä komento tarkistaa ympäristösi ja raportoi mahdollisista konfiguraatio-ongelmista.
Vaihe 3: Tunnistautuminen
Claude Code vaatii tunnistautumisen ennen käyttöä. Aja:
claude
Kun ajat tämän komennon ensimmäisen kerran, Claude Code avaa oletusselaimesi ja pyytää sinua kirjautumaan Anthropic-tilillesi. Seuraa kehotteita valtuuttaaksesi CLI-käyttöliittymän.
Tunnistautumisvaihtoehdot
Selainpohjainen kirjautuminen (oletus): Paras vaihtoehto henkilökohtaisille koneille. Claude Code avaa selainikkunan, kirjaudut sisään ja CLI vastaanottaa todennustunnisteen (tokens) automaattisesti. Tämä toimii Claude Pro, Max, Teams ja Enterprise -tileillä.
API-avain (CI/CD- ja automaatiokäyttöön): Jos ajat Claude Code -sovellusta headless-ympäristössä tai CI/CD-putkessa, aseta API-avaimesi ympäristömuuttujaksi:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
Voit luoda API-avaimen Anthropic Console -palvelussa. API-käyttö laskutetaan per tokens Anthropic-yhtiön julkaistujen hintojen mukaisesti.
Tilaus vs. API-laskutus: Pro- tai Max-tilauksella Claude Code -käyttösi sisältyy kuukausisuunnitelmaasi (käyttörajoitusten puitteissa). Console-palvelusta saadulla API-avaimella maksat per tokens. Valitse käyttömääriesi perusteella – tilaukset ovat yksinkertaisempia säännölliseen käyttöön, kun taas API-laskutus antaa enemmän kontrollia vaihteleviin tai automatisoituihin työkuormiin.
Vaihe 4: Ensimmäinen projektisi
Nyt kun Claude Code on asennettu ja todennettu, kokeile sitä oikeassa projektissa.
Siirry mihin tahansa projektihakemistoon:
cd ~/my-project
Käynnistä Claude Code:
claude
Olet nyt interaktiivisessa istunnossa. Claude Code on lukenut projektisi rakenteen ja on valmis auttamaan. Kokeile antaa sille tehtävä:
> Selitä tämän projektin arkkitehtuuri
Claude Code skannaa tiedostosi, tunnistaa teknologiapinon (tech stack) ja antaa yhteenvedon projektin organisoinnista.
Kokeile jotain käytännöllisempää:
> Lisää syötteen vahvistus käyttäjän rekisteröitymislomakkeeseen
Claude Code tunnistaa asiaankuuluvat tiedostot, ehdottaa muutoksia ja pyytää vahvistustasi ennen minkään muokkaamista. Tarkistat jokaisen muutoksen diff-näkymässä ja hyväksyt tai hylkäät ne.
Kertaluonteisia tehtäviä varten ilman interaktiivista tilaa voit käyttää -p-lippua:
claude -p "Kirjoita yksikkötestit auth-moduulille"
Tämä suorittaa tehtävän, tulostaa lopputuloksen ja lopettaa – hyödyllinen skriptaukseen ja nopeisiin kysymyksiin.
Vaihe 5: Keskeiset asetukset
Claude Code toimii heti järkevillä oletusasetuksilla, mutta voit mukauttaa sen toimintaa työnkulkuusi sopivaksi.
Mallin valinta
Claude Code käyttää uusinta Claude-mallia oletuksena. Määrittääksesi eri mallin:
claude config set model claude-opus-4-6
Tai yksittäistä istuntoa varten:
claude --model claude-sonnet-4-20250514
Käyttöoikeudet
Claude Code pyytää vahvistusta ennen mahdollisesti tuhoisia toimintoja, kuten tiedostojen kirjoittamista tai shell-komentojen ajamista. Voit muokata tätä toimintatapaa:
claude config set permissions.auto-accept-edits true
Projektitason asetukset
Luo .claude/settings.json -tiedosto projektisi juureen määritelläksesi tiimin kesken jaetut asetukset:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
Tämä tiedosto tulisi tallentaa versionhallintaan, jotta koko tiimisi jakaa saman Claude Code -toimintatavan.
Henkilökohtaisia ylikirjoituksia varten, joita ei tule tallentaa versionhallintaan, käytä tiedostoa .claude/settings.local.json.
MCP-palvelimen määritykset
Claude Code tukee Model Context Protocol (MCP) -palvelimia ominaisuuksiensa laajentamiseen. Määritä ne .mcp.json -tiedostossa projektisi juuressa:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Asentaminen eri ympäristöihin
macOS
Natiivi-asennusohjelma on yksinkertaisin tapa macOS-käyttöjärjestelmässä. Sekä Apple Silicon (M1/M2/M3/M4) että Intel-koneet ovat tuettuja:
curl -fsSL https://claude.ai/install.sh | bash
Vaihtoehtoisesti Claude Code on saatavilla Homebrew-palvelun kautta:
brew install --cask claude-code
Linux
Toimii Ubuntu 20.04+, Debian 10+ ja useimmissa nykyaikaisissa jakeluissa:
curl -fsSL https://claude.ai/install.sh | bash
Jos käytät vanhempaa jakelua, käytä npm-menetelmää nvm-ohjelman kanssa välttääksesi järjestelmätason riippuvuusongelmat.
Windows (WSL)
Claude Code Windows-käyttöjärjestelmässä vaatii joko WSL-ympäristön tai Git for Windows -sovelluksen. WSL on suositeltu tapa:
- Avaa PowerShell järjestelmänvalvojana ja asenna WSL:
wsl --install
-
Käynnistä tietokoneesi uudelleen pyydettäessä.
-
Avaa WSL-terminaali (oletuksena Ubuntu) ja asenna Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Vaihtoehtoisesti voit käyttää natiivia Windows-asennusohjelmaa suoraan PowerShellissä:
irm https://claude.ai/install.ps1 | iex
Docker
Kontitetuissa ympäristöissä lisää Claude Code Dockerfile-tiedostoosi:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
CI/CD-putkissa välitä API-avain ajon aikana sen sijaan, että kovakoodaisit sen image-tiedostoon:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Aja testisarja ja korjaa mahdolliset virheet"
CI/CD-putket
Claude Code -sovelluksen headless-tila (-p-lippu) on suunniteltu automaatiota varten. Tässä on GitHub Actions -esimerkki:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Arvioi tämän PR:n muutokset ja ehdota parannuksia" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Lippu --output-format json palauttaa jäsenneltyä tulostetta, jota jatkovaiheet voivat analysoida.
Claude Code -sovelluksen päivittäminen
Natiivi-asennusohjelma
Jos asensit Claude Code -sovelluksen natiivilla asennusohjelmalla, päivitykset tapahtuvat automaattisesti taustalla. Toimenpiteitä ei tarvita. Voit määrittää päivityskanavan:
claude config set update-channel stable
Tarkistaaksesi nykyisen versiosi:
claude --version
npm
Jos asensit sovelluksen npm-palvelun kautta, päivitä manuaalisesti:
npm update -g @anthropic-ai/claude-code
Tai asenna tietty versio:
npm install -g @anthropic-ai/claude-code@latest
IDE-integraatio
Vaikka Claude Code on ensisijaisesti terminaalityökalu, se integroituu suoraan suosittuihin IDE-ympäristöihin tarjotakseen visuaalisemman kokemuksen.
VS Code -laajennus
VS Code -laajennus tarjoaa natiivin graafisen käyttöliittymän Claude Code -sovellukselle editorisi sisällä. Se sisältää chat-paneelin, tarkistuspisteisiin perustuvan kumoamisen, tiedostoviittaukset @-maininnoilla sekä mahdollisuuden ajaa useita keskusteluja rinnakkaisissa välilehdissä.
Asentaaksesi, avaa VS Code ja etsi "Claude Code" Extensions-paneelista tai aja:
code --install-extension anthropic.claude-code
Kun asennus on valmis, voit avata Claude Code -paneelin sivupalkista ja olla vuorovaikutuksessa sen kanssa aivan kuten terminaaliversiossa, mutta lisäetuna näet tiedostojen diff-muutokset VS Code -editorin natiivissa näkymässä.
JetBrains-liitännäinen
IntelliJ IDEA, PyCharm, WebStorm, GoLand ja muita JetBrains-ympäristöjä varten voit asentaa Claude Code -liitännäisen JetBrains Marketplace -palvelusta:
- Avaa JetBrains IDE -ympäristösi
- Mene kohtaan Settings sitten Plugins ja sieltä Marketplace
- Etsi "Claude Code"
- Klikkaa Install ja käynnistä IDE uudelleen
JetBrains-liitännäinen ajaa Claude Code CLI -sovellusta IDE-ympäristösi integroidussa terminaalissa ja avaa ehdotetut muutokset IDE:n diff-näkymässä. Se on tällä hetkellä beta-vaiheessa, mutta täysin toimiva päivittäiseen käyttöön.
Vianmääritys
"command not found: claude"
Claude Code -binääri ei ole PATH-ympäristömuuttujassasi. Jos käytit natiivia asennusohjelmaa, kokeile avata uusi terminaali-ikkuna. Jos se ei auta, aja asennusskripti uudelleen. npm-asennuksissa varmista, että globaali npm bin -hakemistosi on PATH-muuttujassa:
npm config get prefix
Lisää kyseisen polun bin-alihakemisto shellisi PATH-muuttujaan.
"Node.js version too old"
Claude Code vaatii vähintään Node.js 18+. Tarkista versiosi komennolla node --version. Jos se on alle 18, asenna uudempi versio nvm-ohjelmalla:
nvm install 22
nvm use 22
npm-käyttöoikeusvirheet (EACCES)
Älä koskaan käytä sudo npm install -g. Korjaa sen sijaan npm-oletushakemisto tai käytä nvm-ohjelmaa, joka asentaa kaiken kotihakemistoosi ja välttää käyttöoikeusristiriidat kokonaan:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Tunnistautuminen epäonnistuu tai selain ei aukea
Jos selainpohjainen kirjautuminen ei toimi (yleistä etäpalvelimilla tai WSL-ympäristössä), voit tunnistautua sen sijaan API-avaimella:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Luo API-avaimesi osoitteessa console.anthropic.com.
"Network Error" tai aikakatkaisu asennuksen aikana
Verkkosi tai palomuurisi saattaa estää npm-palvelun tai natiivin asennusohjelman. Kokeile:
npm config set registry https://registry.npmjs.org/
Jos olet yrityksen välityspalvelimen takana, määritä npm käyttämään sitä:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
Claude Code toimii hitaasti
Claude Code itsessään on kevyt – hitaus tarkoittaa yleensä verkkoviivettä Anthropic-yhtiön API-rajapintaan. Tarkista internet-yhteytesi. Jos käytät VPN-yhteyttä, kokeile sen katkaisemista. Voit myös tarkistaa API-tilan osoitteessa status.anthropic.com.
Seuraavat vaiheet
Claude Code on asennettu, todennettu ja toiminnassa. Tästä voit jatkaa eteenpäin:
- Opi työnkulku: Lue Claude Code -opetusohjelmamme syventyäksesi kehotestrategioihin, usean tiedoston muokkaamiseen ja tekoälyavusteisen kehityksen hyödyntämiseen.
- Vertaile vaihtoehtojasi: Katso kuinka Claude Code pärjää Claude Code vs Cursor -vertailussamme, jos pohdit eri AI-koodaustyökalujen välillä.
- Tutustu lisäominaisuuksiin: Claude Code tukee MCP-palvelimia, mukautettuja hook-toimintoja, headless-automaatiota ja usean mallin konfiguraatioita. Virallinen dokumentaatio kattaa nämä syvällisesti.
Claude Code on nopein tapa tuoda AI nykyiseen kehitystyönkulkuusi vaihtamatta työkaluja tai poistumatta terminaalista. Nyt kun se on asennettu, aloita pienellä tehtävällä oikeassa projektissa – huomaat eron välittömästi.
