Tiivistelmä: Claude Code -sovelluksen asentaminen Windowsiin edellyttää WSL2:n (Windows Subsystem for Linux) määrittämistä, Ubuntun asentamista ja yksinkertaisen asennusskriptin suorittamista. Prosessi antaa Windows-käyttäjille pääsyn Anthropicin tekoälykoodausavustajaan terminaalinsa kautta. Saatavilla on natiiveja Windows-suoritettavia tiedostoja, mutta WSL2 on silti paras käytäntö Windows-asennukseen.
Claude Code on tekoälypohjainen koodausavustaja, joka toimii suoraan terminaalissa ja auttaa kehittäjiä rakentamaan ominaisuuksia, korjaamaan bugeja ja automatisoimaan kehitystehtäviä. Windows-käyttäjillä on kuitenkin yksi rajoitus.
Claude Code on saatavilla natiivina Windows-suoritettavana tiedostona, ja sen voi asentaa npm:n tai suoran binääritiedoston latauksen kautta ilman WSL2:ta. Se vaatii kuitenkin Windows Subsystem for Linux (WSL2):n, ja virallinen asennusmenetelmä perustuu edelleen WSL2:een.
Näin saat sen toimimaan Windows 11:ssä tai Windows 10:ssä.
Järjestelmävaatimukset
Ennen asennuksen aloittamista varmista, että Windows-kone täyttää seuraavat vaatimukset:
- Windows 10 1809+ tai Windows Server 2019+
- Windows 11 (mikä tahansa versio)
- Vähintään 4 Gt vapaata RAM-muistia
- Järjestelmänvalvojan oikeudet
- Internet-yhteys WSL2:n ja Ubuntun lataamiseen
Asennus vaatii levytilaa WSL2:lle, Ubuntulle ja Claude Codelle.
Vaihe 1: Ota käyttöön Windows Subsystem for Linux
WSL2 tarjoaa Linux-ympäristön suoraan Windowsin sisällä. Se on perusta, joka mahdollistaa Claude Code -sovelluksen toiminnan.
Avaa PowerShell järjestelmänvalvojana. Napsauta Käynnistä-painiketta hiiren kakkospainikkeella ja valitse "Windows PowerShell (järjestelmänvalvoja)" tai "Terminaali (järjestelmänvalvoja)" Windows 11:ssä.
Suorita tämä komento:
wsl --install
Tämä komento ottaa käyttöön tarvittavat Windows-ominaisuudet ja asentaa Ubuntun oletus-Linux-jakeluksi. Järjestelmä pyytää todennäköisesti uudelleenkäynnistystä.
Uudelleenkäynnistyksen jälkeen WSL2 viimeistelee asennuksen automaattisesti. Ubuntu käynnistyy ja pyytää käyttäjänimeä ja salasanaa. Nämä tunnukset ovat vain Linux-ympäristöä varten – niiden ei tarvitse vastata Windows-tunnuksia.
Vaihe 2: Varmista WSL2-asennus
Kun järjestelmä on käynnistynyt uudelleen ja Ubuntu on suorittanut alkuasetuksensa, varmista, että WSL2 toimii oikein.
Avaa Ubuntu-terminaali (hae "Ubuntu" Käynnistä-valikosta) ja suorita:
wsl --version
Tämä näyttää WSL-versiotiedot. Etsi tulosteesta "WSL version: 2.x.x".
Jos komento näyttää WSL1:n sijaan, päivitä WSL2:een komennolla:
wsl --set-default-version 2
Vaihe 3: Asenna Claude Code
Nyt itse Claude Code -sovelluksen asennukseen. Virallinen dokumentaatio tarjoaa yhden rivin asennusskriptin.
Suorita Ubuntu-terminaalissa:
curl -fsSL claude.ai/install.sh | bash
Skripti lataa Claude Code -binääritiedoston, asettaa tarvittavat käyttöoikeudet ja lisää sen järjestelmän PATH-ympäristömuuttujaan. Asennuksen kesto vaihtelee internet-nopeuden ja järjestelmän ominaisuuksien mukaan.
Virallisen Claude Code -dokumentaation mukaan asennusohjelma tunnistaa automaattisesti järjestelmän arkkitehtuurin ja lataa sopivan binääriversion.
Yleisiä asennusongelmia
Jotkut Windows-käyttäjät raportoivat näkevänsä "komentoa ei löydy: claude" asennuksen jälkeen. Tämä tapahtuu tyypillisesti, koska PATH-muuttujaa ei ole päivitetty.
Sulje ja avaa Ubuntu-terminaali uudelleen ja yritä uudelleen. Jos ongelma jatkuu, tämä polun määritys voi auttaa epävirallisena ratkaisuna:
echo 'export PATH="$HOME/.claude/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Vaihe 4: Todenna Claude Code
Claude Code vaatii todennuksen Anthropic-tilillä ennen käyttöä.
Suorita tämä komento:
claude
Terminaali näyttää URL-osoitteen ja pyytää todennusta. Prosessi vaihtelee hieman yksittäisten käyttäjien ja tiimitilien välillä:
| Tyyppi | Todennusmenetelmä | Vaaditaan |
|---|---|---|
| Yksittäinen | Henkilökohtainen API-avain | Anthropic-tili API-pääsyllä |
| Tiimi/Organisaatio | Organisaatiotoken | Ylläpitäjän antama todennus token |
Avaa annettu URL-osoite selaimessa, kirjaudu Anthropic-tilillesi ja valtuuta Claude Code. Terminaali vahvistaa onnistuneen todennuksen.
Windows-projektien käyttäminen WSL2:ssa
Tässä asiassa asiat muuttuvat hieman monimutkaisiksi. Windowsin tiedostojärjestelmät ja WSL2:n tiedostojärjestelmät ovat erillisiä.
Windows-tiedostot ovat käytettävissä WSL2:ssa osoitteessa /mnt/c/ (C:-asemalle), /mnt/d/ (D:-asemalle) ja niin edelleen. Tähän liittyy kuitenkin suorituskykykustannuksia. Yhteisökeskustelut osoittavat suorituskykyeroja Windows-liitettyjen ja natiivien WSL2-hakemistojen välillä.
Parhaan suorituskyvyn saavuttamiseksi kopioi projektitiedostot WSL2:n kotihakemistoon:
cp -r /mnt/c/Users/YourName/Projects/your-project ~/projects/your-project
Kompromissi? IDE-integraatiosta tulee monimutkaisempaa. Visual Studio Code käsittelee tämän hyvin Remote-WSL-laajennuksensa avulla, mutta muut IDE:t voivat kohdata vaikeuksia.
Asennuksen testaaminen
Varmista, että Claude Code toimii oikein yksinkertaisella testillä.
Siirry projektihakemistoon (tai luo testihakemisto):
mkdir ~/claude-test
cd ~/claude-test
claude "luo yksinkertainen hello world Python-skripti"
Claude Code -sovelluksen pitäisi vastata, luoda tiedosto ja näyttää koodi. Tämä vahvistaa, että asennus onnistui.
Lopeta yli maksaminen, lunasta saatavilla olevat tekoälyhyvitykset ensin
Claude Code -sovelluksen asentaminen Windowsiin on yleensä nopeaa. Todellinen kustannus ilmenee myöhemmin, kun kehittäjät alkavat testata kehotteita, suorittaa skriptejä ja integroida mallia sovelluksiin. Tämä kokeiluvaihe voi tuottaa paljon API-kutsuja, ja monet tiimit huomaavat kustannukset vasta rakentamisen aloittamisen jälkeen.
Ennen kuin käytät rahaa käyttöön, kannattaa tarkistaa, täytätkö oikeuden tekoälyhyvityksiin tai kumppaniohjelmiin. Get AI Perks kerää nämä mahdollisuudet yhteen paikkaan ja listaa tekoälypalveluntarjoajien, pilvialustojen ja kehittäjätyökalujen hyvitykset ja alennukset sekä yksinkertaiset ohjeet niiden lunastamiseen.
Ennen ensimmäisen Claude Code -projektisi suorittamista tarkista Get AI Perks ja lunasta tekoälyhyvitykset, jotka voivat kattaa kehityskustannuksesi.
Usein kysytyt kysymykset
Voiko Claude Code -sovellusta käyttää natiivisti Windowsissa ilman WSL2:ta?
Kyllä, mutta WSL2 on edelleen paras asennustapa Windowsille.
Toimiiko Claude Code Windows Terminalin kanssa?
Kyllä. Windows Terminal voi avata Ubuntu-välilehtiä, mikä mahdollistaa pääsyn Claude Code -sovellukseen ilman erillisen Ubuntu-ikkunan käyttöä. Napsauta Windows Terminalissa pudotusvalikkoa ja valitse Ubuntu profiililuettelosta.
Toimivatko nykyiset Windows-kehitystyökaluni Claude Code -sovelluksen kanssa?
Se riippuu työkalusta. Visual Studio Code integroituu hyvin Remote-WSL-laajennuksen kautta. JetBrains IDE:t ja muut työkalut saattavat vaatia lisämäärityksiä. Virallinen dokumentaatio mainitsee VS Code:n ja JetBrains:in tuettuina alustoina.
Kuinka päivitetään Claude Code Windowsissa?
Claude Code päivittyy oletusarvoisesti automaattisesti. Päivittääksesi manuaalisesti, suorita `claude update` Ubuntu-terminaalissa. Automaattinen päivitysominaisuus voidaan poistaa käytöstä konfiguraatiotiedostojen kautta, jos se on tarpeen yritysympäristöissä.
Mikä on ero Claude Code -sovelluksen ja Claude API:n välillä?
Claude Code on terminaalipohjainen koodausavustaja, joka suorittaa komentoja ja muokkaa tiedostoja. Claude API tarjoaa ohjelmallisen pääsyn Claude-kielimalliin räätälöityjen sovellusten rakentamiseksi. Ne palvelevat eri tarkoituksia ja vaativat erilaisia asennusprosesseja.
Voinko käyttää Claude Code -sovellusta .NET-projektien kanssa Windowsissa?
Kyllä, mutta rajoituksin. Yhteisökeskustelut osoittavat, että .NET SDK -tuki WSL2:ssa toimii, mutta vaatii Linux-version .NET SDK:sta asentamista Ubuntuun. Windowsiin asennettua .NET:iä ei voi käyttää WSL2:sta.
Kuinka paljon Claude Code maksaa?
Hinnoittelu riippuu käytöstä ja tilin tyypistä. Tarkista viralliselta Anthropic-verkkosivustolta ajankohtaiset hinnoittelutasot ja tiimitilaukset, sillä kustannukset vaihtelevat API-kulutuksen ja organisaation vaatimusten mukaan.
Seuraavat vaiheet asennuksen jälkeen
Kun Claude Code on asennettu, aloita sen ominaisuuksien tutkiminen. Pikaoppaan dokumentaatio suosittelee aloittamaan yksinkertaisista tehtävistä, kuten koodin selittämisestä, ennen monimutkaisempiin toimintoihin siirtymistä.
Kokeile näitä komentoja tutustuaksesi:
- claude "selitä tämä funktio" -- Hanki koodiselityksiä
- claude commit -- Luo Git commit -viestejä
- claude -c -- Jatka viimeisintä keskustelua
Virallinen dokumentaatio tarjoaa yksityiskohtaisia oppaita IDE-integraatiosta, liitännäisten asennuksesta ja edistyneistä konfiguraatiovaihtoehdoista. Tiimeille palvelinohjatut asetukset ja analytiikan seuranta tarjoavat lisäkontrollia Claude Code -käyttöönottoihin.
WSL2-asetukset saattavat vaikuttaa lisäaskelilta verrattuna natiiveihin Windows-sovelluksiin, mutta se on tällä hetkellä ainoa tapa suorittaa Claude Code -sovellusta Windowsissa. Hyvä uutinen? Kun se on määritetty, se toimii sujuvasti ja integroituu useimpiin kehitystyönkulkuihin.
