Rýchle zhrnutie: Claude Code je možné nainštalovať pomocou natívnych inštalátorov na macOS, Windows a Linux z oficiálnej webovej stránky Claude Code. Používatelia systému Windows si musia najprv nainštalovať WSL2 pred spustením Claude Code. Po inštalácii sa prihláste do svojho účtu Claude, keď Claude Code otvorí okno prehliadača, aby ste sa pri prvom spustení mohli prihlásiť a začať kódovať s pomocou AI priamo z terminálu alebo desktopovej aplikácie.
Claude Code predstavuje snahu spoločnosti Anthropic o vývojové nástroje agentného AI. Tento príkazový asistent číta kódové základne, upravuje súbory, spúšťa príkazy a integruje sa s vývojovými pracovnými postupmi.
Získanie inštalácie však nie je vždy priamočiare. Rôzne platformy vyžadujú rôzne prístupy. Windows potrebuje dodatočné nastavenie. A dokumentácia, hoci je komplexná, môže začiatočníkov zahlcovať.
Tento sprievodca rieši zložitosť. Pokrýva systémové požiadavky, špecifické kroky inštalácie podľa platformy, autentizáciu a overenie – všetko, čo je potrebné na správne spustenie Claude Code.
Systémové požiadavky pred inštaláciou
Podľa oficiálnej dokumentácie Claude Code tento nástroj podporuje macOS, Windows a Linux. Každá platforma má však špecifické predpoklady.
Pre macOS sú požiadavky minimálne. Systém potrebuje macOS 13.0 alebo novší. Procesory Intel aj Apple Silicon fungujú dobre.
Windows predstavuje väčšiu zložitosť. Operačný systém musí byť Windows 10 Build 19041 alebo novší, alebo Windows 11. Ale tu je háčik – Claude Code neběží natívne vo Windowse.
Windows Subsystem for Linux 2 (WSL2) je povinný. Tým sa vytvorí prostredie Linuxu, kde Claude Code skutočne funguje. Bez WSL2 inštalácia zlyhá.
Používatelia Linuxu potrebujú 64-bitovú distribúciu. Oficiálna dokumentácia potvrdzuje podporu pre Ubuntu, Debian, Fedora a ďalšie hlavné distribúcie. Alpine Linux a systémy založené na musl vyžadujú dodatočnú konfiguráciu.
Všetky platformy potrebujú počas inštalácie stabilné internetové pripojenie. Veľkosti sťahovania sa líšia, ale zvyčajne sa pohybujú od 50 MB do 500 MB v závislosti od toho, čo je už nainštalované.
| Platforma | Minimálna verzia | Špeciálne požiadavky |
|---|---|---|
| macOS | 13.0 | Žiadne |
| Windows | 10 Build 19041 alebo 11 | Vyžaduje sa WSL2 |
| Linux | 64-bitová distribúcia | Preferovaný systém založený na glibc |
Inštalácia Claude Code na macOS
Proces inštalácie macOS používa natívny inštalátor. Toto je najjednoduchšia cesta spomedzi všetkých platforiem.
Najprv si stiahnite inštalátor z oficiálnej webovej stránky Claude Code. Stiahnuteľná stránka automaticky rozpozná macOS a ponúkne príslušný balík.
Otvorte stiahnutý súbor .dmg. Presuňte aplikáciu Claude Code do priečinka Aplikácie. Štandardná inštalácia macOS – nič nezvyčajné.
Niektorí používatelia sa pri prvom spustení stretnú s bezpečnostnou výzvou. macOS predvolene blokuje aplikácie od neidentifikovaných vývojárov. Kliknite pravým tlačidlom myši na aplikáciu Claude Code a vyberte „Otvoriť“ (Open), aby ste túto jednorazovú výstrahu obišli.
Nástroj príkazového riadka sa nainštaluje automaticky s desktopovou aplikáciou. Otvorte Terminal a zadajte `claude --version` na overenie. Ak sa zobrazí číslo verzie, inštalácia bola úspešná.
Overenie inštalácie na macOS
Spustite tieto príkazy na potvrdenie, že všetko funguje:
| claude --version claude --help |
Oba príkazy by mali vrátiť výstup bez chýb. Príkaz `version` zobrazí nainštalovanú verziu Claude Code. Príkaz `help` zobrazí dostupné možnosti a príkazy.
Vytvorenie testovacieho priečinka pomáha overiť plnú funkčnosť. Prejdite do priečinka projektu a spustite `claude` na spustenie interaktívnej relácie. Nástroj by sa mal inicializovať a vyzvať na prihlásenie, ak ešte nie ste prihlásení.
Inštalácia vo Windowse s WSL2
Inštalácia vo Windowse vyžaduje viacero krokov. Proces trvá dlhšie ako na macOS, ale zostáva zvládnuteľný.
Najprv musíte nainštalovať WSL2. Otvorte PowerShell ako správca a spustite:
| wsl --install |
Tento príkaz predvolene nainštaluje WSL2 a Ubuntu. Systém bude vyžadovať reštart. Po reštartovaní sa Ubuntu automaticky spustí na dokončenie počiatočného nastavenia.
Pri výzve vytvorte používateľské meno a heslo pre Unix. Tieto prihlasovacie údaje sú oddelené od prihlasovacích údajov systému Windows.
Keď je WSL2 spustený, platí proces inštalácie pre Linux. Otvorte terminál Ubuntu (nainštalovaný s WSL2) a stiahnite si inštalátor Claude Code pre Linux.
Inštalácia Claude Code v WSL2
Podľa oficiálnej dokumentácie príkaz na inštaláciu stiahne a spustí natívny inštalátor:
| curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash |
Tento skript automaticky spravuje závislosti. Nainštaluje Node.js, ak je to potrebné, nastaví binárny súbor Claude Code a nakonfiguruje premenné PATH.
Inštalácia trvá niekoľko minút. Indikátory priebehu a stavové správy ukazujú, čo sa deje. Po dokončení zatvorte a znova otvorte terminál na obnovenie premenných prostredia.
Testovanie inštalácie prebieha rovnako ako na macOS. Spustite `claude --version` na overenie.
Proces inštalácie na Linuxe
Používatelia Linuxu majú najjednoduchšiu cestu inštalácie. Natívny inštalátor funguje priamo bez dodatočných vrstiev, ako je WSL2.
Stiahnite si a spustite inštalačný skript:
| curl -fsSL claude.ai/install.sh | bash |
Toto stiahne binárny súbor Claude Code, nainštaluje závislosti a nakonfiguruje prostredie shellu. Skript detekuje distribúciu a podľa toho sa prispôsobí.
Pre systémy založené na Ubuntu a Debian skript konfiguruje inštaláciu. Oficiálna dokumentácia potvrdzuje podporu pre Ubuntu 20.04+, Debian 10+ a ďalšie distribúcie.
Zohľadnenie Alpine Linux
Alpine Linux a distribúcie založené na musl potrebujú dodatočné kroky. Oficiálna dokumentácia uvádza, že tieto systémy vyžadujú manuálnu konfiguráciu.
Štandardný inštalátor môže na Alpine zlyhať. Namiesto toho si stiahnite binárny súbor kompatibilný s musl priamo zo stránky s vydaniami. Rozbaľte ho do priečinka v systémovej PATH, zvyčajne /usr/local/bin.
Nastavte spustiteľné povolenia:
| chmod +x /usr/local/bin/claude |
Používatelia Alpine by mali pred pokračovaním skontrolovať kompatibilitu. Niektoré funkcie nemusia fungovať rovnako ako na distribúciách založených na glibc.
Autentizácia a nastavenie účtu
Po nainštalovaní Claude Code spustite `claude` vo svojom termináli. Pri prvom spustení Claude Code otvorí okno prehliadača, aby ste sa mohli prihlásiť.
Tým sa otvorí autentizačná stránka Claude. Prihláste sa pomocou existujúceho účtu Claude alebo si vytvorte nový.
Prehliadač zobrazí autorizačný kód. Skopírujte tento kód a vráťte sa do terminálu. Vložte kód, keď sa zobrazí výzva.
Úspešná autentizácia uloží prihlasovacie údaje lokálne. Budúce relácie nebudú vyžadovať prihlásenie, pokiaľ platnosť prihlasovacích údajov nevyprší alebo nie sú manuálne vymazané.
Autentizácia pre tímy a podniky
Podľa oficiálnej dokumentácie k autentizácii majú tímy používajúce Claude pre Tímy alebo Enterprise ďalšie možnosti. Organizácie si môžu nastaviť jednotné prihlásenie (SSO) alebo autentizáciu cez cloudového poskytovateľa.
Nastavenie SSO vyžaduje konfiguráciu administrátora. Individuálni vývojári sa potom autentizujú prostredníctvom poskytovateľa identity svojej organizácie, nie prostredníctvom osobných účtov Claude.
Autentizácia cez cloudového poskytovateľa funguje pre nasadenia AWS, Google Cloud a Azure. Táto metóda používa existujúce cloudové prihlasovacie údaje namiesto samostatných účtov Claude.
| Metóda autentizácie | Prípad použitia | Zložitosť nastavenia |
|---|---|---|
| Osobný účet | Individuálni vývojári | Jednoduché |
| SSO pre tímy/podniky | Organizácie | Vyžaduje administrátora |
| Cloudový poskytovateľ | Používatelia AWS/GCP/Azure | Stredná |
Inštalácia desktopovej aplikácie
Claude Code ponúka ako príkazový riadok, tak aj desktopovú aplikáciu. Desktopová aplikácia poskytuje grafické rozhranie a zároveň zachováva plnú funkčnosť terminálu.
Stiahnite si desktopový inštalátor z oficiálnej webovej stránky Claude. Stránka ponúka verzie pre macOS, Windows a Windows ARM64. Vyberte príslušnú verziu pre váš systém.
Inštalácia macOS nasleduje rovnaký proces .dmg popísaný vyššie. Používatelia systému Windows si môžu stiahnuť desktopovú aplikáciu pre grafické rozhranie bez potreby nastavenia WSL2.
Desktopová aplikácia obsahuje integrovaný prístup k terminálu. Môže spúšťať relácie Claude Code bez prepínania na externé aplikácie terminálu.
Jednou z výhod desktopovej aplikácie je jej dostupnosť na pozadí. Podľa oficiálnej stránky na stiahnutie sa aplikácia „udržiava pripravená na pozadí“ a dá sa vyvolať z akejkoľvek aplikácie bez prepínania okien alebo straty zamerania.
Použite Get AI Perks na nájdenie kreditov pre váš Claude Code stack
Inštalácia je ľahká časť. Skutočné náklady zvyčajne pochádzajú zo všetkého okolo: infraštruktúra, podporné nástroje a platené služby používané počas nastavenia a testovania. Get AI Perks môže pomôcť tým, že uvedie startupové kredity a zľavy na jednom mieste, spolu s návodom, ako ich aplikovať.
S Get AI Perks môžete:
- Nájsť kredity pre cloudové a AI nástroje
- Skontrolovať podmienky perks pred žiadosťou
- Vyhnúť sa plytvaniu časom na ponuky, na ktoré sa možno nekvalifikujete
- Znížiť náklady na získanie nastavenia
Navštívte Get AI Perks a zistite, či dostupné ponuky zodpovedajú nástrojom, ktoré plánujete použiť s Claude Code.
Rozšírenia IDE a integrácie
Okrem samostatnej inštalácie sa Claude Code integruje s populárnymi vývojovými prostrediami. Existujú rozšírenia pre Visual Studio Code a JetBrains IDE.
Rozšírenie VS Code sa inštaluje cez marketplace. Vyhľadajte „Claude Code“ v paneli Rozšírenia a kliknite na Inštalovať. Rozšírenie vyžaduje, aby bol najprv nainštalovaný nástroj príkazového riadka.
Niektorí používatelia hlásia problémy s priloženým súborom rozšírenia VS Code. Ak automatická inštalácia zlyhá s chybou „End of central directory record signature not found“, priložený súbor .vsix môže byť poškodený.
Obchádzanie spočíva v manuálnej inštalácii rozšírenia z marketplace VS Code namiesto spoliehania sa na verziu pribalenú v CLI. Tým sa tieto dve komponenty oddelia a zabráni sa konfliktom pri inštalácii.
Integrácia JetBrains funguje podobne. Nainštalujte plugin z marketplace JetBrains v rámci IntelliJ IDEA, PyCharm, WebStorm alebo iných produktov JetBrains.
Overenie úspešnosti inštalácie
Správne overenie zabezpečí, že Claude Code funguje správne pred začatím skutočných vývojových úloh.
Základné overenie kontroluje dostupnosť príkazov:
| claude --help claude --version |
Tieto príkazy by sa mali vykonať bez chýb. Príkaz `help` zobrazí dostupné možnosti. Príkaz `version` zobrazí nainštalovanú verziu.
Funkčné testovanie vyžaduje spustenie relácie. Vytvorte testovací priečinok:
| mkdir test-project cd test-project claude |
Tým sa inicializuje interaktívna relácia Claude Code. Nástroj by mal analyzovať adresár (v tomto prípade prázdny) a zobraziť výzvu.
Skúste použiť základné príkazy v relácii. Napíšte `help` na zobrazenie dostupných akcií. Požiadajte o jednoduché úlohy, ako napríklad „vytvoriť súbor README“ alebo „vysvetli, čo dokážeš“.
Úspešné odpovede naznačujú správnu inštaláciu. Ak sa vyskytnú chyby, zvyčajne sa týkajú autentizácie, sieťového pripojenia alebo chýbajúcich závislostí.
Aktualizácia a správa verzií
Claude Code sa predvolene aktualizuje automaticky. Oficiálna dokumentácia vysvetľuje, že nástroj kontroluje nové verzie a inštaluje ich bez zásahu používateľa.
Správanie aktualizácií je možné nakonfigurovať prostredníctvom nastavení Claude Code. Oficiálna dokumentácia pokrýva konfiguráciu kanálov vydaní a možnosti manuálnej aktualizácie.
Manuálne aktualizácie vyžadujú opätovné spustenie inštalačného skriptu. Rovnaký príkaz, aký sa používa na počiatočnú inštaláciu, stiahne najnovšiu verziu:
| curl -fsSL claude.ai/install.sh | bash |
Inštalácia konkrétnych verzií je možná na účely testovania alebo kompatibility. Dokumentácia pokročilého nastavenia pokrýva pripínanie verzií a konfiguráciu kanálov vydaní.
Kanály vydaní zahŕňajú stabilný, beta a nočný. Stabilný je odporúčaný pre produkčnú prácu. Beta a nočné kanály poskytujú skorý prístup k novým funkciám, ale môžu obsahovať chyby.
Bežné problémy s inštaláciou
Niekoľko problémov sa často objavuje v komunitných diskusiách o inštalácii Claude Code.
Konfigurácia PATH spôsobuje mnoho problémov. Ak príkaz `claude` po inštalácii nenájde, adresár s binárnym súborom nie je v systémovej PATH.
Na macOS a Linuxe pridanie adresára do PATH zvyčajne zahŕňa úpravu ~/.bashrc, ~/.zshrc alebo podobných konfiguračných súborov shellu. Inštalačný skript to zvyčajne robí automaticky, ale manuálne overenie pomáha pri riešení problémov.
Používatelia Windowsu v WSL2 možno budú musieť po inštalácii zatvoriť a znova otvoriť terminál. Premenné prostredia sa v existujúcich reláciách neobnovujú.
Sieťové obmedzenia blokujú niektoré inštalácie. Firewally spoločností alebo proxy servery môžu brániť sťahovaniu inštalátora alebo pripojeniu k autentizačným serverom.
Konfigurácia proxy vyžaduje premenné prostredia:
| export HTTP_PROXY=proxy.example.com:8080 export HTTPS_PROXY=proxy.example.com:8080 |
Chyby oprávnení sa vyskytujú pri inštalácii do chránených priečinkov. Inštalátor potrebuje prístup na zápis do /usr/local/bin alebo podobných umiestnení. Spustenie s `sudo` to vyrieši, ale malo by sa tomu vyhnúť, pokiaľ to nie je nevyhnutné.
Často kladené otázky
Môže Claude Code bežať bez internetového pripojenia?
Nie. Claude Code na svoju funkciu potrebuje internetové pripojenie. Nástroj posiela kód a dotazy na servery Anthropic na spracovanie. Lokálne cachovanie môže umožniť dočasnú prácu niektorých operácií offline, ale plná funkčnosť vyžaduje aktívne pripojenie.
Funguje Claude Code s existujúcimi nástrojmi na AI kódovanie?
Áno. Claude Code môže bežať súbežne s GitHub Copilot, Cursor alebo inými nástrojmi pre AI vývoj. Fungujú nezávisle a nekonfliktujú. Používanie viacerých AI asistentov súčasne však môže spôsobiť zmätok v tom, ktorý nástroj spracúva ktorú úlohu.
Vyžaduje sa WSL2 pre všetky funkcie Windowsu?
Nástroj príkazového riadka vyžaduje WSL2 na Windowse. Desktopová aplikácia však beží natívne na Windowse bez WSL2. Desktopová aplikácia poskytuje podobnú funkčnosť prostredníctvom grafického rozhrania namiesto čistej interakcie cez príkazový riadok.
Koľko stojí používanie Claude Code?
Ceny sa líšia v závislosti od používania a úrovne predplatného. Pozrite si oficiálnu webovú stránku Claude, kde nájdete aktuálne ceny, pretože náklady a štruktúra plánov sa časom menia. Niektoré funkcie vyžadujú predplatné Claude Pro alebo Enterprise.
Môže Claude Code upravovať súbory mimo adresára projektu?
Štandardne Claude Code z bezpečnostných dôvodov obmedzuje prístup k súborom na aktuálny adresár projektu. Konfiguračné nastavenia môžu rozšíriť povolenia, ale vyžaduje si to explicitné povolenie. Dokumentácia k sandboxingu podrobne pokrýva správu povolení.
Aký je rozdiel medzi Claude Code a API Claude?
Claude Code je vývojový nástroj pre interaktívnu pomoc pri kódovaní. API Claude poskytuje programový prístup na vytváranie aplikácií, ktoré využívajú AI schopnosti Claude. Slúžia na rôzne účely – jeden pre vývojárov píšucich kód, druhý pre aplikácie integrujúce funkcie AI.
Odstráni odinštalovanie všetky dáta Claude Code?
Odinštalovanie odstráni binárny súbor aplikácie, ale môžu zostať konfiguračné súbory a uložené dáta. Úplné odstránenie vyžaduje manuálne vymazanie adresára ~/.claude na macOS a Linuxe, alebo ekvivalentného umiestnenia AppData na Windowse.
Začíname po inštalácii
Keď je Claude Code nainštalovaný a overený, ďalším krokom je pochopenie, ako ho efektívne používať.
Dokumentácia rýchleho spustenia odporúča začať s jednoduchými úlohami. Prejdite do existujúceho projektu a spustite `claude` na začatie interaktívnej relácie.
Požiadajte Claude, aby vysvetlil štruktúru projektu. Vyžiadajte si zhrnutie toho, čo kódová základňa robí. Tieto prieskumné dotazy pomáhajú pochopiť, ako nástroj interpretuje kód.
Skúste urobiť malé zmeny. Požiadajte Claude, aby pridal komentáre k funkciám, vytvoril jednoduché testovacie súbory alebo refaktoroval základné bloky kódu. Tieto úlohy demonštrujú editačné možnosti bez rizika.
Integrácia s Git funguje automaticky, ak projekt používa správu verzií. Claude Code môže vytvárať commity, vysvetľovať rozdiely a navrhovať vylepšenia na základe zmien.
Oficiálna dokumentácia obsahuje príklady pracovných postupov pre bežné vývojové úlohy. Tieto pokrývajú opravu chýb, implementáciu funkcií, prehľad kódu a automatizované testovanie.
Claude Code je vyvíjajúci sa nástroj. Inštalácia je len základ. Pochopenie jeho schopností, obmedzení a najlepších postupov si vyžaduje experimentovanie a prax.
Ste pripravení nainštalovať Claude Code? Stiahnite si príslušný inštalátor pre vašu platformu z oficiálnej webovej stránky a postupujte podľa krokov uvedených v tomto sprievodcovi. Prihláste sa do svojho účtu Claude, overte, že inštalácia funguje správne, a začnite skúmať vývoj s asistenciou AI.
