## Что это

Хук — это действие, которое WorkAI выполняет автоматически, когда в сессии происходит определённое событие: началась сессия, агент собирается вызвать инструмент, контекст сжимается. Вместо того чтобы каждый раз реагировать на такой момент вручную, вы один раз привязываете к нему действие — и дальше оно срабатывает само.

## События

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

| Событие | Когда срабатывает |
|---|---|
| `SessionStart` | Сессия чата началась |
| `SessionEnd` | Сессия чата завершилась |
| `UserPromptSubmit` | Вы отправили сообщение агенту |
| `PreToolUse` | Перед тем как агент вызовет инструмент |
| `PostToolUse` | После того как инструмент отработал |
| `PreCompact` | Перед сжатием контекста (см. [Compaction](/docs/agent/compaction)) |
| `SubagentStart` | Запустился субагент |
| `SubagentStop` | Субагент завершил работу |
| `Stop` | Агент закончил ход и вернул ответ |
| `ErrorOccurred` | Во время работы агента произошла ошибка |

## Что можно делать

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

## Как настроить

Команда `/hooks` в чате открывает диалог настройки: он спрашивает, на какое событие реагировать и какую команду выполнить, и сохраняет результат в конфигурационный файл. Тот же мастер доступен из настроек WorkAI — пункт **Хуки** в списке разделов (он не открывает свой экран, а сразу вызывает этот диалог).

## Где хранится конфиг

| Путь | Область действия |
|---|---|
| `.github/hooks` | Проект |
| `.claude/settings.local.json` | Проект, локальный файл (не для git) |
| `.claude/settings.json` | Проект |
| `~/.copilot/hooks` | Все проекты текущего пользователя |
| `~/.claude/settings.json` | Все проекты текущего пользователя |

## Дальше

- Как WorkAI сжимает контекст и на каком событии срабатывает `PreCompact` — [/docs/agent/compaction](/docs/agent/compaction)
- Делегирование работы субагентам, чьи старт и завершение тоже видны хукам — [/docs/subagents](/docs/subagents)
- Где ещё в настройках лежат смежные разделы — [/docs/configuration/settings](/docs/configuration/settings)