Stručné shrnutí: Claude Code CLI se instaluje jediným příkazem, který automaticky stáhne a nakonfiguruje nástroj. Na macOS a Linux použijte oficiální skript shellu z dokumentace Anthropic, zatímco uživatelé Windows spustí příkazy PowerShellu nebo WSL. Po instalaci se ověřte pomocí svého API klíče a začněte používat AI asistenta pro kódování Claude ve vašem terminálu.
Claude Code je agilní nástroj pro kódování, který žije ve vašem terminálu a rozumí celému vašemu kódovému základu. Podle oficiální dokumentace Claude Code dokáže číst soubory, spouštět příkazy, upravovat kód a integrovat se s vývojovými nástroji prostřednictvím konverzací v přirozeném jazyce.
Zahájení však vyžaduje správnou instalaci. Zde je vše, co potřebujete k instalaci Claude Code CLI a jeho správné konfiguraci.
Systémové požadavky před instalací
Před instalací Claude Code ověřte, zda systém splňuje základní požadavky. Podle oficiální dokumentace pro pokročilou instalaci tuto větu zcela odstraňte.
Zkontrolujte instalaci Node.js otevřením terminálu a spuštěním:
| node –version |
Pokud Node.js není nainstalován nebo je verze nižší než 18, stáhněte si jej z oficiálních stránek Node.js. Verze Long-Term Support (LTS) funguje pro Claude Code perfektně.
Kromě Node.js systém potřebuje základní požadavky: macOS 13.0 nebo vyšší pro uživatele Mac, Windows 10 nebo vyšší pro systémy Windows a většina moderních distribucí Linuxu funguje bez problémů. K ověření po instalaci je také nutný účet Claude od společnosti Anthropic.
Instalace Claude Code na macOS a Linux
Proces instalace pro macOS a Linux používá jediný příkaz shellu, který se postará o vše automaticky. Tato metoda je zdokumentována v oficiálním průvodci rychlým spuštěním Claude Code.
Otevřete Terminál a spusťte instalační skript:
| curl -fsSL claude.ai/install.sh | bash |
Skript stáhne binární soubor Claude Code, umístí jej do správného adresáře a automaticky nakonfiguruje PATH. Celý proces se obvykle dokončí za méně než minutu.
Pro uživatele macOS, kteří preferují Homebrew, existuje alternativní metoda instalace, ačkoli není oficiálně zdokumentována v primárních zdrojích. Metoda curl zůstává doporučeným přístupem podle oficiální dokumentace.
Ověření instalace
Po dokončení instalace ověřte, že je Claude Code přístupný:
| claude –version |
Tento příkaz by měl zobrazit číslo nainstalované verze. Pokud se objeví chyba s textem „příkaz nenalezen“, je třeba upravit konfiguraci PATH.
Podle oficiální dokumentace k řešení problémů jsou problémy s PATH nejčastějším instalačním problémem. Oprava spočívá v přidání instalačního adresáře Claude do konfiguračního souboru shellu.
Instalace Claude Code na macOS a Linux
Proces instalace pro macOS a Linux využívá npm (Node Package Manager). Podle oficiální dokumentace musíte mít ve svém systému nainstalován Node.js 18+ před pokračováním. Na rozdíl od tradičních CLI nástrojů, které používají shell skripty, je Claude Code instalován globálně prostřednictvím vašeho terminálu, aby bylo zajištěno správné zpracování všech závislostí.
Otevřete svůj Terminál a spusťte následující příkaz k instalaci balíčku:
| export CLAUDE_CODE_RELEASE_ALPHA=1 && npm install -g @anthropic-ai/claude-code |
Poznámka: Proměnná prostředí CLAUDE_CODE_RELEASE_ALPHA=1 je v současné době vyžadována během veřejné beta/alfa fáze, aby bylo potvrzeno předběžné stavu nástroje.
Tento příkaz stáhne balíček z oficiálního registru npm a propojí spustitelný soubor claude s globálním adresářem bin vašeho systému. Zatímco někteří uživatelé se mohou pokoušet najít formule Homebrew, metoda npm je jedinou oficiálně podporovanou a zdokumentovanou cestou instalace.
Ověření instalace
Po dokončení instalace ověřte, že je CLI správně namapován na vaše prostředí spuštěním:
| claude –version |
Tento příkaz by měl zobrazit aktuální číslo verze (např. 0.2.9). Pokud narazíte na chybu „příkaz nenalezen“, obvykle to znamená, že globální adresář npm není ve vašem systémovém PATH.
Podle oficiální dokumentace k řešení problémů můžete toto opravit identifikací svého npm prefixu pomocí příkazu npm config get prefix a zajištěním, že výsledný adresář /bin bude přidán do vašeho souboru .zshrc nebo .bashrc.
Instalace Claude Code na Windows
Instalace pro Windows nabízí dva hlavní přístupy: nativní instalace přes PowerShell nebo použití Windows Subsystem for Linux (WSL). Oficiální dokumentace doporučuje pro většinu uživatelů PowerShell.
Metoda instalace přes PowerShell
Otevřete PowerShell jako správce (klikněte pravým tlačítkem na nabídku Start a vyberte „Windows PowerShell (Admin)“). Spusťte tento příkaz:
| irm claude.ai/install.ps1 | iex |
Skript PowerShell se postará o automatické stažení, instalaci a konfiguraci PATH. Po dokončení zavřete a znovu otevřete PowerShell, abyste zajistili, že se aktualizace PATH projeví.
Metoda instalace přes WSL
Vývojáři, kteří již používají WSL, mohou nainstalovat Claude Code pomocí metody pro Linux. Otevřete terminál WSL a spusťte stejný příkaz curl použitý pro Linux:
| curl -fsSL claude.ai/install.sh | bash |
Přístup WSL funguje identicky jako nativní instalace Linuxu. Jedna výhoda: WSL poskytuje prostředí více podobné Unixu, které odpovídá konfiguraci produkčních serverů.
Podle oficiální dokumentace k řešení problémů se uživatelé WSL občas setkávají s problémy s připojením k síti. Pokud se instalace zasekává, ověřte, že WSL má přístup k externím sítím a že pravidla firewallu neblokují provoz.
Najděte kredity na Claude a AI nástroje na jednom místě
Instalace Claude Code CLI je jedním krokem. Placení za AI nástroje dlouhodobě je jiný. Get AI Perks shromažďuje počáteční kredity a slevy na software pro AI a cloudové nástroje na jednom místě. Poskytuje zakladatelům přístup k více než 200 výhodám, včetně nabídek od Anthropic, Claude, OpenAI, Gemini, ElevenLabs, Intercom a dalších. Platforma také zobrazuje podmínky výhod a návody pro uplatnění každé nabídky.
Hledáte kredity na Claude nebo Anthropic?
Podívejte se na Get AI Perks a:
- najděte kredity a slevy na AI nástroje na jednom místě
- před podáním žádosti si prohlédněte podmínky výhod
- získejte přístup k návodům pro uplatnění startupových nabídek
👉 Navštivte Get AI Perks a prohlédněte si dostupné výhody pro Claude, Anthropic a další AI software.
Ověření a prvotní konfigurace
Po instalaci vyžaduje Claude Code ověření, než může začít fungovat. Nástroj používá API klíče od Anthropic k ověření přístupu.
Proces ověření zahájíte spuštěním:
| claude |
Při prvním spuštění tohoto příkazu vás Claude Code vyzve k ověření. Podle oficiálního průvodce rychlým spuštěním se otevře okno prohlížeče pro přihlášení k účtu Anthropic.
Po přihlášení prostřednictvím prohlížeče získá CLI automaticky ověřovací token. Tento token je lokálně uložen a přetrvává mezi relacemi, takže opakované ověřování není nutné.
Konfigurace nastavení na úrovni projektu
Claude Code podporuje konfiguraci na více úrovních podle oficiální dokumentace k nastavení. Nejběžnější úrovně konfigurace jsou:
| Rozsah | Umístění | Použití |
|---|---|---|
| Uživatel | Adresář ~/.claude/ | Osobní preference napříč všemi projekty |
| Projekt | .claude/ v repozitáři | Sdílená týmová konfigurace |
| Lokální | .claude/settings.local.json | Přepsání specifická pro daný stroj |
Pro prvotní nastavení je dostačující konfigurace na úrovni uživatele. Nastavení na úrovni projektu se stává důležitým při práci s týmy, které sdílejí kódovací standardy.
Spuštění vaší první relace Claude Code
Po dokončení instalace a ověření spusťte Claude Code spuštěním příkazu bez argumentů:
| claude |
Toto spustí interaktivní režim, kde Claude odpovídá na požadavky v přirozeném jazyce. Oficiální dokumentace popisuje interaktivní režim jako primární způsob použití Claude Code pro vývojářské úkoly.
Zkuste jednoduchý testovací příkaz:
| Ukaž mi strukturu tohoto projektu |
Claude Code analyzuje aktuální adresář a poskytne přehled struktury kódového základu. To dokazuje, že instalace funguje správně a Claude má přístup ke čtení souborů.
Základní příkazy pro každodenní použití
Kromě interaktivního režimu podporuje Claude Code několik vzorů příkazů zdokumentovaných v referenční příručce CLI:
| Vzor příkazu | Účel | Příklad |
|---|---|---|
| claude | Spustit interaktivní relaci | claude |
| claude “úkol” | Spustit jednorázový úkol | claude “oprav chyby lintingu” |
| claude -p “dotaz” | Rychlý dotaz bez relace | claude -p “co dělá tato funkce” |
Vzor jednorázového úkolu je obzvláště užitečný pro CI/CD pipeline a automatizační skripty, kde interaktivní relace není vhodná.
Běžné řešení problémů s instalací
I přes automatizované instalační skripty se občas vyskytnou problémy. Oficiální dokumentace k řešení problémů pokrývá nejčastější problémy.
Chyby „příkaz nenalezen“
Pokud se po instalaci v terminálu zobrazí „příkaz nenalezen: claude“, konfigurace PATH nebyla správně dokončena. Pro macOS a Linux přidejte umístění binárního souboru Claude do konfiguračního souboru shellu ručně.
Pro uživatele bash upravte soubor ~/.bashrc nebo ~/.bash_profile a přidejte:
| export PATH=”$HOME/.local/bin:$PATH” |
Pro uživatele zsh (výchozí na moderních macOS) upravte soubor ~/.zshrc stejným řádkem. Po uložení obnovte konfiguraci pomocí source ~/.zshrc nebo otevřete nové okno terminálu.
Problémy se sítí a firewallem
Firemní sítě a restriktivní firewally někdy blokují instalační skript. Podle dokumentace k řešení problémů, pokud se instalace zasekává nebo vrací HTML místo provádění, může být přístup k serverům Anthropic blokován.
Obcházení spočívá v samostatném stažení instalačního skriptu:
| curl -fsSL code.anthropic.com/install.sh -o install.sh chmod +x install.sh ./install.sh |
Tento přístup poskytuje větší přehled o tom, co selhává, pokud dojde k chybám během stahování nebo provádění.
Problémy specifické pro WSL
Uživatelé Windows používající WSL se občas setkávají s problémy s připojením mezi subsystémem Linux a Windows. Oficiální dokumentace uvádí, že pravidla firewallu může být nutné upravit, aby povolila provoz WSL.
Pokud se Claude Code nainstaluje úspěšně, ale nemůže se připojit k serverům Anthropic pro ověření, zkontrolujte, zda firewall Windows povoluje přístup k síti WSL. Průvodce řešením problémů poskytuje konkrétní příkazy PowerShellu pro konfiguraci pravidel firewallu.
Aktualizace Claude Code
Claude Code dostává pravidelné aktualizace s novými funkcemi a vylepšeními. Podle oficiální dokumentace se aktualizace instalují pomocí stejného příkazu jako počáteční instalace.
Znovu spusťte instalační skript:
| curl -fsSL code.anthropic.com/install.sh | sh |
Skript detekuje existující instalaci a aktualizuje ji na nejnovější verzi. Během procesu aktualizace nedojde ke ztrátě žádné konfigurace ani ověření.
Před a po aktualizaci zkontrolujte aktuální verzi:
| claude –version |
Changelog v oficiální dokumentaci Claude Code uvádí všechny změny mezi verzemi, což pomáhá určit, zda aktualizace přináší funkce relevantní pro konkrétní pracovní postupy.
Další kroky po instalaci
Po instalaci a funkčnosti Claude Code je možné prozkoumat pokročilé funkce. Oficiální dokumentace popisuje několik oblastí, které stojí za prozkoumání:
- Schopnosti a přizpůsobení: Podle oficiální dokumentace pro schopnosti podporuje Claude Code vlastní schopnosti definované v souborech Markdown v adresáři .claude/skills/. Tyto schopnosti rozšiřují možnosti Claude o příkazy a pracovní postupy specifické pro daný projekt.
- Model Context Protocol (MCP): Integrace MCP umožňuje Claude Code připojit se k externím nástrojům a službám. Tím se z Claude stává centrum, které může přistupovat k databázím, API a dalším vývojovým prostředkům.
- Týmová spolupráce: Konfigurační soubory na úrovni projektu v adresáři .claude/ lze zahrnout do správy verzí a sdílet nastavení Claude Code napříč celými vývojářskými týmy.
- Oficiální dokumentace poskytuje podrobné návody pro každou z těchto oblastí a navazuje na základní instalaci popsanou zde.
Často kladené otázky
Potřebuji placený předplatné Claude k používání Claude Code CLI?
Claude Code vyžaduje účet Claude od společnosti Anthropic, ale konkrétní úroveň předplatného závisí na používání. Podle oficiální dokumentace je nutné ověření, ale podrobnosti o cenách by měly být ověřeny na oficiálních stránkách Anthropic, protože plány se časem mění.
Mohu nainstalovat Claude Code bez oprávnění správce?
Na macOS a Linux se Claude Code ve výchozím nastavení instaluje do domovského adresáře uživatele a nevyžaduje přístup správce. Uživatelé Windows mohou pro metodu instalace přes PowerShell potřebovat oprávnění správce, ačkoli instalace přes WSL nevyžadují přístup správce.
Funguje Claude Code offline?
Ne. Claude Code je nástroj poháněný umělou inteligencí, který komunikuje se servery Anthropic za účelem zpracování požadavků. Podle oficiální dokumentace je pro analýzu kódu a generování odpovědí Claude nutné aktivní připojení k internetu.
Jak odinstalovat Claude Code?
Oficiální dokumentace pro pokročilou instalaci vysvětluje, že odinstalace zahrnuje odstranění binárního souboru a konfiguračních souborů. Na macOS a Linux odstraňte adresář ~/.claude a odeberte úpravu PATH z konfiguračních souborů shellu. Uživatelé Windows by měli odstranit instalační adresář a vymazat proměnnou prostředí PATH.
Může Claude Code přistupovat k mému celému souborovému systému?
Ve výchozím nastavení Claude Code funguje v rámci aktuálního pracovního adresáře a jeho podsložek. Podle oficiální dokumentace k oprávněním lze přístup dále omezit pomocí nastavení sandboxu v konfiguračních souborech. Claude vždy požádá o potvrzení před provedením potenciálně destruktivních operací.
Jaký je rozdíl mezi Claude Code CLI a Claude Desktop?
Claude Code CLI běží v terminálu a zaměřuje se na vývojářské pracovní postupy s přímým přístupem k souborovému systému a spouštěním příkazů. Claude Desktop je samostatná aplikace s grafickým rozhraním. Oba nástroje slouží různým účelům, přičemž CLI je optimalizován pro vývojáře, kteří preferují pracovní postupy založené na terminálu.
Jak často bych měl aktualizovat Claude Code?
Aktualizace lze instalovat kdykoli je to vhodné. Changelog v oficiální dokumentaci popisuje nové funkce a opravy chyb. Pro týmy koordinace aktualizací zajišťuje, že všichni používají kompatibilní verze, ačkoli Claude Code udržuje zpětnou kompatibilitu s konfiguračními soubory napříč verzemi.
Závěr
Instalace Claude Code CLI trvá jen pár minut bez ohledu na operační systém. Automatizované instalační skripty se postarají o konfiguraci, nastavení PATH a umístění binárních souborů bez manuálního zásahu.
Po instalaci a ověření se Claude Code stane výkonným AI asistentem pro kódování přístupným z jakéhokoli terminálu. Příkazy v přirozeném jazyce umožňují vývojářům psát kód, opravovat chyby a automatizovat úlohy, aniž by opustili příkazový řádek.
Jste připraveni zažít vývoj s podporou AI? Spusťte instalační příkaz pro svou platformu a zahajte svou první relaci Claude Code ještě dnes. Oficiální dokumentace na code.claude.com poskytuje komplexní návody pro pokročilé funkce po dokončení základního nastavení.
