Настройте в Claude Code хук, который после изменения файлов запускает команду проверки проекта. Хук — это автоматическое действие при заданном событии: например, ИИ сохранил код, а проект сразу проверил его на ошибки. Для сайта или небольшого сервиса такой порядок помогает замечать поломки ещё во время работы. Ниже разберём, какую проверку выбрать, как подключить её к правкам и как убедиться, что автоматизация действительно срабатывает. Начните с одной команды, результат которой понятен вам или разработчику.
Что проверять после правок ИИ в небольшом проекте?
Выберите действие, поломку которого бизнес заметит сразу. Для сайта это отправка заявки, для внутреннего калькулятора — расчёт суммы, для кабинета — доступ к нужному разделу. Сам хук ничего не знает о работе бизнеса. Он лишь запускает команду, а полезность результата зависит от того, что эта команда проверяет.
После каждого изменения лучше запускать короткую проверку кода: поиск синтаксических ошибок, проверку типов или небольшой набор тестов. Полный проход по сайту через браузер оставьте отдельному этапу. Если каждое сохранение запускает долгую процедуру, работа будет постоянно ждать её завершения.
Попросите разработчика показать команду проверки и пример её результата. У успешного запуска должен быть понятный итог, у ошибки — название файла или описание сломанного сценария. Сообщение «процесс завершён» без результата проверки для приёмки не подходит.
Для браузерных сценариев в материалах о Claude Code упоминается Playwright: с его помощью можно проверять действия на странице. Но такой тест сначала нужно связать с конкретным ожиданием, например: после нажатия кнопки появляется сообщение об отправке заявки. Сам факт открытия страницы этого не подтверждает (источник: «Скиллы для Claude Code, которые делают его лучше», vc.ru).
Как настроить хук Claude Code после изменения файлов?
Сначала запустите выбранную проверку вручную из папки проекта. Например, команда npm run check подходит только тогда, когда в package.json уже есть сценарий check. Если сценария нет, сначала настройте его с разработчиком. Иначе хук будет исправно сообщать об отсутствии команды вместо поиска ошибок в коде.
Для настройки откройте меню хуков командой /hooks в Claude Code. Названия пунктов интерфейса зависят от версии, поэтому ориентируйтесь на событие, инструмент и команду запуска. Для реакции после успешного выполнения инструмента используют событие PostToolUse.
- Выберите область проекта, чтобы настройка относилась к этому сайту или приложению.
- Добавьте хук на событие PostToolUse.
- Задайте фильтр Write|Edit для инструментов записи и редактирования файлов.
- Укажите команду проверки, которую уже успешно запустили вручную.
- Сохраните настройку и попросите Claude Code внести безопасную правку в тестовой ветке.
Фильтр Write|Edit охватывает вызовы этих инструментов. Если Claude Code меняет файл через команду терминала, такой запуск под него не попадёт. Поэтому после настройки проверьте, каким способом агент редактирует ваш проект. Обещать проверку после любой правки при одном таком фильтре нельзя.
Для первого подключения выберите одну короткую команду. Если она запускает сразу несколько проверок, настройте остановку при первой ошибке или сохранение общего неуспешного результата. Иначе последняя успешная команда скроет сбой предыдущей.
Проектные настройки обычно находятся в .claude/settings.json. Перед сохранением посмотрите, какие хуки там уже есть: новая настройка не должна затереть существующую. Команду хука тоже стоит прочитать вручную, ведь она выполняется с правами вашего пользователя.
Как убедиться, что хук действительно находит ошибки?
Проверьте настройку на намеренно неверной правке в отдельной тестовой ветке. Например, измените ожидаемое значение в тесте, чтобы проверка гарантированно завершилась ошибкой. Затем верните правильное значение. Боевой сайт для этой проверки не нужен.
Проследите всю цепочку: Claude Code изменил файл, хук запустил нужную команду, команда обнаружила ошибку, агент получил её вывод. После исправления проверка должна пройти снова. Именно этот повторный запуск показывает, что цикл работает.
Сообщение о запуске хука ещё не означает, что тесты прошли. Смотрите на итог команды и её код завершения: при ошибке он должен быть ненулевым. Если вспомогательный скрипт печатает ошибку, но сообщает системе об успехе, автоматизация даст ложный зелёный результат.
Разделяйте обнаружение ошибки и запрет дальнейших действий. Хук после правки помогает получить обратную связь, но сам по себе не доказывает, что коммит или публикация сайта заблокированы. Если нужен такой запрет, его отдельно настраивают и проверяют попыткой выполнить действие при сломанном тесте.
Рабочий результат можно показать без технической презентации: неверная правка вызывает ошибку, исправление возвращает успешную проверку. Сохраните этот короткий сценарий рядом с инструкцией по запуску проекта.
Как связать хуки с приёмкой сайта после вайбкодинга?
В задаче разработчику опишите ожидаемое поведение, а затем попросите подобрать проверку. Например: «После изменения формы заявка отправляется, а при пустом обязательном поле пользователь видит подсказку». Так проще проверить, что автоматический тест отвечает на вопрос бизнеса.
Отдельно проверьте доступ к функциям. Успешная сборка сайта не подтверждает, что пользователь не откроет чужой раздел. Для этого пригодится проверка прав доступа после вайбкодинга с Claude Code: её сценарии можно включить в приёмку наряду с проверкой формы.
Попросите передать вместе с проектом команду ручного запуска, описание событий хука и инструкцию на случай ошибки. Проверки должны работать и без текущего диалога с ИИ. Если агент теряет задачу после длинной сессии, порядок восстановления можно закрепить по инструкции о том, как продолжить работу в Claude Code после сброса контекста.
Настройку проверок удобно выделить в отдельную задачу по доработке проекта. Её результат — файлы настроек и воспроизводимый сценарий: проверяющий запускает команду, видит ошибку на неверной правке и успех после исправления. Такой результат можно принять независимо от того, кто писал исходный код.
Когда базовый цикл работает, переходите к сокращению лишних запусков. Например, в описании claude-harness есть механизм, который не повторяет тесты перед коммитом, если те же изменения уже прошли проверку на предусмотренном этапе. Переносить такой подход в свой проект стоит только после проверки правил: результат должен относиться к текущим изменениям, включая тесты и настройки (источник: SALUTme/claude-harness).
Типичные ошибки при настройке хуков Claude Code
- Подключать команду без ручного запуска. Сначала проверьте её из папки проекта и убедитесь, что она находит тесты.
- Считать Write|Edit контролем всех изменений. Отдельно проверьте правки через терминал и другие инструменты.
- Запускать полный браузерный тест после каждого сохранения. Оставьте частому хуку короткую проверку, а полный сценарий запускайте на отдельном этапе.
- Разрешать агенту менять тесты ради успешного результата. Просматривайте изменения проверок отдельно и сверяйте их с исходным требованием.
- Принимать успешный хук за готовность к публикации. Перед выпуском проверьте основной пользовательский сценарий на тестовой версии сайта.
Начните сейчас: за одну минуту отправьте разработчику сообщение «Какая команда проверяет наш проект и что именно она проверяет?». Ответ станет отправной точкой для настройки первого хука.
