Вы просите Claude Code что-то поправить в коде, он правит — а потом каждый раз приходится вручную запускать форматирование, прогонять проверки или напоминать себе не забыть про тесты. Знакомо? Хочется, чтобы рутина случалась сама, без напоминаний.
Ровно для этого в Claude Code есть hooks — «хуки», или, по-русски, зацепки. Это способ сказать инструменту: «когда произойдёт вот такое событие — автоматически сделай вот это». Давайте разберёмся, что это за идея и чем она полезна тому, кто только начинает.
Что такое hook на самом деле
Hook — это ваша команда или маленький скрипт, который Claude Code запускает сам в определённый момент работы. Вы один раз описываете правило, а дальше оно срабатывает без вашего участия.
По смыслу это очень похоже на привычку: «после того как поел — помыл тарелку». Только привычка тут не у человека, а у инструмента.
- событие — то, на что реагируем (например, файл был изменён);
- действие — что выполнить в ответ (например, запустить форматирование);
- автоматизм — вам больше не нужно помнить об этом самому.
Зачем это новичку
Может показаться, что автоматизация — тема для опытных. На деле именно новичку хуки снимают самую утомительную часть: «не забыть сделать N после каждого изменения».
- автоформат — код приводится к единому виду сразу после правок;
- проверки — линтер или тесты запускаются автоматически, и вы раньше видите ошибку;
- наведение порядка — например, мелкая уборка временных файлов;
- меньше держать в голове — рутина уходит из вашей оперативной памяти в правило.
Главное — вы перестаёте полагаться на «вспомню сам». Машина не забывает.
Чтобы это не звучало абстрактно, посмотрим на пару бытовых сценариев «до и после».
Сценарий 1: форматирование. Раньше: вы просите Claude дописать функцию, он дописывает, а отступы и кавычки выглядят чуть иначе, чем в остальном файле. Вы открываете файл, запускаете форматтер, проверяете, что ничего не съехало. После хука: Claude меняет файл — форматтер срабатывает сам, файл всегда аккуратный, и вы об этом даже не думаете.
Сценарий 2: тесты. Раньше: вы внесли правку, обрадовались, пошли дальше — а через час выяснилось, что один маленький тест давно красный. После хука: проверки запускаются сразу после изменения, и красный тест вы видите в ту же секунду, пока контекст ещё свежий в голове.
Сценарий 3: уборка. Раньше: в проекте копятся временные файлы, и вы периодически вспоминаете «надо бы прибраться». После хука: мелкая уборка происходит сама в нужный момент, и папка проекта остаётся чистой без вашего участия.
Заметили общий шаблон? Во всех трёх случаях исчезает одно и то же — необходимость помнить про шаг и делать его руками.
Чтобы было проще прикинуть, где хук уместен, держите небольшую шпаргалку «когда что».
| Когда срабатывает | Что делает хук | Зачем новичку |
|---|---|---|
| После изменения файла | Запускает форматирование | Код всегда выглядит единообразно |
| После изменения файла | Прогоняет линтер или тесты | Ошибку видно сразу, а не через час |
| Перед запуском команды | Проверяет, всё ли на месте | Меньше шансов сломать проект случайно |
| После завершения задачи | Делает мелкую уборку | Папка проекта остаётся чистой |
Таблица — не исчерпывающий список, а ориентир: почти любая рутина, которую вы делаете «каждый раз после чего-то», — кандидат на хук.
С чего это похоже, что вы уже знаете
Если вы прошли первые уроки про терминал, то хуки соберутся из знакомых кубиков. Действие хука — это обычная команда, такая же, как ls, grep или вызов форматтера. Событие — это просто момент, в который Claude Code эту команду за вас вызовет.
То есть никакой новой магии: вы уже умеете писать команды — а хук лишь решает, когда их запустить. Если терминал пока в новинку, начните с него на странице уроков, а к хукам вернётесь позже — они станут очевидными.
Совет
Не пытайтесь сразу автоматизировать всё. Начните с одного простого действия, которое реально надоело делать руками, — и убедитесь, что оно срабатывает как надо. Один работающий хук полезнее десяти, в которых вы путаетесь.
Частые ошибки новичков
Хуки — штука простая, но в самом начале легко наступить на пару грабель. Вот три самых частых.
- Автоматизируют слишком много сразу. Соблазн повесить хук на каждое событие велик, но тогда непонятно, что и когда срабатывает. Заведите один хук, поживите с ним пару дней, и только потом добавляйте следующий.
- Вешают на хук медленную команду. Если действие выполняется долго, оно будет тормозить каждую правку и начнёт раздражать. На частые события ставьте только быстрые проверки; тяжёлое — запускайте вручную, когда нужно.
- Забывают проверить, что хук вообще сработал. Описать правило и решить, что «теперь работает», — не одно и то же. После настройки сделайте тестовое изменение и убедитесь своими глазами, что действие выполнилось.
Совет
Завести хук стоит только под ту рутину, которую вы уже умеете делать руками. Если вы пока не понимаете, что именно должно происходить «само», сначала сделайте это несколько раз вручную — а автоматизируете уже осознанно.
А как именно это настроить?
Точный синтаксис конфигурации хуков легко перепутать, и заучивать его наизусть не нужно — детали и актуальный формат мы разбираем по шагам прямо в курсе, на живых примерах. Здесь важно ухватить идею: событие → ваше действие → автоматизм.
Заодно держите рядом два соседних понятия, которые часто упоминают вместе с хуками: CLAUDE.md — файл с инструкциями для Claude Code по вашему проекту, и plan mode — режим, где Claude сначала показывает план, а потом действует. Вместе они делают работу предсказуемой.
Хуки — это маленький шаг от «я всё делаю руками» к «рутина случается сама». Начать стоит не с теории, а с практики: сперва уверенно освоить терминал и команды, а автоматизация ляжет сверху естественно.
Короткий FAQ
Нужно ли уметь программировать, чтобы пользоваться хуками? Нет. Достаточно понимать команды терминала. Действие хука — это обычная команда, которую вы и так запускали бы руками; хук лишь решает, когда её вызвать за вас.
Хук может что-нибудь сломать в проекте? Сам по себе — нет, он просто запускает вашу же команду. Риск ровно тот же, что и при запуске этой команды руками. Поэтому начинайте с безобидных действий вроде форматирования и тестов и проверяйте результат.
Сколько хуков нужно для начала? Один. Возьмите ту рутину, которая надоела сильнее всего, автоматизируйте именно её и убедитесь, что всё работает. Остальное добавите позже, когда почувствуете, как это устроено.
Хочешь глубже? Большой разбор: Как управлять Claude Code: CLAUDE.md, Skills и hooks.