Claude Code séria tutoriálov 5: Ako nainštalovať Claude Code?

Ako nainštalovať Claude Code

Inštalácia Claude Code nemá grafické rozhranie s tlačidlom 'Ďalej', celý proces prebieha v príkazovom riadku. Ak bežne používate npm, celý proces netrvá dlhšie ako dve minúty.

Predpoklady

Pred začatím sa uistite, že máte po ruke nasledujúce:

Node.js 18 alebo novší
Spôsob kontroly: v termináli spustite node -v. Ak je verzia nižšia ako 18, použite nvm, fnm alebo priamo nodejs.org na upgrade.
Anthropic účet
Registrácia na adrese https://console.anthropic.com. Účet poskytne API kľúč, ktorý budete potrebovať po inštalácii. Registrácia je bezplatná, skutočné náklady sa počítajú podľa využitia.
Sieťový prístup k Anthropic API endpointu
Predvolená doména je api.anthropic.com. Ak prostredie vyžaduje konfiguráciu proxy, nezabudnite v termináli nastaviť HTTP_PROXY alebo HTTPS_PROXY.

Spôsob inštalácie 1: Globálna inštalácia cez npm

Toto je najbežnejší spôsob, nainštalujete raz a potom ho môžete použiť kdekoľvek.

npm install -g @anthropic-ai/claude-code

Po dokončení spustite claude --version; ak sa zobrazí číslo verzie, inštalácia je úspešná. Po globálnej inštalácii je príkaz claude dostupný priamo v akomkoľvek adresári.

Ak narazíte na chybu oprávnení (bežná v adresári /usr/local/lib na macOS), existujú dva spôsoby riešenia:

Použite sudo na inštaláciu (jednoduché, ale bezpečnostne sporné).
Nakonfigurujte npm na používanie používateľského adresára, aby ste sa vyhli sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Potom pridajte ~/.npm-global/bin do PATH a reštartujte terminál.

Spôsob inštalácie 2: npx - použite a choďte

Ak nechcete inštalovať nič globálne, alebo si to chcete len dočasne vyskúšať, npx je priamejšie.

npx @anthropic-ai/claude-code

npx dočasne stiahne najnovší balík a po spustení nezanechá globálny príkaz. Pri každom použití skontroluje aktualizácie, takže je vždy aktuálny. Nevýhodou je, že je o niečo pomalší (každý krát sa sťahuje) a nie je vhodný na časté volania v automatických skriptoch.

Vhodné scenáre: prvé vyskúšanie, dočasné použitie na cudzom počítači alebo občasné použitie.

Overenie, či sa dá spustiť

Po inštalácii sa ešte neponáhľajte s autentifikáciou. Spustite jednoduchý príkaz a zistite, či sa nástroj spustí:

claude --help

Ak sa zobrazí pomocné informácie, binárny súbor je v poriadku. Ďalším krokom je pripojenie vášho účtu, o tom neskôr

Po inštalácii oboma spôsobmi je jadro rovnaké, následná autentifikácia a používanie sú úplne rovnaké. Vyberte si ten, ktorý vám vyhovuje.

Často kladené otázky

Príliš nízka verzia Node
Verzia nižšia ako 18 spôsobí priamo chybu, nie varovanie. Inovácia Node je najpriamejšie riešenie.
Sieťový timeout
Či už ide o sťahovanie balíka cez npm alebo následné pripojenie k API, môže byť zablokované proxy alebo firewallom. Najprv overte, že curl https://api.anthropic.com funguje, potom pokračujte.
Použitie natívneho cmd v systéme Windows
Aj keď je to teoreticky možné, odporúča sa používať Git Bash, WSL2 alebo Windows Terminal, aby ste sa vyhli zvláštnym problémom s escapovaním ciest.