Než začneš
Claude Code běží v terminálu tvého počítače – v tom okně s textem, kam píšeš příkazy. Taky budeš potřebovat placený plán Claude (Pro nebo Max); bezplatný plán Claude Code neobsahuje.
Dobrá zpráva: s oficiálním instalátorem nemusíš instalovat Node.js. Je to jen jeden příkaz.
Jedna věc, kterou musíš udělat nejdřív, pokud jsi na Windows: Claude Code potřebuje pro svou funkci bezplatný nástroj Git pro Windows (používá ho na pozadí – nemusíš se ho učit nebo ho sám používat). Pokud jsi na Windows a ještě ho nemáš, nainstaluj si ho, než budeš pokračovat:
Jdi na git-scm.com/downloads/win a stáhni si instalátor.
Spusť instalátor. Klikni na Další na každé obrazovce, abys přijal výchozí nastavení – nemusíš nic měnit, i když je tam několik obrazovek.
Pokud se tě zeptá, jaký editor použít, nech výchozí a klikni na Další.
Až se dostaneš na obrazovku s názvem "Adjusting your PATH environment" (Úprava vaší cestovní proměnné prostředí), ponech zvolenou možnost, která je už vybraná.
Nejseš si jistý, jestli máš Git? Nainstaluj si ho stejně – opakovaná instalace nezpůsobuje žádné problémy. Uživatelé Macu můžou přeskočit; nic dalšího není potřeba.
Krok 1 — Otevři svůj terminál
Otevři terminál na svém počítači. Způsob, jakým to uděláš, závisí na tvém systému:
Windows 10: Stiskni klávesu Windows + R, napiš
cmda stiskni Enter. Otevře se Příkazový řádek.Windows 11: Klikni na vyhledávací lištu na hlavním panelu (nebo stiskni klávesu Windows), napiš
Terminala klikni na Terminál ve výsledcích. Alternativně klikni pravým tlačítkem na tlačítko Start a vyber Terminál.Mac: Stiskni Cmd + Mezerník pro otevření Spotlight, napiš
Terminala stiskni Enter.
Objeví se okno s prázdkým řádkem, kam můžeš psát. Zde jsou všechny příkazy níže.
Krok 2 — Spusť instalátor
Zkopíruj příkaz pro svůj systém, vlož ho do terminálu a stiskni Enter.
Mac:
curl -fsSL https://claude.ai/install.sh | bash
Windows 11 (a Windows 10 pomocí Terminálu/PowerShellu):
irm https://claude.ai/install.ps1 | iex
Windows 10 (pokud jsi v Kroku 1 otevřel Příkazový řádek pomocí cmd):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Uvidíš, jak se posouvá nějaký text, zatímco se to děje. Až to bude hotové, uvidíš zprávu potvrzující, že Claude Code byl úspěšně nainstalován. Pokud místo toho uvidíš chybu, podívej se na sekci Řešení problémů na konci.
Krok 3 — Otevři nové okno terminálu
Tento krok je snadné přeskočit, ale je důležitý. Úplně zavři okno terminálu a otevři nové (stejnou metodou z Kroku 1).
Instalátor přidá Claude Code do tvého systému, ale tvůj terminál si změny všimne až při spuštění nového okna. Přeskočení tohoto je nejčastější důvod, proč další krok nevypadá, že "funguje".
Krok 4 — Spusť Claude Code a přihlas se
V novém okně terminálu napiš:
claude
Poprvé, když ho spustíš, se tě zeptá, jak se chceš přihlásit. Zvol přihlášení pomocí tvého účtu Claude (ne pomocí API klíče). Otevře se okno prohlížeče, kde se přihlásíš ke svému účtu Claude. Jakmile se přihlásíš, můžeš se vrátit do terminálu – tvé předplatné Pro nebo Max teď funguje v Claude Code.
To je vše. Teď můžeš psát otázky nebo požadavky přímo v terminálu.
Řešení problémů
Kroky instalace jsou na každém systému stejné, ale pokud se něco pokazí, oprava se může lišit v závislosti na tom, co používáš. Zde jsou nejčastější problémy.
„claude is not recognized“ nebo „command not found“ po instalaci
To téměř vždy znamená, že jsi přeskočil Krok 3. Úplně zavři terminál, otevři zcela nové okno a napiš claude znovu. Terminál si nově nainstalované příkazy všimne až při spuštění nové relace.
Windows: „irm is not recognized“ (jsi v Příkazovém řádku, ne v PowerShellu)
Pokud příkaz irm vrátí chybu jako "is not recognized as an internal or external command" (není rozpoznán jako interní nebo externí příkaz), tak jsi v Příkazovém řádku (CMD) místo PowerShellu. Poznáš, ve kterém jsi, pohledem na začátek řádku: PowerShell zobrazí PS C:\... zatímco Příkazový řádek zobrazí jen C:\....
Místo toho použij verzi příkazu pro Příkazový řádek:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 10: „Could not create SSL/TLS secure channel“ (Nelze vytvořit zabezpečený kanál SSL/TLS)
To se může stát na starších systémech Windows 10. V PowerShellu nejprve spusť řádek níže a pak znovu spusť příkaz instalátoru:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 irm https://claude.ai/install.ps1 | iex
Windows: „Claude Code on Windows requires git-bash“ (Claude Code na Windows vyžaduje git-bash)
To znamená, že Git pro Windows není nainstalován (nebo ho Claude Code nemůže najít). Vrať se do sekce "Než začneš" výše a nainstaluj si Git pro Windows, pak zavři terminál, otevři nový a spusť claude znovu.
Mac: bezpečnostní zpráva nebo zpráva o „oprávnění“
Protože oficiální instalátor umístí Claude Code do složky, kterou vlastníš (uvnitř tvého domovského adresáře), chyby s oprávněními, které způsobovaly starší metody instalace, se zde nestávají. Pokud tvůj Mac zobrazí první bezpečnostní okno při prvním spuštění claude s tím, že nemohl ověřit aplikaci, otevři Nastavení systému → Soukromí a zabezpečení, sjeď dolů ke zprávě o claude a klikni na Povolit i přesto. Pak spusť claude znovu v terminálu.
Stále jsi zaseknutý?
Po instalaci můžeš spustit tento příkaz, aby Claude Code zkontroloval sám sebe a upozornil na to, co je špatně:
claude doctor
Prohlédne tvoji instalaci a běžná nastavení a obvykle ti přesně řekne, co máš opravit.