Kako namestiti Claude Code z uradnega spletnega mesta

Kaj je Claude Code in zakaj deluje v terminalu?#

Terminal prestraši skoraj vsakogar, ki se brez ozadja v razvoju programske opreme loti vibe codinga. Videti je kot črno okno iz hekerskih filmov, v resnici pa je le vrstica, v katero vnašate ukaze. Claude Code ga potrebuje prav zato, da lahko odpre vaše datoteke, jih spreminja in sam izvaja preverjanja, medtem ko mu z besedami opisujete nalogo.

Anthropic izdelek opisuje takole.

Razlika v primerjavi z običajnim klepetom je preprosta. V brskalniku ročno kopirate kodo sem in tja med oknom in urejevalnikom. Claude Code sam odpre mapo projekta, prebere potrebne datoteke, izvede spremembo in vam pokaže, kaj je spremenil. Vi še vedno odločate in odobrite spremembe; orodje namesto vas opravi mehansko delo.

Če terminala res ne želite uporabljati, Anthropic ponuja namizno aplikacijo z običajnim oknom in spletno različico na naslovu claude.ai/code, ki deluje neposredno v brskalniku. Najzmogljivejša in najbolj prilagodljiva možnost pa je različica za terminal, o kateri govori celoten članek.

Kje je uradno spletno mesto Claude Code in kaj prenesti?#

Začetniki se najprej pogosto sprašujejo, kje je uradno spletno mesto Claude Code in kaj klikniti za prenos. Tukaj je tabela vseh uradnih naslovov Anthropic, da vam ne bo treba ugibati.

Namestitvenega programa ne prenesete s spletnega mesta tako kot pri običajnem programu, kar je v nasprotju s pričakovanji ljudi. Namestite ga z ukazom v terminalu, ki nato prenese pravo različico za vaš sistem. Ta članek vsebuje natančne ukaze za Mac, Windows in Linux.

Pogosta past je ime: ljudje ga pogosto napačno napišejo kot clode code, clade code, слод код ali clode design. Ime izdelka je Claude Code, z au. To ime upoštevajte, ko iščete uradno spletno mesto: domene s podobnim zapisom pripadajo nekomu drugemu.

Dobro je poznati tudi natančno ime paketa npm. Kanonični paket je @anthropic-ai/claude-code, s predpono @anthropic-ai/. Anthropic ima tudi kratko ime claude-code brez predpone – to je njihova uradna povezava do istega paketa. Preprosto pravilo: izdajatelj mora biti Anthropic, ime za namestitev pa mora vsebovati predpono.

Kaj potrebujete za namestitev: zahteve za računalnik#

Zahteve za Claude Code so skromne: večino dela opravijo Anthropicovi strežniki; vaš računalnik pošilja le zahteve in prejema odgovore.

Posebna opomba o Node.js, saj je okoli njega največ mitov. Izvirni namestitveni program – ki ga priporoča sam Anthropic – Node.js sploh ne potrebuje: namesti se kot ena samostojna datoteka. Node.js potrebujete samo, če Claude Code namestite prek npm; v tem primeru potrebujete različico 22 ali novejšo. V starejših člankih piše »Node 18 ali novejši« – to je zastarelo; upoštevajte različico 22+.

Za glavno različico potrebujete terminal. Če ga ne želite uporabljati, namestite namizno aplikacijo z običajnim oknom ali uporabite spletno različico na naslovu claude.ai/code. Različica za terminal ima še vedno več funkcij, zato preostanek članka pojasnjuje njeno namestitev.

Namestitev Claude Code je kot orodje, ki ga vzamete v roke. Sam zase pa pogosto halucinira: pozabi na vaš projekt, si izmišlja stvari in sredi naloge izgubi nit. Zanesljivost zagotavlja kombinacija treh stvari: AI-klon, Second Brain in inženirstvo konteksta. To so trije stebri, ki preprečujejo, da bi AI haluciniral.

Kako namestite Claude Code v sistem macOS?#

Odprite Terminal (na voljo je v vsakem Macu: v Spotlightu pritisnite Cmd+Space in vnesite »Terminal«) ter prilepite to vrstico:

curl -fsSL https://claude.ai/install.sh | bash

Ukaz prenese namestitveni program z uradnega naslova Anthropic in namesti Claude Code. Node.js ni potreben. Izvirni način je priročen tudi zaradi posodobitev.

Če že uporabljate Homebrew, je na voljo še druga možnost:

brew install --cask claude-code

Razlikujeta se v načinu posodabljanja: izvirni namestitveni program se posodablja sam, Homebrew pa ne – posodobiti ga morate ročno z ukazom brew upgrade claude-code. Sam program je enak, zato izberite način, ki ste ga vajeni. Če niste prepričani, uporabite prvega.

Kako namestite Claude Code v sistem Windows?#

Najprej ugotovite, kje ste. Windows ima dve lupini in vsaka ima svoj ukaz. Odprite okno in si oglejte začetek poziva: PS C:\> pomeni PowerShell, medtem ko C:\> brez PS pomeni ukazni poziv (CMD).

Za PowerShell (najlažje ga odprete tako, da z desno tipko kliknete gumb Start in izberete »Terminal«):

irm https://claude.ai/install.ps1 | iex

Za ukazni poziv (CMD):

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

Tretja možnost je uporaba vgrajenega upravljalnika paketov WinGet:

winget install Anthropic.ClaudeCode

Če že imate delujoče okolje WSL (Linux v sistemu Windows), namestite Claude Code neposredno v WSL z istim ukazom kot v Linuxu. WSL ima posebnost glede Nodea, ki jo bom obravnaval spodaj v razdelku o pogostih napakah.

Kako namestite Claude Code v sistem Linux?#

Osnovni način za vse priljubljene distribucije je isti samostojni namestitveni program:

curl -fsSL https://claude.ai/install.sh | bash

Node.js ni potreben; program je na voljo kot ena datoteka in se nato sam posodablja.

Če ste navajeni nameščati programe samo prek sistemskega upravljalnika paketov, lahko dodate uradne Anthropicove repozitorije: apt za Debian in Ubuntu, dnf za Fedoro in RHEL ter apk za Alpine. Podpisani so s ključem ter ponujajo kanala stable in latest. Za začetnika je to odveč, zato podrobnosti prepuščam dokumentaciji v razdelku z viri in privzeto priporočam zgornji ukaz.

Na poceni strežnikih lahko pride do ene težave. Če ima računalnik zelo malo prostega pomnilnika, se lahko namestitev ustavi z besedo Killed (koda 137) – sistem je ustavil proces, ker mu je zmanjkalo pomnilnika. Rešitev je dodati datoteko swap: Claude Code za namestitev potrebuje približno 512 MB prostega pomnilnika.

Kako prvič zaženete Claude Code?#

Prvi zagon traja nekaj minut. Postopek je takšen.

1. Odprite mapo projekta

   V terminalu z ukazom cd path-to-project odprite mapo, v kateri želite delati, nato vnesite claude.

2. Prijavite se v svoj račun

   Odprlo se bo okno za prijavo v brskalniku. Če se ne odpre samodejno, pritisnite c, da kopirate povezavo, in jo ročno prilepite v brskalnik. Če brskalnik prikaže kodo (to se lahko zgodi v WSL in na oddaljenih strežnikih), jo prilepite nazaj v terminal.

3. Počakajte na potrditev

   Ko se prijavite, bo terminal prikazal Login successful in vas pozval, da pritisnete Enter.

4. Zastavite prvo vprašanje

   Vprašajte nekaj preprostega o projektu, na primer »kaj počne ta projekt?« Claude bo prebral datoteke in odgovoril.

5. Odobrite prvo spremembo

   Ko ga prosite, naj kaj spremeni, vam bo Claude pokazal predlagane spremembe in zahteval potrditev. Načine dostopa lahko preklopite z Shift+Tab.

Vredno se je takoj naučiti nekaj osnovnih ukazov v seji: /help prikaže seznam ukazov, /clear počisti zgodovino pogovora, /exit pa konča sejo (enako naredi dvakratni pritisk Ctrl+D). Claude vam bo vse to prikazal sam, če vnesete /help.

Prijava z naročnino ali ključem API: kaj izbrati?#

To je prvo vprašanje, ki se pojavi ob prijavi.

Prijavite se lahko na dva načina, ki se razlikujeta po načinu plačila.

Za prijavo z naročnino preprosto uporabite svoj račun Claude.ai. Za prijavo s ključem API pridobite ključ v Claude Console (platform.claude.com); stroški se med uporabo odštevajo od vašega vnaprej plačanega dobroimetja. Ključ nastavite v okoljski spremenljivki ANTHROPIC_API_KEY, pa Claude Code ne bo vsakič odprl brskalnika.

V seji lahko račune zamenjate z ukazom /login in se odjavite z /logout.

Toda Claude Code se brez plačljivega dostopa ne bo zagnal. Če računa še nimate, najprej ugotovite, kateri e-poštni naslov uporabiti za registracijo: pozneje ga ne morete spremeniti.

Kako preverite, ali je bila namestitev uspešna?#

Že na začetku velja poznati tri ukaze.

Prvi preveri različico:

claude --version

Delujoča namestitev vrne številko v obliki X.Y.Z (Claude Code). Natančne številke se spreminjajo od različice do različice; pomembno je, da ukaz sploh vrne številko različice. Odgovor »command not found« pomeni nekaj drugega – o tem bo govora v naslednjem razdelku.

Drugi je namenjen diagnostiki, ko gre kaj narobe.

Tretji je /status v seji: pokaže, kako ste se prijavili, kateri e-poštni naslov ali organizacija sta povezana z računom in ali je vaš dostop potekel. Ukaz claude update pa takoj namesti najnovejšo posodobitev, namesto da bi čakal na posodobitev v ozadju.

Zakaj po namestitvi ukaza claude ni mogoče najti?#

To je najpogostejša pritožba začetnikov in zveni huje, kot je v resnici. Terminal ne išče ukazov po celotnem računalniku; preverja le mape v PATH. Claude Code se namesti na mesto ~/.local/bin/claude (v Macu in Linuxu) ali %USERPROFILE%\\.local\\bin\\claude.exe (v Windowsu). Če te mape ni v PATH, terminal programa preprosto ne vidi.

V Macu in Linuxu dodajte mapo na seznam. Odprite datoteko z nastavitvami lupine (~/.zshrc za Zsh, ~/.bashrc za Bash) in na konec dodajte to vrstico:

export PATH="$HOME/.local/bin:$PATH"

Nato zaprite terminal in ga znova odprite (ali zaženite source ~/.zshrc). Ukaz claude bo zatem najden.

Pogoste napake pri namestitvi in prvem zagonu#

Oglejmo si jih po vrsti; vse so povzete po Anthropicovem uradnem vodniku za odpravljanje težav.

1. Stara različica Node pri namestitvi prek npm. Paket @anthropic-ai/claude-code zahteva Node.js 22 ali novejši. V Windowsu lahko npm spodleti s sporočilom o onemogočenih skriptih – pravilnik PowerShella blokira njihovo izvajanje. V WSL je pogosta napaka exec: node: not found: WSL uporablja Windows Node namesto Linux Node. Če imate težave z npm, preklopite na izvirni namestitveni program; ta ne potrebuje Node.
2. Napačen namestitveni program za lupino. 'irm' is not recognized pomeni, da ste ukaz PowerShell prilepili v ukazni poziv. The token '&&' is not a valid statement separator pomeni, da ste storili nasprotno in ukaz CMD zagnali v PowerShellu. A parameter cannot be found that matches parameter name 'fsSL' pomeni, da ste ukaz za Mac/Linux zagnali v PowerShellu. Preverite začetek poziva: PS C:\ pomeni PowerShell, C:\ pa CMD.
3. Star ključ API preglasi naročnino. Če je vaša naročnina aktivna, vendar je v okolju še vedno nastavljen star ključ, boste videli API Error: 400 ... This organization has been disabled. Ključ ima prednost pred prijavo z naročnino. Odstranite ga z ukazom unset ANTHROPIC_API_KEY (v PowerShellu uporabite Remove-Item Env:ANTHROPIC_API_KEY), preverite datoteki ~/.zshrc in ~/.bashrc, nato vnesite /status.
4. Premalo pomnilnika na šibkem strežniku. Namestitev se ustavi z besedo Killed in kodo 137 – to pomeni, da ni dovolj RAM-a. Potrebujete približno 512 MB prostega prostora; dodajanje swap-a odpravi težavo.
5. Namestitveni program je vrnil nekaj drugega. Napaka syntax error near unexpected token '<' ali sklic na <!DOCTYPE html> pomeni, da je namestitveni URL namesto namestitvenega skripta vrnil spletno stran – navadno zaradi vaše regije, korporativnega požarnega zidu ali začasnega izpada. Poskusite z drugo metodo (Homebrew, WinGet) ali znova čez nekaj minut.

Pri vseh teh napakah začnite enako: zaženite claude doctor. Pokazal bo, kaj ne deluje, in predlagal, kje iskati težavo.

Pri diagnostiki upoštevajte še to: samostojna napaka 403 med namestitvijo lahko izvira tudi iz korporativnega požarnega zidu ali posredniškega strežnika. Če ste torej v pisarniškem omrežju, najprej preverite, ali blokira dostop.

Kaj storiti po namestitvi: prvi koraki#

Namestitev je šele začetek. Pravo delo se začne zatem, prva stvar, na katero naletijo ljudje, pa je spomin. Jezikovni model se vas med pogovori ne spomni: v novem klepetu ve le tisto, kar ste vključili v njegov kontekst.

Prvi zares pomemben korak po namestitvi je zato ustvariti datoteko CLAUDE.md v korenski mapi projekta. To je besedilna datoteka s pravili in kontekstom projekta, ki jo Claude Code prebere ob vsakem zagonu. Enkrat opišite, kaj počnete, kako je projekt organiziran in kaj je pomembno – tega vam ne bo treba ponavljati v vsakem pogovoru.

V ločenem vodniku pokažem, kako pripraviti to datoteko in prilagoditi Claude: kako prilagoditi Claude. Pripravil sem tudi splošni pregled orodij za vibe coding za leto 2026.

Kaj še sprašujejo uporabniki?#

Celoten okvir za vibe coding: AI-klon + Second Brain + inženirstvo konteksta.