Claude Code instalace: návod pro macOS, Windows a Linux

Co je Claude Code a proč běží v terminálu?#

Terminál děsí téměř každého, kdo se pustí do vibe codingu bez zkušeností s vývojem softwaru. Vypadá jako černé okno z hackerských filmů, ale ve skutečnosti je to jen řádek, do kterého zadáváte příkazy. Claude Code ho potřebuje právě proto, aby mohl sám otevírat vaše soubory, měnit je a spouštět kontroly, zatímco mu slovy popisujete úkol.

Anthropic popisuje produkt takto.

Rozdíl oproti běžnému chatu je jednoduchý. V prohlížeči ručně kopírujete kód tam a zpět mezi oknem chatu a editorem. Claude Code vstoupí přímo do složky projektu, přečte potřebné soubory, provede změnu a ukáže vám, co upravil. Rozhodujete a schvalujete stále vy; nástroj za vás vykonává mechanickou práci.

Pokud terminál opravdu používat nechcete, Anthropic nabízí desktopovou aplikaci s běžným oknem a webovou verzi na claude.ai/code, která běží přímo v prohlížeči. Nejmocnější a nejflexibilnější možností je ale terminálová verze, které se věnuje celý tento článek.

Kde jsou oficiální stránky Claude Code a co si máte stáhnout?#

Začátečníky nejprve mate, kde jsou oficiální stránky Claude Code a na co kliknout, aby si ho stáhli. Tady je přehled všech oficiálních adres společnosti Anthropic, takže nemusíte hádat.

Instalační program nestahujete z webu jako u běžného programu, což je v rozporu s tím, co lidé očekávají. Nainstalujete ho příkazem v terminálu, který pak stáhne správnou verzi pro váš systém. Tento článek obsahuje přesné příkazy pro Mac, Windows a Linux.

Častou pastí je název: lidé ho často píšou chybně jako clode code, clade code, слод код nebo clode design. Produkt se jmenuje Claude Code, s písmeny au. Při hledání oficiálních stránek na to pamatujte: domény s podobným pravopisem patří někomu jinému.

Vyplatí se znát i přesný název balíčku npm. Kanonický balíček je @anthropic-ai/claude-code, s předponou @anthropic-ai/. Anthropic vlastní krátký název claude-code bez předpony – jde o jejich oficiální odkaz na tentýž balíček. Jednoduché pravidlo: vydavatelem má být Anthropic a instalační název obsahuje předponu.

Co potřebujete k instalaci: požadavky na počítač#

Požadavky Claude Code jsou skromné: náročnou práci odvádějí servery Anthropic; váš počítač jen odesílá požadavky a přijímá odpovědi.

Samostatná poznámka k Node.js, protože kolem něj koluje nejvíc mýtů. Nativní instalační program – ten, který doporučuje sama Anthropic – Node.js vůbec nepotřebuje: nainstaluje se jako jediný samostatný soubor. Node.js je nutný pouze při instalaci Claude Code přes npm a v takovém případě potřebujete verzi 22 nebo novější. Starší články uvádějí „Node 18 a novější“ – to už neplatí; řiďte se verzí 22+.

Pro hlavní verzi potřebujete terminál. Pokud ho používat nechcete, nainstalujte desktopovou aplikaci s běžným oknem nebo použijte webovou verzi na claude.ai/code. Terminálová verze má stále více funkcí, proto se zbytek článku věnuje její instalaci.

Instalace Claude Code je jako získat do rukou nástroj. Sama o sobě ale často halucinuje: zapomíná na váš projekt, vymýšlí si a v půlce úkolu ztrácí nit. Spolehlivost zajišťuje kombinace tří věcí: AI klon, Druhý mozek a inženýrství kontextu. To jsou tři pilíře, které brání AI v halucinování.

Jak nainstalovat Claude Code na macOS?#

Otevřete Terminál (je součástí každého Macu: stiskněte Cmd+Space a ve Spotlightu napište „Terminal“) a vložte tento řádek:

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

Příkaz stáhne instalační program z oficiální adresy Anthropic a nainstaluje Claude Code. Node.js není potřeba. Nativní způsob je pohodlný také díky aktualizacím.

Pokud už používáte Homebrew, máte ještě druhou možnost:

brew install --cask claude-code

Rozdíl spočívá ve způsobu aktualizací: nativní instalační program se aktualizuje sám, zatímco Homebrew ne – program budete muset ručně aktualizovat příkazem brew upgrade claude-code. Samotný program je stejný, proto zvolte metodu, na kterou jste zvyklí. Pokud si nejste jistí, použijte první možnost.

Jak nainstalovat Claude Code ve Windows?#

Nejprve zjistěte, kde se nacházíte. Windows mají dva shelly a každý používá vlastní příkaz. Otevřete okno a podívejte se na začátek příkazového řádku: PS C:\> znamená PowerShell, zatímco samotné C:\> bez PS znamená Příkazový řádek (CMD).

Pro PowerShell (nejjednodušeji ho otevřete kliknutím pravým tlačítkem na tlačítko Start a výběrem „Terminál“):

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

Pro Příkazový řádek (CMD):

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

Třetí možností je použití vestavěného správce balíčků WinGet:

winget install Anthropic.ClaudeCode

Pokud už máte funkční prostředí ve WSL (Linux ve Windows), nainstalujte Claude Code přímo do WSL stejným příkazem jako v Linuxu. WSL má zvláštní problém s Node, kterému se budu věnovat níže v části o běžných chybách.

Jak nainstalovat Claude Code v Linuxu?#

Základní způsob pro každou oblíbenou distribuci je stejný samostatný instalační program:

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

Node.js není potřeba; program se dodává jako jediný soubor a od té chvíle se sám aktualizuje.

Pokud jste zvyklí instalovat programy pouze prostřednictvím systémového správce balíčků, můžete přidat oficiální repozitáře Anthropic: apt pro Debian a Ubuntu, dnf pro Fedoru a RHEL a apk pro Alpine. Jsou podepsané klíčem a mají kanály stable a latest. Pro začátečníka je to zbytečně složité, proto podrobnosti ponechávám dokumentaci v části se zdroji a jako výchozí možnost doporučuji výše uvedený příkaz.

Na levných serverech může nastat jeden problém. Pokud má počítač velmi málo volné paměti, instalace se může zastavit se slovem Killed (kód 137) – systém ukončil proces, protože mu došla paměť. Řešením je přidat odkládací soubor: Claude Code potřebuje k instalaci přibližně 512 MB volné paměti.

Jak poprvé spustit Claude Code?#

První spuštění zabere pár minut. Postup je následující.

1. Přejděte do složky projektu

   V terminálu přejděte příkazem cd path-to-project do složky, se kterou chcete pracovat, a pak napište claude.

2. Přihlaste se ke svému účtu

   Otevře se prohlížeč s přihlašovacím oknem. Pokud se neotevře automaticky, stisknutím c zkopírujte odkaz a ručně ho vložte do prohlížeče. Pokud se v prohlížeči zobrazí kód (může se to stát ve WSL a na vzdálených serverech), vložte ho zpět do terminálu.

3. Počkejte na potvrzení

   Po přihlášení se v terminálu zobrazí Login successful a výzva ke stisknutí Enter.

4. Položte první otázku

   Zeptejte se na něco jednoduchého o projektu, například „co tento projekt dělá?“ Claude přečte soubory a odpoví.

5. Schvalte první změnu

   Když ho požádáte, aby něco změnil, Claude vám ukáže navržené změny a požádá o potvrzení. Režim přístupu můžete přepínat pomocí Shift+Tab.

Vyplatí se hned se naučit několik základních příkazů, které můžete použít přímo v relaci: /help vypíše příkazy, /clear vymaže historii konverzace a /exit relaci ukončí (totéž udělá dvojí stisknutí Ctrl+D). Když napíšete /help, Claude vám to všechno sám ukáže.

Přihlášení pomocí předplatného, nebo API klíče: co si vybrat?#

Tohle je první otázka, která se při přihlašování objeví.

Přihlásit se lze dvěma způsoby, které se liší tím, jak se za službu platí.

Pro přihlášení s předplatným jednoduše použijte svůj účet Claude.ai. Pro přihlášení pomocí API klíče si pořiďte klíč v Claude Console (platform.claude.com); poplatky se odečítají z předplaceného zůstatku podle toho, jak službu používáte. Nastavte klíč v proměnné prostředí ANTHROPIC_API_KEY a Claude Code už při každém spuštění neotevře prohlížeč.

Mezi účty můžete během relace přepínat pomocí /login a odhlásit se příkazem /logout.

Claude Code se ale bez placeného přístupu nespustí. Pokud ještě účet nemáte, nejprve zjistěte, kterou e-mailovou adresu použít k registraci: později ji už změnit nemůžete.

Jak ověřit, že se vše správně nainstalovalo?#

Hned na začátku stojí za to znát tři příkazy.

První zkontroluje verzi:

claude --version

Funkční instalace odpoví číslem ve formátu X.Y.Z (Claude Code). Konkrétní číslice se s verzemi mění; důležité je, že příkaz vůbec vrátí číslo verze. Hláška „command not found“ znamená něco jiného – tomu se věnuji v následující části.

Druhým příkazem je diagnostika pro případ, že se něco pokazí.

Třetím příkazem je /status uvnitř relace: ukazuje způsob přihlášení, propojený e-mail nebo organizaci a informaci, zda přístup nevypršel. Příkaz claude update navíc použije nejnovější aktualizaci okamžitě, místo aby čekal na aktualizaci na pozadí.

Proč se po instalaci nedaří najít příkaz claude?#

Začátečníci si na to stěžují nejčastěji a zní to hůř, než to je. Terminál nehledá příkazy v celém počítači; kontroluje jen složky uvedené v PATH. Claude Code se umístí do ~/.local/bin/claude (na Macu a Linuxu) nebo %USERPROFILE%\\.local\\bin\\claude.exe (ve Windows), a pokud tato složka není v PATH, terminál program jednoduše nevidí.

Na Macu a Linuxu přidejte složku do seznamu. Otevřete soubor s nastavením shellu (~/.zshrc pro Zsh, ~/.bashrc pro Bash) a na konec přidejte tento řádek:

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

Potom terminál zavřete a znovu otevřete (nebo spusťte source ~/.zshrc). Příkaz claude se pak najde.

Běžné chyby při instalaci a prvním spuštění#

Projděme si je postupně; všechny vycházejí z oficiální příručky Anthropic pro řešení problémů.

1. Stará verze Node při instalaci přes npm. Balíček @anthropic-ai/claude-code vyžaduje Node.js 22 nebo novější. Ve Windows může npm selhat se zprávou o zakázaných skriptech – jejich spuštění blokuje zásada PowerShellu. Ve WSL se často objevuje chyba exec: node: not found: WSL používá Windows Node místo Linux Node. Pokud vám npm dělá potíže, přejděte na nativní instalační program; Node nepotřebuje.
2. Nesprávný instalační program pro shell. Hláška 'irm' is not recognized znamená, že jste vložili příkaz PowerShellu do Příkazového řádku. The token '&&' is not a valid statement separator znamená opak: spustili jste příkaz CMD v PowerShellu. A parameter cannot be found that matches parameter name 'fsSL' znamená, že jste v PowerShellu spustili příkaz pro Mac/Linux. Zkontrolujte začátek příkazového řádku: PS C:\ označuje PowerShell a C:\ označuje CMD.
3. Starý API klíč přebíjí předplatné. Pokud je vaše předplatné aktivní, ale v prostředí je stále nastavený starý klíč, zobrazí se API Error: 400 ... This organization has been disabled. Klíč má přednost před přihlášením přes předplatné. Odstraňte ho příkazem unset ANTHROPIC_API_KEY (v PowerShellu použijte Remove-Item Env:ANTHROPIC_API_KEY), zkontrolujte ~/.zshrc a ~/.bashrc a potom napište /status.
4. Nedostatek paměti na slabém serveru. Instalace se zastaví se slovem Killed a kódem 137 – to znamená, že není dostatek RAM. Potřebujete přibližně 512 MB volné paměti; přidání swapu problém vyřeší.
5. Instalační program vrátil něco jiného. Chyba syntax error near unexpected token '<' nebo odkaz na <!DOCTYPE html> znamená, že instalační adresa URL vrátila webovou stránku namísto instalačního skriptu – obvykle kvůli vašemu regionu, firemnímu firewallu nebo dočasnému výpadku. Zkuste jinou metodu (Homebrew, WinGet) nebo to zopakujte za několik minut.

U kterékoli z těchto chyb postupujte stejně: nejprve spusťte claude doctor. Ukáže, co nefunguje, a poradí, kde hledat.

Diagnostiku může komplikovat také samotný kód 403 při instalaci; může ho způsobovat firemní firewall nebo proxy. Pokud jste tedy v kancelářské síti, nejprve ověřte, zda neblokuje přístup.

Co dělat po instalaci: první kroky#

Instalace je teprve začátek. Skutečná práce začíná potom a první problém, na který lidé narazí, je paměť. Jazykový model si vás mezi konverzacemi nepamatuje: v novém chatu zná jen to, co jste mu vložili do kontextu.

Prvním skutečným krokem po instalaci je proto vytvořit v kořenové složce projektu soubor CLAUDE.md. Je to textový soubor s pravidly a kontextem projektu, který Claude Code čte při každém spuštění. Jednou popište, čemu se věnujete, jak je projekt uspořádaný a na čem záleží – a nebudete to muset opakovat v každé konverzaci.

V samostatném průvodci popisuji, jak tento soubor připravit a přizpůsobit Claude: jak přizpůsobit Claude. Sestavil jsem také obecnou mapu nástrojů pro vibe coding pro rok 2026.

Na co dalšího se lidé ptají?#

Kompletní rámec vibe codingu: AI klon + Druhý mozek + inženýrství kontextu.