Хуки Claude Code:автоматизация рутины

Ты наверняка ловил это: просишь Claude «всегда форматируй код после правок» — и через десять сообщений он про это забывает. Инструкции в промте — это просьба, а не гарантия: модель может их проигнорировать, особенно в длинной сессии. Хуки решают проблему в корне. Это твои команды, которые Claude Code запускает сам в нужный момент, и они срабатывают всегда, независимо от внимания модели.

Часть 1 · Понятие

Что такое хуки

Слово «хук» (от английского hook — «зацепка») значит точку, к которой можно «прицепить» своё действие. В Claude Code такими точками служат события: агент собирается вызвать инструмент, агент правит файл, ты отправил промт, сессия закончилась. На каждое из этих событий можно повесить команду — обычную команду терминала, которую система запустит сама.

Инструкция в промте — это просьба. Хук — это гарантия.

В этом ключевое отличие. Когда ты пишешь в промте «форматируй код», Claude может это сделать, а может забыть. Хук PostToolUse, который запускает форматтер после каждой правки файла, сработает всегда — он не зависит от того, помнит модель про правило или нет.

Часть 2 · Смысл

Зачем нужны хуки

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

1. Автоформат. После каждой правки файла прогоняется форматтер (Prettier, Black и любой другой) — код всегда причёсан, без напоминаний.
2. Линт и проверки. После правок запускается линтер или типизация — ошибки ловятся сразу, а не на коммите.
3. Защита от опасных команд. Перед вызовом инструмента хук проверяет команду и блокирует то, чего ты боишься (например, rm -rf).

Общая идея: всё, что должно происходить всегда и независимо от модели, выноси в хуки. Так ты перестаёшь полагаться на память Claude и получаешь стабильное поведение проекта. Это разгружает и контекст — не нужно держать в нём инструкции про формат и линт.

Часть 3 · События

Какие события бывают

Хук привязывается к событию. Вот основные точки, к которым можно прицепиться:

На практике 90% хуков висят на двух событиях: PostToolUse (что сделать после правки — формат, линт) и PreToolUse (что проверить до действия — защита). Остальные нужны под более тонкие сценарии вроде загрузки контекста при старте сессии.

Часть 4 · Настройка

Как настроить хук

Вот рабочий хук, который запускает Prettier после каждой правки файла. Разберём по частям:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Читается так: на событие PostToolUse (после действия), если инструмент — Edit или Write (правка файла), запусти команду. Команда здесь берёт путь к файлу из данных события (через jq) и прогоняет по нему Prettier. matcher — это фильтр: "Edit|Write" значит «реагируй только на эти инструменты, на остальные не трогай».

Часть 5 · Примеры

Полезные хуки на копипаст

Кроме автоформата выше, два частых хука: линт после правок и защита от опасных действий.

Линт после каждой правки

Тот же PostToolUse, но вместо форматтера — твой скрипт проверки:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "/path/to/lint-check.sh"
          }
        ]
      }
    ]
  }
}

Защита от опасных команд

Для запретов есть два пути. Простой — список deny в правах доступа: Claude просто не сможет выполнить команду из чёрного списка.

{
  "permissions": {
    "allow": [
      "Bash(npm test *)",
      "Bash(npm run *)"
    ],
    "deny": [
      "Bash(rm -rf *)"
    ]
  }
}

Более гибкий путь — хук на событие PreToolUse: он срабатывает перед вызовом инструмента и может проверить команду своим скриптом. Если скрипт завершится с кодом 2, действие блокируется — Claude не выполнит то, что ты запретил. Это полезно для сложных проверок, которые не выразить простым списком.

Часть 6 · Граница

Когда хук — перебор

Вопросы

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

Читать дальше

Соседние гайды