Kratek povzetek: Claude Code CLI se namesti z enim ukazom, ki samodejno prenese in konfigurira orodje. Na macOS in Linux uporabite uradni skript lupine iz dokumentacije Anthropic, medtem ko uporabniki Windows izvedejo ukaze PowerShell ali WSL. Po namestitvi se potrdite s svojim API ključem, da začnete uporabljati Claudeov AI pomočnik za kodiranje v svojem terminalu.
Claude Code je agencijsko orodje za kodiranje, ki deluje v vašem terminalu in razume celotno kodo vašega projekta. Po uradni dokumentaciji Claude Code lahko bere datoteke, izvaja ukaze, ureja kodo in se integrira z razvojnimi orodji preko pogovorov v naravnem jeziku.
Vendar pa je za začetek potrebna pravilna namestitev. Tukaj je vse, kar potrebujete za namestitev Claude Code CLI in njegovo pravilno konfiguracijo.
Sistemske zahteve pred namestitvijo
Preden namestite Claude Code, preverite, ali sistem izpolnjuje osnovne zahteve. Po uradni dokumentaciji za napredno namestitev odstranite to stavko v celoti.
Preverite namestitev Node.js z odpiranjem terminala in zagonom:
| node –version |
Če Node.js ni nameščen ali je različica nižja od 18, ga prenesite z uradne spletne strani Node.js. Različica za dolgoročno podporo (LTS) odlično deluje za Claude Code.
Poleg Node.js sistem potrebuje osnovne zahteve: macOS 13.0 ali novejši za uporabnike Mac, Windows 10 ali novejši za sisteme Windows, večina sodobnih distribucij Linux pa deluje brez težav. Za avtentikacijo po namestitvi je potreben tudi račun Claude pri Anthropic.
Namestitev Claude Code na macOS in Linux
Postopek namestitve za macOS in Linux uporablja en sam ukaz lupine, ki samodejno skrbi za vse. Ta metoda je dokumentirana v uradniku vodniku za hitro namestitev Claude Code.
Odprite Terminal in zaženite namestitveni skript:
| curl -fsSL claude.ai/install.sh | bash |
Skript prenese binarno datoteko Claude Code, jo postavi v ustrezen imenik in samodejno konfigurira PATH. Celoten postopek se običajno zaključi v manj kot minuti.
Za uporabnike macOS, ki imajo raje Homebrew, obstaja alternativna metoda namestitve, čeprav ni uradno dokumentirana v primarnih virih. Metoda curl ostaja priporočeni pristop glede na uradno dokumentacijo.
Preverjanje namestitve
Ko je namestitev končana, preverite, ali je Claude Code dostopen:
| claude –version |
Ta ukaz bi moral prikazati nameščeno številko različice. Če se prikaže napaka z sporočilom "command not found", je treba konfiguracijo PATH prilagoditi.
Po uradni dokumentaciji za odpravljanje težav so težave s PATH najpogostejši problem pri namestitvi. Rešitev vključuje dodajanje imenika za namestitev Claude v datoteko konfiguracije lupine.
Namestitev Claude Code na macOS in Linux
Postopek namestitve za macOS in Linux se zanaša na npm (Node Package Manager). Po uradni dokumentaciji morate imeti nameščen Node.js 18+ v svojem sistemu, preden nadaljujete. Za razliko od tradicionalnih CLI orodij, ki uporabljajo skripte lupine, se Claude Code globalno namesti preko vašega terminala, da se zagotovi pravilno obravnavanje vseh odvisnosti.
Odprite svoj Terminal in zaženite naslednji ukaz za namestitev paketa:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Opomba: Trenutno je okoljska spremenljivka CLAUDE_CODE_RELEASE_ALPHA=1 potrebna med javno beta/alfa fazo za priznanje predoglednega statusa orodja.
Ta ukaz prenese paket iz uradnega repozitorija npm in poveže izvedljivo datoteko claude z globalnim imenikom bin na vašem sistemu. Medtem ko nekateri uporabniki morda poskušajo najti Homebrew formule, je metoda npm edina uradno podprta in dokumentirana pot namestitve.
Preverjanje namestitve
Ko se namestitev konča, preverite, ali je CLI pravilno preslikan v vaše okolje z zagonom:
| claude –version |
Ta ukaz bi moral prikazati trenutno številko različice (npr. 0.2.9). Če naletite na napako "command not found", to običajno pomeni, da globalni imenik npm ni v sistemski poti (PATH).
Po uradni dokumentaciji za odpravljanje težav lahko to popravite tako, da identificirate svoj npm prefix z npm config get prefix in zagotovite, da je dobljena mapa /bin dodana v vaši datoteki .zshrc ali .bashrc.
Namestitev Claude Code na Windows
Namestitev za Windows ponuja dva glavna pristopa: izvorna namestitev PowerShell ali uporaba Windows Subsystem for Linux (WSL). Uradna dokumentacija priporoča PowerShell za večino uporabnikov.
Metoda namestitve PowerShell
Odprite PowerShell kot skrbnik (z desno miškino tipko kliknite meni Start in izberite "Windows PowerShell (Admin)"). Zaženite ta ukaz:
| irm claude.ai/install.ps1 | iex |
Skript PowerShell samodejno poskrbi za prenos, namestitev in konfiguracijo PATH. Po zaključku zaprite in ponovno odprite PowerShell, da zagotovite, da se posodobitve PATH uveljavijo.
Metoda namestitve WSL
Razvijalci, ki že uporabljajo WSL, lahko namestijo Claude Code z uporabo metode za Linux. Odprite terminal WSL in zaženite isti ukaz curl, ki se uporablja za Linux:
| curl -fsSL claude.ai/install.sh | bash |
Pristop WSL deluje enako kot izvorne namestitve v Linuxu. Ena prednost: WSL zagotavlja okolje, ki je bolj podobno Unixu in se ujema s konfiguracijami produkcijskih strežnikov.
Po uradni dokumentaciji za odpravljanje težav uporabniki WSL občasno naletijo na težave z omrežno povezljivostjo. Če se namestitev ustavi, preverite, ali ima WSL dostop do zunanjih omrežij in ali pravila požarnega zidu ne blokirajo prometa.
Poiščite dobroimetja za Claude in AI orodja na enem mestu
Namestitev Claude Code CLI je en korak. Dolgoročno plačevanje za AI orodja je drug. Get AI Perks na enem mestu združuje zagonska dobroimetja in popuste na programske opreme za AI in oblačna orodja. Omogoča ustanoviteljem dostop do več kot 200 ugodnosti, vključno s ponudbami podjetij Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom in drugih. Platforma prikazuje tudi pogoje ugodnosti in vodnike za uveljavljanje vsake ponudbe.
Iščete dobroimetja za Claude ali Anthropic?
Preverite Get AI Perks, da:
- poiščete dobroimetja in popuste za AI orodja na enem mestu
- pregledate pogoje ugodnosti pred prijavo
- dostopite do vodnikov za uveljavljanje zagonskih ponudb
👉 Obiščite Get AI Perks, da si ogledate razpoložljive ugodnosti za Claude, Anthropic in drugo programsko opremo AI.
Avtentikacija in začetna konfiguracija
Po namestitvi Claude Code zahteva avtentikacijo, preden lahko deluje. Orodje uporablja API ključe iz Anthropic za preverjanje dostopa.
Začnite postopek avtentikacije z zagonom:
| claude |
Prvič, ko se ta ukaz zažene, vas Claude Code pozove k avtentikaciji. Po uradnem vodniku za hitro namestitev se odpre okno brskalnika za prijavo v račun Anthropic.
Po prijavi preko brskalnika CLI samodejno prejme avtentikacijski žeton. Ta žeton se shrani lokalno in ostane veljaven med sejami, zato ponavljajoča se avtentikacija ni potrebna.
Konfiguracija nastavitev na ravni projekta
Claude Code podpira konfiguracijo na več ravneh po uradni dokumentaciji o nastavitvah. Najpogostejše ravni konfiguracije so:
| Področje | Lokacija | Uporaba |
|---|---|---|
| Uporabnik | ~/.claude/ imenik | Osebne nastavitve za vse projekte |
| Projekt | .claude/ v repozitoriju | Skupna konfiguracija ekipe |
| Lokalno | .claude/settings.local.json | Prevozi, specifični za napravo |
Za prvo nastavitev je dovolj konfiguracija na ravni uporabnika. Nastavitve na ravni projekta postanejo pomembne pri delu z ekipami, ki delijo standarde kodiranja.
Začetek vaše prve seje Claude Code
Ko sta namestitev in avtentikacija končani, zaženite Claude Code z zagonom ukaza brez argumentov:
| claude |
To zažene interaktivni način, kjer Claude odgovarja na zahteve v naravnem jeziku. Uradna dokumentacija opisuje interaktivni način kot primarni način uporabe Claude Code za razvojna opravila.
Poskusite preprost testni ukaz:
| Show me the structure of this project |
Claude Code analizira trenutni imenik in zagotovi pregled strukture kode projekta. To pokaže, da namestitev deluje pravilno in da ima Claude dostop do branja datotek.
Ključni ukazi za vsakodnevno uporabo
Poleg interaktivnega načina Claude Code podpira več vzorcev ukazov, dokumentiranih v referenci CLI:
| Vzorec ukaza | Namen | Primer |
|---|---|---|
| claude | Zaženi interaktivno sejo | claude |
| claude “naloga” | Izvedi enkratno nalogo | claude “popravi linting napake” |
| claude -p “poizvedba” | Hitra poizvedba brez seje | claude -p “kaj počne ta funkcija” |
Vzorec enkratne naloge je še posebej uporaben za CI/CD cevovode in skripte za avtomatizacijo, kjer interaktivna seja ni primerna.
Pogoste težave pri namestitvi
Tudi z avtomatiziranimi skripti za namestitev se občasno pojavijo težave. Uradna dokumentacija za odpravljanje težav pokriva najpogostejše probleme.
Napake "Command Not Found"
Če terminal po namestitvi prikaže "command not found: claude", konfiguracija PATH ni bila pravilno izvedena. Za macOS in Linux dodajte lokacijo binarne datoteke Claude v datoteko konfiguracije lupine ročno.
Za uporabnike bash uredite ~/.bashrc ali ~/.bash_profile in dodajte:
| export PATH=”$HOME/.local/bin:$PATH” |
Za uporabnike zsh (privzeto na sodobnih macOS) uredite ~/.zshrc z isto vrstico. Po shranjevanju ponovno naložite konfiguracijo z source ~/.zshrc ali odprite novo okno terminala.
Težave z omrežjem in požarnim zidom
Korporativna omrežja in omejevalni požarni zidovi včasih blokirajo namestitveni skript. Po dokumentaciji za odpravljanje težav, če se namestitev ustavi ali vrne HTML namesto izvajanja, je morda dostop do strežnikov Anthropic blokiran.
Obhodna rešitev vključuje ločeno prenašanje namestitvenega skripta:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Ta pristop omogoča večjo preglednost nad tem, kaj se je pokvarilo, če med prenosom ali izvajanjem pride do napak.
Težave, specifične za WSL
Uporabniki Windows, ki uporabljajo WSL, občasno naletijo na težave s povezljivostjo med podrazdelkom Linux in Windows. Uradna dokumentacija omenja, da je morda treba prilagoditi pravila požarnega zidu, da se omogoči promet WSL.
Če se Claude Code uspešno namesti, vendar ne more doseči strežnikov Anthropic za avtentikacijo, preverite, ali požarni zid Windows dovoljuje dostop do omrežja WSL. Vodnik za odpravljanje težav ponuja specifične ukaze PowerShell za konfiguracijo pravil požarnega zidu.
Posodabljanje Claude Code
Claude Code prejema redne posodobitve z novimi funkcijami in izboljšavami. Po uradni dokumentaciji se posodobitve namestijo z istim ukazom kot začetna namestitev.
Ponovno zaženite namestitveni skript:
| curl -fsSL code.anthropic.com/install.sh | sh |
Skript zazna obstoječo namestitev in jo nadgradi na najnovejšo različico. Med postopkom posodobitve se ne izgubi nobena konfiguracija ali avtentikacija.
Pred posodobitvijo in po njej preverite trenutno različico:
| claude –version |
Dnevnik sprememb v uradni dokumentaciji Claude Code navaja vse spremembe med različicami, kar pomaga določiti, ali posodobitev uvaja funkcije, pomembne za določene delovne tokove.
Naslednji koraki po namestitvi
Ko je Claude Code nameščen in deluje, postane raziskovanje naprednih funkcij možno. Uradna dokumentacija opisuje več področij, ki jih je vredno raziskati:
- Sposobnosti in prilagajanje: Po uradni dokumentaciji o sposobnostih Claude Code podpira sposobnosti, definirane v datotekah Markdown v imeniku .claude/skills/. Te sposobnosti razširjajo zmožnosti Claude z ukazi in delovnimi tokovi, specifičnimi za projekt.
- Protokol konteksta modela (MCP): Integracija MCP omogoča Claude Code, da se poveže z zunanjimi orodji in storitvami. To spremeni Claude v središče, ki lahko dostopa do baz podatkov, API-jev in drugih razvojnih virov.
- Timsko sodelovanje: Konfiguracijske datoteke na ravni projekta v imeniku .claude/ se lahko prenesejo v nadzor različic, s čimer se nastavitve Claude Code delijo med celotnimi razvojnimi ekipami.
- Uradna dokumentacija ponuja podrobne vodnike za vsako od teh področij, ki nadgrajujejo osnovno namestitev, obravnavano tukaj.
Pogosto zastavljena vprašanja
Ali potrebujem plačljivo naročnino na Claude za uporabo Claude Code CLI?
Claude Code zahteva račun Claude pri Anthropic, vendarstopnja naročnine, ki je potrebna, odvisno od uporabe. Po uradni dokumentaciji je avtentikacija potrebna, vendar je treba podrobnosti o cenah preveriti na uradni spletni strani Anthropic, saj se načrti sčasoma spreminjajo.
Ali lahko namestim Claude Code brez administratorskih pravic?
Na macOS in Linux se Claude Code privzeto namesti v domačo mapo uporabnika in ne zahteva administratorskega dostopa. Uporabniki Windows morda potrebujejo administratorske pravice za metodo namestitve PowerShell, čeprav namestitve WSL ne zahtevajo skrbniškega dostopa.
Ali Claude Code deluje brez povezave?
Ne. Claude Code je orodje, ki ga poganja AI in komunicira s strežniki Anthropic za obdelavo zahtev. Po uradni dokumentaciji je aktivna internetna povezava potrebna, da lahko Claude analizira kodo in ustvarja odgovore.
Kako odstranim Claude Code?
Uradna dokumentacija za napredno namestitev pojasnjuje, da odstranitev vključuje brisanje binarne datoteke in konfiguracijskih datotek. Na macOS in Linux izbrišite imenik ~/.claude in odstranite modifikacijo PATH iz datotek konfiguracije lupine. Uporabniki Windows naj odstranijo imenik za namestitev in počistijo spremenljivko okolja PATH.
Ali ima Claude Code dostop do celotnega mojega datotečnega sistema?
Privzeto Claude Code deluje znotraj trenutnega delovnega imenika in njegovih podimenikov. Po uradni dokumentaciji o dovoljenjih se dostop lahko dodatno omeji z uporabo nastavitev peskovnika v konfiguracijskih datotekah. Claude vedno zaprosi za potrditev pred izvajanjem potencialno uničujočih operacij.
Kakšna je razlika med Claude Code CLI in Claude Desktop?
Claude Code CLI deluje v terminalu in se osredotoča na razvojne delovne tokove z neposrednim dostopom do datotečnega sistema in izvajanjem ukazov. Claude Desktop je samostojna aplikacija z grafičnim vmesnikom. Obe orodji služita različnim primerom uporabe, pri čemer je CLI optimiziran za razvijalce, ki imajo raje delovne tokove v terminalu.
Kako pogosto naj posodabljam Claude Code?
Posodobitve je mogoče namestiti, kadar je to primerno. Uradni dnevnik sprememb dokumentira nove funkcije in popravke napak. Za ekipe usklajevanje posodobitev zagotavlja, da vsi uporabljajo združljive različice, čeprav Claude Code ohranja združljivost nazaj z konfiguracijskimi datotekami med različicami.
Zaključek
Namestitev Claude Code CLI traja le nekaj minut, ne glede na operacijski sistem. Avtomatizirani namestitveni skripti skrbijo za konfiguracijo, nastavitev PATH in postavitev binarne datoteke brez ročnega posredovanja.
Po namestitvi in avtentikaciji Claude Code postane zmogljiv AI pomočnik za kodiranje, dostopen iz katerega koli terminala. Ukazi v naravnem jeziku omogočajo razvijalcem, da pišejo kodo, popravljajo napake in avtomatizirajo naloge, ne da bi zapustili ukazno vrstico.
Ste pripravljeni izkusiti razvoj s pomočjo AI? Zaženite namestitveni ukaz za svojo platformo in začnite svojo prvo sejo Claude Code že danes. Uradna dokumentacija na code.claude.com ponuja obsežne vodnike za napredne funkcije, ko je osnovna nastavitev zaključena.
