# Hooks в Claude Code: автодействия на событиях

Канонический URL: https://zero2claude.ru/blog/claude-hooks
Дата: 2026-07-04 (обновлено 2026-06-27)
Теги: claude-code, автоматизация

Что такое hooks в Claude Code простыми словами: скрипты, которые срабатывают сами на нужных событиях, и зачем они новичку.

Вы просите Claude Code что-то поправить в коде, он правит — а потом каждый раз приходится вручную запускать форматирование, прогонять проверки или напоминать себе не забыть про тесты. Знакомо? Хочется, чтобы рутина случалась сама, без напоминаний.

Ровно для этого в Claude Code есть hooks — «хуки», или, по-русски, зацепки. Это способ сказать инструменту: «когда произойдёт вот такое событие — автоматически сделай вот это». Давайте разберёмся, что это за идея и чем она полезна тому, кто только начинает.

<Cover src="/blog/claude-hooks.jpg" alt="Схема: событие в Claude Code запускает скрипт-хук" />

## Что такое hook на самом деле

Hook — это ваша команда или маленький скрипт, который Claude Code запускает сам в определённый момент работы. Вы один раз описываете правило, а дальше оно срабатывает без вашего участия.

По смыслу это очень похоже на привычку: «после того как поел — помыл тарелку». Только привычка тут не у человека, а у инструмента.

- событие — то, на что реагируем (например, файл был изменён);
- действие — что выполнить в ответ (например, запустить форматирование);
- автоматизм — вам больше не нужно помнить об этом самому.

## Зачем это новичку

Может показаться, что автоматизация — тема для опытных. На деле именно новичку хуки снимают самую утомительную часть: «не забыть сделать N после каждого изменения».

- автоформат — код приводится к единому виду сразу после правок;
- проверки — линтер или тесты запускаются автоматически, и вы раньше видите ошибку;
- наведение порядка — например, мелкая уборка временных файлов;
- меньше держать в голове — рутина уходит из вашей оперативной памяти в правило.

Главное — вы перестаёте полагаться на «вспомню сам». Машина не забывает.

Чтобы это не звучало абстрактно, посмотрим на пару бытовых сценариев «до и после».

**Сценарий 1: форматирование.** Раньше: вы просите Claude дописать функцию, он дописывает, а отступы и кавычки выглядят чуть иначе, чем в остальном файле. Вы открываете файл, запускаете форматтер, проверяете, что ничего не съехало. После хука: Claude меняет файл — форматтер срабатывает сам, файл всегда аккуратный, и вы об этом даже не думаете.

**Сценарий 2: тесты.** Раньше: вы внесли правку, обрадовались, пошли дальше — а через час выяснилось, что один маленький тест давно красный. После хука: проверки запускаются сразу после изменения, и красный тест вы видите в ту же секунду, пока контекст ещё свежий в голове.

**Сценарий 3: уборка.** Раньше: в проекте копятся временные файлы, и вы периодически вспоминаете «надо бы прибраться». После хука: мелкая уборка происходит сама в нужный момент, и папка проекта остаётся чистой без вашего участия.

Заметили общий шаблон? Во всех трёх случаях исчезает одно и то же — необходимость *помнить* про шаг и *делать* его руками.

Чтобы было проще прикинуть, где хук уместен, держите небольшую шпаргалку «когда что».

| Когда срабатывает | Что делает хук | Зачем новичку |
|---|---|---|
| После изменения файла | Запускает форматирование | Код всегда выглядит единообразно |
| После изменения файла | Прогоняет линтер или тесты | Ошибку видно сразу, а не через час |
| Перед запуском команды | Проверяет, всё ли на месте | Меньше шансов сломать проект случайно |
| После завершения задачи | Делает мелкую уборку | Папка проекта остаётся чистой |

Таблица — не исчерпывающий список, а ориентир: почти любая рутина, которую вы делаете «каждый раз после чего-то», — кандидат на хук.

## С чего это похоже, что вы уже знаете

Если вы прошли первые уроки про терминал, то хуки соберутся из знакомых кубиков. Действие хука — это обычная команда, такая же, как `ls`, `grep` или вызов форматтера. Событие — это просто момент, в который Claude Code эту команду за вас вызовет.

То есть никакой новой магии: вы уже умеете писать команды — а хук лишь решает, *когда* их запустить. Если терминал пока в новинку, начните с него на странице [уроков](/learn), а к хукам вернётесь позже — они станут очевидными.

<Callout type="tip">
Не пытайтесь сразу автоматизировать всё. Начните с одного простого действия, которое реально надоело делать руками, — и убедитесь, что оно срабатывает как надо. Один работающий хук полезнее десяти, в которых вы путаетесь.
</Callout>

## Частые ошибки новичков

Хуки — штука простая, но в самом начале легко наступить на пару грабель. Вот три самых частых.

- **Автоматизируют слишком много сразу.** Соблазн повесить хук на каждое событие велик, но тогда непонятно, что и когда срабатывает. Заведите один хук, поживите с ним пару дней, и только потом добавляйте следующий.
- **Вешают на хук медленную команду.** Если действие выполняется долго, оно будет тормозить каждую правку и начнёт раздражать. На частые события ставьте только быстрые проверки; тяжёлое — запускайте вручную, когда нужно.
- **Забывают проверить, что хук вообще сработал.** Описать правило и решить, что «теперь работает», — не одно и то же. После настройки сделайте тестовое изменение и убедитесь своими глазами, что действие выполнилось.

<Callout type="tip">
Завести хук стоит только под ту рутину, которую вы уже умеете делать руками. Если вы пока не понимаете, что именно должно происходить «само», сначала сделайте это несколько раз вручную — а автоматизируете уже осознанно.
</Callout>

## А как именно это настроить?

Точный синтаксис конфигурации хуков легко перепутать, и заучивать его наизусть не нужно — детали и актуальный формат мы разбираем по шагам прямо в курсе, на живых примерах. Здесь важно ухватить идею: событие → ваше действие → автоматизм.

Заодно держите рядом два соседних понятия, которые часто упоминают вместе с хуками: `CLAUDE.md` — файл с инструкциями для Claude Code по вашему проекту, и plan mode — режим, где Claude сначала показывает план, а потом действует. Вместе они делают работу предсказуемой.

Хуки — это маленький шаг от «я всё делаю руками» к «рутина случается сама». Начать стоит не с теории, а с практики: сперва уверенно освоить терминал и команды, а автоматизация ляжет сверху естественно.

## Короткий FAQ

**Нужно ли уметь программировать, чтобы пользоваться хуками?**
Нет. Достаточно понимать команды терминала. Действие хука — это обычная команда, которую вы и так запускали бы руками; хук лишь решает, когда её вызвать за вас.

**Хук может что-нибудь сломать в проекте?**
Сам по себе — нет, он просто запускает вашу же команду. Риск ровно тот же, что и при запуске этой команды руками. Поэтому начинайте с безобидных действий вроде форматирования и тестов и проверяйте результат.

**Сколько хуков нужно для начала?**
Один. Возьмите ту рутину, которая надоела сильнее всего, автоматизируйте именно её и убедитесь, что всё работает. Остальное добавите позже, когда почувствуете, как это устроено.

**Хочешь глубже?** Большой разбор: [Как управлять Claude Code: CLAUDE.md, Skills и hooks](/blog/steering-claude-code).

 [Начать с азов терминала](/learn)