Tutorialul seriei Claude Code 5: Cum se instalează Claude Code?

Cum se instalează Claude Code

Instalarea Claude Code nu are un „Următorul” în interfața grafică, totul se face în linia de comandă. Dacă folosești npm, întregul proces nu durează mai mult de două minute.

Cerințe prealabile

Înainte de a începe, asigură-te că ai următoarele:

Node.js 18 sau mai nou
Verifică: rulează node -v în terminal. Dacă versiunea este sub 18, actualizează folosind nvm, fnm sau direct de pe nodejs.org.
Un cont Anthropic
Înregistrează-te la https://console.anthropic.com. Contul va oferi o cheie API, necesară după instalare. Înregistrarea este gratuită, costurile reale sunt calculate în funcție de utilizare.
Acces la rețea către punctul final API Anthropic
Numele de domeniu implicit este api.anthropic.com. Dacă mediul necesită un proxy, setează HTTP_PROXY sau HTTPS_PROXY în terminal.

Metoda de instalare 1: Instalare globală cu npm

Aceasta este cea mai comună metodă, instalezi o dată și poți folosi oriunde.

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

După finalizare, rulează claude --version. Dacă apare un număr de versiune, instalarea a reușit. După instalarea globală, comanda claude poate fi apelată direct din orice director.

Dacă întâmpini erori de permisiuni (comune pe macOS pentru /usr/local/lib), ai două opțiuni:

Folosește sudo pentru instalare (mai simplu, dar cu controverse de securitate).
Configurează npm să folosească directorul utilizatorului, evitând sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Apoi adaugă ~/.npm-global/bin la PATH și redeschide terminalul.

Metoda de instalare 2: Folosirea npx (fără instalare permanentă)

Dacă nu vrei să instalezi nimic global sau vrei doar să încerci temporar, npx este mai direct.

npx @anthropic-ai/claude-code

npx va descărca temporar cel mai recent pachet, îl va rula și nu va lăsa comenzi globale. De fiecare dată când rulezi, verifică actualizări, deci rămâi automat la cea mai recentă versiune. Dezavantajul este că este puțin mai lent (trebuie să descarce de fiecare dată) și nu este potrivit pentru scripturi automate care rulează frecvent.

Potrivit pentru: prima experiență, utilizare temporară pe mașina altcuiva sau utilizare ocazională.

Verifică dacă pornește corect

După instalare, nu te grăbi să autentifici. Rulează o comandă simplă pentru a vedea dacă instrumentul pornește:

claude --help

Dacă apare informația de ajutor, fișierul binar funcționează. Următorul pas este conectarea contului tău, care va fi discutat mai târziu.

Ambele metode instalează același pachet; autentificarea și modul de utilizare ulterioare sunt identice. Alege metoda care ți se pare mai convenabilă.

Întrebări frecvente

Versiune Node prea veche
Sub 18, apare o eroare, nu doar un avertisment. Actualizarea Node este soluția directă.
Timeout de rețea
Atât descărcarea pachetului npm, cât și conexiunea API pot fi blocate de proxy sau firewall. Verifică mai întâi dacă curl https://api.anthropic.com funcționează, apoi continuă.
Utilizarea cmd-ului nativ pe Windows
Deși teoretic posibil, se recomandă Git Bash, WSL2 sau Windows Terminal pentru a evita problemele ciudate de cale.