Claude Code série tutoriálů 5: Jak nainstalovat Claude Code?

Jak nainstalovat Claude Code

Instalace Claude Code nemá žádné grafické rozhraní s tlačítky 'Další', celý proces probíhá v příkazovém řádku. Pokud obvykle používáte npm, celý proces nezabere více než dvě minuty.

Předpoklady

Než začnete, ujistěte se, že máte po ruce následující:

Node.js 18 nebo novější
Způsob kontroly: v terminálu spusťte node -v. Pokud je verze nižší než 18, upgradujte pomocí nvm, fnm nebo přímo z nodejs.org.
Účet Anthropic
Registrační adresa je https://console.anthropic.com. Účet poskytne API klíč, který bude potřeba po instalaci. Registrace je zdarma, skutečné náklady se počítají podle použití.
Síťový přístup ke koncovému bodu API Anthropic
Výchozí doména je api.anthropic.com. Pokud prostředí vyžaduje konfiguraci proxy, nezapomeňte v terminálu nastavit HTTP_PROXY nebo HTTPS_PROXY.

Způsob instalace 1: globální instalace pomocí npm

Toto je nejběžnější způsob, nainstalujete jednou a můžete používat všude.

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

Po dokončení spusťte claude --version. Pokud se zobrazí číslo verze, instalace je úspěšná. Po globální instalaci lze příkaz claude volat přímo z libovolného adresáře.

Pokud narazíte na chybu oprávnění (běžnou v adresáři /usr/local/lib na macOS), existují dva způsoby řešení:

Použijte sudo k instalaci (jednoduché, ale bezpečnostně sporné).
Nakonfigurujte npm tak, aby používal uživatelský adresář a vyhnul se sudo:
bash mkdir -p ~/.npm-global npm config set prefix '~/.npm-global'
Poté přidejte ~/.npm-global/bin do PATH a restartujte terminál.

Způsob instalace 2: npx – použij a jdi

Pokud nechcete nic instalovat globálně, nebo si to chcete jen vyzkoušet, použijte npx – je to přímější.

npx @anthropic-ai/claude-code

npx dočasně stáhne nejnovější balíček, po spuštění nezanechá žádný globální příkaz. Při každém použití kontroluje aktualizace, takže je vždy v nejnovější verzi. Nevýhodou je mírná pomalost (pokaždé se stahuje) a není vhodný pro časté volání v automatických skriptech.

Vhodné pro: první vyzkoušení, dočasné použití na cizím počítači nebo občasné použití.

Ověření, zda se nástroj spouští správně

Po instalaci nespěchejte s autentizací. Spusťte jednoduchý příkaz a zjistěte, zda se nástroj spouští:

claude --help

Pokud se zobrazí nápověda, binární soubor je v pořádku. Dalším krokem je připojení vašeho účtu, o tom bude řeč později.

Po instalaci oběma způsoby je samotný nástroj stejný, následná autentizace a použití jsou zcela shodné. Vyberte si ten, který vám vyhovuje.

Časté problémy

Příliš nízká verze Node
Pod 18 se zobrazí chyba, nikoli varování. Upgrade Node je nejjednodušší řešení.
Časový limit sítě
Ať už při stahování balíčku npm nebo při pozdějším připojení k API, může dojít k zablokování kvůli proxy nebo firewallu. Nejprve ověřte, že curl https://api.anthropic.com funguje, a pak pokračujte.
Použití nativního cmd pod Windows
I když je to teoreticky možné, doporučujeme použít Git Bash, WSL2 nebo Windows Terminal, abyste se vyhnuli zvláštním problémům s převodem cest.