Хуки в Claude Code. Команда, яка виконується завжди, а не тоді, коли Claude пам'ятає

Що таке хук у Claude Code, до яких подій його можна прив'язати і де його зберегти. Два готові приклади, форматування після редагування і блокування змін у файлі .env.

Частина посібникаClaude Code, повний посібник. Від встановлення до власних скілів і плагінів

У цьому тексті
  1. Що таке хук у Claude Code
  2. Події, до яких можна прив'язати хук
  3. Де зберегти хук
  4. Приклад 1. Форматування після кожного редагування
  5. Приклад 2. Блокування змін у .env
  6. Команда /hooks і безпека

Коротко

Хук у 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 має бути встановлений.

.claude/settings.json
{
  "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.

bash
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, тому йому не потрібне право на виконання.

.claude/settings.json
{
  "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.

Що хочете змінити у своїй фірмі?

Залиште номер. Поговоримо про ваш процес і перевіримо, чи можемо допомогти. Перша розмова безкоштовна.

Коли зручно зателефонувати?
Адміністратор: Oleksandr Bondarenko (BondSoft)Політика конфіденційностіРегламент
Юридичні деталі

Адміністратором даних є Oleksandr Bondarenko, що веде господарську діяльність під фірмою Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Дані обробляємо виключно з метою контакту у справі вашого запиту та надання пропозиції — на підставі вашої згоди (ст. 6 ч. 1 п. a RODO та ст. 398 закону Prawo komunikacji elektronicznej) і нашого правомірного інтересу, що полягає в опрацюванні запиту (ст. 6 ч. 1 п. f RODO).

Надання даних добровільне, але необхідне для зворотного контакту. Згоду можете відкликати будь-коли, написавши на office@bondsoft.pl — це не впливає на законність обробки до відкликання.

Ви маєте право на доступ до даних, їх виправлення, видалення, обмеження обробки, перенесення, а також на скаргу до Голови Управління охорони персональних даних.

Повна інформація: Політика конфіденційності.

Напишіть на пошту

Послуга, про яку цей текст

Автоматизація та AI / OCR

Автоматизація переписування документів, OCR і правила перевірки, а дані лишаються у вас.