Jak použít Claude Code hooks pro automatizaci workflow v roce 2026\n\nPředstav si, že pokaždé, když Claude Code dokončí úkol, automaticky se spustí formátování kódu, vytvoří se commit nebo odešle notifikace do Slacku. Bez tvého zásahu. To není sci-fi — to jsou Claude Code hooks, událostmi řízená automatizace přímo v terminálu. V tomto návodu si ukážeme, jak použít Claude Code hooks k tomu, abys ušetřil hodiny práce týdně a zároveň udržel svůj workflow bezpečný.\n\n## Co jsou Claude Code hooks a proč je potřebuješ\n\nClaude Code hooks jsou skripty nebo příkazy, které se spouštějí v reakci na konkrétní události během seance s Claude. Můžeš je přirovnat k Git hooks — malé automatizace, které se spustí ve správný okamžik.\n\nPodporované události zahrnují:\n\n- PreToolUse — spustí se před tím, než Claude použije nástroj (může zablokovat nebezpečný příkaz).\n- PostToolUse — spustí se po použití nástroje (vhodné pro formátování nebo logování).\n- UserPromptSubmit — ověří uživatelský dotaz před odesláním.\n- SessionStart / SessionEnd — připraví prostředí nebo pošle shrnutí po skončení seance.\n- Stop / SubagentStop — spustí se po dokončení hlavního agenta nebo subagenta.\n\nProč to není jen další zbytečná funkce? Protože hooks přesouvají opakující se ruční práci z tvé hlavy do konfigurace. Nemusíš už pamatovat, že po každém editu máš spustit Prettier. Nemusíš kontrolovat, jestli se náhodou nedostaly tajné klíče do výstupu. Prostě nastavíš pravidla jednou a Claude je dodržuje za tebe.\n\nPokud Claude Code používáš společně s MCP servery pro propojení s externími nástroji, hooks jsou logickým dalším krokem. Zatímco MCP rozšiřují, co Claude umí, hooks definují, jak se má chovat v klíčových okamžicích.\n\n## Kde a jak Claude Code hooks nastavit\n\nKonfigurace hooks probíhá přes soubory settings.json. Můžeš je umístit na třech úrovních:\n\n1. ~/.claude/settings.json — globální nastavení pro celý tvůj stroj.\n2. .claude/settings.json — projektové nastavení, které můžeš commitnout do repozitáře.\n3. .claude/settings.local.json — lokální projektové nastavení, které se do gitu nedostane.\n\nDíky tomu můžeš mít globální bezpečnostní guardrails, projektové formátování a lokální experimenty zcela oddělené.\n\nZákladní struktura vypadá takto:\n\njson\\n{\\n "hooks": {\\n "PostToolUse": [\\n {\\n "matcher": "Edit|Write",\\n "hooks": [\\n {\\n "type": "command",\\n "command": "npx prettier --write $(jq -r '.tool_input.file_path')"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\nKlíčové pojmy:\n\n- matcher — říká, pro který nástroj se hook spustí (Bash, Edit, Write, Read, mcp__*, *).\n- type — může být command, prompt, agent nebo http.\n- command — shell příkaz, který se vykoná.\n- async — pokud je true, hook neblokuje další práci.\n\nOd ledna 2026 Claude Code podporuje také Setup hooks — speciální hooky, které se spustí před začátkem seance pomocí příkazu claude --init. Hodí se pro instalaci závislostí, inicializaci databáze nebo stažení potřebných assetů. Po inicializaci můžeš rovnou předat prompt, například claude --init "/install", a nechat Claude připravit celé prostředí bez dalšího klikání.\n\nOficiální dokumentaci k hooks najdeš v přehledu od Anthropic (Hooks guide, aktualizováno 2026). Doporučuji ji mít po ruce, protože formát se rychle vyvíjí.\n\n## Jak funguje životní cyklus hooku krok za krokem\n\nAby ses v hooks neztratil, pomůže pochopit, jakým způsobem Claude jednotlivé události zpracovává. Celý proces probíhá ve třech fázích:\n\n1. Příprava — před spuštěním seance se provedou Setup hooks a načtou se všechny konfigurační soubory. Claude nejprve vezme globální ~/.claude/settings.json, poté projektové .claude/settings.json a nakonec lokální .claude/settings.local.json. Pokud se stejná událost definuje na více úrovních, hooky se obvykle slučují, nikoli přepisují.\n\n2. Běh seance — při každém nástroji nebo interakci se vyhodnotí PreToolUse a PostToolUse hooky. Pokud PreToolUse vrátí nenulový exit kód, akce se neprovede a Claude dostane vysvětlení, proč byla zablokována. To je klíčové pro bezpečnostní guardrails.\n\n3. Ukončení — po dokončení tasku se spustí Stop nebo SessionEnd hooky. Ty jsou ideální pro finalizaci: spuštění testů, vytvoření commitu, odeslání notifikace nebo vygenerování reportu.\n\nDíky tomuto modelu můžeš automatizovat nejen jednotlivé akce, ale celé workflow od přípravy prostředí až po finální kontrolu. A právě proto jsou hooks tak mocným doplňkem k Claude Code Routines, kde necháváš AI pracovat déle bez dohledu.\n\n## Jak napsat svůj první hook od nuly\n\nNež se pustíme do pokročilejších příkladů, projdeme si jednoduchý hook krok za krokem. Cílem bude automaticky zkontrolovat, že soubor uložený Claude obsahuje validní JSON.\n\nKrok 1: Vytvoř adresář a skript.\n\nbash\\nmkdir -p .claude/hooks\\ncat > .claude/hooks/validate-json.sh << 'EOF'\\n#!/bin/bash\\nFILE=$(jq -r '.tool_input.file_path')\\nif [[ "$FILE" == *.json ]]; then\\n python3 -m json.tool "$FILE" > /dev/null || exit 1\\nfi\\nEOF\\nchmod +x .claude/hooks/validate-json.sh\\n\n\nKrok 2: Přidej hook do projektového nastavení.\n\njson\\n{\\n "hooks": {\\n "PostToolUse": [\\n {\\n "matcher": "Write|Edit",\\n "hooks": [\\n {\\n "type": "command",\\n "command": "bash .claude/hooks/validate-json.sh"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\nKrok 3: Otestuj. Nech Claude upravit libovolný JSON soubor. Pokud výstup nebude validní, hook vrátí chybu a ty zjistíš problém okamžitě, místo abys na něj narazil později v produkci.\n\nTento přístup funguje pro jakýkoliv typ kontroly: formátování, linting, bezpečnostní scan nebo audit. Důležité je, že hook dostane kontext události přes standardní vstup, takže můžeš číst metadata o nástroji, který byl právě použit.\n\n## 5 praktických Claude Code hooků, které okamžitě využiješ\n\nTeorie je pěkná, ale nejužitečnější je vidět konkrétní příklady. Vybral jsem pět hooků, které reálně zrychlují práci a zároveň jsou bezpečné nasadit.\n\n### 1. Auto-formátování kódu po každém editu\n\nNejčastější použití hooks. Jakmile Claude upraví nebo vytvoří soubor, okamžitě se spustí Prettier, Black, gofmt nebo jiný formátovač.\n\njson\\n{\\n "hooks": {\\n "PostToolUse": [\\n {\\n "matcher": "Edit|Write",\\n "hooks": [\\n {\\n "type": "command",\\n "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\nVýsledek? Ušetříš desítky minut denně, které bys jinak trávil ručním formátováním nebo řešením CI chyb.\n\n### 2. Blokování nebezpečných příkazů\n\nPreToolUse může fungovat jako bezpečnostní brána. Můžeš například zablokovat rm -rf /, force-push do mainu nebo spuštění neznámých skriptů z internetu.\n\njson\\n{\\n "hooks": {\\n "PreToolUse": [\\n {\\n "matcher": "Bash",\\n "hooks": [\\n {\\n "type": "command",\\n "command": "bash .claude/hooks/safety-check.sh"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\nSkript safety-check.sh může obsahovat jednoduché deny-listy nebo pokročilejší detekci citlivých dat. Komunitní projekt cc-safe-setup nabízí přes 890 příkladů bezpečnostních hooků (GitHub, 2026).\n\n### 3. Automatické lintování a typové kontroly\n\nMísto toho, abys čekal na CI zpětnou vazbu, můžeš spustit lint a testy lokálně hned po dokončení změn. To je obzvlášť užitečné, když používáš Claude Code společně s Cursorem a chceš udržet konzistentní kvalitu napříč nástroji.\n\njson\\n{\\n "hooks": {\\n "Stop": [\\n {\\n "hooks": [\\n {\\n "type": "command",\\n "command": "npm run lint && npm run typecheck"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\n### 4. Logování a audit všech změn\n\nPro týmy je důležité vědět, co AI agent udělal. Hook může po každém nástroji zapsat záznam do lokálního logu nebo poslat zprávu do centrálního systému.\n\njson\\n{\\n "hooks": {\\n "PostToolUse": [\\n {\\n "hooks": [\\n {\\n "type": "command",\\n "command": "bash .claude/hooks/log-tool-use.sh"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\nPřípadová studie — tým pěti vývojářů: Jeden z týmů, se kterým jsem konzultoval, nastavil tři základní hooky: formátování po editu, bezpečnostní kontrola Bash příkazů a automatický lint po Stop. Během prvních dvou týdnů klesl počet neúspěšných CI buildů o 40 % a vývojáři ušetřili v průměru 30 minut denně na ručních kontrolách. Žádný z hooků nebyl složitý — šlo o jednoduché shell skripty, které se spouštěly ve správný okamžik.\n\nTento přístup se skvěle doplňuje s MCP servery pro enterprise governance, kde potřebuješ mít přehled o všech krocích agenta.\n\n### 5. Notifikace a shrnutí po skončení seance\n\nKdyž Claude dokončí dlouhý task, může tě hook upozornit zvukem, desktopovou notifikací nebo zprávou ve Slacku. To oceníš zejména při Claude Code Routines, kdy necháváš AI pracovat na pozadí.\n\njson\\n{\\n "hooks": {\\n "SessionEnd": [\\n {\\n "hooks": [\\n {\\n "type": "command",\\n "command": "bash .claude/hooks/notify-done.sh"\\n }\\n ]\\n }\\n ]\\n }\\n}\\n\n\n## Jak bezpečně nasadit hooks v týmu\n\nHooks jsou mocný nástroj, ale s mocí přichází odpovědnost. Tady je pár pravidel, která pomohou vyhnout se bolestem:\n\n1. Začni malý. Nepřidávej desítky hooků najednou. Začni s jedním — typicky formátováním — a postupně přidávej další.\n2. Testuj lokálně. Vždycky si hook ověř v izolovaném prostředí, než ho nasadíš do týmového repozitáře.\n3. Rozděl osobní a týmové nastavení. Osobní preference dej do settings.local.json, sdílená pravidla do .claude/settings.json.\n4. Nastav timeouty. Dlouho běžící hook může znepříjemnit práci. Používej rozumné timeouty, ideálně pod 30 sekund.\n5. Měj fail-safe. Kritické bezpečnostní hooky by měly být synchronní a blokující. Kosmetické hooky mohou běžet asynchronně.\n\nPokud řešíš bezpečnost na vyšší úrovni, mrkni na náš článek Jak bezpečně nasadit Claude agenty: Sandboxy a MCP tunely. Kombinace sandboxů, MCP tunelů a hooks tvoří solidní obrannou linii.\n\n## Kdy hooks nepoužívat\n\nNe každý problém se hodí řešit hookem. Vyhni se těmto situacím:\n\n- Dlouhé operace — pokud hook běží déle než pár sekund, zdržuješ interaktivní práci. Takové věci raději přesuň do claude -p v CI/CD.\n- Komplexní rozhodování — hooks nejsou náhradou za promyšlený agentic workflow. Pokud potřebuješ větvit se podle více podmínek, zvaž pro rychlejší SaaS automatizace Zapier, pro flexibilnější logiku raději n8n workflow nebo vlastní skript.\n- Tajné hodnoty — nikdy neukládej API klíče přímo do settings.json. Používej proměnné prostředí nebo bezpečné úložiště.\n- Přehnaná autonomie — než hooku dovolíš commitnout, pushnout nebo deploynout, ujisti se, že máš rollback plán.\n\n## Časté otázky\n\n### Co když hook selže?\n\nZáleží na typu. PreToolUse hook může zablokovat akci, pokud vrátí nenulový exit kód. PostToolUse a SessionEnd hooky obvykle selhání jen zalogují a nezastaví práci. Vždycky si nastavení otestuj v bezpečném prostředí.\n\n### Mohou být hooks použité i v CI/CD?\n\nAno. Claude Code podporuje headless režim pomocí příkazu claude -p, takže ho můžeš použít v CI pipelinech, pre-commit hooks nebo v nočních build skriptech. V kombinaci s hooks tak můžeš automatizovat i složitější workflow.\n\n### Jaký je rozdíl mezi hooks a MCP servery?\n\nMCP servery rozšiřují, k čemu má Claude přístup — například k databázi, Jiru nebo prohlížeči. Pokud chceš vidět lehčí variantu práce v browseru bez vlastního MCP setupu, mrkni i na Claude for Chrome. Hooks naopak řídí, jak se Claude chová v určitých okamžicích. Doplňují se: MCP dává schopnosti, hooks dávají pravidla.\n\n### Potřebuji k hooks placený plán?\n\nNe. Hooks jsou součástí Claude Code CLI, která je dostupná zdarma i v placených tarifech. Některé pokročilé hooky mohou volat placené služby (například API notifikací), ale samotná funkce je bezplatná.\n\n### Existují hotové knihovny hooků?\n\nAno. Kromě oficiální dokumentace stojí za zmínku komunitní projekty jako cc-safe-setup nebo claude-sdlc-wizard, které nabízejí předpřipravené sady hooků pro bezpečnost a vývojářský životní cyklus (GitHub, 2026).\n\n## Závěr\n\nClaude Code hooks představují posun od pasivního AI asistenta k aktivnímu členu tvého workflow. Umožňují ti automatizovat opakující se úkoly, vynucovat bezpečnostní pravidla a udržovat kvalitu kódu bez ručního dohledu.\n\nNejlepší cesta, jak začít, je dnes: otevři svůj projekt, vytvoř .claude/settings.json a přidej první hook pro formátování. Uvidíš okamžitý rozdíl. A až budeš připravený na víc, propoj hooks s MCP servery a postav si opravdu autonomní vývojářský workflow.\n\nPokud chceš hlubší srovnání s dalšími AI coding nástroji, podívej se na náš článek Claude Code vs Cursor vs Windsurf. Pomůže ti vybrat nástroj, který se k tvému novému hook-based workflow nejvíc hodí.\n