Prepli ste model cez /model, zopakovali úlohu a dostali inú odpoveď. No agent si prečítal CLAUDE.md rovnako, pred príkazom si vypýtal povolenie rovnako a hook sa spustil ako predtým. Zdá sa teda, že toto všetko nie je súčasťou modelu.

Pozrime sa, kde sa končí model a začína program, ktorý ho obklopuje. Pomôže vám to zistiť, čo kontrolovať, keď agent urobí chybu.

Model a obal

Model spracuje dodaný kontext a vytvorí odpoveď alebo požiadavku na nástroj. Napríklad vyberie, ktorý súbor má prečítať a ktorý príkaz spustiť. Na vykonanie týchto úkonov je potrebný program okolo modelu: pristupuje k súborom, spúšťa príkazy a vracia modelu výsledky.

V anglických materiáloch sa takýto program nazýva harness. Doslovne to znamená "postroj" (áno, ten pre kone), no po slovensky je výstižnejšie hovoriť o obale. Dokumentácia Anthropic to hovorí priamo: Claude Code je obal a Claude je model vo vnútri. Výraz harness nájdete aj v článkoch o agentoch všeobecne, takže stojí za to si ho zapamätať.

Požiadavka zľava vstupuje do obalu. V jeho strede je model a okolo neho tri skupiny: čo model vidí, čím môže konať a kde ho zastavia. Obal vykoná požiadavku na nástroj a vráti jej výsledok modelu, aby mohol vybrať ďalší krok. Vpravo je výsledok práce v projekte.Obal (harness)cyklusPožiadavkaModelvýber krokuČo model vidípokyny, CLAUDE.mdČím model konánástroje, MCP, subagentiKde model zastaviapovolenia, hooksVýsledokv projekte
Pracovný cyklus: požiadavka na nástroj, výsledok, ďalší krok

Obal na schéme zhromažďuje kontext, kontroluje povolenia a vykonáva požiadavky modelu na nástroje. Šípka pod modelom znázorňuje cyklus: výsledok nástroja sa vráti do kontextu a model vyberie ďalší krok alebo dokončí odpoveď. Hotová odpoveď ešte nedokazuje, že je úloha vyriešená: výsledok treba overiť.

Čo ste už nastavovali

Takto sa jednotlivé časti obalu prejavujú v Claude Code. Súbory a príkazy v pravom stĺpci vám pomôžu nájsť každý mechanizmus v projekte alebo relácii.

Časť obaluČo robíKde ju nájdete
Systémové pokynyClaude Code ich pridá do kontextu ešte pred vašou prvou správou: ako pracovať, aké nástroje sú k dispozícii a v ktorom priečinku prebieha reláciariadok System prompt vo výstupe /context
CLAUDE.mdpravidlá projektu, ktoré si agent prečíta na začiatku reláciesúbor v koreňovom priečinku projektu
Nástroječítanie a úprava súborov, vyhľadávanie, príkazy v termináliriadky ako Read(...) a Bash(...) počas práce
Skillspokyny, ktoré si model môže vybrať podľa úlohy alebo ktoré môžete výslovne vyvolať vy.claude/skills/, /skills
MCPmost k externým službám a aktuálnym údajom/mcp
Subagentisamostatný vykonávateľ s vlastným kontextom.claude/agents/
Žiadosti o povolenieobal kontroluje, či je akcia povolená; v prípade potreby si vyžiada váš súhlasotázka v termináli pred príkazom alebo úpravou
Hooksvaše príkazy naviazané na udalosti relácie; spúšťajú sa bez rozhodnutia modelu/hooks
Kontext a reláciačo model práve vidí a ku ktorému okamihu sa môžete vrátiť/context, /clear, /rewind
Agentný cyklusvracia modelu výsledky nástrojov, aby mohol vybrať ďalší krokniekoľko akcií po sebe v reakcii na jednu požiadavku

CLAUDE.md a skills poskytujú modelu pokyny. Model môže pravidlo nesprávne pochopiť alebo ho prehliadnuť. Kontrola povolení a príkazy v nastavených hooks sa vykonávajú programovo: výsledok závisí od zadaných podmienok a samotných príkazov.

Plugins v tabuľke nie sú, pretože nejde o samostatnú súčasť, ale o balík: niekoľko skills, príkazov alebo hooks nainštalovaných naraz.

Ten istý model, iné správanie

Predstavte si webový chat bez prístupu k vášmu projektu a terminálu. Má vlastný obal: históriu konverzácie, rozhranie, niekedy aj vyhľadávanie na webe či nahrávanie súborov. V takomto chate môže model vysvetliť úpravu a ukázať kód, zatiaľ čo Claude Code s prístupom k projektu ju môže zapísať do súboru. Model je rovnaký, možnosti sú odlišné, pretože sa líši program, ktorý ho obklopuje.

S príkazom /model je to naopak. Model sa zmení, obal zostane rovnaký, takže pravidlá, nástroje ani žiadosti o povolenie nezmiznú.

Od modelu závisí, ako pochopí úlohu, vyberie nástroje a vyhodnotí ich výsledky. Obal zhromažďuje kontext, sprístupňuje nástroje a kontroluje povolenia. Model môže napríklad požiadať o chýbajúci súbor a obal ho prečíta a vráti jeho obsah.

Ako to vyzerá v Claude Code

Agent presvedčivo rozoberá funkciu, ktorá v projekte už dávno nie je? Najprv skontrolujte, či sa aktuálny kód dostal do kontextu. Môžete ho pridať pomocou @ a cesty k súboru, vložiť do správy alebo načítať nástrojom na čítanie. V prvých dvoch prípadoch nemusí dôjsť k samostatnému volaniu nástroja na čítanie. Ak sa nástroj použil, pozrite sa, čo vrátil: obsah súboru alebo chybu prístupu či nesprávnej cesty. Ak kód v kontexte chýba, vložte ho alebo požiadajte agenta, aby súbor prečítal. Ak tam kód je, ale záver je nesprávny, overte uvažovanie podľa konkrétnych riadkov. Tu môže pomôcť aj iný model.

Čo upraviť, keď agent robí chyby

Jednorazovú chybu najľahšie napravíte krátkou poznámkou: "to nie je správny súbor, pozri sa do src/utils.js". Ak sa však chyba opakuje v každej relácii, skontrolujte pokyny a dostupné údaje. Možno musíte potrebné pravidlo zakaždým vysvetľovať odznova.

V praxi to môže vyzerať takto:

  • agent v každej relácii zabúda na pravidlo projektu, napríklad že sa testy spúšťajú príkazom npm test - zapíšte ho do súboru CLAUDE.md. Dôležité pravidlo je istejšie výslovne uložiť do tohto súboru, než sa spoliehať na pripomenutie v konverzácii;
  • rovnaký postup vysvetľujete už tretí raz - je čas presunúť ho do skillu. Agent si bude môcť načítať pokyny podľa úlohy. Počas práce skontrolujte, či sa skill vyvolal; ak nie, spustite ho sami cez /skill-name, pričom namiesto skill-name dosaďte jeho skutočný názov;
  • agent háda údaje, ktoré nemá - poskytnite mu ich: pridajte súbor do kontextu pomocou @ alebo pripojte externú službu cez MCP. Presviedčaním hádanie nevyriešite;
  • agent napíše "hotovo", hoci nespustil kontrolu - hook na udalosť Stop môže spustiť testy sám, bez rozhodnutia modelu. Výsledok aj tak posudzujete vy podľa výstupu príkazu, nie podľa správy agenta;
  • potrebné údaje sú dostupné a načítané, no agent sa stráca v zložitom uvažovaní - skúste iný model cez /model a porovnajte výsledky pri rovnakej úlohe.
Zistite príčinu

Najprv skontrolujte, či sú potrebné údaje a nástroje dostupné. Ak je problém v uvažovaní, môžete hneď skúsiť iný model. Porovnávajte kvalitu výsledku aj spotrebu v /usage: opakované neúspešné pokusy tiež míňajú váš limit aj čas.