Claude Code vodič 5: Kako instalirati Claude Code?

Kako instalirati Claude Code

Instalacija Claude Code nema grafički sučelje s "sljedeće", sve se radi u naredbenom retku. Ako inače koristite npm, cijeli proces ne traje više od dvije minute.

Preduvjeti

Prije početka provjerite imate li sljedeće:

Node.js 18 ili noviji
Provjera: u terminalu pokrenite node -v. Ako je verzija niža od 18, nadogradite pomoću nvm, fnm ili izravno s nodejs.org.
Anthropic račun
Registracija na https://console.anthropic.com. Račun daje API ključ, bit će potreban nakon instalacije. Registracija je besplatna, trošak se obračunava prema korištenju.
Mrežni pristup Anthropic API krajnjoj točki
Zadana domena je api.anthropic.com. Ako okolina zahtijeva proxy, postavite HTTP_PROXY ili HTTPS_PROXY u terminalu.

Način instalacije 1: npm globalna instalacija

Ovo je najčešći način, instalira se jednom i može se koristiti svugdje.

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

Nakon završetka, pokrenite claude --version; ako se ispiše broj verzije, instalacija je uspjela. Globalnom instalacijom naredba claude dostupna je u svim direktorijima.

Ako naiđete na grešku dopuštenja (često na macOS u /usr/local/lib), postoje dva rješenja:

Instalirajte pomoću sudo (jednostavno, ali sigurnosno upitno).
Konfigurirajte npm da koristi korisnički direktorij, izbjegavajući sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Zatim dodajte ~/.npm-global/bin u PATH i ponovno otvorite terminal.

Način instalacije 2: npx - koristi i zaboravi

Ako ne želite globalno instalirati ništa ili samo želite privremeno isprobati, npx je izravniji.

npx @anthropic-ai/claude-code

npx će privremeno preuzeti najnoviji paket, pokrenuti ga i ne ostavljati globalne naredbe. Svaki put provjerava ažuriranja, pa je uvijek najnovija verzija. Nedostatak je što je malo sporiji (svaki put preuzima) i nije prikladan za automatske skripte koje se često pozivaju.

Prikladno za: prvi dojam, privremeno korištenje na tuđem računalu ili rijetku upotrebu.

Provjera ispravnog pokretanja

Nakon instalacije nemojte odmah raditi autentifikaciju. Pokrenite jednostavnu naredbu da vidite može li se alat pokrenuti:

claude --help

Ako se ispiše pomoć, binarna datoteka je ispravna. Sljedeći korak je povezivanje vašeg računa, o čemu ćemo kasnije.

Obje metode instalacije daju isti program, a kasnija autentifikacija i korištenje su potpuno isti. Odaberite onu koja vam više odgovara.

Česta pitanja

Node verzija preniska
Verzija niža od 18 uzrokuje izravnu grešku, ne upozorenje. Nadogradnja Node-a je izravno rješenje.
Mrežni timeout
Bilo povlačenje npm paketa ili naknadno povezivanje s API-jem može zapeti zbog proxyja ili vatrozida. Prvo provjerite radi li curl https://api.anthropic.com, pa tek onda nastavite.
Izvorna cmd na Windowsu
Iako je teoretski moguće, preporučuje se Git Bash, WSL2 ili Windows Terminal kako biste izbjegli čudne probleme s putanjama.