Хуки Claude Code: как автоматизировать проверки и ошибки

Хуки Claude Code: как автоматизировать проверки и ошибки

Хуки Claude Code запускают команды до и после действий, блокируют правки защищённых файлов и заставляют модель проверять работу без напоминаний.

Одна из самых раздражающих вещей в Claude Code — необходимость исправлять одни и те же ошибки по нескольку раз. Я пробовал записывать их в CLAUDE.md проекта: помогает, но всё равно приходится следить, соблюдаются ли инструкции.

А недавно я поэкспериментировал с хуками Claude Code — и, кажется, это одна из самых недооценённых его функций. Хуки автоматически запускают команды до или после определённых действий либо когда Claude завершает задачу. Я приспособил их, чтобы перехватывать ошибки, следить за правилами проекта и заставлять Claude проверять собственную работу — без напоминаний с моей стороны.

Инструкций в CLAUDE.md не всегда хватает

Часть правил нужно жёстко контролировать

Файл CLAUDE.md удобен, чтобы задать Claude инструкции под конкретный проект: какие команды использовать, какие файлы не трогать, как подходить к кодовой базе. Ещё я вёл отдельный mistakes.md и записывал туда проблемы, на которые натыкался. Оба файла дают модели больше контекста, но это по-прежнему инструкции, которые она должна интерпретировать.

Проблема в том, что часть действий нужно выполнять стабильно, раз за разом. Скажем, вы попросили Claude прогонять тесты после правок — и не хотите проверять, сделал ли он это. То же с запретом трогать определённые конфиги или с требованием убедиться, что правки не принесли новых ошибок.

Хуки дают над этим больше контроля. Claude Code предоставляет несколько событий по ходу работы, и к каждому можно прицепить скрипт или команду. Хук PreToolUse срабатывает до того, как Claude вызовет инструмент, и может заблокировать действие — например, попытку отредактировать защищённый файл. Хук PostToolUse срабатывает после работы инструмента: удобно, чтобы автоматически запускать форматирование, линтинг или другие проверки после изменений кода.

Есть ещё хуки Stop и TaskCompleted — они проверяют, выполнены ли нужные условия, прежде чем Claude закончит работу. Настраиваете такие хуки один раз, и Claude Code сам вызывает их при каждом подходящем событии. Если проверка не прошла, хук возвращает обратную связь или блокирует действие.

Я начал превращать ошибки в хуки

Как задать Claude Code рамки

С хуками важно быть конкретным в том, что вы хотите предотвратить. Инструкция «ничего не сломай» бесполезна. А вот «не меняй эти конфиги» или «не закрывай задачу с проваленными тестами» — то, что можно реально проконтролировать.

Например, напишите небольшой скрипт, который проверяет путь к файлу всякий раз, когда Claude пытается внести правку. Если путь совпадает с защищённым файлом вроде.env, скрипт завершается с кодом 2 и возвращает объяснение. Claude Code блокирует правку и передаёт это объяснение обратно модели. Скрипты можно держать в каталоге.claude/hooks/ проекта и регистрировать через.claude/settings.json.

Отдельно скажу про автоматическую валидацию — она особенно полезна. Можно заставить Claude Code запускать Prettier или линтер при каждом изменении файла, чтобы проблемы форматирования и другие частые ошибки ловились сразу. Для дорогих проверок вроде полного набора тестов разумнее дождаться конца задачи. Хук TaskCompleted прогонит тесты и не даст Claude отметить задачу выполненной, если они провалены, — и у модели будет шанс исправить ошибки.

Писать эти скрипты самому необязательно. Опишите нужные проверки в Claude Code и попросите его сгенерировать скрипты хуков и конфигурацию. Команда /hooks покажет, что уже настроено, а условие сбоя можно вызвать намеренно — чтобы убедиться, что всё работает.

Хуки умеют куда больше, чем ловить ошибки

Автоматизировать можно многое

Claude Code справляется со сложными задачами без особого вмешательства, и сидеть, уставившись в терминал, я не люблю. Но время от времени он просит разрешение на команду или задаёт вопрос, прежде чем продолжить. Тут выручает хук Notification: он отправляет уведомление на рабочий стол, когда Claude нуждается во внимании. На macOS можно обойтись встроенной командой osascript — ничего дополнительно ставить не придётся.

Ещё одно интересное применение — управление контекстом в долгих сессиях. Когда контекстное окно заполняется, Claude Code автоматически сжимает разговор, и важные детали иногда теряются в сводке. Хук SessionStart можно запускать после сжатия и подкидывать Claude свежую информацию о проекте. Скажем, скрипт достаёт последние коммиты Git, незавершённые задачи или нужные заметки из файлов проекта и добавляет их обратно в контекст. Данные берутся прямо из проекта, так что остаются актуальными по мере работы.

Хуки можно подключать и к другим инструментам и сервисам. Например, отправлять вебхук в n8n, когда Claude завершает задачу, вести локальный журнал активности или запускать другую автоматизацию по итогам сессии. Я уже использую n8n в нескольких личных проектах, так что встроить Claude Code в эти процессы вполне реально.

Моды — ещё одно направление

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

Реклама
Здесь будет баннер
Здесь будет рекламный блок
Источник: XDA Developers
Telegram:

Читайте также