Ako nainštalovať Claude Code z oficiálnej webovej stránky

Čo je Claude Code a prečo sa používa v termináli?#

Terminál vystraší takmer každého, kto sa pustí do vibe codingu bez vzdelania v oblasti vývoja softvéru. Vyzerá ako čierne okno z hackerských filmov, no v skutočnosti je to len riadok, do ktorého píšete príkazy. Claude Code ho potrebuje práve preto, aby mohol otvárať vaše súbory, meniť ich a sám spúšťať kontroly, zatiaľ čo vy úlohu opisujete slovami.

Anthropic opisuje tento produkt takto.

Rozdiel oproti známemu chatu je jednoduchý. V prehliadači ručne kopírujete kód sem a tam medzi oknom a editorom. Claude Code vstúpi priamo do priečinka projektu, prečíta potrebné súbory, vykoná zmenu a ukáže vám, čo zmenil. Vy rozhodujete a schvaľujete; on za vás vykonáva mechanickú prácu.

Ak naozaj nechcete používať terminál, Anthropic má počítačovú aplikáciu s bežným oknom a webovú verziu na adrese claude.ai/code, ktorá funguje priamo v prehliadači. Najvýkonnejšou a najflexibilnejšou možnosťou je však verzia pre terminál, ktorej sa venuje celý tento článok.

Kde je oficiálna webová stránka Claude Code a čo si máte stiahnuť?#

Začiatočníkov najprv mätie, kde sa nachádza oficiálna webová stránka Claude Code a na čo kliknúť, aby si ho stiahli. Tu je tabuľka všetkých oficiálnych adries spoločnosti Anthropic, aby ste nemuseli hádať.

Inštalačný program si z webovej stránky nesťahujete tak, ako by ste to urobili pri bežnom programe, čo je v rozpore s očakávaniami. Nainštalujete ho príkazom v termináli, ktorý potom stiahne správnu verziu pre váš systém. Tento článok obsahuje presné príkazy pre Mac, Windows a Linux.

Častou pascou je názov: ľudia ho často nesprávne napíšu ako clode code, clade code, слод код alebo clode design. Produkt sa volá Claude Code, s au. Pri hľadaní oficiálnej webovej stránky na to pamätajte: domény s podobným pravopisom patria niekomu inému.

Je dobré poznať aj presný názov balíka npm. Kanonický balík je @anthropic-ai/claude-code s predponou @anthropic-ai/. Samotná spoločnosť Anthropic vlastní krátky názov claude-code bez predpony — je to jej oficiálny odkaz na ten istý balík. Jednoduché pravidlo: vydavateľom má byť Anthropic a názov určený na inštaláciu má obsahovať predponu.

Čo potrebujete na inštaláciu: požiadavky na počítač#

Požiadavky Claude Code sú skromné: náročnú prácu vykonávajú servery Anthropic; váš počítač iba odosiela požiadavky a prijíma odpovede.

Osobitná poznámka o Node.js, okolo ktorého koluje najviac mýtov. Natívny inštalátor — ten, ktorý odporúča samotná Anthropic — Node.js vôbec nepotrebuje: nainštaluje sa ako jediný samostatný súbor. Node.js je potrebný len vtedy, ak Claude Code inštalujete cez npm; v takom prípade potrebujete verziu 22 alebo novšiu. Staršie články uvádzajú „Node 18 a novší“ — to už neplatí; riaďte sa verziou 22+.

Pre hlavnú verziu potrebujete terminál. Ak ho nechcete používať, nainštalujte si počítačovú aplikáciu s bežným oknom alebo použite webovú verziu na adrese claude.ai/code. Verzia pre terminál má stále viac funkcií, preto zvyšok článku vysvetľuje, ako ju nainštalovať.

Inštalácia Claude Code je ako získanie nástroja do rúk. Sama osebe však často halucinuje: zabudne na váš projekt, vymýšľa si a uprostred úlohy stratí niť. Spoľahlivosť zabezpečuje kombinácia troch vecí: klon AI, Second Brain a inžinierstvo kontextu. To sú tri piliere, ktoré bránia AI v halucinovaní.

Ako nainštalovať Claude Code v macOS?#

Otvorte Terminal (je súčasťou každého Macu: v Spotlight stlačte Cmd+Space a napíšte „Terminal“) a vložte tento jeden riadok:

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

Príkaz stiahne inštalátor z oficiálnej adresy Anthropic a nainštaluje Claude Code. Node.js netreba. Natívny spôsob je pohodlný aj vďaka aktualizáciám.

Ak už používate Homebrew, máte aj druhú možnosť:

brew install --cask claude-code

Rozdiel je v spôsobe aktualizácie: natívny inštalátor sa aktualizuje sám, kým Homebrew nie — budete ho musieť aktualizovať manuálne príkazom brew upgrade claude-code. Samotný program je rovnaký, takže si vyberte spôsob, na ktorý ste zvyknutí. Ak si nie ste istí, použite prvý.

Ako nainštalovať Claude Code vo Windows?#

Najprv zistite, kde ste. Windows má dva shelly a každý má vlastný príkaz. Otvorte okno a pozrite sa na začiatok výzvy: PS C:\> znamená PowerShell, zatiaľ čo samotné C:\> bez PS znamená Príkazový riadok (CMD).

Pre PowerShell (najjednoduchšie ho otvoríte kliknutím pravým tlačidlom na tlačidlo Štart a výberom položky „Terminal“):

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

Pre Príkazový riadok (CMD):

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

Tretia možnosť je použiť vstavaný správca balíkov WinGet:

winget install Anthropic.ClaudeCode

Ak už máte funkčné prostredie vo WSL (Linux vo Windows), nainštalujte Claude Code priamo vo WSL pomocou rovnakého príkazu ako v Linuxe. Vo WSL je osobitná komplikácia týkajúca sa Node, ktorú vysvetlím nižšie v časti o bežných chybách.

Ako nainštalovať Claude Code v Linuxe?#

Základný spôsob je rovnaký pre každú obľúbenú distribúciu: samostatný inštalátor:

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

Node.js nie je potrebný; program sa dodáva ako jeden súbor a potom sa sám aktualizuje.

Ak ste zvyknutí inštalovať programy iba prostredníctvom systémového správcu balíkov, môžete pridať oficiálne úložiská Anthropic: apt pre Debian a Ubuntu, dnf pre Fedora a RHEL a apk pre Alpine. Sú podpísané kľúčom a majú kanály stable a latest. Pre začiatočníka je to zbytočne zložité, preto podrobnosti ponechávam na dokumentáciu v časti Zdroje a štandardne odporúčam príkaz uvedený vyššie.

Na lacných serveroch sa môže vyskytnúť jeden problém. Ak má počítač veľmi málo voľnej pamäte, inštalácia sa môže zastaviť so slovom Killed (kód 137) — systému sa minula pamäť, a preto proces ukončil. Riešením je pridať súbor swap: Claude Code potrebuje na inštaláciu približne 512 MB voľnej pamäte.

Ako prvýkrát spustiť Claude Code?#

Prvé spustenie trvá niekoľko minút. Postup je takýto.

1. Prejdite do priečinka projektu

   V termináli použite príkaz cd path-to-project, aby ste prešli do priečinka, s ktorým chcete pracovať, a potom napíšte claude.

2. Prihláste sa do svojho účtu

   Otvorí sa prehliadač s prihlasovacím oknom. Ak sa neotvorí automaticky, stlačením c skopírujte odkaz a ručne ho vložte do prehliadača. Ak prehliadač zobrazí kód (môže sa to stať vo WSL a na vzdialených serveroch), vložte tento kód späť do terminálu.

3. Počkajte na potvrdenie

   Po prihlásení sa v termináli zobrazí Login successful a výzva na stlačenie Enter.

4. Položte prvú otázku

   Položte jednoduchú otázku o projekte, napríklad „čo tento projekt robí?“. Claude prečíta súbory a odpovie.

5. Schváľte prvú zmenu

   Keď ho požiadate o zmenu, Claude vám ukáže navrhované úpravy a požiada o potvrdenie. Režimy prístupu môžete prepínať pomocou Shift+Tab.

Hneď na začiatku sa oplatí naučiť niekoľko základných príkazov v relácii: /help zobrazí príkazy, /clear vymaže históriu konverzácie a /exit ukončí reláciu (to isté urobí aj dvojité Ctrl+D). Claude vám toto všetko ukáže, ak napíšete /help.

Prihlásenie pomocou predplatného alebo kľúča API: čo si vybrať?#

Toto je prvá otázka, ktorá vznikne pri prihlasovaní.

Prihlásiť sa môžete dvoma spôsobmi a líšia sa spôsobom platby.

Ak sa prihlasujete s predplatným, jednoducho použite svoj účet Claude.ai. Ak sa prihlasujete pomocou kľúča API, získajte ho v Claude Console (platform.claude.com); poplatky sa pri práci odpočítavajú z predplateného zostatku. Nastavte kľúč v premennej prostredia ANTHROPIC_API_KEY a Claude Code nebude zakaždým otvárať prehliadač.

Účty môžete v relácii prepínať pomocou /login a odhlásiť sa pomocou /logout.

Claude Code sa však nespustí bez plateného prístupu. Ak ešte nemáte účet, najprv zistite, ktorú e-mailovú adresu použiť pri registrácii: neskôr ju nebudete môcť zmeniť.

Ako skontrolovať, či sa všetko nainštalovalo správne?#

Od začiatku sa oplatí poznať tri príkazy.

Prvý skontroluje verziu:

claude --version

Funkčná inštalácia odpovie číslom v tvare X.Y.Z (Claude Code). Konkrétne číslice sa menia s jednotlivými verziami; dôležité je, aby sa vôbec vrátilo číslo verzie. Odpoveď „command not found“ znamená niečo iné — tomu sa budem venovať v nasledujúcej časti.

Druhým príkazom je diagnostika, ak sa niečo pokazí.

Tretím príkazom je /status v rámci relácie: ukazuje, ako ste sa prihlásili, ktorý e-mail alebo organizácia je prepojená a či váš prístup nevypršal. Príkaz claude update vykoná najnovšiu aktualizáciu okamžite namiesto čakania na aktualizáciu na pozadí.

Prečo sa po inštalácii nedá nájsť príkaz claude?#

Toto je najčastejšia sťažnosť začiatočníkov a znie to horšie, než to v skutočnosti je. Terminál nehľadá príkazy v celom počítači; kontroluje iba priečinky uvedené v PATH. Claude Code sa nachádza v ~/.local/bin/claude (na Macu a Linuxe) alebo v %USERPROFILE%\\.local\\bin\\claude.exe (vo Windows) a ak tento priečinok nie je v PATH, terminál program jednoducho nevidí.

V Macu a Linuxe pridajte priečinok do zoznamu. Otvorte súbor s nastaveniami svojho shellu (~/.zshrc pre Zsh, ~/.bashrc pre Bash) a na koniec pridajte tento riadok:

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

Potom terminál zatvorte a znova otvorte (alebo spustite source ~/.zshrc). Následne sa príkaz claude nájde.

Bežné chyby pri inštalácii a prvom spustení#

Prejdime si ich postupne; všetky sú uvedené v oficiálnej príručke na riešenie problémov od Anthropic.

1. Stará verzia Node pri inštalácii cez npm. Balík @anthropic-ai/claude-code vyžaduje Node.js 22 alebo novší. Vo Windows môže npm zlyhať so správou o vypnutých skriptoch — ich spusteniu bráni politika PowerShellu. Vo WSL je častou chybou exec: node: not found: WSL používa Node pre Windows namiesto Node pre Linux. Ak máte s npm problémy, prejdite na natívny inštalátor; Node nepotrebuje.
2. Nesprávny inštalátor pre shell. Hlásenie 'irm' is not recognized znamená, že ste príkaz pre PowerShell vložili do Príkazového riadka. The token '&&' is not a valid statement separator znamená opak: príkaz CMD ste spustili v PowerShelli. A parameter cannot be found that matches parameter name 'fsSL' znamená, že ste v PowerShelli spustili príkaz pre Mac/Linux. Skontrolujte začiatok výzvy: PS C:\ označuje PowerShell a C:\ CMD.
3. Starý kľúč API má prednosť pred predplatným. Ak je vaše predplatné aktívne, ale v prostredí je stále nastavený starý kľúč, zobrazí sa hlásenie API Error: 400 ... This organization has been disabled. Kľúč má pri prihlasovaní prednosť pred predplatným. Odstráňte ho príkazom unset ANTHROPIC_API_KEY (v PowerShelli použite Remove-Item Env:ANTHROPIC_API_KEY), skontrolujte súbory ~/.zshrc a ~/.bashrc a potom zadajte /status.
4. Nedostatok pamäte na slabom serveri. Inštalácia sa zastaví so slovom Killed a kódom 137 — znamená to, že nie je dostatok RAM. Potrebujete približne 512 MB voľnej pamäte; pridaním swapu problém vyriešite.
5. Inštalátor vrátil niečo iné. Chyba syntax error near unexpected token '<' alebo zmienka o <!DOCTYPE html> znamená, že inštalačná adresa namiesto inštalačného skriptu vrátila webovú stránku — zvyčajne kvôli vášmu regiónu, firemnej bráne firewall alebo dočasnému výpadku. Skúste inú metódu (Homebrew, WinGet) alebo to skúste znova o niekoľko minút.

Pri každej z týchto chýb je prvý krok rovnaký: spustite claude doctor. Ukáže, čo nefunguje, a poradí, kde hľadať.

Je tu ešte jedna diagnostická komplikácia: samotná odpoveď 403 počas inštalácie môže pochádzať aj z firemnej brány firewall alebo proxy servera. Ak ste teda vo firemnej sieti, najprv skontrolujte, či neblokuje prístup.

Čo robiť po inštalácii: prvé kroky#

Inštalácia je len začiatok. Skutočná práca sa začína potom a prvým problémom, na ktorý ľudia narazia, je pamäť. Jazykový model si vás medzi konverzáciami nepamätá: v novom chate vie iba to, čo ste vložili do jeho kontextu.

Preto je prvým skutočným krokom po inštalácii vytvorenie súboru CLAUDE.md v koreňovom priečinku projektu. Je to textový súbor s pravidlami a kontextom projektu, ktorý Claude Code číta pri každom spustení. Raz opíšte, čomu sa venujete, ako je projekt usporiadaný a na čom záleží — a nebudete to musieť opakovať v každej konverzácii.

V samostatnej príručke vysvetľujem, ako tento súbor pripraviť a prispôsobiť Claude: ako prispôsobiť Claude. Pripravil som aj všeobecný prehľad nástrojov na vibe coding pre rok 2026.

Na čo sa ľudia ešte pýtajú?#

Úplný rámec vibe codingu: klon AI + Second Brain + inžinierstvo kontextu.