Jak nainstalovat Claude Code: Kompletní průvodce (2026)

Rychlé shrnutí: Claude Code lze nainstalovat pomocí nativních instalátorů na macOS, Windows a Linuxu z oficiálních webových stránek Claude Code. Uživatelé Windows musí nejprve nainstalovat WSL2 před spuštěním Claude Code. Po instalaci se po prvním spuštění, kdy Claude Code otevře okno prohlížeče pro přihlášení, ověřte pomocí svého účtu Claude a začněte kódovat s asistencí AI přímo z terminálu nebo desktopové aplikace.

Claude Code představuje snahu společnosti Anthropic o nástroje pro vývoj agentní AI. Tento asistent z příkazové řádky čte kódové základny, upravuje soubory, spouští příkazy a integruje se s vývojovými pracovními postupy.

Ale jeho instalace není vždy jednoduchá. Různé platformy vyžadují různé přístupy. Windows potřebuje dodatečné nastavení. A dokumentace, i když je komplexní, může začátečníky zahltit.

Tento průvodce se proseká složitostí. Pokrývá systémové požadavky, specifické instalační kroky pro jednotlivé platformy, ověřování a kontrolu – vše, co je potřeba k tomu, aby Claude Code správně fungoval.

Systémové požadavky před instalací

Podle oficiální dokumentace Claude Code podporuje macOS, Windows a Linux. Každá platforma však má specifické předpoklady.

Pro macOS jsou požadavky minimální. Systém potřebuje macOS 13.0 nebo novější. Oba typy procesorů, Intel i Apple Silicon, fungují dobře.

Windows představuje větší složitost. Operační systém musí být Windows 10 Build 19041 nebo novější, nebo Windows 11. Ale tady je háček – Claude Code neběží nativně na Windows.

Windows Subsystem for Linux 2 (WSL2) je povinné. To vytváří linuxové prostředí, kde Claude Code skutečně běží. Bez WSL2 instalace selže.

Uživatelé Linuxu potřebují 64bitovou distribuci. Oficiální dokumentace potvrzuje podporu pro Ubuntu, Debian, Fedora a další hlavní distribuce. Alpine Linux a systémy založené na musl vyžadují další konfiguraci.

Všechny platformy potřebují během instalace stabilní připojení k internetu. Velikost stahování se liší, ale obvykle se pohybuje od 50 MB do 500 MB v závislosti na tom, co je již nainstalováno.

Instalace Claude Code na macOS

Proces instalace na macOS využívá nativní instalátor. Toto je nejjednodušší cesta ze všech platforem.

Nejprve si stáhněte instalátor z oficiálních webových stránek Claude Code. Stahovací stránka automaticky detekuje macOS a nabídne vhodný balíček.

Otevřete staanžený soubor .dmg. Přetáhněte aplikaci Claude Code do složky Aplikace. Standardní instalace macOS – nic neobvyklého.

Někteří uživatelé se při prvním spuštění setkají s bezpečnostním upozorněním. macOS ve výchozím nastavení blokuje aplikace od neidentifikovaných vývojářů. Klikněte pravým tlačítkem na aplikaci Claude Code a vyberte „Otevřít“, abyste toto jednorázové varování přeskočili.

Nástroj pro příkazovou řádku se instaluje automaticky s desktopovou aplikací. Otevřete Terminál a zadejte příkaz `claude --version` pro ověření. Pokud se zobrazí číslo verze, instalace proběhla úspěšně.

Ověření instalace na macOS

Spusťte následující příkazy pro potvrzení, že vše funguje:

Oba příkazy by měly vrátit výstup bez chyb. Příkaz `version` zobrazí nainstalovanou verzi Claude Code. Příkaz `help` zobrazí dostupné možnosti a příkazy.

Vytvoření testovacího adresáře pomůže ověřit plnou funkčnost. Přejděte do složky projektu a spusťte `claude` pro zahájení interaktivní relace. Nástroj by se měl inicializovat a v případě, že nejste již přihlášeni, vás vyzvat k ověření.

Instalace na Windows s WSL2

Instalace na Windows vyžaduje několik kroků. Proces trvá déle než na macOS, ale zůstává zvládnutelný.

WSL2 musí být nainstalováno nejprve. Otevřete PowerShell jako administrátor a spusťte:

Tento příkaz ve výchozím nastavení nainstaluje WSL2 a Ubuntu. Systém bude vyžadovat restart. Po restartu se Ubuntu automaticky spustí pro dokončení počátečního nastavení.

Při zobrazení výzvy vytvořte uživatelské jméno a heslo pro Unix. Tyto přihlašovací údaje jsou oddělené od přihlašovacích údajů k Windows.

Jakmile WSL2 běží, platí proces instalace pro Linux. Otevřete terminál Ubuntu (nainstalovaný s WSL2) a stáhněte si instalátor Claude Code pro Linux.

Instalace Claude Code v WSL2

Podle oficiální dokumentace příkaz k instalaci stáhne a spustí nativní instalátor:

Tento skript automaticky spravuje závislosti. V případě potřeby nainstaluje Node.js, nastaví binární soubor Claude Code a nakonfiguruje proměnné PATH.

Instalace trvá několik minut. Indikátory průběhu a stavové zprávy ukazují, co se děje. Po dokončení zavřete a znovu otevřete terminál, abyste obnovili proměnné prostředí.

Testování instalace probíhá stejným způsobem jako na macOS. Pro ověření spusťte `claude --version`.

Proces instalace na Linuxu

Uživatelé Linuxu mají nejpřímější cestu instalace. Nativní instalátor funguje přímo bez dalších vrstev, jako je WSL2.

Stáhněte a spusťte instalační skript:

Toto stáhne binární soubor Claude Code, nainstaluje závislosti a nakonfiguruje shell prostředí. Skript detekuje distribuci a odpovídajícím způsobem se přizpůsobí.

Pro systémy založené na Ubuntu a Debian skript konfiguruje instalaci. Oficiální dokumentace potvrzuje podporu pro Ubuntu 20.04+, Debian 10+ a další distribuce.

Zohlednění Alpine Linux

Alpine Linux a distribuce založené na musl potřebují dodatečné kroky. Oficiální dokumentace uvádí, že tyto systémy vyžadují manuální konfiguraci.

Standardní instalátor může na Alpine selhat. Místo toho si stáhněte binární soubor kompatibilní s musl přímo ze stránky s vydáními. Rozbalte jej do adresáře v systémové cestě PATH, obvykle /usr/local/bin.

Nastavte oprávnění ke spuštění:

Uživatelé Alpine by měli před pokračováním ověřit kompatibilitu. Některé funkce nemusí fungovat stejně jako u distribucí založených na glibc.

Ověřování a nastavení účtu

Po instalaci Claude Code spusťte v terminálu příkaz `claude`. Při prvním spuštění Claude Code otevře okno prohlížeče, kde se můžete přihlásit.

Tím se otevře stránka pro ověření Claude. Přihlaste se pomocí existujícího účtu Claude nebo si vytvořte nový.

V prohlížeči se zobrazí autorizační kód. Zkopírujte tento kód a vraťte se do terminálu. Po zobrazení výzvy vložte kód.

Úspěšné ověření uloží přihlašovací údaje lokálně. Budoucí relace nebudou vyžadovat přihlášení, pokud platnost přihlašovacích údajů nevyprší nebo nebudou ručně vymazány.

Ověřování týmů a podnikových účtů

Podle oficiální dokumentace k ověřování mají týmy používající Claude for Teams nebo Enterprise další možnosti. Organizace mohou konfigurovat jednotné přihlašování (SSO) nebo ověřování poskytovatele cloudu.

Nastavení SSO vyžaduje konfiguraci administrátorem. Jednotliví vývojáři se pak ověřují prostřednictvím poskytovatele identity své organizace namísto osobních účtů Claude.

Ověřování poskytovatele cloudu funguje pro nasazení AWS, Google Cloud a Azure. Tato metoda používá stávající cloudové přihlašovací údaje místo samostatných účtů Claude.

Instalace desktopové aplikace

Claude Code nabízí jak aplikaci pro příkazovou řádku, tak desktopovou aplikaci. Desktopová aplikace poskytuje grafické rozhraní a zároveň zachovává plnou funkčnost terminálu.

Stáhněte si desktopový instalátor z oficiálních webových stránek Claude. Stránka nabízí verze pro macOS, Windows a Windows ARM64. Vyberte vhodnou verzi pro váš systém.

Instalace na macOS probíhá stejným procesem .dmg, jaký byl popsán dříve. Uživatelé Windows si mohou stáhnout desktopovou aplikaci pro grafické rozhraní bez nutnosti nastavovat WSL2.

Desktopová aplikace obsahuje integrovaný přístup k terminálu. Může spouštět relace Claude Code bez přepínání na externí terminálové aplikace.

Jednou z výhod desktopové aplikace je dostupnost na pozadí. Podle oficiální stahovací stránky se aplikace „udržuje připravená na pozadí“ a lze ji vyvolat z jakékoli aplikace bez přepínání oken nebo ztráty fokusu.

Použijte Get AI Perks k nalezení kreditů pro váš Claude Code Stack

Instalace je ta snadná část. Skutečné náklady obvykle plynou ze všeho kolem: infrastruktury, podpůrných nástrojů a placených služeb používaných během nastavení a testování. Get AI Perks vám může pomoci tím, že na jednom místě nabídne startupové kredity a slevy, spolu s pokyny, jak je uplatnit.

S Get AI Perks můžete:

• Najít kredity pro cloudové a AI nástroje
• Zkontrolovat podmínky perků před jejich uplatněním
• Vyhnout se plýtvání časem na nabídky, na které se možná nekvalifikujete
• Snížit náklady na zprovoznění vašeho nastavení

Navštivte Get AI Perks a zjistěte, zda nabízené nabídky odpovídají nástrojům, které plánujete s Claude Code používat.

Rozšíření a integrace IDE

Kromě samostatné instalace se Claude Code integruje s oblíbenými vývojovými prostředími. Existují rozšíření pro Visual Studio Code a IDE od JetBrains.

Rozšíření pro VS Code se instaluje prostřednictvím tržiště. Vyhledejte „Claude Code“ v panelu Rozšíření a klikněte na Nainstalovat. Rozšíření vyžaduje předchozí instalaci nástroje pro příkazovou řádku.

Někteří uživatelé hlásí problémy s přibaleným souborem rozšíření VS Code. Pokud automatická instalace selže s chybou „End of central directory record signature not found“, přibalený soubor .vsix může být poškozený.

Řešením je instalace rozšíření ručně z tržiště VS Code namísto spoléhání se na verzi přibalenou v CLI. Tím se oddělí obě komponenty a zabrání se konfliktům při instalaci.

Integrace JetBrains funguje podobně. Nainstalujte plugin z tržiště JetBrains v IntelliJ IDEA, PyCharm, WebStorm nebo jiných produktech JetBrains.

Ověření úspěšné instalace

Správné ověření zajistí, že Claude Code funguje správně, než začnete se skutečnými vývojovými úkoly.

Základní ověření kontroluje dostupnost příkazů:

Tyto příkazy by se měly spustit bez chyb. Příkaz `help` zobrazuje dostupné možnosti. Příkaz `version` zobrazuje nainstalovanou verzi.

Funkční testování vyžaduje spuštění relace. Vytvořte testovací adresář:

Toto inicializuje interaktivní relaci Claude Code. Nástroj by měl analyzovat adresář (v tomto případě prázdný) a zobrazit výzvu.

Vyzkoušejte základní příkazy v relaci. Zadejte `help` pro zobrazení dostupných akcí. Požádejte o jednoduché úkoly, jako je „vytvořit soubor README“ nebo „vysvětlit, co umíš“.

Úspěšné odpovědi indikují správnou instalaci. Pokud dojde k chybám, obvykle souvisejí s ověřením, připojením k síti nebo chybějícími závislostmi.

Aktualizace a správa verzí

Claude Code se ve výchozím nastavení aktualizuje automaticky. Oficiální dokumentace vysvětluje, že nástroj kontroluje nové verze a instaluje je bez zásahu uživatele.

Chování aktualizací lze konfigurovat prostřednictvím nastavení Claude Code. Oficiální dokumentace pokrývá konfiguraci kanálů vydání a možnosti ruční aktualizace.

Ruční aktualizace vyžadují opětovné spuštění instalačního skriptu. Stejný příkaz, který byl použit pro počáteční instalaci, stáhne nejnovější verzi:

Instalace specifických verzí je možná pro testování nebo z důvodů kompatibility. Dokumentace pokročilého nastavení pokrývá připnutí verzí a konfiguraci kanálů vydání.

Kanály vydání zahrnují stabilní, beta a noční. Stabilní kanál se doporučuje pro produkční práci. Beta a noční kanály poskytují včasný přístup k novým funkcím, ale mohou obsahovat chyby.

Běžné problémy při instalaci

Několik problémů se často objevuje v komunitních diskuzích o instalaci Claude Code.

Konfigurace PATH způsobuje mnoho problémů. Pokud příkaz `claude` po instalaci nenalezen, adresář s binárním souborem není v systémové cestě PATH.

Na macOS a Linuxu přidání adresáře do PATH obvykle zahrnuje úpravu souborů ~/.bashrc, ~/.zshrc nebo podobných konfiguračních souborů shellu. Instalační skript se o to obvykle postará automaticky, ale ruční ověření pomáhá při řešení problémů.

Uživatelé Windows v WSL2 mohou po instalaci potřebovat zavřít a znovu otevřít terminál. Proměnné prostředí se v existujících relacích neobnoví.

Síťová omezení blokují některé instalace. Firewally společností nebo proxy servery mohou bránit stahování instalátoru nebo připojení k ověřovacím serverům.

Konfigurace proxy vyžaduje proměnné prostředí:

Chyby oprávnění se vyskytují při instalaci do chráněných adresářů. Instalátor potřebuje přístup k zápisu do /usr/local/bin nebo ekvivalentních umístění. Spuštění s `sudo` to řeší, ale mělo by se mu vyhnout, pokud to není nutné.

Často kladené otázky

Začínáme po instalaci

Po nainstalování a ověření Claude Code je dalším krokem pochopení, jak jej efektivně používat.

Dokumentace pro rychlý start doporučuje začít s jednoduchými úkoly. Přejděte do existujícího projektu a spusťte `claude` pro zahájení interaktivní relace.

Požádejte Claude o vysvětlení struktury projektu. Požádejte o shrnutí toho, co kódová základna dělá. Tyto průzkumné dotazy pomáhají pochopit, jak nástroj interpretuje kód.

Zkuste provést malé změny. Požádejte Claude o přidání komentářů k funkcím, vytvoření jednoduchých testovacích souborů nebo refaktorování základních bloků kódu. Tyto úkoly demonstrují editační schopnosti bez rizika.

Integrace s Gitem funguje automaticky, pokud projekt používá správu verzí. Claude Code může vytvářet commity, vysvětlovat rozdíly a navrhovat vylepšení na základě změn.

Oficiální dokumentace obsahuje příklady pracovních postupů pro běžné vývojové úkoly. Tyto zahrnují opravu chyb, implementaci funkcí, revizi kódu a automatizované testování.

Claude Code je vyvíjející se nástroj. Instalace je jen základ. Pochopení jeho schopností, omezení a osvědčených postupů vyžaduje experimentování a praxi.

Jste připraveni nainstalovat Claude Code? Stáhněte si vhodný instalátor pro vaši platformu z oficiálního webu a postupujte podle kroků uvedených v tomto průvodci. Ověřte se pomocí svého účtu Claude, zkontrolujte, zda instalace funguje správně, a začněte objevovat vývoj s asistencí AI.