Хуки (Hooks)

Определение

Хуки — shell-команды или скрипты, привязанные к событиям жизненного цикла Claude Code: до запуска инструмента, после сохранения файла, при завершении сессии. Ключевое отличие от инструкций в промпте: хуки исполняются гарантированно. LLM может проигнорировать правило из CLAUDE.md, посчитав его необязательным — хук проигнорировать нельзя.

Это позволяет добавлять к вероятностному поведению агента детерминированные точки контроля.

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

Хуки настраиваются в .claude/settings.json:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "write_to_file",
        "command": "npx eslint --fix $FILE"
      }
    ],
    "PostSession": [
      {
        "command": "gh issue comment $ISSUE --body 'Session complete: $SUMMARY'"
      }
    ]
  }
}

Примеры рабочих хуков

Фиксация прогресса в GitHub Issues

{
  "hooks": {
    "PostSession": [
      {
        "command": "gh issue comment $CURRENT_ISSUE --body \"Итоги сессии: $SESSION_SUMMARY\""
      }
    ]
  }
}

Решает проблему потери контекста между сессиями — не нужно помнить писать заметки, хук делает это автоматически.

Линтер после каждого изменения

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "write_to_file",
        "command": "npx eslint --fix $FILE"
      }
    ]
  }
}

Проверка безопасности перед коммитом

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "git_commit",
        "command": "git diff --staged | grep -qE '(API_KEY|SECRET|PASSWORD)' && exit 1 || exit 0"
      }
    ]
  }
}

CLAUDE.md vs Hooks

Правило: то, что должно выполняться всегда — в хуки. То, что может быть гибким — в CLAUDE.md.

В курсе

Ссылки

• Automate workflows with hooks — Anthropic
• Claude Code Hooks Mastery — YUV.AI

Связанное

• CLAUDE.md — вероятностные правила (хуки — детерминированные)
• Claude Code — платформа, где работают хуки
• Skills — переиспользуемые промпты (хуки — переиспользуемые команды)
• Compact — хуки решают проблему потери контекста при compact