Zpět na blog
Pro vývojáře 26. března 2026 18 min čtení

Claude Code od A do Z: Instalace, příkazy a tipy pro vývojáře

Claude Code je terminálový AI asistent od Anthropicu, který čte, píše a refaktoruje kód přímo ve vašem repozitáři. Tady je kompletní průvodce — od instalace přes klíčové přepínače až po tipy, které vám ušetří hodiny práce.

claude

Co je Claude Code?

Claude Code je CLI nástroj (command-line interface), který propojuje AI model Claude přímo s vaším terminálem. Na rozdíl od webového rozhraní claude.ai má Claude Code přímý přístup k souborům ve vašem projektu — čte kód, edituje soubory, spouští příkazy a pracuje s Gitem. Funguje jako AI pair-programming partner, který sedí přímo ve vašem terminálu.

Oproti IDE pluginům (Cursor, Copilot) má dvě zásadní výhody: obrovský kontext (až 1M tokenů — celý codebase najednou) a plný přístup k shellu. Může spustit testy, commitnout změny, nainstalovat závislosti — cokoliv, co byste udělali v terminálu.

1M

tokenů kontextu — Claude Code vidí celý váš projekt najednou

Instalace na macOS

Na macOS máte dvě možnosti. Nejrychlejší je instalační skript, který stáhne a nastaví vše automaticky:

Terminál

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

Alternativně můžete použít Homebrew:

Terminál

brew install --cask claude-code

Požadavky: macOS 13.0 (Ventura) nebo novější, minimálně 4 GB RAM. Po instalaci spusťte claude --version pro ověření a claude pro první spuštění, které vás provede přihlášením k Anthropic účtu.

Instalace na Windows

Windows vyžaduje nainstalovaný Git for Windows. Poté v PowerShellu:

PowerShell

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

Nebo v klasickém CMD:

CMD

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

Požadavky: Windows 10 (verze 1809) nebo novější. Claude Code na Windows běží nativně — nepotřebujete WSL, i když WSL je také podporované.

Tip pro Windows

Pokud používáte Windows Terminal, doporučujeme profil s PowerShell 7+ nebo Git Bash. Claude Code funguje ve všech shellech, ale v moderním PowerShellu je zážitek nejlepší — barevný výstup, Unicode znaky a klávesové zkratky fungují bez problémů.

Instalace na Linuxu

Na Linuxu je instalace stejně jednoduchá jako na macOS:

Terminál

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

Podporované distribuce: Ubuntu 20.04+, Debian 10+, Alpine 3.19+ a další. Funguje i ve WSL (Windows Subsystem for Linux), což je skvělá volba pro vývojáře, kteří preferují Linux workflow na Windows stroji.

Po instalaci na jakémkoliv systému spusťte claude doctor — diagnostický příkaz, který zkontroluje, že vše je správně nastavené: verze, připojení k API, shell, Git a další závislosti.

macOS Win Linux

Tři režimy práce

Claude Code nabízí tři základní režimy, které se liší mírou interakce:

  • Interaktivní režim — spustíte příkazem claude. Otevře se konverzace v terminálu, kde píšete zprávy a Claude odpovídá. Nejpoužívanější režim pro běžnou práci.
  • Print režim (-p) — jednorázové dotazy. claude -p "vysvětli tento kód" vypíše odpověď a skončí. Ideální pro skripty a CI/CD pipeline.
  • Pipe režim — vstup přes stdin. cat error.log | claude -p "analyzuj chyby". Kombinuje se s dalšími unixovými nástroji.

Pouze webové rozhraní

Kopírujete kód tam a zpět. Žádný přístup k souborům. Ručně vkládáte kontext. Výstup kopírujete zpět do editoru.

Claude Code v terminálu

Přímý přístup k souborům. Automatický kontext z codebase. Editace souborů na místě. Spouštění příkazů a testů. Git integrace.

Klíčové CLI přepínače

Claude Code má desítky přepínačů. Tady jsou ty, které budete používat denně — s konkrétními příklady pro reálné workflow.

1. --continue / --resume — návrat k rozpracované session

Zavřeli jste terminál uprostřed refaktoringu? Žádný problém. Claude Code ukládá konverzace automaticky.

Příkazy

# Pokračovat v poslední konverzaci v aktuálním adresáři claude --continue # Pokračovat v konkrétní pojmenované session claude --resume "auth-refactor" # Otevřít interaktivní výběr ze všech sessions claude --resume

Sessions můžete pojmenovávat při startu (claude -n "muj-projekt") nebo během konverzace příkazem /rename. Pojmenované sessions se snáze hledají, zvláště když pracujete na více věcích paralelně.

2. --model — výběr modelu

Claude Code podporuje různé modely z rodiny Claude. Výchozí je Opus (nejschopnější), ale pro rychlejší odpovědi můžete přepnout na Sonnet:

Příkazy

# Spustit se Sonnet modelem (rychlejší, levnější) claude --model sonnet # Nebo s plným názvem claude --model claude-sonnet-4-6 # Přepnout model během session: /model sonnet

3. --chrome — ovládání prohlížeče

Jedna z nejpůsobivějších funkcí. Claude Code se připojí k vašemu Chrome prohlížeči a může v něm navigovat, testovat formuláře, číst obsah stránek a dokonce pořizovat screenshoty. Vyžaduje rozšíření „Claude in Chrome".

Příkazy

# Spustit s Chrome integrací claude --chrome # Nebo aktivovat během session /chrome

Praktické použití:

  • „Otevři localhost:3000, vyplň přihlašovací formulář s neplatnými daty a zkontroluj chybové hlášky"
  • „Jdi na naši staging URL, otestuj nový checkout flow a zapiš co nefunguje"
  • „Otevři Google Docs a vytvoř draft release notes z posledních 10 commitů"
  • „Extrahuj data z tabulky na této stránce a ulož je jako JSON"

Claude Code má přístup k autentizovaným stránkám (Gmail, Notion, Jira), protože používá váš skutečný prohlížeč se všemi přihlášeními. Nemusíte nastavovat žádné API tokeny.

Chrome integrace je killer feature pro end-to-end testování. Claude Code může spustit dev server, otevřít aplikaci v prohlížeči, proklikat celý user flow a reportovat problémy — vše v jedné konverzaci.

4. --add-dir — přidání dalších adresářů

Pracujete s monorepem nebo potřebujete vidět víc projektů najednou? Přidejte další adresáře do kontextu:

Příkazy

# Přidat knihovnu a aplikaci z monorepa claude --add-dir ../packages/shared ../apps/web # Claude pak vidí soubory z obou adresářů # a může dělat změny napříč projekty

5. --permission-mode — řízení oprávnění

Claude Code má pět režimů oprávnění, které určují, co může dělat bez vašeho potvrzení:

  • plan — pouze čtení. Claude analyzuje kód, ale nic nezmění. Bezpečné pro průzkum cizích repozitářů.
  • default — čtení zdarma, zápis a příkazy vyžadují potvrzení. Doporučený režim.
  • acceptEdits — editace souborů automaticky, příkazy vyžadují potvrzení.
  • auto — vše automaticky v sandboxu. Pro důvěryhodné projekty.
  • bypassPermissions — vše bez omezení. Pouze pro CI/CD a automatizaci.

Příkazy

# Bezpečný průzkum cizího kódu claude --permission-mode plan # Pro důvěryhodný projekt v CI/CD claude -p --permission-mode bypassPermissions "run tests and fix failures" # Přepnout během session: Shift+Tab

Bezpečnostní tip

Přepínač --dangerously-skip-permissions obchází všechny bezpečnostní kontroly. Používejte pouze v izolovaných CI/CD prostředích, nikdy na produkčních strojích nebo s přístupem k citlivým datům.

6. --max-turns a --max-budget-usd — limity

V print režimu můžete omezit, kolik kroků Claude udělá nebo kolik utratí:

Příkazy

# Maximálně 5 kroků (čtení souboru, editace, spuštění testu = 3 kroky) claude -p --max-turns 5 "oprav failing testy" # Maximální rozpočet 2 dolary claude -p --max-budget-usd 2.00 "zrefaktoruj celý modul"

Užitečné pro CI/CD pipeline, kde nechcete, aby Claude běžel neomezeně. Kombinace obou přepínačů zajistí, že se zastaví u prvního splněného limitu.

7. --output-format — výstup pro strojové zpracování

Tři formáty výstupu pro různé účely:

Příkazy

# Prostý text (výchozí) claude -p "vysvětli tento kód" --output-format text # JSON s kompletní historií, tokeny a cenou claude -p "analyzuj bezpečnost" --output-format json # Streamovaný JSON (pro real-time zpracování) claude -p "projdi codebase" --output-format stream-json

JSON výstup je klíčový pro integraci do CI/CD — můžete parsovat výsledky, extrahovat nalezené problémy a automaticky vytvářet issues.

8. --system-prompt — vlastní instrukce

Nahraďte nebo rozšiřte výchozí systémový prompt:

Příkazy

# Kompletní nahrazení systémového promptu claude --system-prompt "Jsi security expert. Hledej zranitelnosti." # Přidání k výchozímu promptu (lepší volba) claude --append-system-prompt "Vždy používej TypeScript strict mode." # Načtení z souboru claude --append-system-prompt-file ./team-rules.txt

Pro trvalé instrukce je lepší použít CLAUDE.md soubor (více níže). --system-prompt se hodí pro jednorázové specializované úkoly.

9. --worktree — izolovaná práce v Git worktree

Claude Code umí vytvořit Git worktree — izolovanou kopii repozitáře, kde může pracovat bez ovlivnění vašeho pracovního adresáře:

Příkazy

# Vytvořit pojmenovaný worktree claude --worktree feature-auth # Automaticky vygenerovat název claude --worktree

Skvělé pro paralelní práci — jeden Claude refaktoruje v hlavním adresáři, druhý implementuje novou feature ve worktree. Změny pak mergnete přes Git.

10. --verbose a --debug — diagnostika

Když potřebujete vidět, co Claude Code dělá pod kapotou:

Příkazy

# Podrobný výpis každého kroku claude --verbose # Debug log pro konkrétní kategorie claude --debug "api,mcp" # Přepnout verbose během session: Ctrl+O

11. --allowedTools / --disallowedTools — kontrola nástrojů

Přesně definujte, které nástroje Claude smí nebo nesmí používat:

Příkazy

# Povolit jen Git příkazy a čtení souborů claude --allowedTools "Bash(git *)" "Read" # Zakázat editaci souborů (read-only analýza) claude --disallowedTools "Edit" "Write" # Omezit na konkrétní sadu nástrojů claude --tools "Bash,Read,Grep,Glob"

12. --effort — úroveň přemýšlení

Ovládá, kolik času Claude věnuje „přemýšlení" (extended thinking) před odpovědí:

Příkazy

# Nízká úroveň — rychlé odpovědi na jednoduché dotazy claude --effort low # Vysoká úroveň — hluboká analýza, architektury, debugování claude --effort high # Maximum — nejdůkladnější analýza claude --effort max # Přepnout během session: /effort high

12+

klíčových CLI přepínačů, které ovládají chování Claude Code

Trust adresářů a CLAUDE.md

Claude Code má systém „důvěry" pro adresáře. Když poprvé otevřete nový projekt, Claude Code se zeptá, jestli mu důvěřujete. To je důležité, protože projekt může obsahovat CLAUDE.md soubor s instrukcemi — a tyto instrukce ovlivňují chování AI.

CLAUDE.md — instrukce pro AI

Soubor CLAUDE.md je ekvivalent .editorconfig pro AI. Umístíte ho do kořene projektu a Claude Code ho automaticky načte při každém spuštění. Definuje pravidla, konvence a kontext projektu.

Příklad CLAUDE.md

# Projekt XYZ ## Tech Stack - TypeScript (strict mode) - React 19 + Next.js 15 - PostgreSQL + Prisma ORM - Vitest pro testy ## Konvence - Funkcionální komponenty, žádné class components - CSS Modules, žádný inline styling - Error handling přes Result type - Pojmenování: camelCase pro funkce, PascalCase pro komponenty ## Příkazy - pnpm dev — dev server - pnpm test — spustit testy - pnpm lint — lint + format check

CLAUDE.md se hledá na několika úrovních (v pořadí priority):

  1. Managed policy — systémová úroveň (/etc/claude-code/CLAUDE.md na Linuxu)
  2. Projekt — ./CLAUDE.md nebo ./.claude/CLAUDE.md
  3. Uživatel — ~/.claude/CLAUDE.md (platí pro všechny projekty)

Soubory z nadřazených adresářů se načítají automaticky až ke kořeni disku. Pokud máte monorepo, můžete mít CLAUDE.md v kořeni s globálními pravidly a další v každém balíčku s pravidly specifickými pro daný modul.

Organizace pravidel do souborů

Pro větší projekty doporučujeme organizovat pravidla do složky .claude/rules/:

Soubor .claude/rules/api.md

--- paths: - "src/api/**/*.ts" --- # Pravidla pro API - Každý endpoint musí mít input validaci (Zod schema) - Standardní error response formát - Rate limiting na všech public endpointech - Logování request/response (bez PII)

Pravidla s paths se aktivují jen když Claude pracuje se soubory odpovídajícími dané glob pattern. Tím pádem Claude nebude zatěžován API pravidly, když edituje frontend komponenty.

Best practice

Cílte na méně než 200 řádků v CLAUDE.md. Buďte konkrétní: „používej 2 mezery pro odsazení" je lepší než „formátuj správně". Importujte další soubory syntaxí @path/to/file místo kopírování obsahu.

Ukládání a obnovení sessions

Claude Code automaticky ukládá každou konverzaci. Nemusíte nic konfigurovat — sessions se ukládají lokálně a jsou svázané s adresářem projektu.

Pojmenování sessions

Pojmenované sessions se mnohem lépe hledají:

Příkazy

# Pojmenovat při startu claude -n "refaktor-auth-modulu" # Přejmenovat během konverzace /rename "refaktor-auth-modulu" # Pokračovat v pojmenované session claude --resume "refaktor-auth-modulu"

Výběr z historie

Příkaz claude --resume bez argumentu otevře interaktivní picker se všemi sessions. Můžete vyhledávat (/), filtrovat podle větve (B), přepínat mezi projekty (A) a zobrazit náhled (P).

Větvení konverzací

Příkaz /branch vytvoří kopii aktuální konverzace. Můžete pak zkusit jiný přístup bez ztráty dosavadní práce. Pokud se nový přístup nevydaří, vrátíte se k původní větvi.

Session management

# Větvení konverzace /branch "zkusim-jiny-pristup" # Export celé konverzace (pro sdílení nebo archivaci) /export conversation.md # Zobrazení spotřeby tokenů /cost

∞

sessions uložených lokálně — žádný limit, žádné mazání

Ctrl + C Ctrl + L cancel clear

Tipy a triky pro každodenní práci

Tady je sbírka praktických tipů, které vám pomohou vytěžit z Claude Code maximum. Každý vychází z reálného vývojářského workflow.

Klávesové zkratky

Nejdůležitější zkratky pro efektivní práci v interaktivním režimu:

  • Ctrl+C — zrušit aktuální generování (nejpoužívanější zkratka)
  • Ctrl+L — vyčistit obrazovku
  • Ctrl+O — přepnout verbose výpis
  • Ctrl+B — přesunout běžící úkol na pozadí
  • Shift+Tab — přepnout permission mode
  • Alt+P (macOS: Option+P) — přepnout model
  • Alt+T (macOS: Option+T) — přepnout extended thinking
  • Esc Esc — vrátit se zpět (rewind) nebo shrnout
  • Ctrl+G — otevřít zprávu v externím editoru (pro delší prompty)

Zkratka Ctrl+G je game changer pro delší prompty. Otevře váš výchozí editor (vim, nano, VS Code) — napíšete prompt pohodlně s formátováním a po uložení se odešle do Claude Code.

Slash příkazy

Během interaktivní session můžete psát příkazy začínající lomítkem. Nejužitečnější:

  • /cost — zobrazí spotřebu tokenů a cenu aktuální session
  • /context — vizualizace využití kontextového okna
  • /diff — zobrazí uncommitted změny (jako git diff)
  • /plan — přepne do plánovacího režimu pro komplexní úkoly
  • /copy — zkopíruje poslední odpověď do clipboardu
  • /export — exportuje celou konverzaci do souboru
  • /init — inicializuje CLAUDE.md pro aktuální projekt
  • /doctor — diagnostika instalace a konfigurace
  • /vim — přepne na Vim keybindings (pro Vim fanoušky)

Bash příkazy přímo z Claude Code

Prefix ! spustí příkaz přímo v shellu bez toho, aby ho zpracovával Claude:

V Claude Code session

# Spustit Git příkaz ! git status # Spustit testy ! npm test # Zkontrolovat běžící procesy ! ps aux | grep node

Pipe do Claude Code

Kombinace s unixovými nástroji je extrémně silná:

Příklady pipe workflow

# Analyzovat error log cat error.log | claude -p "shrň hlavní problémy a navrhni řešení" # Code review posledního commitu git diff HEAD~1 | claude -p "proveď code review, hledej bugy a security issues" # Vysvětlit složitý příkaz echo "find . -name '*.ts' -exec grep -l 'deprecated' {} + | xargs sed -i 's/old/new/g'" \ | claude -p "vysvětli co tento příkaz dělá krok po kroku" # Generovat testy z type definic cat src/types.ts | claude -p "vygeneruj Vitest testy pro všechny exportované typy"

MCP servery — rozšíření schopností

MCP (Model Context Protocol) servery přidávají Claude Code nové schopnosti — přístup k databázi, Slacku, Jira, nebo vlastním interním nástrojům:

MCP příkazy

# Přidat MCP server claude mcp add my-db-server # Zobrazit nastavené servery claude mcp list # Konfigurace v .mcp.json (commitujte do repa pro sdílení v týmu) { "mcpServers": { "postgres": { "type": "stdio", "command": "npx", "args": ["-y", "@modelcontextprotocol/server-postgres", "postgresql://..."] } } }

Automatizace v CI/CD

Claude Code v print režimu je perfektní pro automatizaci:

Příklady pro CI/CD

# Automatické code review v GitHub Actions git diff origin/main | claude -p \ --output-format json \ --max-turns 3 \ --max-budget-usd 1.00 \ "proveď code review, vrať JSON s nalezenými problémy" # Generování release notes git log --oneline v1.0..v1.1 | claude -p \ "vytvoř release notes v markdownu, kategorizuj: features, fixes, breaking changes" # Kontrola bezpečnosti claude -p \ --permission-mode plan \ "zkontroluj src/ na bezpečnostní zranitelnosti (OWASP Top 10)"

Porovnání s ostatními nástroji

Jak si Claude Code stojí oproti konkurenci?

  • Cursor / Windsurf — IDE s integrovaným AI. Skvělé pro běžné kódování. Claude Code vyniká při práci s velkými codebase, migracích a úkolech, které vyžadují spouštění příkazů.
  • GitHub Copilot — autocomplete a chat v editoru. Claude Code je lepší pro komplexní úkoly přesahující jeden soubor.
  • Aider — podobný koncept (CLI pro AI coding), ale Claude Code má větší kontext (1M tokenů) a bohatší ekosystém (Chrome, MCP, worktrees).
  • Webové rozhraní (claude.ai) — pro konverzaci a ad hoc dotazy. Claude Code je lepší pro cokoliv, co vyžaduje přístup k souborům.

V praxi se nástroje doplňují. Typický workflow: Cursor pro psaní kódu v editoru + Claude Code pro refaktoring, testy, CI/CD a úkoly přesahující jeden soubor.

Shrnutí: Jak začít

Claude Code je nástroj, který se nejlépe naučíte používáním. Tady je doporučený postup:

  1. Nainstalujte — jeden příkaz pro váš OS (viz výše).
  2. Spusťte claude doctor — ověřte, že vše funguje.
  3. Vytvořte CLAUDE.md — příkaz /init vygeneruje šablonu pro váš projekt.
  4. Začněte jednoduše — vysvětlení kódu, generování testů, code review.
  5. Postupně přidávejte — Chrome integrace, MCP servery, CI/CD automatizace.
  6. Pojmenovávejte sessions — budete se k nim vracet.

Nejdůležitější tip: CLAUDE.md je multiplikátor. Čím lépe popíšete svůj projekt, tím lepší výstupy Claude Code produkuje — pro celý tým, ne jen pro vás.

Chcete se naučit Claude Code v praxi? Na našich workshopech pro vývojáře ukazujeme celý workflow od instalace přes pokročilé techniky až po integraci do CI/CD pipeline vašeho projektu.