Хуки в Claude Code. Команда, яка виконується завжди, а не тоді, коли Claude пам'ятає
Що таке хук у Claude Code, до яких подій його можна прив'язати і де його зберегти. Два готові приклади, форматування після редагування і блокування змін у файлі .env.
Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів
У цьому тексті
Коротко
Хук у Claude Code це команда, яку Claude Code сам запускає на вибрану подію, наприклад після кожного редагування файлу або перед виконанням команди. Його зберігають у файлі settings.json, а команда /hooks показує всі налаштовані хуки. Нижче два готові приклади, форматування коду після редагування і блокування змін у файлі .env.
У CLAUDE.md написано, що після кожної зміни треба запускати Prettier. Claude зазвичай так і робить. Іноді в довгій сесії забуває, і в репозиторій потрапляє файл з іншим форматуванням. Такі речі переносять з CLAUDE.md у хук.
Хук у Claude Code це команда, яку Claude Code запускає сам у певний момент роботи. Модель про це не вирішує, тому команда виконується щоразу. Документація Anthropic називає це детермінованим контролем. Сторінка входить до путівника по Claude Code, станом на 10 листопада 2026.
Що таке хук у Claude Code
Найчастіше хук це звичайна команда оболонки, тип command. Claude Code передає їй на вхід JSON з описом події, наприклад шлях до зміненого файлу. Хук відповідає кодом виходу. Код 0 означає, що заперечень нема. Код 2 блокує дію, а текст, виведений у stderr, повертається до Claude як пояснення.
Є ще чотири типи. http надсилає дані події на URL, mcp_tool викликає інструмент із сервера MCP, prompt просить модель Claude про одне рішення, а agent запускає перевірку з доступом до інструментів. Тип agent Anthropic позначає як експериментальний.
Різниця між хуком і CLAUDE.md проста. CLAUDE.md це прохання, яке модель читає і зазвичай виконує. Хук це механізм, який працює незалежно від того, що вирішить модель.
Події, до яких можна прив'язати хук
Документація сьогодні описує 33 події. Щодня знадобиться кілька з них.
| Подія | Коли спрацьовує |
|---|---|
SessionStart | На початку сесії і під час її відновлення |
UserPromptSubmit | Після надсилання запиту, до того як Claude його прочитає |
PreToolUse | Перед використанням інструмента, може його заблокувати |
PermissionRequest | Коли інструмент потребує дозволу |
PostToolUse | Після успішного використання інструмента |
Notification | Коли Claude Code надсилає сповіщення |
Stop | Коли Claude закінчує відповідь |
PreCompact | Перед стисненням розмови |
FileChanged | Коли відстежуваний файл змінюється на диску |
SessionEnd | Наприкінці сесії |
Поле matcher звужує хук до вибраних інструментів. Edit|Write означає, що хук спрацює лише під час редагування і запису файлів. Регістр літер має значення.
Де зберегти хук
Хуки лежать у блоці hooks у файлі налаштувань. Від файлу залежить, кого вони стосуються.
| Файл | Діє | У репозиторії |
|---|---|---|
~/.claude/settings.json | Усі ваші проєкти | Ні |
.claude/settings.json | Один проєкт | Так |
.claude/settings.local.json | Один проєкт, лише ви | Ні |
| Керовані налаштування | Уся організація | Ставить адміністратор |
Хуки також можуть прийти з плагіном, скілом або субагентом. Якщо ви редагуєте файл налаштувань під час сесії, Claude Code зазвичай сам помічає зміну.
Приклад 1. Форматування після кожного редагування
Цей хук запускає Prettier на кожному файлі, який змінив Claude. Подія PostToolUse з matcher Edit|Write спрацьовує після редагування і запису. Команда дістає шлях до файлу через jq, тож jq має бути встановлений.
{
"hooks": {
"PostToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
}
]
}
]
}
}Коли хук спрацював правильно, у розмові нічого не з'являється. Щоб перевірити, попросіть Claude дописати рядок з одинарними лапками у файл JavaScript. З типовими налаштуваннями Prettier замінить їх на подвійні.
Приклад 2. Блокування змін у .env
Цей хук не дає Claude змінювати .env, package-lock.json і будь-що в .git/. Скрипт перевіряє шлях і завершується кодом 2, якщо той збігається зі списком. Збережіть його як .claude/hooks/protect-files.sh.
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
PROTECTED_PATTERNS=(".env" "package-lock.json" ".git/")
for pattern in "${PROTECTED_PATTERNS[@]}"
do
if [[ "$FILE_PATH" == *"$pattern"* ]]
then
echo "Заблоковано, $FILE_PATH збігається з шаблоном $pattern" >&2
exit 2
fi
done
exit 0Потім реєструєте його як PreToolUse для редагування і запису. Скрипт запускаємо через bash, тому йому не потрібне право на виконання.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "bash \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
}
]
}
]
}
}Попросіть Claude дописати коментар у .env. Редагування буде відхилене ще до виконання, а Claude отримає повідомлення зі скрипта і шукатиме інший шлях. За документацією, відмова з хука PreToolUse діє в будь-якому режимі дозволів, навіть у bypassPermissions. Код 0 нічого не схвалює, тоді вирішують звичайні правила дозволів.
Команда /hooks і безпека
Введіть /hooks у Claude Code. Відкриється список хуків, згрупований за подіями, з інформацією, з якого файлу кожен з них. Список лише для перегляду. Змінюють і видаляють хук у файлі налаштувань. Усі одразу вимикає "disableAllHooks": true.
Хук можна попросити й словами. Напишіть Claude, що він має робити, наприклад блокувати редагування папки migrations, а потім перевірте результат у /hooks.
Дві речі з розділу про безпеку варто знати. Хук типу command працює з повними правами вашого облікового запису, тож може читати й видаляти все, до чого ви маєте доступ. У звичайній сесії Claude Code не запускає хуків, доки ви не підтвердите довіру до папки. У режимі claude -p такого питання нема, і хуки з чужого репозиторію виконаються одразу. Про цей режим ми пишемо в тексті про Claude Code у скриптах і CI.
Добре почати з одного хука, який захищає файли з доступами, а форматування додати пізніше. Якщо хочете знати, де у вашій фірмі AI може взяти на себе повторювану роботу, замовте безкоштовний аудит AI.
Що хочете змінити у своїй фірмі?
Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.
Послуга, про яку цей текст
Автоматизація та AI / OCRАвтоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.