Руководство
Хуки Claude Code: что это такое и что с ними можно сделать
Коротко: Хуки позволяют Claude Code запускать вашу команду, когда стартует инструмент, запрашивается разрешение или заканчивается ход. Как они работают и как их использует Herdbell.
Хук — это небольшая команда, которую агент запускает в определённый момент. Claude Code, Codex и Cursor поддерживают их в том или ином виде, и это чистый способ для другой программы следить за действиями агента без входа в какие-либо аккаунты и без считывания экрана.
Идея в одном абзаце
Вы говорите агенту: когда случится это, запусти эту команду. Агент запускает её и передаёт ей краткое описание события. Команда может просто записать его (например, чтобы отправить уведомление) или, для некоторых событий, вернуть ответ, который агент использует.
Моменты, к которым можно подключить хук
Точные названия событий и настройки различаются у разных агентов и версий, поэтому перед тем как писать свой скрипт, загляните в документацию каждого агента.
- Сессия начинается или заканчивается, или вы отправляете запрос.
- Инструмент вот-вот запустится или только что отработал.
- Агент просит разрешение что-то сделать.
- Агент завершает ход (событие Stop).
Где они находятся
В файле настроек: для Claude Code это ~/.claude/settings.json, для Codex — ~/.codex/hooks.json, для Cursor — ~/.cursor/hooks.json. Править эти файлы вручную можно, и именно так подключаются такие инструменты, как Herdbell.
Как их использует Herdbell
- При подключении Herdbell делает резервную копию файла, а затем добавляет собственную небольшую команду для нужных ему событий.
- Для большинства событий он только слушает, чтобы показывать, чем занят агент.
- На запрос разрешения он ждёт вашего ответа и возвращает его, так что Allow и Deny вступают в силу. По окончании хода он может удержать агента открытым, чтобы ваш ответ попал в тот же чат.
- Если вы не ответите вовремя, он отпускает агента, и тот возвращается к собственному запросу. Отключение удаляет только хуки Herdbell.
Частые вопросы
Нужны ли хукам API-ключ или вход в аккаунт?
Нет. Хук — это локальная команда на вашем Mac. Herdbell использует их, чтобы ему не приходилось входить в аккаунт агента или обращаться к ИИ-модели.
Может ли хук сломать моего агента?
Плохо написанный хук может замедлить агента или сбить его с толку, поэтому Herdbell сначала делает резервную копию ваших настроек, держит свои хуки маленькими и отпускает агента, если вы не отвечаете. Отключить его можно в любой момент.