Jak nastavit Claude Code: Kompletní průvodce 2026

Rychlé shrnutí: Claude Code je terminálový asistent pro kódování s umělou inteligencí, který běží nativně na macOS a Linuxu, nebo na Windows přes WSL2. Jeho nastavení vyžaduje vytvoření API klíče od společnosti Anthropic, spuštění instalátoru specifického pro danou platformu, ověření pomocí klíče a ověření instalace testovacím příkazem. 

Claude Code představuje oficiálního terminálového asistenta pro kódování od společnosti Anthropic. Žije přímo v příkazové řádce a zpracovává vše od generování kódu po opravy chyb prostřednictvím příkazů v přirozeném jazyce.

Proces nastavení však není vždy přímočarý. Uživatelé Windows potřebují WSL2. Ověřování API může způsobit problémy nováčkům. Mohou nastat konflikty verzí.

Tato příručka vás provede kompletním procesem nastavení pro všechny platformy, od systémových požadavků po vaši první kódovací relaci.

Co Claude Code vlastně je

Claude Code je agilní terminálová aplikace, která se integruje s vývojovými prostředími. Rozumí kódovým základům, provádí rutinní úkoly a spravuje pracovní postupy git prostřednictvím konverzačních příkazů.

Na rozdíl od nástrojů založených na prohlížeči běží Claude Code lokálně v terminálu. Přistupuje k souborům projektu přímo, udržuje kontext napříč relacemi a integruje se do stávajících vývojových pracovních postupů. Podle oficiální dokumentace Claude Code se nástroj připojuje k API společnosti Anthropic a podporuje integraci s Amazon Bedrock, Google Cloud Vertex AI a Azure AI.

Tento nástroj funguje jinak než tradiční asistenti kódování. Upřímně řečeno, je to spíše jako mít v terminálu párového programátora než nástroj pro doplňování kódu.

Systémové požadavky pro Claude Code

Před instalací musí systémy splňovat specifické požadavky. Zde je, co potřebuje každá platforma:

Všechny platformy potřebují stabilní připojení k internetu pro volání API. Stažené soubory Claude Code obvykle vyžadují přibližně 50 MB, přičemž WSL2 na Windows přidává přibližně 500 MB pro subsystém Linux.

Co se týče úložiště, počítejte s alespoň 4 GB volného místa. Samotná aplikace je malá, ale prostor pro závislosti a soubory projektu je důležitý.

Specifické požadavky pro Windows

Claude Code může běžet na Windows přes PowerShell nebo Command Prompt, pokud je nainstalován Node.js. Nástroj vyžaduje Windows Subsystem for Linux 2 pro vytvoření prostředí Linux.

Podle instalačních průvodců z claude.ai potřebují systémy Windows 10 Verzi 1903 nebo novější s Build 19041 nebo vyšším. Uživatelé Windows 11 mají podporu WSL2 integrovanou. Pro počáteční nastavení WSL2 jsou vyžadována oprávnění správce.

Proces zahrnuje povolení virtualizace v BIOSu, aktivaci funkcí Windows a instalaci distribuce Linuxu. Ubuntu 22.04 LTS je doporučená distribuce pro kompatibilitu.

Instalace Claude Code: Postup krok za krokem

Proces instalace se liší podle platformy. Zde je návod, jak spustit Claude Code na každém operačním systému.

Instalace na macOS a Linux

Instalace na macOS a Linux postupuje podle stejného vzoru. Obě platformy podporují nativní instalaci bez dalšího nastavení.

Proces začíná stažením instalátoru. Otevřete terminál a spusťte:

curl -fsSL claude.ai/install.sh | sh

Skript detekuje operační systém, stáhne příslušný binární soubor a nainstaluje Claude Code do lokálního adresáře bin. Instalace se obvykle dokončí za méně než dvě minuty při stabilním připojení.

Pro systémy bez curl funguje wget jako alternativa. Instalátor automaticky přidá Claude Code do systémové cesty (PATH).

Instalace na Windows přes WSL2

Instalace na Windows vyžaduje nejprve nastavení WSL2. Zde je kompletní proces:

Otevřete PowerShell jako správce a povolte WSL:

wsl --install

Tento příkaz povolí požadované funkce Windows, stáhne jádro WSL2 a ve výchozím nastavení nainstaluje Ubuntu. Systém vás vyzve k restartování. Po restartování se Ubuntu automaticky spustí k dokončení nastavení uživatele.

Když budete vyzváni, vytvořte uživatelské jméno a heslo. Tyto přihlašovací údaje jsou pro prostředí Linux, oddělené od přihlašovacích údajů Windows.

Jakmile WSL2 běží, platí proces instalace pro Linux. V terminálu Ubuntu spusťte příkaz curl z části pro macOS/Linux výše.

Instalátor se postará o zbytek. Claude Code se nainstaluje do prostředí WSL2 a spustí se přes terminál Ubuntu.

Získání API klíče Anthropic

Claude Code vyžaduje pro ověření API klíč od společnosti Anthropic. Klíč propojí lokální instalaci se servery společnosti Anthropic.

Navštivte konzoli Anthropic na adrese console.anthropic.com. Vytvořte si účet nebo se přihlaste pomocí stávajících přihlašovacích údajů. V nastavení účtu přejděte na API Keys.

Klikněte na "Create Key" (Vytvořit klíč) pro vygenerování nového API klíče. Klíč se zobrazí pouze jednou – okamžitě si ho zkopírujte. Společnost Anthropic již klíč po opuštění stránky nezobrazí.

Klíč uložte bezpečně. Poskytuje plný přístup k API společnosti Anthropic a veškerému souvisejícímu fakturaci.

Porozumění nákladům na API

Claude Code funguje na modelu platby za použití prostřednictvím API společnosti Anthropic. Podle údajů z instalačních průvodců claude.ai se náklady liší podle modelu:

Minimální nákup pro aktivaci fakturace je 5 USD, ačkoli diskuse v komunitě naznačují, že 20-30 USD poskytuje lepší prostor pro testování. Alternativní možnosti předplatného zahrnují Claude Pro za 20 USD měsíčně nebo Claude Max za 100 USD měsíčně pro intenzivní používání.

Výchozí chování používá Opus až do dosažení 50 % limitů využití, poté se přepne na Sonnet pro efektivitu nákladů.

Ověření a první spuštění

Po instalaci je nutné Claude Code před prvním použitím ověřit. Spusťte Claude Code provedením:

claude

První spuštění vyžádá API klíč. Vložte klíč z konzole Anthropic a stiskněte Enter. Claude Code klíč ověří a bezpečně jej uloží do lokálních konfiguračních souborů.

Ověření zůstává platné napříč relacemi. API klíč není třeba zadávat znovu, pokud není výslovně odstraněn nebo při přepínání účtů.

Pro ověření úspěšného ověření zobrazí Claude Code uvítací zprávu a příkazový řádek. Rozhraní ukazuje dostupné příkazy a potvrzuje připojení k API společnosti Anthropic.

Konfigurace preferencí modelů

Claude Code ve výchozím nastavení automaticky vybírá modely, ale manuální konfigurace je možná. Podle oficiální dokumentace mohou uživatelé upravit výběr modelu pomocí příkazu /model nebo nastavením proměnné prostředí CLAUDE_CODE_EFFORT_LEVEL.

Úroveň úsilí řídí hloubku myšlení pro modely Opus 4.6 a Sonnet 4.6: nízká, střední nebo vysoká. Vyšší úrovně úsilí zvyšují hloubku uvažování, ale také náklady a čas odezvy.

Pro projekty vyžadující hlubokou analýzu, dočasné nastavení "ultrathink" v příkazech nastaví úsilí na vysoké pro daný tah.

Ověření úspěchu instalace

Po ověření zkontrolujte, zda Claude Code funguje správně. Spusťte tyto základní testy:

claude --help
claude --version

Příkaz help zobrazí dostupné možnosti a příkazy. Výstup verze potvrdí, která verze je nainstalována. Oba příkazy by se měly provést bez chyb.

Dále otestujte Claude Code v adresáři projektu. Vytvořte testovací složku:

mkdir test-project
cd test-project
echo "# Test Project" > README.md
claude

V relaci Claude Code zkuste základní interakce:

• Zadejte "help" pro zobrazení dostupných příkazů
• Zeptejte se "explain what you can do" (vysvětli, co umíš)
• Požádejte o "summarize this project" (shrň tento projekt)
• Otestujte příkaz /help

Tyto interakce potvrzují, že Claude Code dokáže číst soubory projektu a reagovat na požadavky. Úspěšné odpovědi znamenají, že instalace je funkční.

Konfigurace Claude Code pro projekty

Claude Code ukládá nastavení specifické pro projekty do konfiguračních souborů. Tyto soubory přizpůsobují chování, definují paměť a nastavují pracovní postupy.

Primárním konfiguračním souborem je CLAUDE.md v kořeni projektu. Tento soubor obsahuje instrukce, kontext a specifické pokyny pro projekt, na které se Claude Code během relací odkazuje.

Vytvořte základní soubor CLAUDE.md:

# Kontext projektu

Toto je [typ projektu] vytvořený pomocí [technologie].

## Klíčové pokyny
– [Důležité pravidlo 1]
– [Důležité pravidlo 2]

## Struktura projektu
[Krátké vysvětlení organizace složek]

Soubor akceptuje formátování Markdown. Claude Code čte tento kontext při zahájení relace a udržuje ho po celou dobu konverzace.

Pokročilé možnosti konfigurace

Kromě základního kontextu podporuje Claude Code pokročilou konfiguraci prostřednictvím adresáře .claude. Tento adresář může obsahovat:

• Dovednosti: Specializované schopnosti definované v souboru .claude/skills/SKILL.md
• Příkazy: Vlastní příkazy se lomítkem v souborech .claude/commands/*.md
• Hooks (Hák): Automatizované pracovní postupy spouštěné událostmi
• Pluginy: Rozšířená funkčnost prostřednictvím programové integrace

Podle oficiální dokumentace Agent SDK tyto funkce umožňují sofistikované přizpůsobení. Dovednosti definují opakovaně použitelné schopnosti. Příkazy vytvářejí zkratky pro běžné úkoly. Hooks automatizují reakce na změny souborů nebo použití nástrojů.

Použití Claude Code: Základní pracovní postupy

Po dokončení instalace Claude Code zvládá běžné vývojové úkoly prostřednictvím přirozeného jazyka.

Spusťte relaci přechodem do adresáře projektu a spuštěním:

claude

Prompt akceptuje požadavky v prostém jazyce. Některé běžné pracovní postupy:

• Generování kódu: "Vytvoř Python funkci, která ověřuje e-mailové adresy s řádným zpracováním chyb."
• Oprava chyb: "Tato funkce vyhazuje výjimku null pointer. Můžeš identifikovat a opravit problém?"
• Refaktoring: "Refaktoruj tuto komponentu tak, aby používala injektáž závislostí namísto přímé instance."
• Operace s Gitem: "Vytvoř novou větev, proveď tyto změny s popisnou zprávou a odešli na origin."

Claude Code udržuje kontext napříč relací. Pamatuje si předchozí interakce, sleduje změny souborů a rozumí širší struktuře projektu.

Porozumění režimu plánu (Plan Mode)

Pro složité změny nabízí Claude Code režim plánu. Tento režim před prováděním změn vytvoří podrobný plán provedení.

Aktivujte režim plánu předřazením požadavků "plan:" nebo použitím příkazu /plan. Claude Code pak navrhne změny, vysvětlí důvody a před provedením počká na schválení.

Režim plánu je obzvláště užitečný pro refaktoring, architektonické změny nebo úpravy ovlivňující více souborů. Poskytuje přehled o tom, co Claude Code hodlá udělat, než se k těmto změnám zaváže.

Integrace s VS Code a IDE

Přestože Claude Code běží v terminálu, integrace s editory kódu vylepšuje pracovní postup. Oficiální rozšíření VS Code přináší schopnosti Claude Code přímo do editoru.

Nainstalujte rozšíření z tržiště VS Code. Vyhledejte "Claude Code" a klikněte na Instalovat. Rozšíření přidá panel Claude Code do postranního panelu.

Podle oficiální dokumentace VS Code podporuje rozšíření:

Rozšíření zachovává stejné funkce jako terminálová verze a přidává pohodlí specifické pro IDE, jako jsou inline rozdíly a odkazování na soubory pomocí @-zmínky.

Aktualizace a správa Claude Code

Claude Code se ve výchozím nastavení aktualizuje automaticky. Aplikace periodicky kontroluje nové verze a instaluje aktualizace na pozadí.

Pro manuální aktualizaci spusťte:

claude --update

Tím se vynutí okamžitá kontrola a instalace nejnovější verze. Proces aktualizace zachovává konfigurační soubory a ověřovací údaje.

Pro organizace vyžadující kontrolu verzí lze automatické aktualizace zakázat. Nastavte proměnnou prostředí CLAUDE_CODE_AUTO_UPDATE na false nebo ji nakonfigurujte prostřednictvím nastavení spravovaného serverem.

Pro instalaci specifické verze použijte:

curl -fsSL claude.ai/install.sh | sh -s -- --version=X.Y.Z

Nahraďte X.Y.Z cílovým číslem verze.

Běžné problémy při nastavení a jejich řešení

Během nastavování se běžně vyskytuje několik problémů. Zde je návod, jak je vyřešit:

• Odmítnutí API klíče: Pokud Claude Code odmítne API klíč, zkontrolujte, zda neobsahuje žádné další mezery nebo znaky. Znovu zkopírujte klíč z konzole Anthropic. Zkontrolujte, zda je aktivováno fakturace – klíče nebudou fungovat bez zadané platební metody.
• Chyby instalace WSL2: Systémy Windows někdy selžou při instalaci WSL2 kvůli nastavení virtualizace. Vstupte do BIOSu a povolte virtualizaci (Intel VT-x nebo AMD-V). Ujistěte se, že verze Windows splňuje minimální požadavky.
• Příkaz nenalezen: Pokud terminál nerozpozná příkaz claude, cesta (PATH) nebyla správně aktualizována. Zavřete a znovu otevřete terminál. Pro trvalé problémy ručně přidejte instalační adresář do PATH.
• Časové limity připojení: Síťová omezení nebo firewally mohou blokovat volání API. Claude Code vyžaduje přístup HTTPS k api.anthropic.com. Podnikové sítě mohou vyžadovat konfiguraci proxy serveru.
• Chyby oprávnění: Instalace na Linux a macOS občas narazí na problémy s oprávněními. Spusťte instalátor s příslušnými oprávněními nebo jej nainstalujte do uživatelského adresáře místo systémových umístění.

Zkontrolujte dostupné AI kredity před nastavením Claude Code

Nastavení Claude Code obvykle znamená experimentování – spouštění promptů, testování integrací a vytváření malých prototypů před nasazením do produkce. Tato raná fáze často vede k velkému využití API. Místo toho, aby vývojáři platili za každý požadavek hned, mnozí nejprve hledají dostupné kredity nebo startovací programy, které pomáhají snížit počáteční náklady.

Get AI Perks shromažďuje tyto příležitosti na jednom místě. Platforma uvádí AI kredity, slevy a partnerské programy napříč poskytovateli AI, cloudovými platformami a vývojářskými nástroji, s podrobnými průvodci vysvětlujícími, jak je získat. Celkem databáze obsahuje výhody od více než 200 nástrojů a miliony dolarů dostupných kreditů, o které se mohou startupy a tvůrci ucházet.

Než dokončíte nastavení Claude Code, zkontrolujte Get AI Perks a získejte AI kredity, které mohou pokrýt vaše první experimenty.

Často kladené otázky

Další kroky s Claude Code

Claude Code transformuje terminálový vývoj integrací AI asistence přímo do příkazové řádky. Nastavení vyžaduje specifickou instalaci pro platformu, ověření API a základní konfiguraci, ale proces je přímočarý, pokud se dodržují správné kroky.

Tento nástroj vyniká v rutinních vývojových úkolech, generování kódu a správě pracovních postupů git. Režim plánu poskytuje bezpečnost pro složité operace. Integrace IDE rozšiřuje možnosti i mimo terminál.

Začněte s jednoduchými úkoly, abyste pochopili, jak Claude Code interpretuje požadavky. Postupně přejděte na složitější pracovní postupy s rostoucí znalostí. Použijte příkaz /clear mezi různými úkoly k udržení čistého kontextu. Konfigurujte soubory CLAUDE.md pro pokyny specifické pro projekt.

Týmy mohou prozkoumat nastavení spravovaná serverem a tržiště pluginů. Jednotliví vývojáři mohou těžit z dovedností a vlastních příkazů přizpůsobených častým vzorům.

Úložiště GitHub na adrese anthropics/claude-code obsahuje další příklady, komunitní pluginy a zdroje pro řešení problémů. Oficiální dokumentace na docs.anthropic.com poskytuje komplexní technické reference.

Nyní je čas začít kódovat. Přejděte do projektu, spusťte Claude Code a zjistěte, jak AI asistovaný vývoj změní váš pracovní postup.