Claude Coden asentaminen viralliselta verkkosivustolta

Mikä Claude Code on ja miksi sitä käytetään päätteessä?#

Pääte pelottaa lähes kaikkia, jotka ryhtyvät vibe-koodaukseen ilman ohjelmistokehitystaustaa. Se näyttää hakkerielokuvien mustalta ikkunalta, mutta todellisuudessa se on vain rivi, johon kirjoitat komentoja. Claude Code tarvitsee päätettä juuri siksi, että se voi avata tiedostosi, muuttaa niitä ja suorittaa tarkistuksia itse, kun kuvailet tehtävää sanoin.

Anthropic kuvailee tuotetta näin.

Ero tuttuihin chat-palveluihin on yksinkertainen. Selaimessa kopioit koodia käsin edestakaisin ikkunan ja editorin välillä. Claude Code siirtyy itse projektikansioon, lukee tarvitsemansa tiedostot, tekee muutoksen ja näyttää, mitä se muutti. Sinä päätät ja hyväksyt; se hoitaa mekaanisen työn puolestasi.

Jos et todellakaan halua käyttää päätettä, Anthropicilla on tavallisella ikkunalla varustettu työpöytäsovellus sekä selainversio osoitteessa claude.ai/code. Tehokkain ja joustavin vaihtoehto on kuitenkin pääteversio, jota tämä koko artikkeli käsittelee.

Missä on Claude Coden virallinen verkkosivusto ja mitä kannattaa ladata?#

Aloittelijoita hämmentää ensimmäiseksi se, missä virallinen Claude Code -verkkosivusto on ja mitä pitää napsauttaa, jotta sen voi ladata. Tässä on taulukko kaikista Anthropicin virallisista osoitteista, joten sinun ei tarvitse arvailla.

Asennusohjelmaa ei ladata verkkosivustolta tavallisen ohjelman tapaan, mikä on vastoin ihmisten odotuksia. Sen sijaan asennat ohjelman päätekomennolla, joka lataa järjestelmällesi sopivan version. Tässä artikkelissa ovat tarkat komennot Macille, Windowsille ja Linuxille.

Yksi tavallinen kompastuskivi on nimi: moni kirjoittaa sen väärin, esimerkiksi clode code, clade code, слод код tai clode design. Tuotteen nimi on Claude Code, ja siinä on au. Muista tämä etsiessäsi virallista verkkosivustoa: samankaltaisesti kirjoitetut verkkotunnukset kuuluvat jollekin muulle.

On hyvä tietää myös npm-paketin tarkka nimi. Kanoninen paketti on @anthropic-ai/claude-code, ja sen etuliite on @anthropic-ai/. Anthropicilla itsellään on lyhyempi nimi claude-code ilman etuliitettä – se on heidän virallinen viittauksensa samaan pakettiin. Yksinkertainen sääntö: julkaisijan tulee olla Anthropic ja asennukseen käytettävässä nimessä tulee olla etuliite.

Mitä asennukseen tarvitaan: tietokoneen vaatimukset#

Claude Coden vaatimukset ovat kohtuulliset: Anthropicin palvelimet tekevät raskaan työn; tietokoneesi lähettää vain pyyntöjä ja vastaanottaa vastauksia.

Erillinen huomio Node.js:stä, sillä siihen liittyy eniten myyttejä. Natiivi asennusohjelma – jota Anthropic itse suosittelee – ei tarvitse Node.js:ää lainkaan: se asentuu yhtenä itsenäisenä tiedostona. Node.js tarvitaan vain, jos asennat Claude Coden npm:n kautta, ja silloin tarvitaan versio 22 tai uudempi. Vanhemmissa artikkeleissa sanotaan ”Node 18 ja uudempi” – se on vanhentunutta tietoa; käytä ohjenuorana versiota 22+.

Pääversiota varten tarvitset päätteen. Jos et halua käyttää sitä, asenna tavallisella ikkunalla varustettu työpöytäsovellus tai käytä selainversiota osoitteessa claude.ai/code. Pääteversiossa on silti enemmän ominaisuuksia, joten artikkelin loppuosa kertoo, miten se asennetaan.

Claude Coden asentaminen on kuin saisi työkalun käteensä. Yksinään se kuitenkin usein hallusinoi: unohtaa projektisi, keksii asioita ja kadottaa punaisen langan tehtävän puolivälissä. Kolmen asian yhdistelmä tekee siitä luotettavan: AI-klooni, Second Brain ja kontekstisuunnittelu. Nämä ovat kolme peruspilaria, jotka estävät tekoälyä hallusinoimasta.

Miten Claude Code asennetaan macOS:ään?#

Avaa Terminal (se löytyy jokaisesta Macista: paina Cmd+Space Spotlightissa ja kirjoita ”Terminal”) ja liitä tämä yksi rivi:

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

Komento lataa asennusohjelman Anthropicin virallisesta osoitteesta ja asentaa Claude Coden. Node.js:ää ei tarvita. Natiivi menetelmä on kätevä myös päivitysten ansiosta.

Jos käytät jo Homebrew'ta, on toinenkin vaihtoehto:

brew install --cask claude-code

Menetelmät eroavat päivitysten osalta: natiivi asennusohjelma päivittyy itsestään, Homebrew ei – sinun on päivitettävä se manuaalisesti komennolla brew upgrade claude-code. Itse ohjelma on sama, joten valitse menetelmä, johon olet tottunut. Jos et ole varma, valitse ensimmäinen.

Miten Claude Code asennetaan Windowsiin?#

Selvitä ensin, missä olet. Windowsissa on kaksi komentotulkkia, joista kummallakin on oma komentonsa. Avaa ikkuna ja katso kehotteen alkua: PS C:\> tarkoittaa PowerShelliä, kun taas pelkkä C:\> ilman PS:ää tarkoittaa Komentokehotetta (CMD).

PowerShellissä (helpoin tapa avata se on napsauttaa Käynnistä-painiketta hiiren oikealla painikkeella ja valita ”Terminal”):

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

Komentokehotteessa (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Kolmas vaihtoehto on käyttää Windowsin omaa WinGet-pakettienhallintaa:

winget install Anthropic.ClaudeCode

Jos sinulla on jo toimiva ympäristö WSL:ssä (Linux Windowsin sisällä), asenna Claude Code suoraan WSL:ään samalla komennolla kuin Linuxissa. WSL:ssä on Nodeen liittyvä erityispiirre, jota käsittelen jäljempänä yleisten virheiden osiossa.

Miten Claude Code asennetaan Linuxiin?#

Kaikissa suosituissa jakeluissa perusmenetelmä on sama: käytä samaa itsenäistä asennusohjelmaa.

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

Node.js:ää ei tarvita; ohjelma toimitetaan yhtenä tiedostona, ja sen jälkeen se päivittyy itsestään.

Jos olet tottunut asentamaan ohjelmia vain järjestelmän paketinhallinnan kautta, voit lisätä Anthropicin viralliset repositoriot: apt Debianille ja Ubuntulle, dnf Fedoralle ja RHEL:lle sekä apk Alpinelle. Ne allekirjoitetaan avaimella, ja niissä on stable- ja latest-kanavat. Tämä on aloittelijalle liioittelua, joten jätän yksityiskohdat lähteet-osiossa mainittuun dokumentaatioon ja suosittelen oletuksena yllä olevaa komentoa.

Edullisilla palvelimilla voi ilmetä yksi ongelma. Jos koneessa on hyvin vähän vapaata muistia, asennus voi pysähtyä sanaan Killed (koodi 137) – järjestelmä lopetti prosessin, koska muisti loppui. Ratkaisu on lisätä swap-tiedosto: Claude Code tarvitsee asennukseen noin 512 MB vapaata muistia.

Miten Claude Code käynnistetään ensimmäistä kertaa?#

Ensimmäinen käynnistys kestää pari minuuttia. Näin se etenee.

1. Siirry projektikansioon

   Siirry päätteessä kansioon, jossa haluat työskennellä, komennolla cd path-to-project ja kirjoita sitten claude.

2. Kirjaudu tilillesi

   Selain avautuu ja näyttää kirjautumisikkunan. Jos se ei avaudu automaattisesti, kopioi linkki painamalla c ja liitä se selaimeen käsin. Jos selain näyttää koodin (näin voi käydä WSL:ssä ja etäpalvelimilla), liitä koodi takaisin päätteeseen.

3. Odota vahvistusta

   Kun olet kirjautunut sisään, päätteessä näkyy Login successful, ja sinua pyydetään painamaan Enteriä.

4. Esitä ensimmäinen kysymyksesi

   Kysy jotain yksinkertaista projektista, esimerkiksi ”mitä tämä projekti tekee?” Claude lukee tiedostot ja vastaa.

5. Hyväksy ensimmäinen muutos

   Kun pyydät sitä muuttamaan jotain, Claude näyttää ehdotetut muutokset ja pyytää vahvistusta. Voit vaihtaa käyttöoikeustilaa näppäinyhdistelmällä Shift+Tab.

Kannattaa opetella muutama peruskomento istunnon aikana heti aluksi: /help luettelee komennot, /clear tyhjentää keskusteluhistorian ja /exit lopettaa istunnon (sama onnistuu painamalla Ctrl+D kahdesti). Claude näyttää nämä itsekin, jos kirjoitat /help.

Kirjaudu sisään tilauksella tai API-avaimella: kumman valitset?#

Tämä on ensimmäinen kysymys, joka herää sisäänkirjautumisen yhteydessä.

Sisäänkirjautumiseen on kaksi tapaa, ja ne eroavat toisistaan maksamisen suhteen.

Kirjaudu tilauksella sisään käyttämällä Claude.ai-tiliäsi. Jos haluat kirjautua sisään API-avaimella, hanki avain Claude Consolesta (platform.claude.com); maksut vähennetään ennakkoon maksetusta saldostasi käytön aikana. Aseta avain ympäristömuuttujaan ANTHROPIC_API_KEY, niin Claude Code ei avaa selainta joka kerta.

Voit vaihtaa tiliä istunnon aikana komennolla /login ja kirjautua ulos komennolla /logout.

Claude Code ei kuitenkaan käynnisty ilman maksullista käyttöoikeutta. Jos sinulla ei vielä ole tiliä, selvitä ensin, mitä sähköpostiosoitetta sinun kannattaa käyttää rekisteröitymiseen: et voi vaihtaa sitä myöhemmin.

Miten tarkistat, että asennus onnistui?#

Aluksi kannattaa tuntea kolme komentoa.

Ensimmäinen tarkistaa version:

claude --version

Toimiva asennus vastaa muodossa X.Y.Z (Claude Code). Tarkat numerot vaihtuvat versiosta toiseen; olennaista on, että komento palauttaa ylipäätään versionumeron. Vastaus ”command not found” tarkoittaa jotakin muuta – käsittelen sitä seuraavassa osiossa.

Toinen on diagnostiikkaa varten, jos jokin menee pieleen.

Kolmas on /status istunnon sisällä: se näyttää, miten kirjauduit sisään, mikä sähköpostiosoite tai organisaatio on yhdistetty ja onko käyttöoikeutesi vanhentunut. Komento claude update asentaa uusimman päivityksen heti sen sijaan, että odottaisit taustapäivitystä.

Miksi claude-komentoa ei löydy asennuksen jälkeen?#

Tämä on aloittelijoiden yleisin valituksen aihe, ja se kuulostaa pahemmalta kuin on. Pääte ei etsi komentoja koko tietokoneelta, vaan tarkistaa vain PATH-muuttujassa olevat kansiot. Claude Code sijoittuu polkuun ~/.local/bin/claude (Macilla ja Linuxissa) tai %USERPROFILE%\\.local\\bin\\claude.exe (Windowsissa). Jos kyseistä kansiota ei ole PATH-muuttujassa, pääte ei yksinkertaisesti löydä ohjelmaa.

Macilla ja Linuxissa lisää kansio luetteloon. Avaa komentotulkkisi asetustiedosto (~/.zshrc Zshille, ~/.bashrc Bashille) ja lisää tämä rivi loppuun:

export PATH="$HOME/.local/bin:$PATH"

Sulje pääte ja avaa se uudelleen (tai suorita source ~/.zshrc). Sen jälkeen claude löytyy.

Tavallisia asennuksen ja ensimmäisen käynnistyksen virheitä#

Käydään ne läpi järjestyksessä; kaikki ovat Anthropicin virallisesta vianmääritysoppaasta.

1. Vanha Node npm-asennuksessa. Paketti @anthropic-ai/claude-code vaatii Node.js-version 22 tai uudemman. Windowsissa npm voi epäonnistua ja ilmoittaa, että komentosarjat on poistettu käytöstä – PowerShellin käytäntö estää niiden suorittamisen. WSL:ssä yleinen virhe on exec: node: not found: WSL käyttää Windowsin Nodea Linuxin Noden sijaan. Jos npm aiheuttaa ongelmia, vaihda natiiviin asennusohjelmaan; se ei tarvitse Nodea.
2. Komentotulkille väärä asennusohjelma. 'irm' is not recognized tarkoittaa, että liitit PowerShell-komennon Komentokehotteeseen. The token '&&' is not a valid statement separator tarkoittaa päinvastaista: suoritit CMD-komennon PowerShellissä. A parameter cannot be found that matches parameter name 'fsSL' tarkoittaa, että suoritit Mac/Linux-komennon PowerShellissä. Tarkista kehotteen alku: PS C:\ on PowerShell ja C:\ on CMD.
3. Vanha API-avain ohittaa tilauksen. Jos tilauksesi on voimassa mutta ympäristöön on yhä asetettu vanha avain, näet virheen API Error: 400 ... This organization has been disabled. Avain ohittaa tilauksella kirjautumisen. Poista se komennolla unset ANTHROPIC_API_KEY (PowerShellissä käytä komentoa Remove-Item Env:ANTHROPIC_API_KEY), tarkista tiedostot ~/.zshrc ja ~/.bashrc ja kirjoita sitten /status.
4. Heikolla palvelimella ei ole tarpeeksi muistia. Asennus pysähtyy sanaan Killed ja koodiin 137 – RAM-muistia ei ole tarpeeksi. Tarvitset noin 512 MB vapaata muistia; swap-tilan lisääminen ratkaisee ongelman.
5. Asennusohjelma palautti jotakin muuta. Virhe syntax error near unexpected token '<' tai viittaus merkkijonoon <!DOCTYPE html> tarkoittaa, että asennusosoite palautti verkkosivun asennuskomentosarjan sijaan – yleensä alueesi, yrityksen palomuurin tai tilapäisen käyttökatkon takia. Kokeile toista menetelmää (Homebrew, WinGet) tai yritä uudelleen muutaman minuutin kuluttua.

Kaikkien näiden virheiden kohdalla ensimmäinen vaihe on sama: suorita claude doctor. Se näyttää, mikä on vialla, ja ehdottaa, mistä kannattaa etsiä.

Diagnostiikkaan liittyy yksi erityispiirre: pelkkä 403 asennuksen aikana voi johtua myös yrityksen palomuurista tai välityspalvelimesta. Jos olet siis toimistoverkossa, tarkista ensin, estääkö se yhteyden.

Mitä tehdä asennuksen jälkeen: ensimmäiset vaiheet#

Asennus on vasta alkua. Varsinainen työ alkaa sen jälkeen, ja ensimmäisenä tulee vastaan muisti. Kielimalli ei muista sinua keskustelujen välillä: uudessa chatissa se tietää vain sen, mitä olet lisännyt sen kontekstiin.

Ensimmäinen käytännön vaihe asennuksen jälkeen on siis luoda CLAUDE.md-tiedosto projektin juurikansioon. Se on tekstitiedosto, jossa on projektin sääntöjä ja kontekstia, jotka Claude Code lukee aina käynnistyessään. Kerro kerran, mitä teet, miten projekti on järjestetty ja mikä on tärkeää – eikä sinun tarvitse toistaa niitä jokaisessa keskustelussa.

Käyn tiedoston kokoamisen ja Clauden mukauttamisen läpi erillisessä oppaassa: näin mukautat Clauden. Olen koonnut myös yleiskatsauksen vibe-koodauksen työkaluihin vuodelle 2026.

Mitä muuta ihmiset kysyvät?#

Vibe-koodauksen täydellinen viitekehys: AI-klooni + Second Brain + kontekstisuunnittelu.