Claude Code vadnica 5: Kako namestiti Claude Code?

Kako namestiti Claude Code

Namestitev Claude Code nima grafičnega vmesnika z 'Naprej', vse poteka v ukazni vrstici. Če običajno uporabljate npm, celoten postopek ne traja več kot dve minuti.

Predpogoji

Pred začetkom se prepričajte, da imate naslednje stvari pri roki:

Node.js 18 ali novejša različica
Preverite tako: v terminalu zaženite node -v. Če je različica nižja od 18, jo nadgradite z nvm, fnm ali neposredno na nodejs.org.
Anthropic račun
Registracija na https://console.anthropic.com. Račun vam bo dal API ključ, ki ga boste potrebovali po namestitvi. Registracija je brezplačna, stroški so odvisni od uporabe.
Omrežje lahko dostopa do Anthropic API končne točke
Privzeta domena je api.anthropic.com. Če okolje zahteva nastavitev proxyja, v terminalu nastavite HTTP_PROXY ali HTTPS_PROXY.

Način namestitve 1: Globalna namestitev z npm

To je najpogostejši način; po namestitvi ga lahko uporabljate povsod.

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

Po končanem postopku zaženite claude --version; če se izpiše številka različice, je namestitev uspela. Po globalni namestitvi lahko ukaz claude kličete iz katere koli mape.

Če naletite na napako dovoljenj (pogosta v /usr/local/lib na macOS), sta na voljo dve možnosti:

Uporabite sudo za namestitev (priročno, a varnostno sporno).
Konfigurirajte npm za uporabo uporabniške mape, da se izognete sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Nato dodajte ~/.npm-global/bin v PATH in znova zaženite terminal.

Način namestitve 2: npx za takojšnjo uporabo

Če ne želite globalno namestiti ničesar ali želite le začasno preizkusiti, je npx bolj preprost.

npx @anthropic-ai/claude-code

npx začasno prenese najnovejši paket in po zagonu ne pusti globalnih ukazov. Vsakič preveri posodobitve, zato je vedno najnovejši. Slabost je, da je nekoliko počasnejši (vsakič prenese paket) in ni primeren za pogoste klice v avtomatiziranih skriptah.

Primerno za: prvo preizkušanje, začasno uporabo na tujem računalniku ali občasno uporabo.

Preverjanje, ali se lahko zažene

Po namestitvi ne hitite z avtentikacijo. Zaženite preprost ukaz, da preverite, ali se orodje lahko zažene:

claude --help

Če se izpiše pomoč, je binarna datoteka v redu. Naslednji korak je povezava z vašim računom, kar bomo obravnavali kasneje.

Po namestitvi z obema načinoma je jedro enako; kasnejša avtentikacija in uporaba sta popolnoma enaki. Izberite tistega, ki vam bolj ustreza.

Pogoste težave

Prenizka različica Node
Različice pod 18 vržejo napako, ne opozorila. Nadgradnja Node je najbolj neposredna rešitev.
Časovna omejitev omrežja
Tako pri nalaganju npm paketa kot pri povezovanju z API-jem lahko pride do težav zaradi proxyja ali požarnega zidu. Najprej preverite, ali curl https://api.anthropic.com deluje, preden nadaljujete.
Uporaba izvornega cmd v sistemu Windows
Čeprav je teoretično mogoče, priporočamo uporabo Git Bash, WSL2 ali Windows Terminal, da se izognete nenavadnim težavam s prevajanjem poti.