Хуки и автопроверки: сторож, который проверяет работу ИИ-агента

Хук это автоматическое действие, которое срабатывает на событие: перед правкой файла, после команды или в конце работы. Например, запустить проверку или остановить опасную команду. Это как сторож у двери: правило выполняется само, независимо от того, вспомнил ли про него агент.

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

Вы увидите: вы ничего не нажимаете, всё происходит само. Дальше разберём, чем хук лучше обычного правила в файле.

Правило в AGENTS.md агент может проигнорировать или забыть, а хук выполняется всегда, потому что его запускает сам инструмент. Поэтому для обязательных вещей, вроде запрета на опасные команды или проверки перед сохранением, надёжнее хук, а для советов и стиля достаточно текстового файла.

Разница как между запиской на холодильнике и замком на двери. Записку «не открывай» можно не заметить. Замок срабатывает всегда. Поэтому жёсткие запреты («не трогать файл с паролями», «перед сохранением прогнать проверку») отдают хуку, а пожелания («пиши коротко», «называй переменные понятно») оставляют в файле правил.

Чаще всего нужны три момента: до действия (можно остановить), после действия (можно проверить результат) и начало или конец сессии (можно подготовить окружение или напомнить правила).

Названия событий у инструментов свои. В Claude Code и Codex перед инструментом срабатывает PreToolUse, в Gemini CLI BeforeTool, в Cursor есть, например, beforeShellExecution (перед командой в терминале). Полный список всегда смотрите в документации вашего инструмента.

Вы увидите: у простого хука всегда три части: событие, команда проверки и решение «можно или нельзя».

Выберите событие, например «перед правкой файла», и команду проверки, которая быстро отвечает «можно» или «нельзя». Настройте её в конфигурации инструмента по документации, затем проверьте на учебной папке, что опасное действие действительно блокируется. Лабораторная 6 проходит этот путь по шагам. Сначала берите самые простые события.

Так выглядит настройка в Claude Code (формат проверен по документации на 01/10/2026): файл .claude/settings.json в папке проекта.

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "python .claude/hooks/guard.py" }
        ]
      }
    ]
  }
}

Читается просто: «перед инструментами Edit и Write (правка и создание файла) запусти скрипт guard.py». Если скрипт завершится с кодом 2 и напишет причину в сообщение об ошибке, инструмент остановит действие и покажет причину агенту. Сам скрипт вы напишете в лабораторной про хук-сторожа.

Вы увидите: в /hooks (команда внутри Claude Code) появится ваш хук в списке. У других инструментов своё место проверки, смотрите документацию.

Нет. Хуки есть не везде, а там, где есть, формат и список событий отличаются. В модуле есть честная таблица с серым значком «нет» для инструментов без этой функции. Если хуков нет, часть задач решают проверки в системе контроля версий или в CI.

Если хуков нет, есть обходные пути. Git умеет запускать скрипт перед коммитом (папка .git/hooks, файл pre-commit), но это срабатывает позже: когда вы сохраняете историю, а не когда агент правит файл. Ещё один путь: те же проверки в CI, о которых будет модуль про режим без интерфейса.

Да, хук выполняет команды на вашем компьютере, поэтому чужой хук без проверки ставить нельзя. Читайте, что он делает, берите проверенные примеры и тестируйте в учебной папке. Ошибка в хуке может блокировать работу или, наоборот, пропускать лишнее, так что сначала проверьте его сами.

Три привычки, которые снимают почти все риски. Первая: читать каждую строку чужого скрипта, а если не понимаете, попросить агента объяснить построчно и не запускать до ответа. Вторая: сначала включать хук в учебной папке, а не в рабочем проекте. Третья: держать список запретов узким. Хук, который ловит «всё, что похоже на опасное», рано или поздно остановит нужную работу.

Ещё одна оговорка из документации Claude Code: если хук завершился с кодом 0, это не значит «разрешаю». Для проверки перед инструментом обычная система разрешений всё равно работает дальше. Хук добавляет стоп-сигнал, а не отменяет режимы из модуля про безопасность.