Kako postaviti Claude Code: Kompletni vodič za 2026.

Brzi sažetak: Claude Code je AI pomoćnik za kodiranje baziran na terminalu koji se izvorno pokreće na macOS-u i Linuxu, ili na Windowsima putem WSL2. Postavljanje zahtijeva izradu Anthropic API ključa, pokretanje instalatera specifičnog za platformu, autentifikaciju ključem i provjeru instalacije testnom naredbom. 

Claude Code predstavlja službeni AI pomoćnik za kodiranje tvrtke Anthropic baziran na terminalu. Živi izravno u komandnoj liniji i obrađuje sve, od generiranja koda do ispravljanja grešaka putem naredbi prirodnog jezika.

Ali proces postavljanja nije uvijek jednostavan. Korisnici Windowsa trebaju WSL2. API autentifikacija može zbuniti nove korisnike. Pojavljuju se sukobi verzija.

Ovaj vodič prolazi kroz cjelokupni proces postavljanja za sve platforme, od sistemskih zahtjeva do vaše prve sesije kodiranja.

Što je zapravo Claude Code

Claude Code je agentna terminalna aplikacija koja se integrira s razvojnim okruženjima. Razumije baze kodova, izvršava rutinske zadatke i upravlja git radnim procesima putem konverzacijskih naredbi.

Za razliku od alata temeljenih na pregledniku, Claude Code se pokreće lokalno u terminalu. Izravno pristupa datotekama projekta, održava kontekst tijekom sesija i integrira se s postojećim razvojnim radnim procesima. Prema službenoj dokumentaciji Claude Code, alat se povezuje s Anthropic API-jem i podržava integraciju s Amazon Bedrock, Google Cloud Vertex AI i Azure AI.

Alat radi drugačije od tradicionalnih AI pomoćnika za kodiranje. Iskreno rečeno: više je kao da imate par programera u svom terminalu nego alat za dovršavanje koda.

Sistemski zahtjevi za Claude Code

Prije instalacije, sustavi moraju zadovoljiti određene zahtjeve. Evo što je potrebno svakoj platformi:

Sve platforme trebaju stabilnu internetsku vezu za API pozive. Preuzimanja Claude Code obično zahtijevaju oko 50 MB, a WSL2 na Windowsima dodaje približno 500 MB za Linux podsustav.

Što se tiče prostora za pohranu, očekujte najmanje 4 GB slobodnog prostora. Sama aplikacija je mala, ali prostor za ovisnosti i datoteke projekta je važan.

Zahtjevi specifični za Windows

Claude Code može se pokrenuti na Windowsima putem PowerShell-a ili Command Prompt-a ako je instaliran Node.js. Alat zahtijeva Windows Subsystem for Linux 2 za stvaranje Linux okruženja.

Prema vodičima za instalaciju s claude.ai, sustavi Windows 10 trebaju verziju 1903 ili noviju s buildom 19041 ili višim. Korisnici Windowsa 11 imaju ugrađenu podršku za WSL2. Za početno postavljanje WSL2 potrebna su administratorska prava.

Proces uključuje omogućavanje virtualizacije u BIOS-u, aktiviranje značajki sustava Windows i instaliranje Linux distribucije. Ubuntu 22.04 LTS preporučena je distribucija za kompatibilnost.

Instalacija Claude Code: Korak po korak

Proces instalacije razlikuje se ovisno o platformi. Evo kako pokrenuti Claude Code na svakom operacijskom sustavu.

Instalacija na macOS i Linux

Instalacije na macOS i Linux slijede isti obrazac. Obje platforme podržavaju izvornu instalaciju bez dodatnog postavljanja.

Proces započinje preuzimanjem instalacijskog programa. Otvorite terminal i pokrenite:

curl -fsSL claude.ai/install.sh | sh

Skripta otkriva operacijski sustav, preuzima odgovarajući binarni zapis i instalira Claude Code u lokalni bin direktorij. Instalacija se obično dovršava za manje od dvije minute uz stabilnu vezu.

Za sustave bez cURL-a, wget radi kao alternativa. Instalacijski program automatski dodaje Claude Code u sistemsku PATH.

Instalacija na Windows putem WSL2

Instalacija na Windows zahtijeva prvo postavljanje WSL2. Evo cjelokupnog procesa:

Otvorite PowerShell kao administrator i omogućite WSL:

wsl --install

Ova naredba omogućuje potrebne značajke sustava Windows, preuzima WSL2 kernel i zadano instalira Ubuntu. Sustav će od vas tražiti ponovno pokretanje. Nakon ponovnog pokretanja, Ubuntu se automatski pokreće za dovršetak postavljanja korisnika.

Kada se to od vas zatraži, stvorite korisničko ime i lozinku. Ove vjerodajnice su za Linux okruženje, odvojene od podataka za prijavu na Windows.

Nakon što WSL2 radi, primjenjuje se proces instalacije za Linux. U Ubuntu terminalu pokrenite cURL naredbu iz odjeljka za macOS/Linux gore.

Instalacijski program brine o ostalom. Claude Code se instalira unutar WSL2 okruženja i pokreće kroz Ubuntu terminal.

Dobivanje Anthropic API ključa

Claude Code zahtijeva Anthropic API ključ za autentifikaciju. Ključ povezuje lokalnu instalaciju s Anthropic poslužiteljima.

Posjetite Anthropic Console na console.anthropic.com. Stvorite račun ili se prijavite s postojećim vjerodajnicama. Idite na API Keys u postavkama računa.

Kliknite "Create Key" da biste generirali novi API ključ. Ključ se pojavljuje jednom – kopirajte ga odmah. Anthropic ne prikazuje cijeli ključ ponovno nakon napuštanja stranice.

Sigurno pohranite ključ. On pruža potpuni pristup Anthropic API-ju i svim povezanim troškovima.

Razumijevanje troškova API-ja

Claude Code radi na modelu plaćanja po korištenju putem Anthropic API-ja. Prema podacima iz vodiča za instalaciju claude.ai, troškovi variraju ovisno o modelu:

Minimalna kupnja za aktivaciju naplate iznosi 5 USD, iako rasprave u zajednici sugeriraju da 20-30 USD pruža bolji prostor za testiranje. Alternativne opcije pretplate uključuju Claude Pro po cijeni od 20 USD mjesečno ili Claude Max po cijeni od 100 USD mjesečno za intenzivnu upotrebu.

Zadani način rada koristi Opus do dostizanja 50% limita korištenja, a zatim prelazi na Sonnet radi efikasnosti troškova.

Autentifikacija i prvo pokretanje

Nakon instalacije, Claude Code zahtijeva autentifikaciju prije prve uporabe. Pokrenite Claude Code naredbom:

claude

Prvo pokretanje traži API ključ. Zalijepite ključ iz Anthropic Console i pritisnite Enter. Claude Code provjerava ključ i sigurno ga pohranjuje u lokalne konfiguracijske datoteke.

Autentifikacija se održava tijekom sesija. API ključ ne treba ponovno unositi osim ako nije izričito uklonjen ili prilikom promjene računa.

Da biste potvrdili uspješnu autentifikaciju, Claude Code prikazuje poruku dobrodošlice i prompt za naredbe. Sučelje prikazuje dostupne naredbe i potvrđuje vezu s Anthropic API-jem.

Konfiguriranje preferenci modela

Claude Code zadano odabire model automatski, ali je moguće i ručno konfiguriranje. Prema službenoj dokumentaciji, korisnici mogu prilagoditi odabir modela putem naredbe /model ili postavljanjem varijable okruženja CLAUDE_CODE_EFFORT_LEVEL.

Razina truda kontrolira dubinu razmišljanja za modele Opus 4.6 i Sonnet 4.6: nisku, srednju ili visoku. Više razine truda povećavaju dubinu razmišljanja, ali i troškove i vrijeme odziva.

Za projekte koji zahtijevaju duboku analizu, uključivanje "ultrathink" u upite privremeno postavlja trud na visoko za taj specifični krug.

Provjera uspješne instalacije

Nakon autentifikacije, provjerite radi li Claude Code ispravno. Pokrenite ove osnovne testove:

claude --help
claude --version

Naredba help prikazuje dostupne opcije i naredbe. Izlaz verzije potvrđuje koja je izdanje instalirano. Obje naredbe bi se trebale izvršiti bez grešaka.

Zatim, testirajte Claude Code u direktoriju projekta. Stvorite testnu mapu:

mkdir test-project
cd test-project
echo "# Test Project" > README.md
claude

Unutar sesije Claude Code, pokušajte osnovne interakcije:

• Upišite "help" da biste vidjeli dostupne naredbe
• Pitajte "explain what you can do"
• Zatražite "summarize this project"
• Testirajte naredbu /help

Ove interakcije potvrđuju da Claude Code može čitati datoteke projekta i odgovarati na upite. Uspješni odgovori znače da je instalacija funkcionalna.

Konfiguriranje Claude Code za projekte

Claude Code pohranjuje postavke specifične za projekt u konfiguracijske datoteke. Ove datoteke prilagođavaju ponašanje, definiraju memoriju i uspostavljaju radne procese.

Primarna konfiguracijska datoteka je CLAUDE.md u korijenu projekta. Ova datoteka sadrži upute, kontekst i smjernice specifične za projekt na koje se Claude Code referencira tijekom sesija.

Stvorite osnovnu datoteku CLAUDE.md:

# Kontekst projekta

Ovo je [vrsta projekta] izgrađen s [tehnologije].

## Ključne smjernice
– [Važno pravilo 1]
– [Važno pravilo 2]

## Struktura projekta
[Kratko objašnjenje organizacije mapa]

Datoteka prihvaća Markdown formatiranje. Claude Code čita ovaj kontekst na početku sesije i održava ga tijekom cijelog razgovora.

Napredne opcije konfiguracije

Osim osnovnog konteksta, Claude Code podržava naprednu konfiguraciju putem direktorija .claude. Ovaj direktorij može sadržavati:

• Vještine (Skills): Specijalizirane mogućnosti definirane u .claude/skills/SKILL.md
• Naredbe (Commands): Prilagođene naredbe s kosom crtom u .claude/commands/*.md
• Kuke (Hooks): Automatski radni procesi pokrenuti događajima
• Dodaci (Plugins): Proširena funkcionalnost putem programskog integriranja

Prema službenoj dokumentaciji Agent SDK, ove značajke omogućuju sofisticirano prilagođavanje. Vještine definiraju mogućnosti koje se mogu ponovno koristiti. Naredbe stvaraju prečace za uobičajene zadatke. Kuke automatiziraju odgovore na promjene datoteka ili korištenje alata.

Korištenje Claude Code: Osnovni radni procesi

Nakon završetka instalacije, Claude Code obrađuje uobičajene razvojne zadatke putem prirodnog jezika.

Započnite sesiju navigacijom do direktorija projekta i pokretanjem:

claude

Prompt prihvaća zahtjeve jednostavnim jezikom. Neki uobičajeni radni procesi:

• Generiranje koda: "Create a Python function that validates email addresses with proper error handling."
• Ispravljanje grešaka: "This function is throwing a null pointer exception. Can you identify and fix the issue?"
• Refaktoriranje: "Refactor this component to use dependency injection instead of direct instantiation."
• Git operacije: "Create a new branch, commit these changes with a descriptive message, and push to origin."

Claude Code održava kontekst tijekom cijele sesije. Pamti prethodne interakcije, prati izmjene datoteka i razumije širu strukturu projekta.

Razumijevanje Plan Mode

Za složene promjene, Claude Code nudi Plan Mode. Ovaj način rada stvara detaljan plan izvršenja prije unošenja izmjena.

Aktivirajte Plan Mode dodavanjem prefiksa "plan:" zahtjevima ili korištenjem naredbe /plan. Claude Code tada iznosi predložene promjene, objašnjava obrazloženje i čeka odobrenje prije izvršenja.

Plan Mode je posebno koristan za refaktoriranje, arhitektonske promjene ili izmjene koje utječu na više datoteka. Pruža uvid u ono što Claude Code namjerava učiniti prije nego što se obveže na promjene.

Integracija s VS Code i IDE-ovima

Iako se Claude Code pokreće u terminalu, integracija s uređivačima koda poboljšava radni proces. Službeni VS Code dodatak donosi mogućnosti Claude Code izravno u uređivač.

Instalirajte dodatak iz VS Code marketplacea. Potražite "Claude Code" i kliknite Install. Dodatak dodaje ploču Claude Code u bočnu traku.

Prema službenoj dokumentaciji VS Code, dodatak podržava:

Dodatak održava jednak skup značajki kao i verzija za terminal, istovremeno dodajući praktičnosti specifične za IDE, kao što su inline diffovi i @-spominjanja referenci datoteka.

Ažuriranje i upravljanje Claude Code

Claude Code se zadano automatski ažurira. Aplikacija periodično provjerava nove verzije i instalira ažuriranja u pozadini.

Za ručno ažuriranje, pokrenite:

claude --update

Ovo prisiljava trenutnu provjeru i instalaciju najnovije verzije. Proces ažuriranja zadržava konfiguracijske datoteke i vjerodajnice za autentifikaciju.

Za organizacije koje zahtijevaju kontrolu verzija, automatska ažuriranja se mogu onemogućiti. Postavite varijablu okruženja CLAUDE_CODE_AUTO_UPDATE na false ili konfigurirajte putem postavki kojima upravlja poslužitelj.

Za instalaciju specifične verzije, koristite:

curl -fsSL claude.ai/install.sh | sh -s -- --version=X.Y.Z

Zamijenite X.Y.Z s brojem ciljne verzije.

Česti problemi pri postavljanju i rješenja

Tijekom postavljanja često se javlja nekoliko problema. Evo kako ih riješiti:

• Odbijanje API ključa: Ako Claude Code odbije API ključ, provjerite nema li dodatnih razmaka ili znakova. Ponovno kopirajte ključ iz Anthropic Console. Provjerite je li naplata aktivirana – ključevi neće raditi bez unesenog načina plaćanja.
• Neuspjesi instalacije WSL2: Windows sustavi ponekad ne uspiju instalirati WSL2 zbog postavki virtualizacije. Uđite u BIOS i omogućite virtualizaciju (Intel VT-x ili AMD-V). Provjerite zadovoljava li verzija Windowsa minimalne zahtjeve.
• Naredba nije pronađena: Ako terminal ne prepoznaje naredbu claude, PATH nije pravilno ažuriran. Zatvorite i ponovno otvorite terminal. Za uporne probleme, ručno dodajte direktorij za instalaciju u PATH.
• Vremenska ograničenja veze: Mrežna ograničenja ili vatrozidi mogu blokirati API pozive. Claude Code zahtijeva HTTPS pristup api.anthropic.com. Korporativne mreže mogu zahtijevati konfiguraciju proxyja.
• Pogreške u dopuštenjima: Instalacije na Linuxu i macOS-u povremeno nailaze na probleme s dopuštenjima. Pokrenite instalacijski program s odgovarajućim dopuštenjima ili ga instalirajte u korisnički direktorij umjesto u sistemske lokacije.

Provjerite dostupne AI kredite prije postavljanja Claude Code

Postavljanje Claude Code obično znači eksperimentiranje – pokretanje upita, testiranje integracija i izgradnju malih prototipova prije nego što bilo što uđe u produkciju. Ta rana faza često dovodi do puno korištenja API-ja. Umjesto da plaćaju za svaki zahtjev odmah, mnogi programeri prvo traže dostupne kredite ili početne programe koji pomažu u smanjenju tih početnih troškova.

Get AI Perks prikuplja ove prilike na jednom mjestu. Platforma navodi AI kredite, popuste i partnerske programe kod AI pružatelja, cloud platformi i razvojnih alata, sa vodičima korak po korak koji objašnjavaju kako ih zatražiti. Ukupno, baza podataka uključuje pogodnosti od više od 200 alata i milijune dolara dostupnih kredita za koje se startupi i graditelji mogu prijaviti.

Prije nego što dovršite postavljanje Claude Code, provjerite Get AI Perks i zatražite AI kredite koji mogu pokriti vaše prve eksperimente.

Često postavljana pitanja

Daljnji koraci s Claude Code

Claude Code transformira terminalno razvoj pomoću AI pomoći integrirane izravno u komandnu liniju. Postavljanje zahtijeva instalaciju specifičnu za platformu, API autentifikaciju i osnovnu konfiguraciju, ali proces je jednostavan kada se slijede ispravni koraci.

Alat se ističe u rutinskim razvojnim zadacima, generiranju koda i upravljanju git radnim procesima. Plan Mode pruža sigurnost za složene operacije. Integracija s IDE-ovima proširuje mogućnosti izvan terminala.

Počnite s jednostavnim zadacima kako biste razumjeli kako Claude Code interpretira zahtjeve. Napredujte prema složenijim radnim procesima kako se upoznajete s alatom. Koristite naredbu /clear između odvojenih zadataka kako biste održali čisti kontekst. Konfigurirajte CLAUDE.md datoteke za smjernice specifične za projekt.

Timovi mogu istraživati postavke kojima upravlja poslužitelj i tržišta dodataka. Pojedinačni programeri mogu imati koristi od vještina i prilagođenih naredbi prilagođenih čestim obrascima.

GitHub repozitorij na anthropics/claude-code sadrži dodatne primjere, dodatke zajednice i resurse za rješavanje problema. Službena dokumentacija na docs.anthropic.com pruža opsežne tehničke reference.

Sada je vrijeme da počnete kodirati. Navigirajte do projekta, pokrenite Claude Code i vidite kako AI-potpomognuti razvoj mijenja vaš radni proces.