Hooks: Создайте свой рабочий процесс

Что такое Claude Code Hooks?

Hooks — система событий Claude Code, позволяющая запускать пользовательские скрипты до и после вызова инструментов. Автоматический запуск линтеров, выполнение тестов, оповещения при доступе к конфиденциальным файлам — всё без ручного вмешательства.

Настройка состоит из трёх уровней: событие, фильтр matcher для инструментов и ваш скрипт во внутреннем массиве hooks. Скрипт читает JSON события из stdin и отвечает кодом выхода: 0 — нет возражений, 2 блокирует вызов там, где это разрешено. Ниже четыре частых события, а не весь список из справки; для них хук command отменяется по умолчанию через 600 секунд (проверено 2026-09-22).

Три практичных сценария автоматизации

Все три примера ниже построены одинаково: выбираете событие, сужаете его фильтром matcher и помещаете скрипт во внутренний массив hooks. Фрагменты показывают только замысел, а поля и вложенность берите из официальной справки; нужные для проверки данные приходят в JSON на stdin.

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "command": "if echo \"$TOOL_INPUT\" | grep -q 'git commit'; then npm run format; fi"
    }]
  }
}

{
  "hooks": {
    "PostToolUse": [{
      "matcher": "Bash",
      "command": "if echo \"$TOOL_INPUT\" | grep -q 'pytest\\|npm test'; then notify-send 'Tests completed'; fi"
    }]
  }
}

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Edit|Write",
      "command": "if echo \"$TOOL_INPUT\" | grep -qE '\\.env|credentials|secrets'; then exit 2; fi"
    }]
  }
}

Пример настройки settings.json

Определите хуки в .claude/settings.json

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "~/scripts/pre-bash-hook.sh"
      },
      {
        "matcher": "Edit|Write",
        "command": "~/scripts/protect-sensitive-files.sh"
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Bash",
        "command": "~/scripts/post-bash-hook.sh"
      }
    ],
    "Notification": [
      {
        "command": "~/scripts/send-notification.sh"
      }
    ],
    "Stop": [
      {
        "command": "~/scripts/on-stop.sh"
      }
    ]
  }
}

Частые вопросы