Ključne ugotovitve
- Dve metodi namestitve: Uporabite native installer (
curl -fsSL https://claude.ai/install.sh | bash) za nastavitev brez odvisnosti ali npm (npm install -g @anthropic-ai/claude-code), če potrebujete fiksiranje različice. - Sistemske zahteve so minimalne: macOS 13+, Linux (Ubuntu 20.04+/Debian 10+) ali Windows 10+ z WSL. Vsaj 4GB RAM. GPU ni potreben.
- Potreben je račun: Potrebujete Claude Pro, Max, Teams, Enterprise ali Console (API) račun. Brezplačni načrt Claude.ai ne vključuje dostopa do Claude Code.
- Nastavitev traja manj kot pet minut: Namestite, se avtenticirajte v brskalniku in takoj začnite uporabljati Claude Code v katerem koli projektnem imeniku.
Kako namestiti Claude Code: Celoten vodnik za nastavitev (2026)
Claude Code je Anthropic AI pomočnik za kodiranje, ki deluje neposredno v vašem terminalu. Bere vašo kodno bazo, piše kodo, izvaja ukaze in upravlja kompleksna urejanja več datotek hkrati – vse to prek enotnega vmesnika ukazne vrstice (CLI).
Za razliko od AI orodij za klepet v brskalniku, Claude Code deluje znotraj vašega dejanskega razvojnega okolja. Vidi vašo strukturo datotek, razume kontekst projekta in uvaja spremembe v resničnih datotekah na vaši napravi.
Ta vodnik vas bo vodil skozi vsak korak namestitve Claude Code v letu 2026, od preverjanja predpogojev do izvajanja vaše prve seje kodiranja z uporabo AI. Ne glede na to, ali uporabljate macOS, Linux ali Windows, bo Claude Code deloval v manj kot petih minutah.
Kaj potrebujete (Seznam predpogojev)
Preden namestite Claude Code, preverite, ali imate naslednje:
- Operacijski sistem: macOS 13.0 (Ventura) ali novejši, Ubuntu 20.04+ ali Debian 10+ ali Windows 10 (različica 1809+) z WSL
- RAM: Vsaj 4GB (priporočeno 8GB za večje kodne baze)
- Internetna povezava: Claude Code se poveže z Anthropic cloud API, zato je potrebna aktivna povezava
- Anthropic račun: Claude Pro ($20/mesec), Claude Max ($100-200/mesec), Teams, Enterprise ali Console (API) račun
- Terminal: Bash, Zsh ali PowerShell
- Node.js 18+ (potrebno samo za metodo namestitve prek npm)
GPU ni potreben. Vsa AI obdelava poteka na strežnikih podjetja Anthropic. Vaša naprava mora le poganjati CLI odjemalca in pošiljati zahteve prek omrežja.
1. korak: Namestite Node.js (če ga še nimate)
Če nameravate uporabiti npm metodo namestitve, potrebujete Node.js 18 ali novejši. Če že imate nameščen Node.js, preverite svojo različico:
node --version
Če izpis prikazuje v18.0.0 ali več, pojdite na 2. korak. Če ne, namestite ali posodobite Node.js z uporabo nvm (Node Version Manager), kar je priporočljiv pristop, saj se izogne težavam z dovoljenji in vam omogoča enostavno preklapljanje med različicami Node.
Namestite nvm na macOS ali Linux:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Zaprite in ponovno odprite terminal, nato namestite Node.js:
nvm install 22
nvm use 22
node --version
Videti bi morali številko različice, ki se začne z v22. Node.js 22 je trenutna LTS izdaja in deluje popolnoma s Claude Code.
Namestite Node.js na Windows (znotraj WSL):
Najprej se prepričajte, da je WSL nameščen (glejte razdelek za Windows spodaj). Nato odprite svoj WSL terminal in zaženite iste zgornje nvm ukaze.
2. korak: Namestite Claude Code
Za namestitev Claude Code imate dve možnosti. Native installer je zdaj priporočena metoda, vendar npm ostaja popolnoma podprt.
Možnost A: Native Installer (Priporočeno)
Native installer ne zahteva nobenih odvisnosti – brez Node.js, brez npm. Samodejno se posodablja v ozadju in je primarna metoda, ki jo Anthropic testira in podpira.
macOS in Linux:
curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell, kot administrator):
irm https://claude.ai/install.ps1 | iex
Namestitveni program prenese Claude Code binarno datoteko, jo postavi v vašo PATH pot in konfigurira samodejne posodobitve. Celoten postopek traja manj kot minuto.
Možnost B: npm namestitev
Če imate raje npm – na primer za fiksiranje specifične različice ali ker je npm standard v vašem delovnem procesu – zaženite:
npm install -g @anthropic-ai/claude-code
Pomembno: Ne uporabljajte sudo z npm install. Če se pojavijo napake pri dovoljenjih, je pravilna rešitev uporaba nvm (ki namesti Node.js v vaš domači imenik), namesto izvajanja npm kot root.
Preverite namestitev
Ne glede na to, katero metodo ste izbrali, preverite, ali je Claude Code nameščen:
claude --version
Videti bi morali številko različice. Zaženete lahko tudi vgrajeno diagnostiko:
claude doctor
Ta ukaz preveri vaše okolje in poroča o morebitnih težavah s konfiguracijo.
3. korak: Avtentikacija
Claude Code zahteva avtentikacijo, preden ga lahko uporabite. Zaženite:
claude
Ko prvič zaženete ta ukaz, Claude Code odpre vaš privzeti spletni brskalnik in vas prosi, da se prijavite v svoj Anthropic račun. Sledite navodilom za avtorizacijo CLI.
Možnosti avtentikacije
Prijava prek brskalnika (privzeto): Najboljše za osebne naprave. Claude Code odpre okno brskalnika, se prijavite, CLI pa samodejno prejme avtentikacijski token. To deluje s Claude Pro, Max, Teams in Enterprise računi.
API ključ (za CI/CD in avtomatizacijo): Če izvajate Claude Code v brezglavem (headless) okolju ali CI/CD cevovodu, nastavite svoj API ključ kot okoljsko spremenljivko:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
API ključ lahko ustvarite v Anthropic Console. Poraba API se obračunava na token po objavljenih cenah podjetja Anthropic.
Naročnina proti API obračunavanju: S Pro ali Max naročnino je vaša uporaba Claude Code vključena v vaš mesečni načrt (ob upoštevanju omejitev porabe). Z API ključem iz Console plačujete po porabljenem žetonu (token). Izberite glede na obseg uporabe – naročnine so preprostejše za redno uporabo, medtem ko API obračunavanje omogoča več nadzora pri spremenljivih ali avtomatiziranih delovnih obremenitvah.
4. korak: Vaš prvi projekt
Zdaj, ko je Claude Code nameščen in avtenticiran, ga preizkusite na pravem projektu.
Pomaknite se v kateri koli projektni imenik:
cd ~/my-project
Zaženite Claude Code:
claude
Zdaj ste v interaktivni seji. Claude Code je prebral strukturo vašega projekta in je pripravljen na pomoč. Poskusite mu dati nalogo:
> Explain the architecture of this project
Claude Code bo pregledal vaše datoteke, identificiral tehnološki nabor (tech stack) in vam podal povzetek o tem, kako je projekt organiziran.
Poskusite nekaj bolj praktičnega:
> Add input validation to the user registration form
Claude Code bo identificiral ustrezne datoteke, predlagal spremembe in vas prosil za potrditev, preden karkoli spremeni. Vsako spremembo pregledate v diff pogledu ter jo sprejmete ali zavrnete.
Za enkratno nalogo brez vstopa v interaktivni način uporabite zastavico -p:
claude -p "Write unit tests for the auth module"
To izvede nalogo, izpiše rezultat in se zaključi – uporabno za skripte in hitra vprašanja.
5. korak: Bistvena konfiguracija
Claude Code deluje takoj s smiselnimi privzetimi nastavitvami, vendar lahko njegovo vedenje prilagodite svojemu delovnemu toku.
Izbira modela
Claude Code privzeto uporablja najnovejši Claude model. Če želite določiti drug model:
claude config set model claude-opus-4-6
Ali za posamezno sejo:
claude --model claude-sonnet-4-20250514
Dovoljenja
Claude Code prosi za potrditev, preden izvede potencialno destruktivna dejanja, kot so pisanje datotek ali izvajanje ukazov lupine. To vedenje lahko konfigurirate:
claude config set permissions.auto-accept-edits true
Nastavitve na ravni projekta
V korenu projekta ustvarite datoteko .claude/settings.json, da določite konfiguracijo, ki si jo deli ekipa:
{
"permissions": {
"allow": ["read", "write", "shell"],
"deny": ["shell:rm -rf *"]
},
"model": "claude-sonnet-4-20250514",
"environment": {
"NODE_ENV": "development"
}
}
To datoteko je treba oddati v sistem za nadzor različic (version control), da si celotna ekipa deli enako vedenje Claude Code.
Za osebne povoze (overrides), ki jih ne želite oddati v sistem, uporabite .claude/settings.local.json.
Konfiguracija MCP strežnika
Claude Code podpira Model Context Protocol (MCP) strežnike za razširitev svojih zmogljivosti. Konfigurirajte jih v .mcp.json v korenu vašega projekta:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"]
}
}
}
Nameščanje v različnih okoljih
macOS
Native installer je najpreprostejša pot na macOS. Podprte so tako Apple Silicon (M1/M2/M3/M4) kot Intel naprave:
curl -fsSL https://claude.ai/install.sh | bash
Alternativno je Claude Code na voljo prek Homebrew:
brew install --cask claude-code
Linux
Deluje na Ubuntu 20.04+, Debian 10+ in večini sodobnih distribucij:
curl -fsSL https://claude.ai/install.sh | bash
Če uporabljate starejšo distribucijo, uporabite npm metodo z nvm, da se izognete težavam z odvisnostmi na ravni sistema.
Windows (WSL)
Claude Code na Windows zahteva ali WSL ali Git for Windows. WSL je priporočen pristop:
- Odprite PowerShell kot administrator in namestite WSL:
wsl --install
-
Po pozivu ponovno zaženite računalnik.
-
Odprite WSL terminal (privzeto Ubuntu) in namestite Claude Code:
curl -fsSL https://claude.ai/install.sh | bash
Alternativno lahko uporabite native Windows installer neposredno v PowerShell:
irm https://claude.ai/install.ps1 | iex
Docker
Za kontejnerizirana okolja dodajte Claude Code v svojo Dockerfile:
FROM node:22-alpine
RUN npm install -g @anthropic-ai/claude-code
ENV ANTHROPIC_API_KEY=your-key-here
Za CI/CD cevovode podajte API ključ ob izvajanju, namesto da bi ga vgradili v sliko:
docker run -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY my-claude-image claude -p "Run the test suite and fix any failures"
CI/CD cevovodi
Headless način Claude Code (zastavica -p) je zasnovan za avtomatizacijo. Tukaj je primer za GitHub Actions:
- name: AI Code Review
run: |
npx @anthropic-ai/claude-code -p "Review the changes in this PR and suggest improvements" --output-format json
env:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
Zastavica --output-format json vrne strukturiran izpis, ki ga lahko naslednji koraki razčlenijo.
Posodabljanje Claude Code
Native Installer
Če ste Claude Code namestili z native installerjem, se posodobitve dogajajo samodejno v ozadju. Nobeno ukrepanje ni potrebno. Kanal za posodabljanje lahko konfigurirate:
claude config set update-channel stable
Če želite preveriti trenutno različico:
claude --version
npm
Če ste namestili prek npm, posodobite ročno:
npm update -g @anthropic-ai/claude-code
Ali namestite specifično različico:
npm install -g @anthropic-ai/claude-code@latest
Integracija z IDE
Čeprav je Claude Code orodje, osredotočeno na terminal, se neposredno integrira s priljubljenimi IDE za bolj vizualno izkušnjo.
VS Code razširitev
Razširitev VS Code zagotavlja izvorni grafični vmesnik za Claude Code znotraj vašega urejevalnika. Vključuje ploščo za klepet, razveljavitev na podlagi kontrolnih točk (checkpoint-based undo), reference datotek z @-omenjavami in možnost izvajanja več pogovorov hkrati v vzporednih zavihkih.
Za namestitev odprite VS Code in v plošči Extensions poiščite "Claude Code" ali zaženite:
code --install-extension anthropic.claude-code
Ko je nameščena, lahko odprete ploščo Claude Code iz stranske vrstice in z njo komunicirate podobno kot v terminalski različici, vendar z dodatno prednostjo ogleda razlik med datotekami, prikazanih v izvornem diff pregledovalniku VS Code.
JetBrains vtičnik
Za IntelliJ IDEA, PyCharm, WebStorm, GoLand in druge JetBrains IDE namestite vtičnik Claude Code iz JetBrains Marketplace:
- Odprite svoj JetBrains IDE
- Pojdite v Settings, nato Plugins, nato Marketplace
- Poiščite "Claude Code"
- Kliknite Install in ponovno zaženite IDE
JetBrains vtičnik poganja Claude Code CLI znotraj integriranega terminala vašega IDE-ja in odpira predlagane spremembe v diff pregledovalniku IDE-ja. Trenutno je v beta fazi, vendar popolnoma funkcionalen za vsakodnevno uporabo.
Odpravljanje težav
"command not found: claude"
Claude Code binarna datoteka ni v vaši PATH poti. Če ste uporabili native installer, poskusite odpreti novo okno terminala. Če to ne deluje, ponovno zaženite namestitveno skripto. Za npm namestitve se prepričajte, da je vaš globalni npm bin imenik v vaši PATH poti:
npm config get prefix
Dodajte podimenik bin te poti v spremenljivko PATH vaše lupine.
"Node.js version too old"
Claude Code zahteva Node.js 18+. Preverite svojo različico z node --version. Če je nižja od 18, namestite novejšo različico z nvm:
nvm install 22
nvm use 22
npm napake pri dovoljenjih (EACCES)
Nikoli ne uporabljajte sudo npm install -g. Namesto tega popravite privzeti imenik npm ali uporabite nvm, ki vse namesti v vaš domači imenik in se popolnoma izogne konfliktom z dovoljenji:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
nvm install 22
npm install -g @anthropic-ai/claude-code
Avtentikacija ne uspe ali se brskalnik ne odpre
Če prijava prek brskalnika ne deluje (pogosto na oddaljenih strežnikih ali WSL), se lahko namesto tega avtenticirate z API ključem:
export ANTHROPIC_API_KEY=sk-ant-your-key-here
claude
Svoj API ključ ustvarite na console.anthropic.com.
"Network Error" ali časovna omejitev med namestitvijo
Vaše omrežje ali požarni zid morda blokira npm ali native installer. Poskusite:
npm config set registry https://registry.npmjs.org/
Če ste za korporativnim posredniškim strežnikom (proxy), konfigurirajte npm, da ga uporablja:
npm config set proxy http://your-proxy:8080
npm config set https-proxy http://your-proxy:8080
Claude Code deluje počasi
Claude Code je sam po sebi lahek – počasnost običajno pomeni omrežno zakasnitev do Anthropic API. Preverite internetno povezavo. Če uporabljate VPN, se poskusite odklopiti. Stanje API lahko preverite tudi na status.anthropic.com.
Naslednji koraki
Claude Code imate nameščen, avtenticiran in delujoč. Tukaj je, kako nadaljevati:
- Spoznajte delovni tok: Preberite naš Claude Code tutorial za poglobljen vpogled v strategije pozivov (prompting), urejanje več datotek in čim boljši izkoristek razvoja s pomočjo AI.
- Primerjajte svoje možnosti: Oglejte si, kako se Claude Code odreže v naši primerjavi Claude Code vs Cursor, če se odločate med AI orodji za kodiranje.
- Raziščite napredne funkcije: Claude Code podpira MCP strežnike, kljuke po meri (custom hooks), headless avtomatizacijo in konfiguracije z več modeli. Uradna dokumentacija te teme podrobno obravnava.
Claude Code je najhitrejši način za vpeljavo AI v vaš obstoječi razvojni delovni tok brez spreminjanja orodij ali zapuščanja terminala. Zdaj, ko je nameščen, začnite z majhno nalogo na realnem projektu – razliko boste opazili takoj.
