Hooks в Claude Code: автодействия по событию

Hook (по-английски «крючок», «зацепка») — это правило вида «когда случилось X — сделай Y», которое срабатывает автоматически. Вы один раз описываете его в настройках, и дальше Claude Code сам исполняет его в нужный момент.

События бывают разные: помощник собирается выполнить инструмент, уже выполнил его, изменил файл, завершил ответ. К каждому такому моменту можно «прицепить» свою команду — например, прогнать линтер (проверку стиля кода) или автоформатирование. Главное отличие от обычной просьбы: hook не нужно вызывать. Он отрабатывает сам, потому что вы заранее договорились, что в этой ситуации он нужен.

Hooks хороши там, где действие должно происходить всегда, а не когда вы вспомнили:

• Автопроверка кода. После каждой правки — прогнать проверку на ошибки, чтобы поймать их сразу, а не на «боевом» сайте.
• Автоформатирование. Привести код к единому виду, не задумываясь об этом вручную.
• Защита от опасного. Hook может перехватить рискованную команду и потребовать подтверждения — связка с режимом разрешений.

Не делайте hook из всего:

• Разовое действие. Если что-то нужно один раз — попросите словами, hook тут лишний.
• Когда вы ещё не нащупали процесс. Сначала пройдите задачу руками пару раз, поймите, что именно должно срабатывать автоматически, — и только потом фиксируйте в hook.
• Тяжёлая операция на каждый чих. Если на событие повесить долгую команду, работа начнёт тормозить. Hook должен быть быстрым.

Самый ценный hook в реальной работе — автопроверка кода после правок. Логика простая: помощник что-то изменил → сразу прогоняется проверка → если она нашла проблему, видно её тут же, а не когда сайт уже сломался у пользователей.

В настройках это выглядит примерно так (упрощённо):

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "npm run lint" }
        ]
      }
    ]
  }
}

Здесь событие — «помощник применил инструмент правки файла» (Edit или Write), а действие — запустить проверку npm run lint. Дальше это происходит само, и мне не нужно каждый раз помнить «а проверил ли я».

На чём спотыкаются новички:

• Путают hook и команду. Команду вы запускаете сами; hook срабатывает автоматически на событие. Если действие нужно «по требованию» — это команда, а не hook.
• Вешают на событие долгую операцию. Тяжёлая команда на каждую правку превращает работу в ожидание. Hook должен быть быстрым.
• Не проверяют, что hook вообще сработал. Добавили правило и забыли. Стоит один раз убедиться, что оно отрабатывает, иначе вы думаете, что защищены, а это не так.
• Ошибка в команде. Если в hook вписана команда, которой нет в проекте, он будет молча падать. Сначала проверьте, что та же команда работает руками.