Kako instalirati Claude Code: Kompletni vodič (2026)

Brzi sažetak: Claude Code se može instalirati putem izvornih instalatora na macOS-u, Windows-u i Linux-u s najnovijeg službenog web-mjesta Claude Code. Korisnici sustava Windows moraju prvo instalirati WSL2 prije pokretanja Claude Code. Nakon instalacije, autenticirajte se sa svojim Claude računom kada Claude Code otvori prozor preglednika kako biste se prijavili pri prvom pokretanju i započeli kodiranje s pomoći umjetne inteligencije izravno iz vašeg terminala ili desktop aplikacije.

Claude Code predstavlja Anthropicov iskorak u razvojne alate agentne umjetne inteligencije. Ovaj pomoćnik u naredbenom retku čita baze kodova, uređuje datoteke, pokreće naredbe i integrira se s razvojnim radnim procesima.

Ali instalacija nije uvijek jednostavna. Različite platforme zahtijevaju različite pristupe. Windows zahtijeva dodatno postavljanje. A dokumentacija, iako opsežna, može preplaviti novopridošlice.

Ovaj vodič prolazi kroz složenost. Pokriva sistemske zahtjeve, korake instalacije specifične za platformu, autentifikaciju i verifikaciju—sve što je potrebno za ispravno pokretanje Claude Code.

Sistemski zahtjevi prije instalacije

Prema službenoj dokumentaciji Claude Code, alat podržava macOS, Windows i Linux. Međutim, svaka platforma ima specifične preduvjete.

Za macOS, zahtjevi su minimalni. Sustav treba macOS 13.0 ili noviji. Oba Intel i Apple Silicon čipa rade dobro.

Windows predstavlja veću složenost. Operativni sustav mora biti Windows 10 Build 19041 ili noviji, ili Windows 11. Ali tu je kvaka—Claude Code se ne pokreće izvorno na Windows-u.

Windows Subsystem for Linux 2 (WSL2) je obavezan. Ovo stvara Linux okruženje gdje Claude Code zapravo radi. Bez WSL2, instalacija ne uspijeva.

Korisnici Linuxa trebaju 64-bitnu distribuciju. Službena dokumentacija potvrđuje podršku za Ubuntu, Debian, Fedora i druge glavne distribucije. Alpine Linux i sustavi temeljeni na musl-u zahtijevaju dodatnu konfiguraciju.

Sve platforme trebaju stabilnu internetsku vezu tijekom instalacije. Veličine preuzimanja variraju, ali obično se kreću od 50 MB do 500 MB, ovisno o tome što je već instalirano.

Instalacija Claude Code na macOS

Proces instalacije na macOS-u koristi izvorni instalator. Ovo je najjednostavniji put među svim platformama.

Prvo, preuzmite instalator sa službenog web-mjesta Claude Code. Stranica za preuzimanje automatski prepoznaje macOS i nudi odgovarajući paket.

Otvorite preuzetu .dmg datoteku. Povucite aplikaciju Claude Code u mapu Applications. Standardna macOS instalacija—ništa neobično.

Neki korisnici nailaze na sigurnosni upit pri prvom pokretanju. macOS prema zadanim postavkama blokira aplikacije od neidentificiranih razvojnih programera. Desnom tipkom miša kliknite aplikaciju Claude Code i odaberite "Open" kako biste zaobišli ovo jednokratno upozorenje.

Alat naredbenog retka automatski se instalira s desktop aplikacijom. Otvorite Terminal i upišite claude --version kako biste provjerili. Ako se prikaže broj verzije, instalacija je uspješna.

Verifikacija instalacije na macOS-u

Pokrenite ove naredbe kako biste potvrdili da sve radi:

Obje naredbe trebale bi vratiti izlaz bez pogrešaka. Naredba version prikazuje instaliranu verziju Claude Code. Naredba help prikazuje dostupne opcije i naredbe.

Stvaranje testne mape pomaže u provjeri potpune funkcionalnosti. Idite na mapu projekta i pokrenite claude kako biste započeli interaktivnu sesiju. Alat bi se trebao inicijalizirati i zatražiti autentifikaciju ako još niste prijavljeni.

Instalacija na Windows pomoću WSL2

Instalacija na Windows zahtijeva više koraka. Proces traje duže nego na macOS-u, ali ostaje upravljiv.

WSL2 se mora instalirati prvi. Otvorite PowerShell kao administrator i pokrenite:

Ova naredba instalira WSL2 i Ubuntu prema zadanim postavkama. Sustav će zahtijevati ponovno pokretanje. Nakon ponovnog pokretanja, Ubuntu se automatski pokreće kako bi dovršio početno postavljanje.

Stvorite korisničko ime i lozinku za Unix kada se to zatraži. Ove vjerodajnice su odvojene od vjerodajnica za prijavu na Windows.

Kada WSL2 radi, primjenjuje se proces instalacije Linuxa. Otvorite Ubuntu terminal (instaliran s WSL2) i preuzmite instalator Claude Code za Linux.

Instalacija Claude Code u WSL2

Prema službenoj dokumentaciji, naredba za instalaciju preuzima i pokreće izvorni instalator:

Ovaj skript automatski rukuje ovisnostima. Instalira Node.js ako je potrebno, postavlja Claude Code binarnu datoteku i konfigurira PATH varijable.

Instalacija traje nekoliko minuta. Indikatori napretka i poruke o statusu pokazuju što se događa. Kada završi, zatvorite i ponovno otvorite terminal kako biste osvježili varijable okruženja.

Testiranje instalacije slijedi isti postupak kao i na macOS-u. Pokrenite claude --version za provjeru.

Proces instalacije na Linuxu

Korisnici Linuxa imaju najjednostavniji put instalacije. Izvorni instalator radi izravno bez dodatnih slojeva poput WSL2.

Preuzmite i pokrenite skript za instalaciju:

Ovo preuzima Claude Code binarnu datoteku, instalira ovisnosti i konfigurira okruženje ljuske. Skript detektira distribuciju i prilagođava se u skladu s tim.

Za sustave temeljene na Ubuntu i Debianu, skript konfigurira instalaciju. Službena dokumentacija potvrđuje podršku za Ubuntu 20.04+, Debian 10+ i druge distribucije.

Razmatranja za Alpine Linux

Alpine Linux i distribucije temeljene na musl-u zahtijevaju dodatne korake. Službena dokumentacija napominje da ti sustavi zahtijevaju ručnu konfiguraciju.

Standardni instalator može ne uspjeti na Alpineu. Umjesto toga, preuzmite binarnu datoteku kompatibilnu s musl-om izravno sa stranice za izdanja. Izdvojite je u mapu u sustavu PATH, obično /usr/local/bin.

Postavite dozvole za izvršavanje:

Korisnici Alpinea trebali bi provjeriti kompatibilnost prije nastavka. Neke značajke možda neće raditi identično kao na distribucijama temeljenim na glibc-u.

Autentifikacija i postavljanje računa

Nakon instalacije Claude Code, pokrenite claude u svom terminalu. Pri prvom pokretanju, Claude Code otvara prozor preglednika kako biste se prijavili.

Ovo otvara stranicu za autentifikaciju Claude. Prijavite se s postojećim Claude računom ili stvorite novi.

Preglednik prikazuje kod autorizacije. Kopirajte ovaj kod i vratite se u terminal. Zalijepite kod kada se to zatraži.

Uspješna autentifikacija pohranjuje vjerodajnice lokalno. Buduće sesije neće zahtijevati prijavu, osim ako vjerodajnice ne isteknu ili se ručno ne izbrišu.

Autentifikacija za timove i poduzeća

Prema službenoj dokumentaciji za autentifikaciju, timovi koji koriste Claude for Teams ili Enterprise imaju dodatne opcije. Organizacije mogu konfigurirati jedinstvenu prijavu (SSO) ili autentifikaciju putem davatelja usluga u oblaku.

Postavljanje SSO-a zahtijeva konfiguraciju administratora. Pojedinačni razvojni programeri zatim se autentificiraju putem davatelja identiteta njihove organizacije, umjesto osobnih Claude računa.

Autentifikacija putem davatelja usluga u oblaku radi za AWS, Google Cloud i Azure implementacije. Ova metoda koristi postojeće vjerodajnice u oblaku umjesto odvojenih Claude računa.

Instalacija desktop aplikacije

Claude Code nudi i aplikacije za naredbeni redak i desktop aplikacije. Desktop aplikacija pruža grafičko sučelje, zadržavajući punu funkcionalnost terminala.

Preuzmite instalator za desktop s službenog web-mjesta Claude. Stranica nudi verzije za macOS, Windows i Windows ARM64. Odaberite odgovarajuću verziju za sustav.

Instalacija na macOS-u slijedi isti .dmg proces opisan ranije. Korisnici sustava Windows mogu preuzeti desktop aplikaciju za grafičko sučelje bez potrebe za postavljanjem WSL2.

Desktop aplikacija uključuje integrirani pristup terminalu. Može pokretati sesije Claude Code bez prebacivanja na vanjske terminalske aplikacije.

Jedna od prednosti desktop aplikacije je dostupnost u pozadini. Prema službenoj stranici za preuzimanje, aplikacija "ostaje spremna u pozadini" i može se pozvati iz bilo koje aplikacije bez prebacivanja prozora ili gubitka fokusa.

Upotrijebite Get AI Perks za pronalaženje kredita za vašu Claude Code opremu

Instalacija je lak dio. Stvarni troškovi obično dolaze od svega što je povezano: infrastruktura, podržavajući alati i plaćene usluge korištene tijekom postavljanja i testiranja. Get AI Perks može pomoći popisom početnih kredita i popusta na jednom mjestu, zajedno sa smjernicama o tome kako se prijaviti.

S Get AI Perks možete:

• Pronaći kredite za alate u oblaku i povezane s AI
• Provjeriti uvjete pogodnosti prije prijave
• Izbjeći gubljenje vremena na ponude za koje možda ne ispunjavate uvjete
• Smanjiti troškove postavljanja vaše opreme

Posjetite Get AI Perks kako biste vidjeli odgovaraju li dostupne ponude alatima koje planirate koristiti s Claude Code.

Proširenja za IDE i integracije

Osim samostalne instalacije, Claude Code integrira se s popularnim razvojnim okruženjima. Postoje proširenja za Visual Studio Code i JetBrains IDE-ove.

Proširenje za VS Code instalira se putem tržišta. Pretražite "Claude Code" u panelu Extensions i kliknite Install. Proširenje zahtijeva da alat naredbenog retka bude instaliran prvi.

Neki korisnici prijavljuju probleme s priloženom datotekom proširenja za VS Code. Ako automatska instalacija ne uspije s pogreškom "End of central directory record signature not found", priložena .vsix datoteka može biti oštećena.

Rješenje uključuje ručnu instalaciju proširenja s tržišta VS Code, umjesto oslanjanja na verziju priloženu CLI-ju. Ovo razdvaja dvije komponente i sprječava sukobe pri instalaciji.

Integracija s JetBrains-om radi na sličan način. Instalirajte dodatak s JetBrains tržišta unutar IntelliJ IDEA, PyCharm, WebStorm ili drugih JetBrains proizvoda.

Provjera uspješnosti instalacije

Ispravna provjera osigurava da Claude Code radi ispravno prije početka stvarnih razvojnih zadataka.

Osnovna provjera provjerava dostupnost naredbi:

Ove naredbe trebale bi se izvršiti bez pogrešaka. Naredba help navodi dostupne opcije. Naredba version prikazuje instalirano izdanje.

Funkcionalno testiranje zahtijeva pokretanje sesije. Stvorite testnu mapu:

Ovo inicijalizira interaktivnu sesiju Claude Code. Alat bi trebao analizirati mapu (praznu u ovom slučaju) i prikazati upit.

Pokušajte s osnovnim naredbama unutar sesije. Upišite help da biste vidjeli dostupne radnje. Zatražite jednostavne zadatke kao što su "create a README file" ili "explain what you can do".

Uspješni odgovori ukazuju na ispravnu instalaciju. Ako se pojave pogreške, obično su povezane s autentifikacijom, mrežnom povezanošću ili nedostajućim ovisnostima.

Upravljanje ažuriranjima i verzijama

Claude Code se prema zadanim postavkama automatski ažurira. Službena dokumentacija objašnjava da alat provjerava nove verzije i instalira ih bez intervencije korisnika.

Ponašanje ažuriranja može se konfigurirati putem postavki Claude Code. Službena dokumentacija pokriva konfiguraciju kanala izdanja i opcije ručnog ažuriranja.

Ručna ažuriranja zahtijevaju ponovno pokretanje skripte za instalaciju. Ista naredba korištena za početnu instalaciju povlači najnoviju verziju:

Moguće je instalirati specifične verzije radi testiranja ili kompatibilnosti. Napredna dokumentacija za postavljanje pokriva prikvačivanje verzija i konfiguraciju kanala izdanja.

Kanali izdanja uključuju stabilni, beta i noćni. Preporučuje se stabilni za produkcijski rad. Beta i noćni kanali pružaju rani pristup novim značajkama, ali mogu sadržavati greške.

Uobičajeni problemi s instalacijom

Nekoliko problema često se pojavljuje u raspravama zajednice o instalaciji Claude Code.

Konfiguracija PATH-a uzrokuje mnoge probleme. Ako naredba claude nije pronađena nakon instalacije, mapa s binarnim datotekama nije u PATH-u sustava.

Na macOS-u i Linuxu, dodavanje mape u PATH obično uključuje uređivanje datoteka ~/.bashrc, ~/.zshrc ili sličnih datoteka za konfiguraciju ljuske. Skript za instalaciju obično to radi automatski, ali ručna provjera pomaže u rješavanju problema.

Korisnici sustava Windows u WSL2-u možda će morati zatvoriti i ponovno otvoriti terminal nakon instalacije. Varijable okruženja se ne osvježavaju u postojećim sesijama.

Mrežna ograničenja blokiraju neke instalacije. Korporativni vatrozidi ili proxy poslužitelji mogu spriječiti preuzimanje instalatora ili povezivanje sa serverima za autentifikaciju.

Konfiguracija proxyja zahtijeva varijable okruženja:

Pogreške u dozvolama nastaju prilikom instalacije u zaštićene mape. Instalatoru je potreban pristup pisanju u /usr/local/bin ili ekvivalentne lokacije. Pokretanje sa sudo to rješava, ali ga treba izbjegavati ako nije nužno.

Često postavljana pitanja

Početak rada nakon instalacije

Nakon što je Claude Code instaliran i provjeren, sljedeći korak je razumjeti kako ga učinkovito koristiti.

Brzi vodič preporučuje započeti s jednostavnim zadacima. Idite na postojeći projekt i pokrenite claude kako biste započeli interaktivnu sesiju.

Zamolite Claudea da objasni strukturu projekta. Zatražite sažetak onoga što codebase radi. Ovi istraživački upiti pomažu razumjeti kako alat interpretira kod.

Pokušajte unijeti male promjene. Zamolite Claudea da doda komentare funkcijama, stvori jednostavne testne datoteke ili refaktorira jednostavne blokove koda. Ovi zadaci demonstriraju mogućnosti uređivanja bez rizika.

Integracija s Git-om radi automatski ako projekt koristi kontrolu verzija. Claude Code može kreirati komite, objasniti razlike i predložiti poboljšanja temeljena na promjenama.

Službena dokumentacija uključuje primjere radnih procesa za uobičajene razvojne zadatke. Oni pokrivaju ispravljanje grešaka, implementaciju značajki, pregled koda i automatizirano testiranje.

Claude Code je alat u razvoju. Instalacija je samo temelj. Razumijevanje njegovih mogućnosti, ograničenja i najboljih praksi zahtijeva eksperimentiranje i praksu.

Spremni za instalaciju Claude Code? Preuzmite odgovarajući instalator za svoju platformu s službenog web-mjesta i slijedite korake navedene u ovom vodiču. Autentificirajte se sa svojim Claude računom, provjerite radi li instalacija ispravno i počnite istraživati razvoj uz pomoć umjetne inteligencije.