Pika yhteenveto: Claude Code voidaan asentaa natiivien asennusohjelmien avulla macOS:lle, Windowsille ja Linuxille viralliselta Claude Code -verkkosivustolta. Windows-käyttäjien on asennettava WSL2 ensin ennen Claude Coden käyttöä. Asennuksen jälkeen vahvista Claude-tililläsi, kun Claude Code avaa selainikkunan, jotta voit kirjautua sisään ensimmäisellä käynnistyksellä ja aloittaa koodauksen tekoälyavustuksella suoraan pääte- tai työpöytäsovelluksestasi.
Claude Code edustaa Anthropicin panostusta agenttimaiseen tekoälyn kehitystyökaluihin. Tämä komentoriviassistentti lukee koodikantoja, muokkaa tiedostoja, suorittaa komentoja ja integroituu kehitystyönkulkuihin.
Mutta sen asentaminen ei aina ole suoraviivaista. Eri alustat vaativat erilaisia lähestymistapoja. Windows vaatii lisäasetuksia. Ja dokumentaatio, vaikkakin kattava, voi ylikuormittaa uusia käyttäjiä.
Tämä opas selventää monimutkaisuutta. Se kattaa järjestelmävaatimukset, alustakohtaiset asennusvaiheet, todennuksen ja vahvistuksen – kaiken, mitä tarvitaan Claude Coden asianmukaisen toiminnan varmistamiseksi.
Järjestelmävaatimukset ennen asennusta
Virallisen Claude Code -dokumentaation mukaan työkalu tukee macOS:ää, Windowsia ja Linuxia. Jokaisella alustalla on kuitenkin omat erityisvaatimuksensa.
macOS:lle vaatimukset ovat minimaaliset. Järjestelmä vaatii macOS 13.0 tai uudemman. Sekä Intel- että Apple Silicon -prosessorit toimivat hyvin.
Windows esittää enemmän monimutkaisuutta. Käyttöjärjestelmän on oltava Windows 10 Build 19041 tai uudempi, tai Windows 11. Mutta tässä on haaste – Claude Code ei toimi natiivisti Windowsissa.
Windows Subsystem for Linux 2 (WSL2) on pakollinen. Tämä luo Linux-ympäristön, jossa Claude Code todella toimii. Ilman WSL2:ta asennus epäonnistuu.
Linux-käyttäjät tarvitsevat 64-bittisen jakelun. Virallinen dokumentaatio vahvistaa tuen Ubuntulle, Debianille, Fedoralle ja muille tärkeimmille jakeluille. Alpine Linux ja musl-pohjaiset järjestelmät vaativat lisäkonfiguraatiota.
Kaikki alustat tarvitsevat vakaan internetyhteyden asennuksen aikana. Latauskoot vaihtelevat, mutta ovat yleensä 50 MB–500 MB riippuen siitä, mitä on jo asennettu.
| Alusta | Minimiversio | Erityisvaatimukset |
|---|---|---|
| macOS | 13.0 | Ei mitään |
| Windows | 10 Build 19041 tai 11 | WSL2 vaaditaan |
| Linux | 64-bittinen jakelu | glibc-pohjainen suositeltava |
Claude Coden asennus macOS:lle
macOS-asennusprosessi käyttää natiivia asennusohjelmaa. Tämä on yksinkertaisin tapa kaikista alustoista.
Lataa ensin asennusohjelma viralliselta Claude Code -verkkosivustolta. Lataussivu tunnistaa automaattisesti macOS:n ja tarjoaa sopivan paketin.
Avaa ladattu .dmg-tiedosto. Vedä Claude Code -sovellus Sovellukset-kansioon. Tavallinen macOS-asennus – ei mitään epätavallista tässä.
Jotkut käyttäjät kohtaavat turvallisuuskehotteen ensimmäisellä käynnistyksellä. macOS estää tunnistamattomien kehittäjien sovellukset oletusarvoisesti. Napsauta Claude Code -sovellusta hiiren kakkospainikkeella ja valitse "Avaa" ohittaaksesi tämän kertaluonteisen varoituksen.
Komentorivityökalu asennetaan automaattisesti työpöytäsovelluksen kanssa. Avaa Pääte ja kirjoita `claude --version` varmistaaksesi. Jos versionumero ilmestyy, asennus onnistui.
macOS-asennuksen vahvistaminen
Suorita nämä komennot vahvistaaksesi, että kaikki toimii:
| `claude --version` `claude --help` |
Molempien komentojen pitäisi palauttaa tulostetta ilman virheitä. Version komento näyttää asennetun Claude Code -version. Ohje-komento näyttää käytettävissä olevat valinnat ja komennot.
Testihakemiston luominen auttaa varmistamaan täyden toimivuuden. Siirry projektikansioon ja suorita `claude` aloittaaksesi interaktiivisen istunnon. Työkalun tulisi alustaa ja pyytää todennusta, jos sitä ei ole vielä kirjautunut sisään.
Windows-asennus WSL2:lla
Windows-asennus vaatii useita vaiheita. Prosessi kestää kauemmin kuin macOS:llä, mutta pysyy hallittavissa.
WSL2 on asennettava ensin. Avaa PowerShell järjestelmänvalvojana ja suorita:
| `wsl --install` |
Tämä komento asentaa WSL2:n ja Ubuntun oletusarvoisesti. Järjestelmä vaatii uudelleenkäynnistyksen. Uudelleenkäynnistyksen jälkeen Ubuntu käynnistyy automaattisesti täydentämään alustavan asetuksen.
Luo Unix-käyttäjänimi ja salasana pyydettäessä. Nämä tunnukset ovat erillisiä Windows-kirjautumistunnuksista.
Kun WSL2 on käynnissä, Linux-asennusprosessi pätee. Avaa Ubuntu-pääte (asennettu WSL2:lla) ja lataa Claude Code -asennusohjelma Linuxille.
Claude Coden asennus WSL2:een
Virallisen dokumentaation mukaan asennuskomento lataa ja suorittaa natiivin asennusohjelman:
| `curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash` |
Tämä skripti hoitaa riippuvuudet automaattisesti. Se asentaa Node.js:n tarvittaessa, asettaa Claude Code -binäärin ja konfiguroi PATH-muuttujat.
Asennus kestää muutaman minuutin. Edistymispalkit ja tilaviestit ilmaisevat, mitä tapahtuu. Kun se on valmis, sulje ja avaa pääte uudelleen päivittääksesi ympäristömuuttujat.
Asennuksen testaaminen noudattaa samaa prosessia kuin macOS:llä. Suorita `claude --version` varmistaaksesi.
Linux-asennusprosessi
Linux-käyttäjillä on suoraviivaisin asennuspolku. Natiivi asennusohjelma toimii suoraan ilman lisäkerroksia, kuten WSL2:ta.
Lataa ja suorita asennusskripti:
| `curl -fsSL claude.ai/install.sh | bash` |
Tämä lataa Claude Code -binäärin, asentaa riippuvuudet ja konfiguroi shell-ympäristön. Skripti tunnistaa jakelun ja säätää sen mukaan.
Ubuntun ja Debianin kaltaisille järjestelmille skripti konfiguroi asennuksen. Virallinen dokumentaatio vahvistaa tuen Ubuntu 20.04+:lle, Debian 10+:lle ja muille jakeluille.
Alpine Linux -huomioita
Alpine Linux ja musl-pohjaiset jakelut vaativat lisävaiheita. Virallinen dokumentaatio huomauttaa, että nämä järjestelmät vaativat manuaalista konfiguraatiota.
Vakioasennusohjelma voi epäonnistua Alpinessa. Lataa sen sijaan musl-yhteensopiva binääri suoraan julkaisusivulta. Pura se hakemistoon järjestelmän PATH:ssa, tyypillisesti `/usr/local/bin`.
Aseta suoritettavat oikeudet:
| `chmod +x /usr/local/bin/claude` |
Alpine-käyttäjien tulisi varmistaa yhteensopivuus ennen jatkamista. Jotkin ominaisuudet eivät välttämättä toimi samalla tavalla kuin glibc-pohjaisissa jakeluissa.
Todennus ja tilin asetus
Kun Claude Code on asennettu, suorita `claude` pääteesi. Ensimmäisellä käynnistyksellä Claude Code avaa selainikkunan, jotta voit kirjautua sisään.
Tämä avaa Claude-todennussivun. Kirjaudu sisään olemassa olevalla Claude-tilillä tai luo uusi.
Selain näyttää valtuutuskoodin. Kopioi tämä koodi ja palaa pääteeseesi. Liitä koodi pyydettäessä.
Onnistunut todennus tallentaa tunnukset paikallisesti. Tulevat istunnot eivät vaadi kirjautumista, elleivät tunnukset vanhene tai niitä tyhjennetä manuaalisesti.
Tiimi- ja yritystason todennus
Virallisen todennusdokumentaation mukaan Claude for Teams tai Enterprise -palvelua käyttävillä tiimeillä on lisävaihtoehtoja. Organisaatiot voivat konfiguroida kertakirjautumisen (SSO) tai pilvipalveluntarjoajan todennuksen.
SSO-asetukset vaativat järjestelmänvalvojan konfiguraatiota. Yksittäiset kehittäjät todennetaan sitten organisaationsa identiteetintarjoajan kautta henkilökohtaisten Claude-tilien sijaan.
Pilvipalveluntarjoajan todennus toimii AWS-, Google Cloud- ja Azure-käyttöönotoissa. Tämä menetelmä käyttää olemassa olevia pilvitunnuksia erillisten Claude-tilien sijaan.
| Todennusmenetelmä | Käyttötapaus | Asetusten monimutkaisuus |
|---|---|---|
| Henkilökohtainen tili | Yksittäiset kehittäjät | Yksinkertainen |
| Tiimi/Yritys SSO | Organisaatiot | Vaatii adminin |
| Pilvipalveluntarjoaja | AWS/GCP/Azure-käyttäjät | Kohtalainen |
Työpöytäsovelluksen asennus
Claude Code tarjoaa sekä komentorivi- että työpöytäsovelluksen. Työpöytäsovellus tarjoaa graafisen käyttöliittymän säilyttäen samalla täyden pääte-toiminnallisuuden.
Lataa työpöytäasennusohjelma viralliselta Claude-verkkosivustolta. Sivusto tarjoaa macOS-, Windows- ja Windows ARM64-versiot. Valitse järjestelmälle sopiva versio.
macOS-asennus noudattaa samaa .dmg-prosessia kuin aiemmin kuvattiin. Windows-käyttäjät voivat ladata työpöytäsovelluksen graafista käyttöliittymää varten ilman WSL2-asetuksia.
Työpöytäsovellus sisältää integroidun pääteyhteyden. Se voi käynnistää Claude Code -istuntoja vaihtamatta ulkoisiin päätesovelluksiin.
Yksi työpöytäsovelluksen eduista on taustalla toimiminen. Virallisen lataussivun mukaan sovellus "pysyy valmiina taustalla" ja sen voi tuoda esiin mistä tahansa sovelluksesta vaihtamatta ikkunoita tai menettämättä kohdistusta.
Käytä Get AI Perksiä löytääksesi krediittejä Claude Code -asetelmaasi
Asennus on helppo osa. Todellinen kustannus tulee yleensä kaikesta sen ympärillä: infrastruktuuri, tukityökalut ja maksetut palvelut, joita käytetään asennuksen ja testauksen aikana. Get AI Perks voi auttaa listaamalla startup-krediitit ja alennukset yhteen paikkaan, sekä ohjeita niiden hakemiseen.
Get AI Perksin avulla voit:
- Löytää krediittejä pilvi- ja tekoälytyökaluille
- Tarkistaa etujen ehdot ennen hakemista
- Välttää ajan tuhlaamista tarjouksiin, joihin et ehkä kelpaa
- Alentaa asetuksesi käyttöönottamisen kustannuksia
Käy Get AI Perksissä nähdäksesi, vastaavatko saatavilla olevat tarjoukset työkaluja, joita aiot käyttää Claude Coden kanssa.
IDE-laajennukset ja integraatiot
Standalone-asennuksen lisäksi Claude Code integroituu suosittuihin kehitysympäristöihin. Laajennuksia on saatavilla Visual Studio Codeen ja JetBrains IDE:ihin.
VS Code -laajennus asennetaan markkinapaikan kautta. Hae "Claude Code" Laajennukset-paneelista ja napsauta Asenna. Laajennus vaatii komentorivityökalun asentamista ensin.
Jotkut käyttäjät raportoivat ongelmista mukana tulevassa VS Code -laajennustiedostossa. Jos automaattinen asennus epäonnistuu virheilmoituksella "End of central directory record signature not found", mukana tuleva .vsix-tiedosto voi olla vioittunut.
Työkierto sisältää laajennuksen asentamisen manuaalisesti VS Code -markkinapaikasta CLI:n mukana tulevan version sijaan. Tämä erottaa kaksi osaa ja estää asennusristiriitoja.
JetBrains-integraatio toimii samankaltaisesti. Asenna liitännäinen JetBrains-markkinapaikasta IntelliJ IDEA:n, PyCharm:n, WebStorm:n tai muiden JetBrains-tuotteiden sisällä.
Asennuksen onnistumisen vahvistaminen
Asianmukainen vahvistus varmistaa, että Claude Code toimii oikein ennen todellisten kehitystehtävien aloittamista.
Perusvarmistus tarkistaa komentojen saatavuuden:
| `claude --help` `claude --version` |
Näiden komentojen pitäisi suorittua ilman virheitä. Ohje-komento luettelee käytettävissä olevat valinnat. Version komento näyttää asennetun julkaisun.
Toiminnallinen testaus vaatii istunnon aloittamisen. Luo testihakemisto:
| `mkdir test-project` `cd test-project` `claude` |
Tämä käynnistää interaktiivisen Claude Code -istunnon. Työkalun pitäisi analysoida hakemisto (tässä tapauksessa tyhjä) ja näyttää kehote.
Kokeile peruskomennoita istunnon aikana. Kirjoita `help` nähdäksesi käytettävissä olevat toiminnot. Pyydä yksinkertaisia tehtäviä, kuten "luo README-tiedosto" tai "selitä mitä voit tehdä".
Onnistuneet vastaukset osoittavat asianmukaisen asennuksen. Jos virheitä ilmenee, ne liittyvät yleensä todennukseen, verkkoyhteyteen tai puuttuviin riippuvuuksiin.
Päivitys- ja versionhallinta
Claude Code päivittyy oletusarvoisesti automaattisesti. Virallinen dokumentaatio selittää, että työkalu tarkistaa uusia versioita ja asentaa ne ilman käyttäjän toimenpiteitä.
Päivityskäyttäytymistä voidaan konfiguroida Claude Code -asetusten kautta. Virallinen dokumentaatio kattaa julkaisukanavien konfiguraation ja manuaaliset päivitysvaihtoehdot.
Manuaaliset päivitykset vaativat asennusskriptin suorittamista uudelleen. Sama komento, jota käytettiin alkuperäiseen asennukseen, lataa uusimman version:
| `curl -fsSL claude.ai/install.sh | bash` |
Tiettyjen versioiden asentaminen on mahdollista testaus- tai yhteensopivuussyistä. Edistynyt asennusdokumentaatio kattaa versioiden kiinnittämisen ja julkaisukanavien konfiguraation.
Julkaisukanavia ovat vakaa, beta ja yötä päivää. Vakaata suositellaan tuotantotyöhön. Beta- ja yötä päivää -kanavat tarjoavat aikaisen pääsyn uusiin ominaisuuksiin, mutta voivat sisältää virheitä.
Yleiset asennusongelmat
Useat ongelmat esiintyvät usein yhteisökeskusteluissa Claude Code -asennuksesta.
PATH-konfiguraatio aiheuttaa monia ongelmia. Jos `claude`-komentoa ei löydy asennuksen jälkeen, binäärihakemisto ei ole järjestelmän PATH:ssa.
macOS:llä ja Linuxilla hakemiston lisääminen PATH:iin sisältää tyypillisesti ~/.bashrc-, ~/.zshrc- tai vastaavien shell-konfiguraatiotiedostojen muokkaamisen. Asennusskripti hoitaa tämän yleensä automaattisesti, mutta manuaalinen vahvistus auttaa vianmäärityksessä.
Windows-käyttäjät WSL2:ssa saattavat joutua sulkemaan ja avaamaan päätteen uudelleen asennuksen jälkeen. Ympäristömuuttujat eivät päivity olemassa olevissa istunnoissa.
Verkkorajoitukset estävät joitakin asennuksia. Yritysverkkopalvelimet tai välityspalvelimet voivat estää asennusohjelman lataamisen tai todennuspalveluihin yhdistymisen.
Välityspalvelimen konfiguraatio vaatii ympäristömuuttujia:
| `export HTTP_PROXY= proxy.example.com:8080` `export HTTPS_PROXY= proxy.example.com:8080` |
Oikeusvirheitä esiintyy asennettaessa suojattuihin hakemistoihin. Asennusohjelma tarvitsee kirjoitusoikeuden /usr/local/bin- tai vastaaviin sijainteihin. Suorittaminen sudo-oikeuksilla ratkaisee tämän, mutta sitä tulisi välttää, ellei se ole välttämätöntä.
Usein kysytyt kysymykset
Voiko Claude Code toimia ilman internet-yhteyttä?
Ei. Claude Code vaatii internet-yhteyden toimiakseen. Työkalu lähettää koodia ja kyselyitä Anthropicin palvelimille käsiteltäväksi. Paikallinen välimuisti voi sallia joidenkin toimintojen väliaikaisen offline-toiminnan, mutta täysi toiminnallisuus vaatii aktiivisen yhteyden.
Toimiiko Claude Code olemassa olevien tekoälykoodaustyökalujen kanssa?
Kyllä. Claude Code voi toimia rinnakkain GitHub Copilotin, Cursorin tai muiden tekoälyn kehitystyökalujen kanssa. Ne toimivat itsenäisesti eivätkä ole ristiriidassa. Useiden tekoälyavustajien samanaikainen käyttö voi kuitenkin luoda sekaannusta siitä, mikä työkalu hoitaa mitäkin tehtävää.
Vaatiiko WSL2 kaikkien Windows-ominaisuuksien käyttöä?
Komentorivityökalu vaatii WSL2:n Windowsissa. Työpöytäsovellus kuitenkin toimii natiivisti Windowsissa ilman WSL2:ta. Työpöytäsovellus tarjoaa samankaltaista toiminnallisuutta graafisen käyttöliittymän kautta puhtaan komentorivi-interaktion sijaan.
Kuinka paljon Claude Code maksaa käyttää?
Hinnoittelu vaihtelee käytön ja tilaustason mukaan. Tarkista virallisesta Claude-verkkosivustosta ajankohtaiset hinnat, sillä kustannukset ja tason rakenteet muuttuvat ajan myötä. Jotkin ominaisuudet vaativat Claude Pro- tai Enterprise-tilauksia.
Voiko Claude Code muokata tiedostoja projektihakemiston ulkopuolella?
Oletusarvoisesti Claude Code rajoittaa tiedostojen käyttöä nykyiseen projektihakemistoon turvallisuussyistä. Konfiguraatioasetukset voivat laajentaa oikeuksia, mutta se vaatii nimenomaisen valtuutuksen. Hiekkalaatikkodokumentaatio kattaa oikeuksien hallinnan yksityiskohtaisesti.
Mikä on ero Claude Coden ja Claude API:n välillä?
Claude Code on kehitystyökalu interaktiiviseen koodausavustukseen. Claude API tarjoaa ohjelmallisen pääsyn sovellusten rakentamiseen, jotka käyttävät Clauden tekoälyominaisuuksia. Ne palvelevat eri tarkoituksia – toinen kehittäjille, jotka kirjoittavat koodia, toinen tekoälyominaisuuksia integroiville sovelluksille.
Poistaako Claude Coden poistaminen kaikki sen tiedot?
Poistaminen poistaa sovellusbinäärin, mutta voi jättää konfiguraatiotiedostot ja välimuistitiedot. Täydellinen poistaminen vaatii ~/.claude-hakemiston manuaalisen poistamisen macOS:llä ja Linuxilla, tai vastaavan AppData-sijainnin Windowsissa.
Aloittaminen asennuksen jälkeen
Kun Claude Code on asennettu ja vahvistettu, seuraava askel on sen tehokkaan käytön ymmärtäminen.
Pikaopas suosittelee aloittamista yksinkertaisilla tehtävillä. Siirry olemassa olevaan projektiin ja suorita `claude` aloittaaksesi interaktiivisen istunnon.
Pyydä Claudea selittämään projektin rakenne. Pyydä yhteenveto siitä, mitä koodikanta tekee. Nämä tutkivat kyselyt auttavat ymmärtämään, miten työkalu tulkitsee koodia.
Kokeile tehdä pieniä muutoksia. Pyydä Claudea lisäämään kommentteja funktioihin, luomaan yksinkertaisia testitiedostoja tai refaktoroimaan yksinkertaisia koodilohkoja. Nämä tehtävät osoittavat muokkausominaisuudet ilman riskiä.
Git-integraatio toimii automaattisesti, jos projekti käyttää versionhallintaa. Claude Code voi luoda sitoumuksia, selittää eroja ja ehdottaa parannuksia muutosten perusteella.
Virallinen dokumentaatio sisältää työnkulkuesimerkkejä yleisiin kehitystehtäviin. Nämä kattavat virheenkorjauksen, ominaisuuksien toteutuksen, koodikatselmointien ja automatisoidun testauksen.
Claude Code on kehittyvä työkalu. Asennus on vain perusta. Sen ominaisuuksien, rajoitusten ja parhaiden käytäntöjen ymmärtäminen vaatii kokeilua ja harjoittelua.
Oletko valmis asentamaan Claude Coden? Lataa sopiva asennusohjelma alustallesi viralliselta verkkosivustolta ja noudata tämän oppaan vaiheita. Todennäköistä Claude-tililläsi, vahvista asennuksen oikea toimivuus ja ala tutkia tekoälyavusteista kehitystä.
