Kratki sažetak: Claude Code je Anthropicov AI pomoćnik za kodiranje temeljen na terminalu koji zahtijeva instalaciju putem upravitelja paketa poput npm-a ili Homebrew-a, nakon čega slijedi autentifikacija pomoću Anthropic API ključa. Nakon postavljanja, programeri mogu koristiti naredbe na prirodnom jeziku za izvršavanje zadataka kodiranja, od otklanjanja pogrešaka i refaktura do git radnih procesa i uređivanja više datoteka. Alat se integrira izravno s postojećim projektima i podržava prilagodbu putem kuka (hooks), dodataka (plugins) i konfiguracijskih datoteka.
Claude Code je agentni alat za kodiranje koji je izradila tvrtka Anthropic i koji živi izravno u terminalu. Nije proširenje IDE-a ili internetsko sučelje – to je pomoćnik za naredbeni redak koji razumije baze kodova, izvršava rutinske zadatke i upravlja svime, od otklanjanja pogrešaka do git radnih procesa, putem prirodnog jezika.
Za razliku od tradicionalnih pomoćnika za kodiranje, Claude Code radi autonomno. Može čitati datoteke, izvršavati naredbe i unositi izmjene u više datoteka uz minimalnu ljudsku intervenciju. Kvaliteta njegovog izlaza u potpunosti ovisi o ispravnom postavljanju i upravljanju kontekstom.
Ovaj vodič pokriva sve, od instalacije do prvih radnih procesa. Bez suvišnih informacija, samo praktični koraci koji doista znače.
Sistemski zahtjevi i preduvjeti
Prije početka procesa instalacije, provjerite zadovoljava li sustav osnovne zahtjeve. Claude Code radi na macOS-u, Linuxu i Windows 10/11 putem WSL2.
Evo što je potrebno:
- Uklonite ovaj zahtjev ili ga ublažite na "Node.js može biti potreban za određene metode instalacije" – izvorni materijal ne navodi Node.js 18 kao sistemski zahtjev
- Instaliran i konfiguriran Git
- Pristup terminalu s dopuštenjima ljuske (shell)
- Stabilna internetska veza za API pozive
- Anthropic račun s API pristupom
Za korisnike sustava Windows, Claude Code ne može se pokretati nativno na Windowsima. Alat zahtijeva Windows Subsystem for Linux 2 (WSL2) za stvaranje Linux okruženja u kojem Claude Code učinkovito radi. Za instalaciju WSL2 potreban je Windows 10 verzija 1903 ili novija (Build 18362+).
Ukupna veličina preuzimanja tijekom postavljanja obično iznosi manje od 1 GB, uključujući WSL2 na Windowsima (približno 500 MB), Node.js (oko 30 MB) i Claude Code s ovisnostima (oko 50 MB).
Pronađite AI alate i kredite prije početka
Početak rada s Claude Codeom često uključuje odabir drugih AI alata oko njega. Get AI Perks pomaže u tome prikupljanjem početnih kredita i popusta na softver za AI i cloud alate na jednom mjestu. Platforma uključuje 200+ pogodnosti, s ponudama od Claudea, Anthropa, OpenAI-a, Geminija, ElevenLabsa, Intercoma i drugih, zajedno s uvjetima i koracima za njihovo preuzimanje.
Tražite AI kredite prije prijave?
Provjerite Get AI Perks kako biste:
- pregledali ponude za Claude i druge AI alate
- vidjeli koje pogodnosti odgovaraju vašoj tvrtki
- pratili vodiče za preuzimanje dostupnih kredita
👉 Posjetite Get AI Perks kako biste usporedili dostupne pogodnosti AI softvera.
Instaliranje Claude Codea
Proces instalacije malo se razlikuje ovisno o operativnom sustavu, ali slijedi isti opći obrazac.
Instalacija na macOS i Linux
Za korisnike macOS-a s instaliranim Homebrewom, proces je jednostavan:
| brew install –cask claude-code |
Bez Homebrew-a, koristite npm:
| npm install -g @anthropic-ai/claude-code ili koristite preporučene metode instalacije (curl ili brew) |
Korisnici Linuxa mogu slijediti isti pristup s npm-om. Globalna zastavica za instalaciju (-g) osigurava da Claude Code postane dostupan u cijelom sustavu, a ne samo za određeni projekt.
Instalacija na Windows putem WSL2
Instalacija na Windows zahtijeva prethodno postavljanje WSL2. Otvorite PowerShell kao administrator i pokrenite:
| wsl –install |
Ova naredba instalira WSL2, a prema zadanim postavkama i Ubuntu. Nakon dovršetka instalacije, ponovno pokrenite sustav. Prilikom ponovnog pokretanja, Ubuntu se automatski pokreće kako bi dovršio postavljanje kreiranjem korisničkog imena i lozinke.
Unutar Linux okruženja WSL2, instalirajte Node.js:
| curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash – sudo apt-get install -y nodejs |
Zatim instalirajte Claude Code pomoću npm-a kao što je prikazano gore.
Provjerite instalaciju pokretanjem:
| claude –version |
Naredba bi trebala vratiti trenutni broj verzije. Ako to ne učini, putanja instalacije možda nije u varijabli sustava PATH.
Autentifikacija i postavljanje računa
Claude Code zahtijeva autentifikaciju Anthropic API ključem prije nego što može funkcionirati.
Dobivanje API ključa
Idite na Anthropic Console na console.anthropic.com i stvorite račun ili se prijavite. U odjeljku API generirajte novi API ključ. Odmah kopirajte ovaj ključ – neće vam se više prikazati nakon napuštanja stranice.
API pristup radi na principu plaćanja po korištenju. Prema službenoj dokumentaciji, cijene se temelje na modelu po tokenu s različitim cijenama za različite Claude modele. Ostavite kako jest – provjereno u službenom izvornom materijalu koji navodi 'Minimalna kupnja: 5 USD' i 'Preporučeno: 20-30 USD za testiranje i početne projekte.'
Povezivanje Claude Codea s API-jem
Prvi put pokrenite Claude Code u bilo kojem direktoriju projekta:
| claude |
Alat će zatražiti autentifikaciju. Otvorit će prozor preglednika za prijavu ili će vam dati URL koji možete kopirati i zalijepiti. Nakon autentifikacije putem preglednika, Claude Code prima autorizaciju i pohranjuje vjerodajnice lokalno.
Proces autentifikacije stvara konfiguracijske datoteke u početnom direktoriju. Te datoteke ostaju i nakon završetka sesija, tako da se autentifikacija događa samo jednom, osim ako se vjerodajnice ručno ne opozovu.
Da biste provjerili radi li sve ispravno, pokrenite:
| claude doctor |
Ova dijagnostička naredba provjerava uobičajene probleme s konfiguracijom, vezu s API-jem i probleme s dopuštenjima.
Pokretanje prve sesije Claude Codea
Nakon dovršene autentifikacije, Claude Code je spreman za stvarni rad.
Pokretanje interaktivnog načina rada
Idite na bilo koji direktorij projekta i pokrenite:
| claude |
Ovo pokreće interaktivni način rada – stalnu sesiju u kojoj Claude Code održava kontekst kroz više naredbi i uređivanja datoteka. Terminal prikazuje upit koji signalizira da je Claude Code aktivan i čeka upute.
Osnovni obrasci naredbi
Claude Code prihvaća tri primarna formata naredbi:
| Format naredbe | Svrha | Primjer |
|---|---|---|
| claude | Pokretanje interaktivne sesije | claude |
| claude “zadatak” | Pokretanje jednokratnog zadatka i izlazak | claude “popravi grešku u izradi” |
| claude -p “upit” | Postavite pitanje bez unošenja promjena | claude -p “objasni ovu funkciju” |
Interaktivni način rada najkorisniji je za složene radne procese koji uključuju više koraka. Jednokratni zadaci su dobri za brze popravke ili automatizirane skripte. Način upita (zastavica -p) pruža informacije bez izmjena datoteka.
Unošenje prve izmjene koda
U interaktivnom načinu rada, isprobajte jednostavan zadatak:
| Dodaj rukovanje pogreškama u glavnu funkciju u app.js |
Claude Code analizira datoteku, identificira glavnu funkciju i predlaže izmjene s odgovarajućim try-catch blokovima ili logikom provjere grešaka. Prije primjene izmjena, prikazuje pregled razlika (diff preview).
Alat traži potvrdu prije izmjene datoteka. Pažljivo pregledajte predložene izmjene. Odobrite unosom "yes" ili odbijte unosom "no" kako biste zatražili izmjene.
Bitni radni procesi i uobičajeni zadaci
Claude Code upravlja širokim rasponom razvojnih radnih procesa izvan osnovnih izmjena koda.
Git integracija
Claude Code izvorno razumije git radne procese. Naredbe poput ovih rade prirodno:
- "Stvori novu granu za značajku prijave"
- "Spremi ove izmjene s opisnom porukom"
- "Pokaži mi što se promijenilo od posljednjeg spremanja"
- "Spoji granu značajke i riješi sukobe"
Alat može čitati git povijest, razumjeti strukture grana i generirati odgovarajuće poruke o spremanju na temelju promjena u kodu.
Otklanjanje pogrešaka i rješavanje problema
Kada se pojave pogreške, Claude Code ih može istražiti i predložiti rješenja:
- "Otkloni pogrešku zašto API poziv ne uspijeva"
- "Pronađi izvor ove iznimke null pokazivača"
- "Zašto ova funkcija ne vraća očekivanu vrijednost"
Claude Code ispituje poruke o pogreškama, prati putanje izvršavanja i provjerava povezane datoteke kako bi utvrdio osnovne uzroke.
Refaktura koda
Refaktura velikog opsega postaje upravljiva sa sviješću o više datoteka:
- "Izdvoji ovu logiku u zaseban pomoćni modul"
- "Refaktura ovu klasu da koristi kompoziciju umjesto nasljeđivanja"
- "Ažuriraj sve uvoze nakon premještanja ove datoteke"
Alat prati ovisnosti između datoteka i automatski ažurira reference.
Podrška za testiranje
Claude Code može generirati testove, pokrenuti skupove testova i protumačiti neuspjehe:
- "Napiši unit testove za modul za autentifikaciju"
- "Pokreni skup testova i objasni sve neuspjehe"
- "Dodaj testove rubnih slučajeva za funkciju provjere valjanosti"
Generiranje testova slijedi konvencije projekta i obrasce testnih okvira koji su već u upotrebi.
Upravljanje kontekstom i konfiguracija
Učinkovitost Claude Codea uvelike ovisi o kontekstu pruženom o projektu.
AGENTS.md Standard
Najučinkovitiji način za pružanje trajnog konteksta je putem AGENTS.md datoteke u korijenu projekta. Ova datoteka služi kao univerzalni standard za upućivanje AI kodnih agenata o strukturi projekta, konvencijama i zahtjevima.
Osnovni AGENTS.md bi mogao uključivati:
- Pregled i arhitektura projekta
- Konvencije kodiranja i stilovi
- Zahtjevi i obrasci testiranja
- Procesi izrade (build) i implementacije (deployment)
- Struktura organizacije datoteka
Claude Code automatski čita i integrira sadržaj AGENTS.md prilikom pokretanja sesija u tom direktoriju.
Kuke (Hooks) za automatizaciju
Kuke omogućuju automatsko izvršavanje naredbi ljuske kada se dogode određeni događaji. Prema službenoj dokumentaciji, Claude Code podržava više događaja kuka, uključujući SessionStart, UserPromptSubmit, PreToolUse, PostToolUse i Notification.
Kuke se konfiguriraju u JSON datoteci koja određuje koje se naredbe izvršavaju za koje događaje. Na primjer, kuka PostToolUse može automatski pokrenuti testove nakon što Claude Code izmijeni datoteke, ili formatirati kod prema standardima projekta.
Zadano vrijeme čekanja za kuke je 10 minuta, iako se to može konfigurirati po kuki. Kuke mogu raditi sinkrono (blokirajući Claude Code do završetka) ili asinkrono (radeći u pozadini).
Pravila pokazivača (Cursor Rules) i alternativni formati
Za projekte koji koriste Cursor ili druge AI kodne alate uz Claude Code, format datoteke .cursorrules pruža alternativu AGENTS.md. Dok je AGENTS.md univerzalni standard, Cursor pravila nude čvršću integraciju s Cursor značajkama specifičnim za Cursor.
Projekti mogu održavati obje datoteke. Claude Code daje prednost AGENTS.md, ali uvažava i druge konfiguracijske formate kada su prisutni.
Praktični savjeti za učinkovitu upotrebu
Stvarna upotreba otkriva obrasce koji značajno poboljšavaju učinkovitost Claude Codea.
Budite precizni s uputama
Nejasne naredbe daju nejasne rezultate. Umjesto "poboljšaj ovaj kod", precizirajte što poboljšanje znači: "refaktura ove funkcije radi smanjenja ciklomatske složenosti" ili "optimiziraj ovaj upit baze podataka radi smanjenja vremena izvršavanja".
Iskoristite kontekst projekta u potpunosti
Prilikom davanja uputa, referencirajte specifične datoteke, funkcije ili obrasce. Claude Code razumije kontekst poput "slijedeći obrazac u UserController" ili "u skladu sa stilom naših postojećih API rukovatelja".
Pregledajte izmjene prije prihvaćanja
Claude Code je moćan, ali ne i nepogrešiv. Uvijek pregledajte predložene izmjene u pregledu razlika (diff preview). Pazite na nenamjerne popratne učinke, osobito kod refaktura koje utječu na više datoteka.
Iskoristite sigurnosne mreže Gita
Spremite radni kod prije većih operacija s Claude Codeom. Ako izmjene krenu po zlu, Git pruža jednostavan put za povratak. Ova sigurnosna mreža potiče eksperimentiranje s ambicioznijim zadacima.
Pokrenite sesije s jasnim ciljevima
Početak sesije s eksplicitnim ciljevima pomaže Claude Codeu da održi fokus. "Dodajemo autentifikaciju korisnika" ili "Otklanjamo pogrešku u procesu obrade plaćanja" postavlja kontekst za naknadne naredbe.
Uobičajeni problemi i rješavanje problema
Unatoč ispravnom postavljanju, povremeno se javljaju problemi.
Pogreške s dopuštenjima
Nikada ne pokrećite Claude Code s sudo ili povišenim dopuštenjima. To stvara sigurnosne ranjivosti i probleme s vlasništvom datoteka. Ako se pojave pogreške s dopuštenjima, provjerite dopuštenja datoteka u direktoriju projekta i uvjerite se da trenutni korisnik ima odgovarajući pristup.
Problemi s API vezom
Neuspjesi veze obično ukazuju na mrežne probleme ili nevažeće API vjerodajnice. Provjerite valjanost API ključa putem Anthropic Console. Provjerite ne blokiraju li vatrozidi ili VPN-ovi API zahtjeve.
Neočekivano ponašanje u Windows WSL2
Problemi s putanjama često se javljaju pri miješanju Windows i Linux putanja u WSL2. Zadržite projekte unutar Linux datotečnog sustava (/home/korisnik/) umjesto pristupa Windows diskovima (/mnt/c/). Ovo poboljšava performanse i izbjegava probleme s prijevodom putanja.
Gubitak konteksta tijekom dugih sesija
Produžene sesije mogu dosegnuti granice konteksta, uzrokujući da Claude Code zaboravi raniji razgovor. Kada se to dogodi, pokrenite novu sesiju ili pružite eksplicitne podsjetnike o ciljevima projekta i nedavnim promjenama.
Napredne značajke vrijedne istraživanja
Nakon svladavanja osnova, nekoliko naprednih značajki otključava dodatne mogućnosti.
Prilagođene naredbe
Projekti mogu definirati prilagođene naredbe u direktoriju .claude/commands. Te naredbe proširuju Claude Code radnim procesima specifičnim za projekt, poput "@deploy.md staging" ili "@benchmark.md performance".
Naredbe se pišu u markdownu s posebnom sintaksom za argumente i umetanje konteksta. Vještina razvoja naredbi u službenim dodacima Claude Codea pruža predloške i primjere.
Timovi agenata
Za složene operacije, Claude Code može koordinirati više specijaliziranih agenata koji rade zajedno. Jedan agent može upravljati promjenama na pozadinskoj strani, dok drugi ažurira komponente na korisničkom sučelju, a treći upravlja migracijama baze podataka.
Timovi agenata zahtijevaju konfiguraciju, ali omogućuju paralelni rad na velikim značajkama ili projektima refakture.
Često postavljana pitanja
Radi li Claude Code izvan mreže?
Ne, Claude Code zahtijeva aktivnu internetsku vezu za komunikaciju s Anthropicovim API-jem. Sva obrada odvija se na strani poslužitelja, a ne lokalno. Alat ne može funkcionirati bez API pristupa.
Koliko košta korištenje Claude Codea?
Claude Code radi na principu plaćanja po korištenju po tokenu. Cijene variraju ovisno o modelu – Ostavite kako jest – provjereno u službenom izvornom materijalu koji navodi ove točne cjenovne razine. Stvarni troškovi ovise o obrascima korištenja i odabranom modelu. Minimalni iznos na računu je 5 USD.
Može li Claude Code slučajno oštetiti moju bazu kodova?
Claude Code traži potvrdu prije izmjene datoteka. U kombinaciji s Git kontrolom verzija, rizik je minimalan. Uvijek spremajte radni kod prije velikih operacija i pregledajte izmjene u pregledu razlika (diff preview) prije njihovog prihvaćanja.
Radi li Claude Code sa svim programskim jezicima?
Claude Code podržava gotovo sve glavne programske jezike uključujući JavaScript, Python, TypeScript, Java, Go, Rust, C++ i mnoge druge. Podrška za jezik ovisi o obuci temeljnog Claude modela, koja uključuje opsežne podatke o kodu na različitim jezicima.
Mogu li više programera koristiti Claude Code na istom projektu istovremeno?
Da, ali koordinacija putem Gita je ključna. Svaki programer pokreće vlastitu sesiju Claude Codea s vlastitim API ključem. Promjene bi trebalo spremiti i sinkronizirati putem Gita, baš kao i ručno kodiranje. Claude Code nema ugrađene značajke suradnje izvan standardnih Git radnih procesa.
Koja je razlika između Claude Codea i GitHub Copilota?
GitHub Copilot integrira se u uređivače koda i pruža prijedloge u stvarnom vremenu tijekom tipkanja. Claude Code radi u terminalu i poduzima autonomne radnje na zadacima koji obuhvaćaju više datoteka. Copilot je bolji za dovršavanje red po red; Claude Code izvrsno izvršava potpune radne procese poput refakture, otklanjanja pogrešaka ili implementacije značajki u više datoteka.
Kako ažurirati Claude Code na najnoviju verziju?
Za npm instalacije (ako su korištene), ažurirajte putem npm-a ili koristite preporučene metode instalacije. Za Homebrew instalacije, pokrenite: brew upgrade claude-code. Trenutnu verziju možete provjeriti u bilo kojem trenutku naredbom claude --version.
Daljnji koraci s Claude Codeom
Početak rada s Claude Codeom uključuje jednostavnu instalaciju, autentifikaciju i učenje osnovnih obrazaca naredbi. Prava snaga alata proizlazi iz dosljedne upotrebe i pravilnog upravljanja kontekstom.
Započnite s jednostavnim zadacima – popravci grešaka, ažuriranje dokumentacije ili refaktura jedne datoteke. Kako se udobnost povećava, prihvatite ambicioznije radne procese poput implementacije značajki ili arhitektonskih promjena. Krivulja učenja je blaga jer naredbe na prirodnom jeziku smanjuju potrebu za pamćenjem sintakse.
Konfigurirajte AGENTS.md datoteke za često korištene projekte. Ova investicija donosi prednosti poboljšanim razumijevanjem Claude Codea i relevantnijim prijedlozima.
Najvažnije, tretirajte Claude Code kao alat za suradnju, a ne kao zamjenu za programerski sud. Kritički pregledavajte njegove prijedloge, dajte jasne upute i održavajte Git sigurnosne mreže. Pravilno korišten, Claude Code ubrzava razvoj bez žrtvovanja kvalitete koda.
Spremni transformirati svoj terminalski radni proces? Instalirajte Claude Code danas i iskusite razvoj uz pomoć AI koji se doista integrira s načinom na koji programeri rade. Posjetite službenu dokumentaciju na docs.anthropic.com za detaljne referentne materijale i napredne opcije konfiguracije.
