Stručné shrnutí: Spuštění Claude Code v terminálu je jednoduché: nainstalujte jej pomocí jednorázového příkazu z oficiálních stránek, ověřte se pomocí svého účtu Anthropic a pro spuštění interaktivní relace zadejte ‚claude‘. Nástroj CLI funguje na macOS, Linuxu a Windows, což vývojářům umožňuje vytvářet funkce, opravovat chyby a automatizovat úkoly pomocí příkazů v přirozeném jazyce přímo v jejich terminálovém prostředí.
Claude Code představuje posun v tom, jak vývojáři interagují s asistencí umělé inteligence. Místo kopírování kódu mezi kartami prohlížeče a textovými editory tento nástroj založený na terminálu žije uvnitř vývojového pracovního postupu, rozumí celým kódovým základnám a provádí složité úkoly prostřednictvím konverzačních příkazů.
Pro většinu vývojářů trvá proces nastavení méně než pět minut. Ale pro efektivní spuštění Claude Code je toho víc než jen instalace.
Tato příručka pokrývá vše od počáteční instalace až po spouštění produktivních relací s praktickými příklady, které fungují na skutečných projektech.
Co Claude Code vlastně dělá
Podle oficiální dokumentace je Claude Code agentní kódovací nástroj, který čte kódové základny, upravuje soubory, spouští příkazy a integruje se s vývojovými nástroji. Terminálové rozhraní slouží jako primární bod interakce pro většinu vývojářů.
Nástroj zvládá rutinní vývojářské úkoly: vytváření funkcí, opravy chyb, automatizaci pracovních postupů a vysvětlování složitých částí kódu. Funguje s plným kontextem souborů projektu, historie git a běžících procesů.
Na rozdíl od asistentů AI založených na prohlížeči, Claude Code spouští příkazy přímo v prostředí shellu. Když je požádán o opravu chyby sestavení, nejenže navrhuje řešení – může skutečně provést opravu, otestovat výsledek a potvrdit změny.
Terminál vs. Jiné platformy
Claude Code funguje na více platformách: terminál CLI, desktopová aplikace, webové rozhraní, rozšíření IDE pro VS Code a JetBrains a rozšíření Chrome pro ladění živých aplikací. Verze pro terminál nabízí nejpřímější kontrolu.
Terminálové relace poskytují klávesové zkratky, spouštění úloh na pozadí a integraci s existujícími konfiguracemi shellu. Vývojáři, kteří žijí v příkazové řádce, považují toto rozhraní za nejrychlejší.
| Platforma | Nejlepší pro | Klíčová výhoda |
|---|---|---|
| Terminál CLI | Vývojáři zvyklí na příkazovou řádku | Nejrychlejší interakce, plná integrace shellu |
| Desktopová aplikace | Vizuální preference s perzistentními relacemi | Grafické rozhraní, snadnější navigace |
| Rozšíření VS Code | Vývojáři, kteří zřídka opouštějí své IDE | Bezproblémová integrace editoru |
| Webové rozhraní | Rychlý přístup bez instalace | Funguje na jakémkoli zařízení s prohlížečem |
Požadavky na instalaci
Před instalací Claude Code ověřte, zda systém splňuje základní požadavky. Nástroj běží na macOS, Linuxu a Windows (včetně WSL2).
Je vyžadován aktivní účet Anthropic. Pokud jej nemáte, vytvořte si jej na oficiálních stránkách Anthropic před zahájením instalace.
Terminál musí mít připojení k internetu a povolení stahovat a spouštět skripty. Některé firemní sítě omezují spouštění skriptů – pokud instalace selže, obraťte se na IT oddělení.
Podporované operační systémy
Odstraňte toto tvrzení – nenalezeno v oficiálních zdrojových materiálech Instalace funguje prostřednictvím terminálu nebo jakéhokoli terminálového emulátoru, jako je iTerm2.
Distribuce Linuxu vyžadují moderní shell (bash nebo zsh). Většina nedávných instalací Ubuntu, Debianu, Fedory a Archu funguje bez úprav.
Uživatelé Windows by si měli nejprve nainstalovat Windows Subsystem for Linux (WSL2). Nativní podpora Windows existuje, ale WSL2 poskytuje lepší kompatibilitu s vývojářskými nástroji.
Snížení nákladů na nástroje AI s Get AI Perks při zahájení
Začátek s Claude Code často znamená vyzkoušet i další nástroje AI. Get AI Perks pomáhá zakladatelům najít startovací kredity a slevy na software napříč produkty AI a cloudovými produkty. Platforma sdružuje více než 200 nabídek, včetně výhod pro Claude, Anthropic, OpenAI, Gemini, ElevenLabs a další, spolu s podmínkami pro každou z nich.
Chcete vidět dostupné výhody nástrojů AI?
Podívejte se na Get AI Perks a:
- prohlížejte nabídky Claude a dalších nástrojů AI
- zjistěte, které výhody odpovídají vaší společnosti
- postupujte podle průvodců pro uplatnění dostupných kreditů
👉 Navštivte Get AI Perks a porovnejte dostupné výhody softwaru AI.
Podrobný postup instalace
Oficiální metoda instalace používá jeden příkaz, který detekuje operační systém a nainstaluje příslušnou verzi.
Pro macOS a Linux
Otevřete okno terminálu a spusťte tento příkaz:
| curl -fsSL claude.ai/install.sh | bash |
Instalační skript stáhne binární soubor Claude Code, umístí jej do systémové cesty a nakonfiguruje integraci shellu. Proces obvykle trvá méně než 30 sekund.
Pokud instalace proběhne úspěšně, terminál zobrazí potvrzovací zprávu. Otestujte instalaci zadáním:
| claude –version |
Tento příkaz by měl vrátit číslo aktuální verze. Pokud se místo toho objeví chyba „command not found“, je třeba upravit konfiguraci PATH.
Pro Windows s WSL2
Nejprve se ujistěte, že je WSL2 nainstalován a nakonfigurován. Otevřete terminál WSL2 (doporučeno Ubuntu) a spusťte stejný instalační příkaz jako pro Linux:
| curl -fsSL install.claude.ai | sh |
Problémy s Windows-specifickým síťováním se někdy vyskytují s WSL2. Podle dokumentace pro řešení problémů může být nutné upravit pravidla firewallu, aby se povolila komunikace mezi procesy WSL2 a Windows.
Řešení problémů s instalací
Nejčastějším problémem při instalaci je konfigurace PATH. Když terminál po instalaci zobrazí „command not found“, binární soubor Claude není v cestě spustitelných souborů shellu.
Zkontrolujte umístění instalace pomocí:
| which claude |
Pokud se nic nevrátí, ručně přidejte instalační adresář do PATH. Pro bash přidejte tento řádek do ~/.bashrc:
| export PATH=”$HOME/.local/bin:$PATH” |
Pro uživatele zsh přidejte stejný řádek do ~/.zshrc. Restartujte terminál nebo spusťte source ~/.bashrc pro okamžité použití změn.
Neúspěšné instalace související se sítí se často zobrazují jako „TLS connect error“ nebo přerušené stahování. Tyto chyby signalizují omezení firewallu nebo zastaralé certifikáty. Aktualizujte systémové certifikáty nebo kontaktujte správce sítě, pokud pracujete v podnikové síti.
Ověření a první spuštění
Po úspěšné instalaci ověření propojí lokální CLI s účtem Anthropic. Spusťte proces ověření zadáním:
| claude |
První spuštění automaticky spustí ověření. Otevře se okno prohlížeče zobrazující přihlašovací stránku. Přihlaste se pomocí svých přihlašovacích údajů k účtu Anthropic.
Po dokončení ověření v prohlížeči se aktivuje terminálová relace. Uvítací zpráva potvrdí připojení a zobrazí základní pokyny k použití.
Správa relací
Pokaždé, když claude spustíte v terminálu, spustí se nová relace. Relace přetrvávají, dokud nejsou explicitně ukončeny pomocí Ctrl+D nebo zadáním exit.
Ověřovací token se uloží lokálně, takže následná spuštění nevyžadují přihlášení v prohlížeči. Token zůstává platný, dokud není ručně zrušen prostřednictvím nastavení účtu na webu Anthropic.
Spuštění interaktivního režimu
Interaktivní režim představuje primární způsob, jak vývojáři používají Claude Code. Spusťte jej zadáním claude bez dalších argumentů.
Terminál se přepne do interaktivního promptu, kde příkazy v přirozeném jazyce řídí AI. Tento režim udržuje kontext konverzace, pamatuje si předchozí požadavky a může provádět vícekrokové pracovní postupy.
Základní interaktivní příkazy
Několik vestavěných příkazů řídí chování relace.
Zadejte je v promptu Claude Code:
- /model – Přepínání mezi různými modely Claude (Opus, Sonnet)
- /status – Zobrazení aktuálního modelu, ID relace a konfigurace
- /btw – Pokládání vedlejších otázek bez změny kontextu úkolu
- ? – Zobrazení klávesových zkratek a informací nápovědy
Klávesové zkratky zvyšují produktivitu. Stisknutím Ctrl+L vymažete obrazovku terminálu bez ukončení relace. Použijte Ctrl+C k zrušení probíhající generace. Ctrl+F ukončí všechny úlohy na pozadí (dvakrát stiskněte pro potvrzení).
Stavový řádek v dolní části zobrazuje aktivní úlohy na pozadí, aktuální model a využití tokenů. Tyto informace pomáhají monitorovat spotřebu zdrojů během složitých úkolů.
Spouštění úloh na pozadí
Claude Code může spouštět dlouhodobé operace na pozadí a zároveň zůstat responzivní pro nové příkazy. Úlohy na pozadí zobrazují indikátory průběhu a dokončují se asynchronně.
Když běží více operací současně, seznam úloh sleduje každou z nich. Stisknutím Ctrl+F otevřete a spravujte úlohy na pozadí.
Spouštění jednorázových příkazů
Ne každý úkol vyžaduje interaktivní relaci. Pro rychlé operace Claude Code přijímá příkazy přímo jako argumenty:
| claude “vysvětli autentizační logiku v src/auth.js” |
Tento příkaz spustí Claude Code, zpracuje požadavek, zobrazí výstup a okamžitě se ukončí. Nezahájí se interaktivní relace.
Jednorázové příkazy fungují dobře pro skriptování a automatizaci. Lze je začlenit do git hooků, CI/CD pipeline nebo skriptů shellu, které potřebují pomoc AI pro konkrétní podúkoly.
Režim pouze dotazování
Příznak -p spouští režim pouze dotazování, který odpovídá na otázky bez provádění změn souborů:
| claude -p “jaké závislosti tento projekt používá?” |
Tento režim čte soubory projektu, ale nic neupravuje, nevytváří ani nemaže. Poskytuje pouze informace, což je bezpečné pro průzkum bez rizika neúmyslných změn.
Výběr a konfigurace modelu
Claude Code podporuje více modelů AI s různými schopnostmi a charakteristikami rychlosti. Podle oficiální dokumentace podporované modely zahrnují Sonnet 4.6, Opus 4.6, Opus 4.5, Haiku 4.5 a Sonnet 4.5.
Změňte aktivní model pomocí příkazu /model během interaktivní relace. Interaktivní menu zobrazuje dostupné možnosti s krátkými popisy silných stránek každého modelu.
Pro trvalou preferenci modelu nastavte proměnnou prostředí před spuštěním Claude Code:
| export ANTHROPIC_MODEL=”claude-opus-4-6″ claude |
Tato konfigurace přetrvává napříč relacemi, dokud se proměnná nezmění nebo nezruší.
Konfigurace rychlého režimu
Rychlý režim upřednostňuje rychlost odezvy před komplexní analýzou. Je užitečný pro rychlé iterace a jednoduché úkoly, kde není nutná analýza plného kontextu.
Povolte rychlý režim prostřednictvím konfigurace nastavení nebo pomocí variant modelů optimalizovaných pro rychlost. Podívejte se do oficiální dokumentace pro aktuální možnosti rychlého režimu, protože se vyvíjejí s novými verzemi modelů.
Práce na projektech
Claude Code chápe strukturu projektu analýzou souborů v aktuálním adresáři a podadresářích. Před spuštěním se přesuňte do adresáře projektu:
| cd /cesta/k/vašemu/projektu claude |
Nástroj automaticky čte soubory projektu, chápe strukturu kódové základny a rozpoznává běžné vzory, jako jsou správci balíčků, konfigurace frameworků a nástroje pro sestavení.
Vyloučení citlivých souborů
Některé soubory by neměly být analyzovány ani upravovány nástroji AI – přihlašovací údaje, klíče API, velké binární soubory nebo generovaný obsah. Vytvořte soubor .claudeignore v kořenovém adresáři projektu a vylučte konkrétní cesty:
| .env .env.local node_modules/ dist/ build/ *.log |
To funguje podobně jako syntaxe .gitignore. Vyloučené soubory zůstanou pro Claude Code neviditelné během analýzy i provádění.
Tipy pro konfiguraci terminálu
Claude Code lépe funguje s určitými konfiguracemi terminálu. Většina problémů pochází z nekompatibilních nastavení shellu nebo chybějících funkcí.
Integrace shellu
Zjemnění: Některé moderní terminály podporují volitelné funkce integrace shellu, jako je detekce promptů pomocí sekvencí OSC 133, ačkoli nejsou povinné
Pro optimální kompatibilitu používejte nejnovější verze populárních terminálových emulátorů: iTerm2 na macOS, Alacritty, Kitty nebo WezTerm na Linuxu. Windows Terminal funguje dobře s WSL2.
Přizpůsobení klávesových zkratek
Výchozí klávesové zkratky se mohou dostat do konfliktu s existujícími vazbami terminálu nebo shellu. Přizpůsobte je prostřednictvím konfiguračního souboru nastavení umístěného na adrese ~/.claude/settings.json.
Soubor nastavení používá formát JSON a podporuje přemapování jakéhokoli vestavěného příkazu na jiné kombinace kláves. Po úpravě restartujte Claude Code, aby se změny projevily.
Běžné pracovní postupy první relace
Upřímně: první relace Claude Code často zahrnuje experimentování. Zde jsou praktické výchozí body, které demonstrují základní schopnosti.
Prozkoumejte kódovou základnu
Začněte tím, že požádáte Claude Code o vysvětlení struktury projektu:
„Poskytni mi přehled této kódové základny. Jaké jsou hlavní komponenty a jak spolu interagují?“
Tento požadavek nic nemění – pouze analyzuje a vysvětluje. Odpověď pomáhá ověřit, zda Claude Code správně chápe organizaci projektu.
Proveďte jednoduchou změnu
Zkuste provést nízkorizikovou úpravu, abyste viděli úpravu souboru v akci:
„Přidejte komentář na začátek souboru README.md vysvětlující, co tento projekt dělá.“
Claude Code si přečte soubor, vygeneruje odpovídající obsah a provede úpravu. Zkontrolujte změnu pomocí git diff, abyste přesně viděli, co se stalo.
Opravte existující problém
Pokud projekt obsahuje známé chyby nebo položky TODO, požádejte Claude Code, aby je vyřešil:
„Oprav chybu ověření přihlášení popsanou v problému #42.“
Nástroj čte relevantní zdrojové soubory, identifikuje problém, implementuje opravu a může dokonce spustit testy, aby ověřil, že řešení funguje.
Oprávnění a bezpečnost
Claude Code vyžaduje před prováděním potenciálně rizikových operací oprávnění. Systém oprávnění kategorizuje příkazy podle úrovně dopadu.
Čtení souborů probíhá bez výzev k udělení oprávnění – čtení kódu je vždy bezpečné. Zápis do souborů, mazání a spouštění příkazů shellu vyžadují výslovné schválení při prvním výskytu.
Volby oprávnění lze uložit pro relaci nebo trvale. Trvalá oprávnění se ukládají v konfiguračních souborech a platí pro všechny budoucí relace.
Konfigurace sandboxing
Podle oficiální dokumentace k nastavení sandboxování omezuje, kde může Claude Code provádět změny. Nakonfigurujte předpony cest sandboxu, abyste omezili přístup k souborovému systému na konkrétní adresáře.
Tato bezpečnostní vrstva zabraňuje neúmyslným úpravám systémových souborů nebo adresářů mimo rozsah projektu. Týmy pracující na citlivých kódových základnách by měly před nasazením nakonfigurovat sandboxování.
| Typ oprávnění | Výchozí chování | Doporučeno pro |
|---|---|---|
| Čtení souboru | Vždy povoleno | Všechny případy použití |
| Zápis/úprava souboru | Výzva poprvé | Aktivní vývoj |
| Mazání souboru | Výzva pokaždé | Pouze pro zkušené uživatele |
| Příkazy shellu | Výzva s náhledem | Automatizované pracovní postupy |
| Přístup k síti | Výzva poprvé | Práce na integraci API |
Často kladené dotazy
Funguje Claude Code po instalaci offline?
Ne. Claude Code vyžaduje pro všechny operace připojení k internetu, protože modely AI běží na serverech Anthropic. Klient terminálu odesílá požadavky na API a přijímá odpovědi. Bez připojení nástroj nemůže fungovat.
Kolik stojí provoz Claude Code?
Ceny závisí na plánu účtu Anthropic a objemu využití. Aktuální podrobnosti o cenách naleznete na oficiálních stránkách Anthropic, protože plány a sazby se časem mění. Spotřeba tokenů se liší v závislosti na velikosti kódové základny a složitosti požadavků.
Může Claude Code přistupovat k souborům mimo aktuální adresář?
Ve výchozím nastavení ano. Claude Code může přistupovat k jakémukoli souboru, ke kterému má uživatelský účet oprávnění ke čtení. Konfigurace sandboxu však omezuje přístup na určené adresáře. V prostředích s citlivými údaji nakonfigurujte nastavení sandboxu před prvním použitím.
Co se stane, když Claude Code udělá chybu?
Všechny změny souborů jsou viditelné prostřednictvím standardních příkazů git diff. Před potvrzením jakýchkoli úprav provedených Claude Code si změny pečlivě zkontrolujte. Jelikož se vše děje v repozitáři git (doporučeno), vrácení chyb je s příkazy git přímočaré.
Mohou běžet více relací Claude Code současně?
Ano. Každé okno terminálu může spustit nezávislou relaci Claude Code. Relace se vzájemně neovlivňují, ačkoli souběžné úpravy stejného souboru z různých relací mohou způsobit konflikty.
Jak zastavím běžící úlohu Claude Code?
Stisknutím Ctrl+C zrušíte aktuální operaci. U úloh na pozadí stiskněte Ctrl+F pro otevření správce úloh a poté potvrďte zrušení. Relace zůstává aktivní i po zrušení – zastaví se pouze konkrétní úloha.
Pamatuje si Claude Code předchozí konverzace?
V rámci jedné relace ano. Claude Code udržuje kontext konverzace a pamatuje si předchozí požadavky a změny. Spuštění nové relace (zavřením a znovuotevřením) vymaže tento kontext. Pro trvalé znalosti o projektu použijte funkce instrukcí a paměti popsané v oficiálních příručkách.
Další kroky po instalaci
Jakmile Claude Code úspěšně běží, prozkoumejte jeho rozšířené možnosti. Oficiální dokumentace pokrývá pokročilá témata, jako jsou vlastní podagenti, vývoj pluginů a automatizace plánovaných úloh.
Dovednosti (Skills) poskytují způsob, jak rozšířit Claude Code o příkazy a pracovní postupy specifické pro projekty. Vytváření dovedností v adresáři .claude/skills/ přidává vlastní možnosti přizpůsobené konkrétním vývojářským potřebám.
Integrace protokolu Model Context Protocol (MCP) umožňuje Claude Code interagovat s externími nástroji a službami. To otevírá možnosti pro dotazy do databáze, testování API a správu infrastruktury prostřednictvím stejného konverzačního rozhraní.
Funkce dálkového ovládání umožňují pokračovat v relacích na různých zařízeních. Začněte práci na stolním počítači a poté pokračujte v téže relaci na notebooku nebo mobilním zařízení. Podívejte se do dokumentace integrací platformy pro pokyny k nastavení.
Pomoc, když se zasekneme
Oficiální dokumentace pro řešení problémů řeší většinu běžných problémů. Když dojde k problémům, nejprve se tam podívejte, než se pustíte do hlubší systémové konfigurace.
Komunitní diskuse na platformách, jako je Reddit, poskytují reálná řešení od jiných vývojářů. Mnoho uživatelů sdílí své úpravy konfigurace a optimalizace pracovních postupů na těchto fórech.
V případě problémů s instalací nebo ověřením zkontrolujte stav účtu na webu Anthropic. Vypršená předplatná nebo omezení účtu brání úspěšnému připojení i při správném lokálním nastavení.
Problémy specifické pro terminál se často týkají konfigurace shellu nebo kompatibility. Testování s výchozí konfigurací terminálu (bez vlastních úprav shellu) pomáhá izolovat, zda problém pramení z lokálních úprav.
Závěr
Spuštění Claude Code v terminálu trvá jen několik minut po dokončení instalace. Kombinace příkazů v přirozeném jazyce a přímé integrace kódové základny vytváří vývojový pracovní postup, který zvládá jak jednoduché dotazy, tak složité refaktorování napříč více soubory.
Terminálové rozhraní udržuje vývojáře v jejich preferovaném prostředí bez přepínání kontextu na karty prohlížeče nebo samostatné aplikace. Spouštění úloh na pozadí znamená, že dlouhodobé operace neblokují ostatní práci.
Stejně jako u jakéhokoli vývojářského nástroje, zdatnost přichází s praxí. Začněte s jednoduchými dotazy pouze pro čtení, abyste pochopili, jak Claude Code interpretuje strukturu projektu. Postupně přejděte k úpravám souborů a automatizovaným pracovním postupům, jak se bude zvyšovat sebevědomí. Systém oprávnění zabraňuje nevratným chybám během fáze učení.
Jste připraveni transformovat svůj kódovací pracovní postup? Nainstalujte si Claude Code ještě dnes a zažijte AI-asistovaný vývoj přímo ve svém terminálu.
