Ako nainštalovať Claude Code CLI (Kompletný sprievodca 2026)

Author Avatar
Andrew
AI Perks Team
13,542
Ako nainštalovať Claude Code CLI (Kompletný sprievodca 2026)

Rýchle zhrnutie: Claude Code CLI sa inštaluje pomocou jediného príkazu, ktorý nástroj automaticky stiahne a nakonfiguruje. Na macOS a Linux použite oficiálny shell skript z dokumentácie Anthropic’s, zatiaľ čo používatelia Windows spustia príkazy PowerShell alebo WSL. Po inštalácii sa overte pomocou svojho API kľúča, aby ste mohli začať používať asistenta kódovania AI Claude’ vo svojom termináli.

Claude Code je agentúrny kódovací nástroj, ktorý žije vo vašom termináli a rozumie celému vášmu codebase. Podľa oficiálnej dokumentácie Claude Code dokáže čítať súbory, vykonávať príkazy, upravovať kód a integrovať sa s vývojovými nástrojmi prostredníctvom konverzácií v prirodzenom jazyku.

Ale začatie práce vyžaduje správnu inštaláciu. Tu’s všetko potrebné na inštaláciu Claude Code CLI a jeho správnu konfiguráciu.

Požiadavky na systém pred inštaláciou

Pred inštaláciou Claude Code si overte, či systém spĺňa základné požiadavky. Podľa oficiálnej dokumentácie pre pokročilú konfiguráciu, odstráňte túto vetu úplne.

Skontrolujte inštaláciu Node.js otvorením terminálu a spustením:

node –version

Ak Node.js nie je nainštalovaný alebo je verzia nižšia ako 18, stiahnite si ho z oficiálnej webovej stránky Node.js. Verzia s dlhodobou podporou (LTS) funguje pre Claude Code perfektne.

Okrem Node.js potrebuje systém základné požiadavky: macOS 13.0 alebo vyšší pre používateľov Mac, Windows 10 alebo vyšší pre systémy Windows a väčšina moderných distribúcií Linuxu funguje bez problémov. Na overenie po inštalácii je tiež potrebný účet Claude od Anthropic.

Inštalácia Claude Code na macOS a Linux

Proces inštalácie pre macOS a Linux používa jediný shell príkaz, ktorý zvláda všetko automaticky. Táto metóda je zdokumentovaná v oficiálnej príručke Claude Code quickstart.

Otvorte Terminál a spustite inštalačný skript:

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

Skript stiahne binárny súbor Claude Code, umiestni ho do správneho adresára a automaticky nakonfiguruje PATH. Celý proces sa zvyčajne dokončí za menej ako minútu.

Pre používateľov macOS, ktorí preferujú Homebrew, existuje alternatívna metóda inštalácie, aj keď nie je oficiálne zdokumentovaná v primárnych zdrojoch. Metóda curl zostáva odporúčaným prístupom podľa oficiálnej dokumentácie.

Overenie inštalácie

Po dokončení inštalácie overte, či je Claude Code dostupný:

claude –version

Tento príkaz by mal zobraziť nainštalované číslo verzie. Ak sa zobrazí chyba „command not found“, je potrebné upraviť konfiguráciu PATH.

Podľa oficiálnej dokumentácie pre riešenie problémov sú problémy s PATH najbežnejším problémom pri inštalácii. Riešenie spočíva v pridaní adresára inštalácie Claude’ do konfiguračného súboru shellu.

Inštalácia Claude Code na macOS a Linux

Proces inštalácie pre macOS a Linux sa spolieha na npm (Node Package Manager). Podľa oficiálnej dokumentácie musíte mať pred pokračovaním nainštalovaný Node.js 18+. Na rozdiel od tradičných CLI nástrojov, ktoré používajú shell skripty, Claude Code sa inštaluje globálne cez váš terminál, aby sa zabezpečilo správne spracovanie všetkých závislostí.

Otvorte svoj Terminál a spustite nasledujúci príkaz na inštaláciu balíka:

export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code

Poznámka: Environmentálna premenná CLAUDE_CODE_RELEASE_ALPHA=1 je momentálne vyžadovaná počas verejnej beta/alfa fázy, aby sa potvrdil predbežný stav nástroja.

Tento príkaz stiahne balík z oficiálneho npm registra a prepojí spustiteľný súbor claude s globálnym adresárom bin vášho systému. Aj keď sa niektorí používatelia môžu pokúsiť nájsť Homebrew formuláre, metóda npm je jedinou oficiálne podporovanou a zdokumentovanou cestou inštalácie.

Overenie inštalácie

Po dokončení inštalácie overte, či je CLI správne namapované na vaše prostredie spustením:

claude –version

Tento príkaz by mal zobraziť aktuálne číslo verzie (napr. 0.2.9). Ak narazíte na chybu „command not found“, zvyčajne to znamená, že váš globálny adresár npm nie je v PATH vášho systému.

Podľa oficiálnej dokumentácie pre riešenie problémov môžete toto opraviť identifikáciou svojho npm prefixu pomocou príkazu npm config get prefix a zabezpečením, že výsledný adresár /bin bude pridaný do vášho súboru .zshrc alebo .bashrc.

Štvorstupňový automatizovaný proces inštalácie pre systémy macOS a Linux

Inštalácia Claude Code na Windows

Inštalácia pre Windows ponúka dva hlavné prístupy: natívna inštalácia cez PowerShell alebo použitie Windows Subsystem for Linux (WSL). Oficiálna dokumentácia odporúča PowerShell pre väčšinu používateľov.

Metóda inštalácie cez PowerShell

Otvorte PowerShell ako správca (kliknite pravým tlačidlom myši na ponuku Štart a vyberte „Windows PowerShell (Admin)“). Spustite tento príkaz:

irm claude.ai/install.ps1 | iex

Skript PowerShell automaticky spracuje stiahnutie, inštaláciu a konfiguráciu PATH. Po dokončení zatvorte a znovu otvorte PowerShell, aby sa zmeny PATH prejavili.

Metóda inštalácie cez WSL

Vývojári, ktorí už používajú WSL, si môžu nainštalovať Claude Code pomocou metódy pre Linux. Otvorte terminál WSL a spustite rovnaký príkaz curl použitý pre Linux:

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

Prístup cez WSL funguje rovnako ako natívne inštalácie v Linuxe. Jedna výhoda: WSL poskytuje prostredie bližšie k Unixu, ktoré zodpovedá konfiguráciám produkčných serverov.

Podľa oficiálnej dokumentácie pre riešenie problémov sa používatelia WSL občas stretávajú s problémami s pripojením. Ak sa inštalácia zasekne, overte, či WSL má prístup k externým sieťam a či pravidlá firewallu neblokujú premávku.

Nájdite kredity Claude a AI nástrojov na jednom mieste

Inštalácia Claude Code CLI je jeden krok. Dlhodobé platenie za AI nástroje je iný. Get AI Perks zhromažďuje startup kredity a zľavy na softvér pre AI a cloudové nástroje na jednom mieste. Poskytuje zakladateľom prístup k viac ako 200 výhodám, vrátane ponúk od Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom a ďalších. Platforma tiež zobrazuje podmienky výhod a návody na uplatnenie každej ponuky.

Hľadáte kredity Claude alebo Anthropic?

Navštívte Get AI Perks, kde nájdete:

  • kredity a zľavy na AI nástroje na jednom mieste
  • podmienky výhod pred ich uplatnením
  • návody na uplatnenie startup ponúk

👉 Navštívte Get AI Perks a prezrite si dostupné ponuky pre Claude, Anthropic a ďalší AI softvér.

Autentizácia a počiatočná konfigurácia

Po inštalácii vyžaduje Claude Code autentizáciu, aby mohol fungovať. Nástroj používa API kľúče od Anthropic na overenie prístupu.

Proces autentizácie spustíte spustením:

claude

Po prvom spustení tohto príkazu Claude Code vyzve na autentizáciu. Podľa oficiálnej príručky quickstart sa otvorí okno prehliadača na prihlásenie do účtu Anthropic.

Po prihlásení cez prehliadač získa CLI automaticky autentizačný token. Tento token sa lokálne ukladá a pretrváva medzi reláciami, takže opakovaná autentizácia nie je potrebná.

Konfigurácia nastavení na úrovni projektu

Claude Code podporuje konfiguráciu na viacerých úrovniach podľa oficiálnej dokumentácie nastavení. Najbežnejšie úrovne konfigurácie sú:

RozsahUmiestneniePrípad použitia
Používateľ~/.claude/ adresárOsobné preferencie naprieč všetkými projektmi
Projekt.claude/ v repozitáriSpoločná tímová konfigurácia
Lokálna.claude/settings.local.jsonPrepísania špecifické pre stroj

Pre prvotné nastavenie je postačujúca konfigurácia na úrovni používateľa. Nastavenia na úrovni projektu sa stanú dôležitými pri práci s tímami, ktoré zdieľajú štandardy kódovania.

Začatie prvej relácie Claude Code

Po dokončení inštalácie a autentizácie spustíte Claude Code spustením príkazu bez argumentov:

claude

Tým sa spustí interaktívny režim, kde Claude reaguje na požiadavky v prirodzenom jazyku. Oficiálna dokumentácia popisuje interaktívny režim ako primárny spôsob používania Claude Code pre vývojové úlohy.

Vyskúšajte jednoduchý testovací príkaz:

Ukáž mi štruktúru tohto projektu

Claude Code analyzuje aktuálny adresár a poskytne prehľad o štruktúre codebase. To demonštruje, že inštalácia funguje správne a Claude má prístup na čítanie súborov.

Základné príkazy pre denné používanie

Okrem interaktívneho režimu Claude Code podporuje niekoľko vzorov príkazov zdokumentovaných v referencii CLI:

Vzor príkazuÚčelPríklad
claudeSpustenie interaktívnej relácieclaude
claude “úloha”Vykonanie jednorazovej úlohyclaude “oprav chyby lintovania”
claude -p “dotaz”Rýchly dotaz bez relácieclaude -p “čo robí táto funkcia”

Vzor jednorazovej úlohy je obzvlášť užitočný pre CI/CD pipeline a automatizačné skripty, kde interaktívna relácia nie je vhodná.

Časté riešenie problémov pri inštalácii

Aj napriek automatizovaným inštalačným skriptom sa občas vyskytnú problémy. Oficiálna dokumentácia pre riešenie problémov pokrýva najčastejšie problémy.

Chyby „Command Not Found“

Ak terminál zobrazí „command not found: claude“ po inštalácii, konfigurácia PATH sa nedokončila správne. Na macOS a Linux manuálne pridajte umiestnenie binárneho súboru Claude’ do konfiguračného súboru shellu.

Pre používateľov bash upravte ~/.bashrc alebo ~/.bash_profile a pridajte:

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

Pre používateľov zsh (predvolené na modernom macOS) upravte ~/.zshrc s rovnakým riadkom. Po uložení obnovte konfiguráciu pomocou source ~/.zshrc alebo otvorte nové okno terminálu.

Problémy so sieťou a firewallom

Firemné siete a reštriktívne firewally niekedy blokujú inštalačný skript. Podľa dokumentácie pre riešenie problémov, ak sa inštalácia zasekne alebo vráti HTML namiesto vykonania, prístup k serverom Anthropic’s môže byť blokovaný.

Riešenie spočíva v samostatnom stiahnutí inštalačného skriptu:

curl -fsSL code.anthropic.com/install.sh -o install.sh
chmod +x install.sh
./install.sh

Tento prístup poskytuje väčšiu viditeľnosť do toho, čo zlyháva, ak sa počas sťahovania alebo vykonávania vyskytnú chyby.

Problémy špecifické pre WSL

Používatelia Windows používajúci WSL sa občas stretávajú s problémami s pripojením medzi subsystémom Linux a Windows. Oficiálna dokumentácia uvádza, že pravidlá firewallu možno bude potrebné upraviť, aby umožnili prevádzku WSL.

Ak sa Claude Code úspešne nainštaluje, ale nemôže sa pripojiť k serverom Anthropic’s na autentizáciu, skontrolujte, či firewall Windows umožňuje sieťový prístup WSL. Príručka na riešenie problémov poskytuje špecifické príkazy PowerShell na konfiguráciu pravidiel firewallu.

Aktualizácia Claude Code

Claude Code dostáva pravidelné aktualizácie s novými funkciami a vylepšeniami. Podľa oficiálnej dokumentácie sa aktualizácie inštalujú pomocou rovnakého príkazu ako pri počiatočnej inštalácii.

Spustite inštalačný skript znova:

curl -fsSL code.anthropic.com/install.sh | sh

Skript detekuje existujúcu inštaláciu a aktualizuje ju na najnovšiu verziu. Počas procesu aktualizácie sa nestratia žiadne konfigurácie ani autentizácie.

Pred a po aktualizácii skontrolujte aktuálnu verziu:

claude –version

Zoznam zmien v oficiálnej dokumentácii Claude Code uvádza všetky zmeny medzi verziami, čo pomáha určiť, či aktualizácia prináša funkcie relevantné pre konkrétne pracovné postupy.

Ďalšie kroky po inštalácii

Po nainštalovaní a fungovaní Claude Code je možné preskúmať pokročilé funkcie. Oficiálna dokumentácia popisuje niekoľko oblastí, ktoré stojí za to preskúmať:

  • Schopnosti a prispôsobenie: Podľa oficiálnej dokumentácie pre schopnosti Claude Code podporuje vlastné schopnosti definované v súboroch Markdown v adresári .claude/skills/. Tieto schopnosti rozširujú možnosti Claude o príkazy a pracovné postupy špecifické pre projekt.
  • Model Context Protocol (MCP): Integrácia MCP umožňuje Claude Code pripojiť sa k externým nástrojom a službám. Tým sa Claude stane centrom, ktoré môže pristupovať k databázam, API a iným vývojovým zdrojom.
  • Tímová spolupráca: Konfiguračné súbory na úrovni projektu v adresári .claude/ je možné commitmentovať do správy verzií, čím sa nastavenia Claude Code zdieľajú naprieč celými vývojovými tímami.
  • Oficiálna dokumentácia poskytuje podrobné návody pre každú z týchto oblastí, ktoré nadväzujú na základnú inštaláciu popísanú tu.

Často kladené otázky

Potrebujem platené predplatné Claude na používanie Claude Code CLI?

Claude Code vyžaduje účet Claude od Anthropic, ale konkrétny potrebný stupeň predplatného závisí od používania. Podľa oficiálnej dokumentácie je autentizácia nevyhnutná, ale podrobnosti o cenách by mali byť overené na oficiálnej webovej stránke Anthropic, pretože plány sa časom menia.

Môžem nainštalovať Claude Code bez oprávnení správcu?

Na macOS a Linux sa Claude Code štandardne inštaluje do domovského adresára používateľa a nevyžaduje prístup správcu. Používatelia Windows môžu potrebovať oprávnenia správcu pre metódu inštalácie cez PowerShell, hoci inštalácie cez WSL nevyžadujú prístup správcu.

Funguje Claude Code offline?

Nie. Claude Code je nástroj poháňaný AI, ktorý komunikuje so servermi Anthropic’s na spracovanie požiadaviek. Podľa oficiálnej dokumentácie je na analýzu kódu a generovanie odpovedí Claude potrebný aktívny internetový pripojenie.

Ako odinštalujem Claude Code?

Oficiálna dokumentácia pre pokročilú konfiguráciu vysvetľuje, že odinštalovanie zahŕňa odstránenie binárneho súboru a konfiguračných súborov. Na macOS a Linux odstráňte adresár ~/.claude a odstráňte úpravu PATH z konfiguračných súborov shellu. Používatelia Windows by mali odstrániť inštalačný adresár a vymazať premennú prostredia PATH.

Môže Claude Code pristupovať k celému môjmu súborovému systému?

Štandardne Claude Code pracuje v rámci aktuálneho pracovného adresára a jeho podadresárov. Podľa oficiálnej dokumentácie pre povolenia je možné prístup ďalej obmedziť pomocou nastavení sandboxu v konfiguračných súboroch. Claude vždy žiada o potvrdenie pred vykonaním potenciálne deštruktívnych operácií.

Aký je rozdiel medzi Claude Code CLI a Claude Desktop?

Claude Code CLI beží v termináli a zameriava sa na vývojové pracovné postupy s priamym prístupom k súborovému systému a vykonávaním príkazov. Claude Desktop je samostatná aplikácia s grafickým rozhraním. Oba nástroje slúžia na rôzne účely, pričom CLI je optimalizované pre vývojárov, ktorí preferujú pracovné postupy založené na termináli.

Ako často by som mal aktualizovať Claude Code?

Aktualizácie je možné nainštalovať kedykoľvek je to vhodné. Zoznam zmien dokumentuje nové funkcie a opravy chýb. Pre tímy koordinácia aktualizácií zabezpečuje, že všetci používajú kompatibilné verzie, hoci Claude Code si zachováva spätnú kompatibilitu s konfiguračnými súbormi naprieč verziami.

Záver

Inštalácia Claude Code CLI trvá len pár minút bez ohľadu na operačný systém. Automatizované inštalačné skripty zvládajú konfiguráciu, nastavenie PATH a umiestnenie binárneho súboru bez manuálneho zásahu.

Po inštalácii a autentizácii sa Claude Code stáva výkonným asistentom kódovania AI prístupným z akéhokoľvek terminálu. Príkazy v prirodzenom jazyku umožňujú vývojárom písať kód, opravovať chyby a automatizovať úlohy bez toho, aby opustili príkazový riadok.

Pripravený zažiť AI asistovaný vývoj? Spustite inštalačný príkaz pre vašu platformu a začnite svoju prvú reláciu Claude Code ešte dnes. Oficiálna dokumentácia na code.claude.com poskytuje komplexné návody pre pokročilé funkcie po dokončení základného nastavenia.

AI Perks

AI Perks poskytuje prístup k exkluzívnym zľavám, kreditom a ponukám na AI nástroje, cloudové služby a API, aby pomohol startupom a vývojárom ušetriť peniaze.

AI Perks Cards

This content is for informational purposes only and may contain inaccuracies. Credit programs, amounts, and eligibility requirements change frequently. Always verify details directly with the provider.