Stručné zhrnutie: Claude Code je AI asistent pre kódovanie, ktorý beží v termináli. Funguje natívne na macOS a Linuxe, alebo na Windows cez WSL2. Jeho nastavenie vyžaduje vytvorenie API kľúča od spoločnosti Anthropic, spustenie špecifického inštalátora pre danú platformu, autentifikáciu pomocou kľúča a overenie inštalácie testovacím príkazom.
Claude Code predstavuje oficiálneho AI asistenta pre kódovanie od spoločnosti Anthropic, ktorý pracuje v termináli. Žije priamo v príkazovom riadku a zvláda všetko od generovania kódu až po opravu chýb prostredníctvom príkazov v prirodzenom jazyku.
Proces nastavenia však nie je vždy jednoduchý. Používatelia Windows potrebujú WSL2. Autentifikácia pomocou API môže byť pre začiatočníkov náročná. Vyskytujú sa konflikty verzií.
Tento sprievodca vás prevedie kompletným procesom nastavenia pre všetky platformy, od systémových požiadaviek až po vašu prvú kódovaciu reláciu.
Čo je Claude Code
Claude Code je agentná terminálová aplikácia, ktorá sa integruje s vývojovými prostrediami. Rozumie kódovým základniam, vykonáva rutinné úlohy a spravuje pracovné postupy Git prostredníctvom konverzačných príkazov.
Na rozdiel od nástrojov založených na prehliadači, Claude Code beží lokálne v termináli. Priamo pristupuje k súborom projektu, udržiava kontext naprieč reláciami a integruje sa s existujúcimi vývojovými pracovnými postupmi. Podľa oficiálnej dokumentácie Claude Code sa nástroj pripája k API spoločnosti Anthropic a podporuje integráciu s Amazon Bedrock, Google Cloud Vertex AI a Azure AI.
Tento nástroj funguje inak ako tradičné kódovacie asistenty. Reálne povedané: je to skôr ako mať párového programátora vo vašom termináli, než nástroj na dopĺňanie kódu.
Systémové požiadavky pre Claude Code
Pred inštaláciou musia systémy spĺňať špecifické požiadavky. Tu je to, čo potrebuje každá platforma:
| Platforma | Požiadavky | Poznámky |
|---|---|---|
| macOS | macOS 13.0 alebo novší | Nativná podpora, jednoduchá inštalácia |
| Linux | 64-bitová distribúcia s glibc 2.28+ | Nativná podpora pre väčšinu moderných distribúcií |
| Windows | Windows 10 Build 19041+ alebo Windows 11 | Vyžaduje najprv inštaláciu WSL2 |
Všetky platformy potrebujú stabilné internetové pripojenie pre API volania. Sťahovanie Claude Code zvyčajne vyžaduje okolo 50 MB, pričom WSL2 na Windows pridáva približne 500 MB pre subsystém Linux.
Pokiaľ ide o úložisko, počítajte s najmenej 4 GB voľného miesta. Samotná aplikácia je malá, ale priestor pre závislosti a súbory projektu je dôležitý.
Požiadavky špecifické pre Windows
Claude Code môže bežať na Windows cez PowerShell alebo Command Prompt, ak je nainštalovaný Node.js. Nástroj vyžaduje Windows Subsystem for Linux 2 na vytvorenie prostredia Linux.
Podľa sprievodcov inštalácie z claude.ai, systémy Windows 10 potrebujú verziu 1903 alebo novšiu s Build 19041 alebo vyšším. Používatelia Windows 11 majú podporu WSL2 zabudovanú. Pre počiatočné nastavenie WSL2 sú potrebné oprávnenia správcu.
Proces zahŕňa povolenie virtualizácie v BIOSe, aktiváciu funkcií Windows a inštaláciu distribúcie Linuxu. Ubuntu 22.04 LTS je odporúčaná distribúcia pre kompatibilitu.
Inštalácia Claude Code: Krokový proces
Proces inštalácie sa líši podľa platformy. Tu je návod, ako spustiť Claude Code na každom operačnom systéme.
Inštalácia na macOS a Linux
Inštalácia na macOS a Linux nasleduje rovnaký vzor. Obe platformy podporujú natívnu inštaláciu bez dodatočného nastavenia.
Proces začína stiahnutím inštalátora. Otvorte terminál a spustite:
curl -fsSL claude.ai/install.sh | sh
Skript detekuje operačný systém, stiahne príslušný binárny súbor a nainštaluje Claude Code do lokálneho adresára bin. Inštalácia zvyčajne trvá menej ako dve minúty pri stabilnom pripojení.
Pre systémy bez curl funguje wget ako alternatíva. Inštalátor automaticky pridá Claude Code do systémovej cesty (PATH).
Inštalácia na Windows cez WSL2
Inštalácia na Windows vyžaduje najprv nastavenie WSL2. Tu je kompletný proces:
Otvorte PowerShell ako správca a povoľte WSL:
wsl –install
Tento príkaz povoľuje potrebné funkcie Windows, sťahuje jadro WSL2 a štandardne inštaluje Ubuntu. Systém vás požiada o reštart. Po reštartovaní sa Ubuntu automaticky spustí na dokončenie nastavenia používateľa.
Pri výzve vytvorte používateľské meno a heslo. Tieto údaje sú určené pre prostredie Linux a sú oddelené od prihlasovacích údajov Windows.
Keď WSL2 beží, platí proces inštalácie pre Linux. V termináli Ubuntu spustite príkaz curl z časti o macOS/Linux vyššie.
Inštalátor sa postará o zvyšok. Claude Code sa nainštaluje v rámci prostredia WSL2 a spustí sa cez terminál Ubuntu.
Získanie API kľúča od spoločnosti Anthropic
Claude Code vyžaduje na autentifikáciu API kľúč od spoločnosti Anthropic. Kľúč spája lokálnu inštaláciu so servermi spoločnosti Anthropic.
Navštívte konzolu Anthropic na adrese console.anthropic.com. Vytvorte si účet alebo sa prihláste pomocou existujúcich prihlasovacích údajov. V nastaveniach účtu prejdite na položku API Keys.
Kliknite na "Create Key" (Vytvoriť kľúč), čím vygenerujete nový API kľúč. Kľúč sa zobrazí raz – ihneď si ho skopírujte. Spoločnosť Anthropic už nezobrazí celý kľúč po opustení stránky.
Uchovávajte kľúč bezpečne. Poskytuje plný prístup k API spoločnosti Anthropic a k súvisiacim fakturáciám.
Porozumenie nákladom na API
Claude Code funguje na základe modelu platby za použitie prostredníctvom API spoločnosti Anthropic. Podľa údajov z návodov na inštaláciu claude.ai sa náklady líšia podľa modelu:
| Model | Náklady na vstup | Náklady na výstup |
|---|---|---|
| Claude Opus 4.6 | 5 USD za milión tokenov | 25 USD za milión tokenov |
| Claude Sonnet 4.6 | 3 USD za milión tokenov | 15 USD za milión tokenov |
Minimálny nákup na aktiváciu fakturácie je 5 USD, aj keď diskusie v komunite naznačujú, že 20-30 USD poskytuje lepšiu rezervu na testovanie. Alternatívne možnosti predplatného zahŕňajú Claude Pro za 20 USD mesačne alebo Claude Max za 100 USD mesačne pre intenzívne používanie.
Predvolené správanie používa Opus, kým sa nedosiahne 50 % limitov využitia, potom sa prepne na Sonnet pre nákladovú efektivitu.
Autentifikácia a prvé spustenie
Po inštalácii potrebuje Claude Code pred prvým použitím autentifikáciu. Spustite Claude Code zadaním:
claude
Pri prvom spustení sa zobrazí výzva na zadanie API kľúča. Vložte kľúč z konzoly Anthropic a stlačte Enter. Claude Code kľúč overí a bezpečne uloží do lokálnych konfiguračných súborov.
Autentifikácia pretrváva naprieč reláciami. API kľúč nie je potrebné zadávať znova, pokiaľ nie je explicitne odstránený alebo pri zmene účtu.
Na overenie úspešnej autentifikácie zobrazí Claude Code uvítaciu správu a príkazový riadok. Rozhranie zobrazuje dostupné príkazy a potvrdzuje spojenie s API spoločnosti Anthropic.
Konfigurácia predvolieb modelov
Claude Code štandardne používa automatický výber modelu, ale manuálna konfigurácia je možná. Podľa oficiálnej dokumentácie môžu používatelia nastaviť výber modelu prostredníctvom príkazu /model alebo nastavením premennej prostredia CLAUDE_CODE_EFFORT_LEVEL.
Úroveň úsilia ovláda hĺbku myslenia pre modely Opus 4.6 a Sonnet 4.6: nízka, stredná alebo vysoká. Vyššie úrovne úsilia zvyšujú hĺbku uvažovania, ale aj náklady a čas odozvy.
Pre projekty vyžadujúce hlbokú analýzu, dočasné zahrnutie "ultrathink" do príkazov nastaví úsilie na vysokú pre daný konkrétny obrat.
Overenie úspešnej inštalácie
Po autentifikácii overte, či Claude Code funguje správne. Spustite tieto základné testy:
claude –help
claude –version
Príkaz help zobrazí dostupné možnosti a príkazy. Výstup verzie potvrdí, ktorá verzia je nainštalovaná. Oba príkazy by sa mali vykonať bez chýb.
Ďalej otestujte Claude Code v adresári projektu. Vytvorte testovací priečinok:
mkdir test-project
cd test-project
echo “# Test Project” > README.md
claude
V relácii Claude Code vyskúšajte základné interakcie:
- Zadajte "help" na zobrazenie dostupných príkazov
- Opýtajte sa "explain what you can do" (vysvetli, čo dokážeš)
- Požiadajte "summarize this project" (zhrň tento projekt)
- Otestujte príkaz /help
Tieto interakcie potvrdia, že Claude Code dokáže čítať súbory projektu a odpovedať na požiadavky. Úspešné odpovede znamenajú, že inštalácia je funkčná.
Konfigurácia Claude Code pre projekty
Claude Code ukladá nastavenia špecifické pre projekty v konfiguračných súboroch. Tieto súbory prispôsobujú správanie, definujú pamäť a stanovujú pracovné postupy.
Hlavným konfiguračným súborom je CLAUDE.md v koreňovom adresári projektu. Tento súbor obsahuje inštrukcie, kontext a špecifické pokyny pre projekt, na ktoré sa Claude Code odvoláva počas relácií.
Vytvorte základný súbor CLAUDE.md:
# Kontext projektu
Toto je [typ projektu] postavený pomocou [technológií].
## Kľúčové pokyny
– [Dôležité pravidlo 1]
– [Dôležité pravidlo 2]
## Štruktúra projektu
[Stručný opis organizácie priečinkov]
Súbor akceptuje formátovanie Markdown. Claude Code číta tento kontext na začiatku relácie a udržiava ho počas celej konverzácie.
Pokročilé možnosti konfigurácie
Okrem základného kontextu podporuje Claude Code pokročilú konfiguráciu prostredníctvom adresára .claude. Tento adresár môže obsahovať:
- Dohotovenia (Skills): Špecializované schopnosti definované v .claude/skills/SKILL.md
- Príkazy (Commands): Vlastné príkazové riadky v .claude/commands/*.md
- Háčiky (Hooks): Automatizované pracovné postupy spúšťané udalosťami
- Pluginy (Plugins): Rozšírená funkcionalita prostredníctvom programovej integrácie
Podľa oficiálnej dokumentácie Agent SDK tieto funkcie umožňujú sofistikované prispôsobenie. Dohotovenia definujú opakovane použiteľné schopnosti. Príkazy vytvárajú skratky pre bežné úlohy. Háčiky automatizujú reakcie na zmeny súborov alebo použitie nástrojov.
Používanie Claude Code: Základné pracovné postupy
Po dokončení inštalácie Claude Code zvláda bežné vývojárske úlohy prostredníctvom prirodzeného jazyka.
Spustite reláciu navigáciou do adresára projektu a zadaním:
claude
Príkazový riadok prijíma požiadavky v bežnom jazyku. Niektoré bežné pracovné postupy:
- Generovanie kódu: "Vytvor funkciu v Pythone, ktorá overuje e-mailové adresy s primeraným spracovaním chýb."
- Oprava chýb: "Táto funkcia vyvoláva výnimku null pointer. Môžeš identifikovať a opraviť problém?"
- Refaktorovanie: "Refaktoruj túto komponentu tak, aby používala injekciu závislostí namiesto priameho vytvárania inštancií."
- Operácie Git: "Vytvor novú vetvu, commituj tieto zmeny s popisnou správou a pushni na origin."
Claude Code udržiava kontext naprieč reláciou. Pamätá si predchádzajúce interakcie, sleduje úpravy súborov a rozumie širšej štruktúre projektu.
Porozumenie režimu plánu (Plan Mode)
Pre zložité zmeny ponúka Claude Code režim plánu (Plan Mode). Tento režim vytvára podrobný plán vykonania pred vykonaním zmien.
Aktivujte režim plánu predradením požiadaviek "plan:" alebo použitím príkazu /plan. Claude Code potom načrtne navrhované zmeny, vysvetlí zdôvodnenie a pred vykonaním čaká na schválenie.
Režim plánu je obzvlášť užitočný pri refaktorovaní, architektonických zmenách alebo úpravách ovplyvňujúcich viacero súborov. Poskytuje prehľad o tom, čo Claude Code zamýšľa urobiť pred tým, než sa zaviaže k zmenám.
Integrácia s VS Code a IDE
Aj keď Claude Code beží v termináli, integrácia s editorom kódu zlepšuje pracovný postup. Oficiálne rozšírenie pre VS Code prináša funkcie Claude Code priamo do editora.
Nainštalujte rozšírenie z obchodu VS Code. Vyhľadajte "Claude Code" a kliknite na Inštalovať. Rozšírenie pridá panel Claude Code na bočný panel.
Podľa oficiálnej dokumentácie VS Code rozšírenie podporuje:
| Funkcia | Klávesová skratka | Popis |
|---|---|---|
| Zameranie vstupu | Cmd+Esc / Ctrl+Esc | Prepínanie medzi editorom a Claudem |
| Otvoriť v novej karte | Cmd+Shift+Esc / Ctrl+Shift+Esc | Spustiť novú konverzáciu ako kartu |
| Otvoriť v termináli | – | Spustiť režim terminálu z VS Code |
Rozšírenie si zachováva paritu funkcií s terminálovou verziou a pridáva špecifické výhody pre IDE, ako sú inline diffy a @-spomenuté odkazy na súbory.
Aktualizácia a správa Claude Code
Claude Code sa štandardne aktualizuje automaticky. Aplikácia periodicky kontroluje nové verzie a inštaluje aktualizácie na pozadí.
Pre manuálnu aktualizáciu spustite:
claude –update
Toto vynúti okamžitú kontrolu a inštaláciu najnovšej verzie. Proces aktualizácie zachováva konfiguračné súbory a autentifikačné údaje.
Pre organizácie vyžadujúce kontrolu verzií je možné automatické aktualizácie vypnúť. Nastavte premennú prostredia CLAUDE_CODE_AUTO_UPDATE na false alebo ju nakonfigurujte prostredníctvom nastavení spravovaných serverom.
Na inštaláciu špecifickej verzie použite:
curl -fsSL claude.ai/install.sh | sh -s — –version=X.Y.Z
Nahraďte X.Y.Z cieľovým číslom verzie.
Bežné problémy pri nastavovaní a riešenia
Pri nastavovaní sa bežne vyskytuje niekoľko problémov. Tu je návod, ako ich vyriešiť:
- Odmietnutie API kľúča: Ak Claude Code odmietne API kľúč, overte, či v ňom nie sú žiadne extra medzery alebo znaky. Skopírujte kľúč znovu z konzoly Anthropic. Skontrolujte, či je aktivované fakturácia – kľúče nebudú fungovať bez uvedeného spôsobu platby.
- Zlyhanie inštalácie WSL2: Systémy Windows niekedy zlyhajú pri inštalácii WSL2 kvôli nastaveniam virtualizácie. Vstúpte do BIOSu a povoľte virtualizáciu (Intel VT-x alebo AMD-V). Uistite sa, že verzia systému Windows spĺňa minimálne požiadavky.
- Príkaz nenájdený: Ak terminál nerozpozná príkaz `claude`, cesta (PATH) nebola správne aktualizovaná. Zatvorte a znova otvorte terminál. V prípade pretrvávajúcich problémov manuálne pridajte inštalačný adresár do PATH.
- Časové limity pripojenia: Sieťové obmedzenia alebo firewally môžu blokovať volania API. Claude Code vyžaduje HTTPS prístup na api.anthropic.com. Firemné siete môžu vyžadovať konfiguráciu proxy.
- Chyby oprávnení: Inštalácie na Linuxe a macOS občas narazia na problémy s oprávneniami. Spustite inštalátor s príslušnými oprávneniami alebo nainštalujte do používateľského adresára namiesto systémových umiestnení.
Skontrolujte dostupné AI kredity pred nastavením Claude Code
Nastavenie Claude Code zvyčajne znamená experimentovanie – spúšťanie príkazov, testovanie integrácií a budovanie malých prototypov skôr, než sa čokoľvek dostane do produkcie. Táto počiatočná fáza často vedie k veľkému využitiu API. Namiesto toho, aby ste platili za každý požadok hneď, mnohí vývojári najprv hľadajú dostupné kredity alebo startup programy, ktoré pomáhajú znížiť počiatočné náklady.
Get AI Perks zhromažďuje tieto príležitosti na jednom mieste. Platforma uvádza AI kredity, zľavy a partnerské programy naprieč poskytovateľmi AI, cloudovými platformami a vývojárskymi nástrojmi, s podrobnými sprievodcami vysvetľujúcimi, ako ich získať. Celkovo databáza obsahuje výhody od viac ako 200 nástrojov a milióny dolárov dostupných kreditov, o ktoré môžu startupy a budovatelia požiadať.
Pred dokončením nastavenia Claude Code si skontrolujte Get AI Perks a získajte AI kredity, ktoré môžu pokryť vaše prvé experimenty.
Často kladené otázky
Musím platiť za Claude Code?
Samotný Claude Code je bezplatný softvér, ale vyžaduje API kľúč od spoločnosti Anthropic, ktorý funguje na základe modelu platby za použitie. Minimálna aktivácia účtu je 5 USD, hoci praktické používanie zvyčajne vyžaduje 20-30 USD v kreditoch. Alternatívne plány predplatného, ako napríklad Claude Pro (20 USD/mesiac) alebo Claude Max (100 USD/mesiac), poskytujú rôzne cenové štruktúry pre intenzívnych používateľov.
Môže Claude Code bežať úplne offline?
Nie. Claude Code vyžaduje aktívne internetové pripojenie na komunikáciu so servermi API spoločnosti Anthropic. Aplikácia spracováva požiadavky lokálne, ale posiela príkazy modelom Claude bežiacim na infraštruktúre spoločnosti Anthropic. Neexistuje žiadny režim offline ani možnosť lokálneho modelu.
Aký je rozdiel medzi Claude Code a Claude.ai?
Claude.ai je webové rozhranie na chatovanie pre všeobecné interakcie s Claudem. Claude Code je špecializovaná terminálová aplikácia navrhnutá špeciálne pre softvérový vývoj. Claude Code sa integruje s gitom, priamo číta súbory projektu, udržiava dlhší vývojový kontext a obsahuje funkcie špecifické pre kódovanie, ako je režim plánu a možnosti úpravy súborov.
Ako prepínam medzi modelmi Claude?
Použite príkaz /model počas relácie Claude Code na prepínanie medzi dostupnými modelmi. Predvolená konfigurácia používa Opus, kým nedosiahne 50 % využitia, potom sa prepne na Sonnet. Manuálny výber umožňuje zvoliť špecifické modely na základe požiadaviek úlohy – Opus pre zložité uvažovanie, Sonnet pre rýchlejšie a nákladovo efektívnejšie odpovede.
Môžem používať Claude Code v VS Code?
Áno. Oficiálne rozšírenie pre VS Code prináša funkcie Claude Code do editora. Nainštalujte ho z obchodu VS Code. Rozšírenie poskytuje rovnaké funkcie ako terminálová verzia s dodatočnou integráciou IDE, ako sú inline diffy, panely na bočnom paneli a klávesové skratky pre rýchly prístup.
Ukladá Claude Code môj kód alebo konverzácie?
Podľa zásad používania údajov spoločnosti Anthropic sa interakcie s API nepoužívajú na trénovanie modelov. Organizácie môžu prostredníctvom podnikových nastavení nakonfigurovať politiky nulového uchovávania údajov. Kód a príkazy sa prenášajú na servery spoločnosti Anthropic na spracovanie, ale spracovanie závisí od konfigurácie účtu a nastavení uchovávania údajov.
Čo sa stane, ak Claude Code urobí chybu?
Claude Code obsahuje bezpečnostné funkcie, ako je integrácia s gitom a režim plánu, na minimalizáciu chýb. V prípade chýb platia štandardné postupy správy verzií – história git poskytuje možnosť vrátenia zmien. Systém oprávnení vyžaduje súhlas pre citlivé operácie. Niektoré komunitné diskusie naznačujú úspešnosť v rozsahu 80-90 % pre bežné úlohy, pričom sa odporúča dohľad pri kritických zmenách.
Pokrok s Claude Code
Claude Code transformuje terminálový vývoj integráciou AI asistencie priamo do príkazového riadku. Nastavenie vyžaduje špecifickú inštaláciu pre danú platformu, autentifikáciu API a základnú konfiguráciu, ale proces je jednoduchý, ak sa dodržiavajú správne kroky.
Nástroj vyniká v rutinných vývojárskych úlohách, generovaní kódu a správe pracovných postupov Git. Režim plánu poskytuje bezpečnosť pre zložité operácie. Integrácia IDE rozširuje možnosti mimo terminálu.
Začnite s jednoduchými úlohami, aby ste pochopili, ako Claude Code interpretuje požiadavky. Postupne prechádzajte k zložitejším pracovným postupom, ako rastie vaša znalosť. Použite príkaz /clear medzi odlišnými úlohami na udržanie čistého kontextu. Konfigurujte súbory CLAUDE.md pre špecifické pokyny pre projekt.
Tímy môžu preskúmať nastavenia spravované serverom a trhy s pluginmi. Jednotliví vývojári môžu využívať dohotovenia a vlastné príkazy prispôsobené častým vzorom.
Repozitár na GitHube na adrese anthropics/claude-code obsahuje ďalšie príklady, komunitné pluginy a zdroje na riešenie problémov. Oficiálna dokumentácia na docs.anthropic.com poskytuje komplexné technické referencie.
Teraz je čas začať kódovať. Prejdite do projektu, spustite Claude Code a zistite, ako AI-asistovaný vývoj mení váš pracovný postup.
