Hooks: правила, които не разчитат на паметта
Hook е команда, която Claude Code пуска сам в определен момент. Тя се изпълнява всеки път, независимо дали моделът помни правилото.
В този урок
Защо правилото в CLAUDE.md не стига
Правило, написано в CLAUDE.md или в паметта, е молба. Claude го чете в началото и през повечето време го спазва. В дълъг разговор обаче навикът понякога печели и правилото се губи.
Hook работи по друг начин. Това е команда, която Claude Code пуска сам в точно определен момент. Моделът не решава дали да я изпълни и не може да я забрави.
Кога може да се закачи
Моментите се наричат събития и са доста. Тези пет ми вършат почти цялата работа.
| Събитие | Кога се случва |
|---|---|
SessionStart | В началото на разговора |
UserPromptSubmit | Когато изпратиш съобщение |
PreToolUse | Преди Claude да използва инструмент |
PostToolUse | След като инструментът е свършил |
Stop | Когато Claude приключи с отговора |
Къде се пише
Hooks стоят във файла с настройките. Ако ги сложиш в ~/.claude/settings.json, важат за всичките ти проекти. Ако ги сложиш в .claude/settings.json в папката на проекта, важат само там.
Това е hook, който се пуска преди всяка команда в терминала:
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "python3 ~/.claude/hooks/pazach.py"
}
]
}
]
}
}Ако файлът вече съществува, добави в него само частта hooks.
Редът matcher казва за кой инструмент важи. Bash е терминалът, а ако напишеш Edit|Write, hook-ът се пуска при всяка промяна на файл.
Как hook казва «не»
Claude Code подава на твоя скрипт кратко описание на това, което предстои. Вътре са името на инструмента и какво точно ще направи, например цялата команда. Скриптът я чете и отговаря с код на изход.
- Изход 0 значи, че всичко е наред и работата продължава по обичайния ред.
- Изход 2 значи «спри». При
PreToolUseкомандата не се изпълнява, а текстът на грешката отива при Claude като причина.
Така той разбира защо е спрян и пробва по друг начин, вместо да повтаря същото.
Ако не ти се пише скрипт, кажи го с думи:
Направи ми hook, който спира git push --force,
и ми обясни какво добави в settings.json.С /hooks виждаш кои hooks са включени в момента.
Грешката, която направих
Агентът ми спираше една програма с команда, която търси процеси по име. Командата намираше и собствения му терминал и го убиваше, а всичко след нея тихо не се изпълняваше. Случи се два пъти за един ден. Записах го като урок в бележките и на другия ден стана пак. Тогава направих hook, който спира тази команда, и оттогава не се е повторило.
Какво имам аз
- Преди команда в терминала. Спира се добавянето на всички файлове в git наведнъж, качването на файл с пароли, презаписването на историята и триенето на цяла папка по абсолютен път.
- При всяко мое съобщение. Един скрипт чете колко голям е станал контекстът. Над 150 хиляди токена напомня на Claude да запише handoff и да пусне /compact.
- След запис на файл. Друг скрипт търси в текста грешки, които вече са излизали. Когато сменихме името на профила, старото продължи да се появява, и сега той го хваща.
- В края на отговора. Какво е правено в разговора се записва в дневника ми, без да го искам.
За какво да внимаваш
Hook е програма, която работи на твоя компютър с твоите права. Затова чети чуждите hooks, преди да ги добавиш.
Естествено, можеш и да прекалиш. Ако hook спира твърде много неща, започва да ти пречи и накрая го изключваш. Моите блокират само няколко точни команди, а при собствена грешка излизат тихо и не спират работата.
В Codex
Codex също има hooks и събитията носят почти същите имена. Пишат се в ~/.codex/hooks.json или във файла config.toml. Преди нов hook да се пусне за първи път, Codex иска да го прегледаш и да му се довериш, а това става с /hooks.
Запомни
- Правило в CLAUDE.md е молба, а hook се изпълнява всеки път.
- Hooks стоят в
settings.jsonи се закачат за събитие. - Изход 2 спира действието и казва на Claude защо.
- Направи hook за грешка, която се е повторила, след като вече си я записал.
Искаш да стане по-бързо?
Вземи шаблоните готови. Наръчникът ти дава CLAUDE.md, brain.md и AGENTS.md за попълване и план за първите 30 дни.19 € Нека го настроя вместо теб. Изграждам ти мозъка, паметта и първите агенти и после ти показвам как да ги караш сам.от 250 €Ако нещо в урока не е ясно, пиши ми в Instagram на @bravis.ai.