Orchestrace agentů v Claude Code: Kuchařka pro /up, /down, /deleg a noční autonomní práci

TL;DR: Vytvoříte pět souborů agentů v ~/.claude/agents/ a tři slash příkazy v ~/.claude/commands/. Pak píšete /up pro Opus, /down pro Sonnet, /deleg pro delegaci na externí CLI. Noční práci spustíte přes skill /night-mode.

Proč to dělat — reálná čísla

Orchestrace není akademická cvičení. Jde o peníze a rychlost. Analýza spotřeby nad Claude Code transcripty ukázala konzistentní vzor, který se opakuje u každého intenzivního uživatele:

Typická struktura nákladů za týden

Celkem tokenů: ~5 mld — z toho 4,8 mld cache-read Claude Opus: ~84 % nákladů Claude Sonnet: ~4 % Claude Haiku: <1 % Top session: jedna maratónská session = stovky dolarů → kontext narostl k 1M tokenů, každý tah re-četl celé okno za prémiovou sazbu

Dvě páky způsobují 95 % nákladů: (1) volba modelu (Opus = 84 % výdajů) a (2) délka session (4,8 mld cache-read tokenů = každý tah přeposílá celou historii). Správná orchestrace útočí na obě.

84 %

nákladů typicky tvoří Opus — přepnutí výchozího modelu na Sonnet je nejsilnější páka

Navíc: Claude Opus nad zhruba 200 tisíc tokenů kontextu přechází na prémiovou sazbu — vstupní tokeny 2×, výstupní 1,5×. Maratónská session na Opusu se exponenciálně zdražuje s každým tahem.

Jak měřit svoji spotřebu

Nástroj ccusage (npm) čte lokální Claude Code transcripty a zobrazuje spotřebu po dnech, sezeních nebo živý rate-limit blok. Instalace: npm install -g ccusage.

Měření spotřeby přes ccusage

# Spotřeba po dnech s rozpadem podle modelů ccusage daily --since 20260601 # Po sezeních — najděte maratóny ccusage session --since 20260601 # Živý 5h rate-limit blok ccusage blocks --live

Adresářová struktura

Claude Code načítá vlastní agenty a slash příkazy ze dvou míst. Globální konfigurace platí pro všechny projekty, projektová jen pro daný repozitář:

Kde co leží

~/.claude/ commands/ ← globální slash příkazy (platí ve všech projektech) up.md down.md deleg.md agents/ ← globální vlastní agenti explorer.md (Haiku — hledání) summarizer.md (Haiku — čtení logů/docs) delegate.md (Haiku — most na externí CLI) code-reviewer.md (Sonnet — code review) security-auditor.md (Opus — security audit) skills/ night-mode/ SKILL.md ← autonomní noční smyčka váš-projekt/ .claude/ commands/ ← projektové slash příkazy (jen tady) agents/ ← projektoví agenti (jen tady) CLAUDE.md ← instrukce specifické pro projekt

Slash příkaz `/up` — eskaluj na Opus

Soubor ~/.claude/commands/up.md říká Claude Code, aby tento jeden tah zpracoval s plnou kapacitou Opusu. Klíčové je frontmatter model: opus — model se nepřepne trvale, jen pro tento příkaz.

~/.claude/commands/up.md

--- description: Up — vyřeš na Opusu (těžké uvažování / citlivý kód) argument-hint: [volitelně popis úkolu] model: opus --- Tento tah řeš s plnou **Opus** kapacitou — jde o náročnou nebo rizikovou práci (architektura, vícekrokový debug, bezpečnost, platby/auth/šifrování, kritická integrace). Mysli důkladně. Pro **trvalé** přepnutí celé session použij `/model opus`. Úkol (když prázdné, pokračuj v rozdělané práci): $ARGUMENTS

Kdy použít /up

/up navrhn architekturu platebního modulu /up debuguj proč JWT tokeny expirují předčasně /up proveď security review OAuth callbacku /up refaktoruj auth modul — dotkne se 12 souborů # Bez argumentu — Opus dokončí rozdělanou práci /up

Jednorázové vs trvalé přepnutí

/up přepne model jen pro jeden tah — ideální pro jeden těžký krok uprostřed jinak rutinní práce. Celou session trvale přepnete přes /model opus nebo Alt+P. Po Opus tahu se session vrátí na výchozí model. Pozor: nad 200k tokenů kontextu nastupuje prémiová sazba (vstup 2×, výstup 1,5×) — sledujte 🧠 context % ve status line.

Slash příkaz `/down` — rutina na Sonnetu

Soubor ~/.claude/commands/down.md explicitně říká, že tento úkol je rutina. Zároveň instruuje, aby velké čtení delegovalo na levné Haiku sub-agenty místo tahání souborů do hlavního Opus kontextu — tohle je druhá velká páka na cache-read náklady.

~/.claude/commands/down.md

--- description: Down — rutina levně (Sonnet, deleguj čtení na Haiku) argument-hint: [volitelně popis úkolu] model: sonnet --- Tento tah řeš úsporně na **Sonnetu** — je to rutina (CRUD, šablony, config, drobné fixy, texty). Velké čtení/hledání deleguj na Haiku sub-agenty (`explorer`/`summarizer`), nedrž velký kontext v hlavní session. Pro **trvalé** přepnutí celé session použij `/model sonnet`. Úkol (když prázdné, pokračuj v rozdělané práci): $ARGUMENTS

Kdy použít /down

/down vygeneruj unit testy pro UserService podle stávajícího vzoru /down přidej validaci e-mailu do registračního formuláře /down aktualizuj README — přidej sekci o konfiguraci prostředí # Bez argumentu — Sonnet dokončí rozdělanou práci /down

Slash příkaz `/deleg` — deleguj na externí CLI

Soubor ~/.claude/commands/deleg.md spustí delegaci na jiný AI nástroj. Proč to dává smysl ekonomicky: GitHub Copilot, Antigravity (agy) a Codex mají oddělené předplatné s vlastní kvótou — jejich spotřeba nejde na účet vašeho Claude Max plánu. Samotné volání provede sub-agent delegate (Haiku), aby hlavní kontext zůstal štíhlý.

~/.claude/commands/deleg.md

--- description: Deleg — implementaci na externí CLI (agy / copilot), pak integruj argument-hint: <co delegovat> --- Deleguj následující práci podle orchestračních pravidel: - Necitlivý, delegovatelný kód → **agy** (primární implementátor; headless `agy --print`). Framework/boilerplate/scaffolding → **copilot** (`copilot --allow-all`). Spouštěj přes `delegate` sub-agenta, ať hlavní kontext zůstane štíhlý. Práci drž ve **worktree izolaci** nebo jako diff/patch. - Free **Codex** jen na drobnosti (kvóta). - **Citlivý kód NEDELEGUJ** (platby, auth, šifrování, uploady) — nech na Opusu (`/up`). - Po dokončení výstup **zreviduj, zintegruj a commitni jen ty** (Claude main). Externí nástroj nikdy necommituje přímo do repozitáře. Úkol k delegaci: $ARGUMENTS

Kdy použít /deleg

# Implementace nové featury — agy má velký kontext, vhodné na refaktoring /deleg implementuj stránku nastavení uživatele podle docs/settings-spec.md # Boilerplate — Copilot je dobrý na zavedené frameworky /deleg vytvoř NestJS modul Notifications se CRUD endpointy # Drobný bulk refaktoring — Codex (free, ale šetřit kvótu) /deleg přejmenuj interface IUser na User v celém src/ # Druhý pohled na architekturu — stejnou otázku položit agy i Claudovi /deleg agy: jak bys navrhl caching strategii pro GraphQL endpoint?

Konfigurace auto-approvals pro externí CLI

Aby externí nástroje fungovaly headless (bez interaktivního ptaní se na každý krok), nastavte jim ekvivalent Claude acceptEdits. Jednou nastavíte, pak funguje automaticky:

~/.gemini/settings.json (pro agy)

{ "general": { "defaultApprovalMode": "auto_edit" } } // auto_edit = agy auto-schválí edit nástroje, na ostatní se ptá // agy sdílí ~/.gemini konfiguraci (stejný gemini-cli core)

~/.codex/config.toml (pro Codex)

[approval] approval_policy = "on-failure" sandbox_mode = "workspace-write" # Pravý ekvivalent acceptEdits: edity ve workspace bez ptaní, bez přístupu k síti/systému

Copilot — spouštět s --allow-all

# Copilot nemá persistent auto-approval settings — vždy spouštět s flagy: copilot --allow-all-tools --allow-all-paths "<prompt>" # nebo zkráceně: copilot --allow-all "<prompt>" # ⚠️ Plný bypass — spouštět jen v izolovaném worktree nebo trusted folderu

Pozor na --print-timeout u agy

Výchozí timeout u agy --print je 5 minut. Když ho ukončíte dřív, vypadá to jako „hang" — ale agy jen čeká na model. Při selhání (prázdný výstup) zkontrolujte přihlášení a TTY, ne kód. Fallback pořadí: agy → codex → copilot.

Agenti v `~/.claude/agents/`

Každý agent je Markdown soubor s frontmatter. Claude Code ho spustí jako samostatný sub-proces s vlastním modelem a sadou nástrojů. Výsledek vrátí orchestrátorovi — agenti sami nikdy necommitují.

`explorer.md` — levné hledání v kódu (Haiku)

Nejpoužívanější agent. Vrací soubor:řádek + 1 věta — nikdy celé soubory. Haiku je zlomek ceny Opusu, ale na lokalizaci kódu stačí.

~/.claude/agents/explorer.md

--- name: explorer description: Cheap read-only code search & locate. Returns concise file:line pointers and 1-line context — not full file dumps. Use to find where something lives without spending main-context tokens. Pinned to Haiku. tools: Read, Grep, Glob model: haiku --- Jsi rychlý, levný **read-only** průzkumník kódu. Úkol: najít, kde co je, a vrátit **stručný** výsledek — ne výpisy celých souborů. - Hledej přes Grep/Glob; čti jen nutné úseky (offset/limit). - Výstup: seznam `soubor:řádek` + 1řádkový popis ke každému; na konci 2–3 věty shrnutí. Žádné dlouhé citace. Tvůj výstup je vstup pro orchestrátora — drž ho kompaktní.

`summarizer.md` — digest logů a dokumentace (Haiku)

Dostane cestu k logu nebo dokumentaci a vrátí kompaktní výtah. Místo tahání 5 000 řádků do hlavního kontextu dostanete 10 klíčových bodů.

~/.claude/agents/summarizer.md

--- name: summarizer description: Cheap read-only summarizer. Reads given files/logs/docs and returns a concise summary or targeted extract, keeping the main session's context small. Pinned to Haiku. tools: Read, Grep, Glob model: haiku --- Jsi levný **read-only** sumarizátor. Dostaneš cesty k souborům (nebo log/doc) a vrátíš **kompaktní** shrnutí nebo cílený výpis. - Čti zadané zdroje; nevypisuj je celé. - Pokud je zadán dotaz/účel, extrahuj jen relevantní (s `soubor:řádek` u klíčových míst). - Výstup: stručné body; uveď co je důležité a co případně chybí. Tvůj výstup je vstup pro orchestrátora — minimalizuj tokeny.

`delegate.md` — most na externí CLI (Haiku)

Spouští headless volání agy/Codex/Copilot z Bashe a vrací jejich výstup. Je na Haiku — jen orchestruje CLI volání, nevytváří kód sám.

~/.claude/agents/delegate.md

--- name: delegate description: Delegate a one-shot task to an external AI CLI (agy, Codex, Copilot) and return its result. Keeps the main session context lean. Pinned to Haiku. tools: Bash, Read, Write model: haiku --- Jsi **delegační most**: dostaneš úkol + (volitelně) který nástroj použít, spustíš ho **headless** a vrátíš výstup orchestrátorovi. ## Headless volání - **agy** (default): `agy --print "<PROMPT>"` Na soubory přidej `--add-dir <adresář>`. Timeout 5 min — nechej čekat. - **codex**: `codex exec "<PROMPT>"` - **copilot**: `copilot -p "<PROMPT>" --allow-all-tools` Přístup k cestám: `--add-dir <adresář>`. Plný bypass → jen v izolaci. ## Postup 1. Vyber nástroj (default **agy**), sestav prompt. Velký vstup zapiš do temp souboru, předej cestou (`--add-dir`). 2. Spusť přes Bash; stderr ignoruj (`2>$null` / `2>/dev/null`). 3. Při selhání fallback: **agy → codex → copilot**, nahlas to. 4. Vrať VÝSTUP nástroje + 1 větu, který nástroj ho vyprodukoval. Pravidlo: default read-only/sandbox; agentní akce jen v izolovaném adresáři.

`code-reviewer.md` — code review (Sonnet)

~/.claude/agents/code-reviewer.md

--- name: code-reviewer description: Reviews code changes for bugs, regressions and convention issues. Read-only — reports findings, does not edit. Pinned to Sonnet. tools: Read, Grep, Glob, Bash model: sonnet --- Jsi zaměřený **read-only** code reviewer. Hlásíš nálezy, neměníš soubory. 1. Zjisti rozsah (zadané soubory nebo `git diff HEAD`). 2. Hledej: regrese a logické chyby, porušení konvencí projektu, bezpečnostní díry, výkon (N+1, zbytečné dotazy). 3. Pro každý nález: `soubor:řádek`, závažnost (kritická/střední/nízká), proč a návrh opravy. Bez chvály. Pokud nic vážného, řekni to. Výstup je report pro orchestrátora.

`security-auditor.md` — hloubkový bezpečnostní audit (Opus)

Záměrně na Opusu — na bezpečnostním kódu se nevyplatí šetřit. Funguje i jako adversariální verifikátor: dostane podezření a pokusí se ho potvrdit i vyvrátit.

~/.claude/agents/security-auditor.md

--- name: security-auditor description: Deep, read-only security audit (payments, auth, uploads, encryption). Reports findings with severity; does NOT edit. Adversarial verifier mode available. Pinned to Opus. tools: Read, Grep, Glob, Bash model: opus --- Jsi senior **read-only** security auditor. Hlásíš nálezy, neměníš soubory. 1. Zjisti rozsah (zadané soubory/modul nebo `git diff HEAD`). 2. Projdi kód; hledej i business-logic chyby (IDOR, autorizace, manipulace cen, přístupová kontrola). 3. Pro každý nález: `soubor:řádek`, závažnost (kritická/vysoká/střední/nízká), stručný důkaz/PoC, doporučená oprava. 4. **Adversariální režim:** máš-li ověřit konkrétní podezření, aktivně se ho snaž potvrdit i vyvrátit — výslovně řekni, zda je reálné (default: skeptický, ne poplašný). Checklist: XSS, SQLi, CSRF, upload MIME, session fixation, IDOR, rate-limit, open redirect, path traversal, weak crypto. Žádná chvála. Výstup je report pro orchestrátora.

Konfigurace v `CLAUDE.md`

Aby Claude Code věděl, kdy eskalovat a kdy šetřit bez toho, abyste to museli pokaždé říkat, přidejte sekci o orchestraci do globálního ~/.claude/CLAUDE.md:

~/.claude/CLAUDE.md (sekce orchestrace)

# Hospodaření s tokeny (model tiering) **Default model je Sonnet** — rutina, CRUD, šablony, texty, config, commit messages. **Eskaluj na Opus (`/up`) — povinně:** Jakmile narazíš na úkol, kde Opus reálně prospěje, aktivně to oznam a vyzvi k přepnutí: „Tohle by si zasloužilo Opus (důvod) — přepni /model opus." Nebo těžkou část odbaví Opus sub-agent a výsledek vrátí do levné main smyčky. Opus si zaslouží: - Návrh architektury nebo vícekrokový debugging - Bezpečnostní audit, platby, auth/OAuth, šifrování, uploady - Refaktoring přes více souborů naráz - Cokoliv kde chyba je drahá nebo je třeba hluboké uvažování Na Sonnetu nech (default, `/down`): - Rutinní CRUD, šablony, konfigurace, drobné fixy, texty **Deleguj na levné Haiku sub-agenty (drž main kontext štíhlý):** - Hledání v kódu → agent `explorer` (nikdy nenačítej celé soubory do main) - Čtení logů/docs → agent `summarizer` - Zběžný code review → agent `code-reviewer` **Deleguj na externí CLI (`/deleg`, jiná kvóta):** - Necitlivé featury, boilerplate → agy (primární) - Framework scaffolding → copilot - Claude main vždy reviewuje výstup a jako jediný commituje **Nikdy nedeleguj:** platby, auth, šifrování, multi-tenant, uploady **Hygiena session:** - `/clear` mezi nesouvisejícími úkoly (každý tah re-čte celou historii) - `/compact` když session nabobtnala ale téma pokračuje - Nad 200k tokenů kontextu na Opusu nastupuje prémiová sazba — sleduj 🧠 context %

Noční autonomní práce: `/night-mode`

/night-mode je skill uložený v ~/.claude/skills/night-mode/SKILL.md. Spustíte ho večer, zadáte co má Claude zvládnout, a ráno najdete výsledky. Řídí smyčku sub-agentů s vlastním časovačem, automaticky se zotaví z výpadků API a nikdy nepřekročí bezpečnostní hranice.

Jde o samostatné téma — kompletní obsah SKILL.md, bezpečnostní hranice, vzory pro různé typy nočních úkolů a tipy pro ranní review jsme popsali v dedikovaném článku:

Celý návod na night-mode: Claude Code night-mode: Kompletní SKILL.md a vzory pro autonomní noční práci

Anti-patterny — co nedělat

Tohle jsou nejčastější chyby, které multi-agent přínos přeměňují v režii:

Anti-patterny

❌ Dva agenti editují tytéž soubory naráz → merge konflikty, nekonzistentní stav → Fix: worktrees pro paralelní práci, nebo sériové pořadí ❌ Maratónská session — jeden kontext přes 10 úkolů za sebou → každý tah re-čte celou historii, exponenciálně zdražuje → Fix: /clear mezi nesouvisejícími úkoly, /compact když nabobtnalo ❌ Opus jako výchozí model na vše → 84 % nákladů z jediného modelu, rutina ho nepotřebuje → Fix: Sonnet default, Opus jen na těžké/citlivé ❌ Načítat celé soubory do hlavního kontextu při hledání → cache-read náklady rostou s délkou session → Fix: explorer agent (Haiku) vrátí jen soubor:řádek ❌ Tři nástroje řeší tentýž úkol naráz a pak se merguje → víc agentů ≠ lepší výsledek, jen vyšší náklady a koordinační režie → Fix: jeden orchestrátor (Claude main), ostatní jako konzultanti/implementátoři ❌ Citlivý kód (platby, auth) delegovat na externí CLI → jiný model, jiná bezpečnostní kontrola, jiné záruky → Fix: citlivý kód vždy Claude Opus, nikdy externě

Přehled: Který příkaz kdy

Rychlá reference

Situace → Příkaz / agent ────────────────────────────────────────────────────────── Architektura, těžký debug → /up Bezpečnostní review citlivého kódu → /up + security-auditor agent (Opus) Rutinní CRUD, šablony, texty → /down Kde je funkce XY v codebase → explorer agent (Haiku, auto) Přečti 3000řádkový log → summarizer agent (Haiku, auto) Implementace necitlivé featury → /deleg (agy → Claude review → commit) Boilerplate / scaffolding → /deleg copilot Code review diffu → code-reviewer agent / /code-review Druhý nezávislý pohled před publikací → /second-opinion Hloubkový security audit → security-auditor agent (Opus) Mechanický refaktoring přes noc → /night-mode Session nabobtala, téma pokračuje → /compact Nové téma / jiný projekt → /clear Trvalé přepnutí modelu → /model opus nebo /model sonnet

Jedno pravidlo nad všemi: Claude main je jediný, kdo commituje. Sub-agenti a externí CLI vrací drafty a reporty — vy (nebo Claude main) rozhodujete co se dostane do repozitáře. Žádný auto-commit z externího nástroje.

Chcete tyhle vzory nastavit pro celý tým a přizpůsobit CLAUDE.md vašemu stacku? Na našich workshopech pro vývojáře projdeme kompletní setup orchestrace krok za krokem.

Proč to dělat — reálná čísla

Adresářová struktura

Slash příkaz /up — eskaluj na Opus

Slash příkaz /down — rutina na Sonnetu

Slash příkaz /deleg — deleguj na externí CLI

Konfigurace auto-approvals pro externí CLI

Agenti v ~/.claude/agents/

explorer.md — levné hledání v kódu (Haiku)

summarizer.md — digest logů a dokumentace (Haiku)

delegate.md — most na externí CLI (Haiku)

code-reviewer.md — code review (Sonnet)

security-auditor.md — hloubkový bezpečnostní audit (Opus)

Konfigurace v CLAUDE.md

Noční autonomní práce: /night-mode