Claude Code -sarjan opetusohjelma 5: Kuinka asentaa Claude Code?

Kuinka asentaa Claude Code

Claude Coden asennuksessa ei ole graafisen käyttöliittymän "Seuraava"-painikkeita, vaan kaikki tehdään komentorivillä. Jos käytät npm:ää, koko prosessi ei vie kahta minuuttia kauempaa.

Edellytykset

Ennen aloitusta varmista, että sinulla on seuraavat asiat:

Node.js 18 tai uudempi
Tarkistustapa: suorita terminaalissa node -v. Jos versio on alle 18, päivitä se nvm:llä, fnm:llä tai suoraan nodejs.org-sivustolta.
Anthropic-tili
Rekisteröidy osoitteessa https://console.anthropic.com. Tili tarjoaa API-avaimen, jota tarvitaan asennuksen jälkeen. Rekisteröityminen on ilmaista, todelliset kustannukset perustuvat käyttöön.
Verkkoyhteys Anthropicin API-päätepisteeseen
Oletusdomain on api.anthropic.com. Jos ympäristö vaatii välityspalvelimen määritystä, muista asettaa HTTP_PROXY tai HTTPS_PROXY terminaalissa.

Asennustapa 1: npm:n yleinen asennus

Tämä on yleisin tapa, ja kun se on asennettu kerran, se toimii kaikkialla.

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

Kun asennus on valmis, suorita claude --version. Jos saat versionumeron, asennus on onnistunut. Yleisen asennuksen jälkeen claude-komento on käytettävissä missä tahansa hakemistossa.

Jos kohtaat käyttöoikeusvirheen (yleinen macOS:n /usr/local/lib-hakemistossa), kaksi tapaa ratkaista se:

Käytä sudo-asennusta (helppo, mutta turvallisuusriski).
Määritä npm käyttämään käyttäjäkohtaista hakemistoa välttääksesi sudo:n:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Lisää sitten ~/.npm-global/bin PATH-muuttujaan ja avaa terminaali uudelleen.

Asennustapa 2: npx:n kertakäyttö

Jos et halua asentaa mitään pysyvästi tai haluat vain kokeilla väliaikaisesti, npx on suoraviivaisempi.

npx @anthropic-ai/claude-code

npx lataa uusimman paketin väliaikaisesti ja ei jätä pysyvää komentoa. Jokainen käyttö tarkistaa päivitykset, joten se on aina uusin versio. Haittapuolena on hitaampi lataus (jokainen kerta) ja se ei sovellu automaattisiin skripteihin, joita kutsutaan usein.

Soveltuu tilanteisiin: ensimmäinen kokeilu, väliaikainen käyttö toisen koneella tai satunnainen käyttö.

Varmista, että se käynnistyy oikein

Asennuksen jälkeen älä kiirehdi todentamaan. Suorita yksinkertainen komento nähdäksesi, käynnistyykö työkalu:

claude --help

Jos saat ohjetekstin, binääritiedosto toimii. Seuraava vaihe on yhdistää tilisi, josta kerrotaan myöhemmin.

Molemmat asennustavat tuottavat saman ohjelman, ja myöhempi todentaminen ja käyttö ovat täysin samat. Valitse se, joka tuntuu sinulle sopivimmalta.

Yleisiä ongelmia

Node-versio liian vanha
Alle 18 aiheuttaa suoraan virheilmoituksen, ei varoitusta. Node-version päivitys on suorin ratkaisu.
Verkon aikakatkaisu
Sekä npm-paketin lataus että API-yhteys voivat jumiutua välityspalvelimen tai palomuurin takia. Varmista ensin, että curl https://api.anthropic.com toimii, ennen kuin jatkat.
Windowsin alkuperäinen cmd
Teoriassa mahdollista, mutta suositellaan Git Bashia, WSL2:ta tai Windows Terminalia oudomman polkujen tulkinnan välttämiseksi.