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ť.
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é pokyny | Claude 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ácia | riadok System prompt vo výstupe /context |
CLAUDE.md | pravidlá projektu, ktoré si agent prečíta na začiatku relácie | súbor v koreňovom priečinku projektu |
| Nástroje | čítanie a úprava súborov, vyhľadávanie, príkazy v termináli | riadky ako Read(...) a Bash(...) počas práce |
| Skills | pokyny, ktoré si model môže vybrať podľa úlohy alebo ktoré môžete výslovne vyvolať vy | .claude/skills/, /skills |
| MCP | most k externým službám a aktuálnym údajom | /mcp |
| Subagenti | samostatný vykonávateľ s vlastným kontextom | .claude/agents/ |
| Žiadosti o povolenie | obal kontroluje, či je akcia povolená; v prípade potreby si vyžiada váš súhlas | otázka v termináli pred príkazom alebo úpravou |
| Hooks | vaš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ý cyklus | vracia modelu výsledky nástrojov, aby mohol vybrať ďalší krok | niekoľ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.
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úboruCLAUDE.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ť
Stopmôž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
/modela porovnajte výsledky pri rovnakej úlohe.
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.
GO TO FULL VERSION