Хуки Claude Code позволяют запускать детерминированные shell-команды на каждом ключевом событии жизненного цикла Claude Code: перед использованием инструмента, после использования инструмента, при отправке промпта, при остановке агента или при отправке уведомления. AgentsRoom — это визуальный центр управления, который позволяет вам наблюдать за срабатыванием каждого хука в реальном времени, по десяткам агентов Claude Code, в десятках проектов.
Хуки — это официальный способ Anthropic добавить детерминированную автоматизацию, защитные ограничения, журналы аудита и пользовательские побочные эффекты в Claude Code. AgentsRoom не заменяет ваши хуки. Он запускает настоящий Claude Code CLI, поэтому каждый хук, настроенный в .claude/settings.json, продолжает работать именно так, как задумано. AgentsRoom добавляет видимость: живую панель управления, где вы можете видеть срабатывание каждого хука, по каждому агенту, по каждому проекту, по каждому запуску.
Хуки Claude Code — это пользовательские shell-команды, которые Claude Code автоматически выполняет в определённые моменты сессии агента. Они настраиваются в .claude/settings.json (общие, закоммиченные в git) или .claude/settings.local.json (личные, в gitignore), и дают вам детерминированный контроль над поведением ваших агентов Claude Code. Если промпт вероятностный, то хук детерминирован на 100%: он запускается каждый раз, когда срабатывает соответствующее событие, без исключений.
Хуки — это ответ Anthropic на потребность в защитных ограничениях, автоматизации, телеметрии, журналах аудита и пользовательских интеграциях. Вы можете использовать хуки Claude Code для автоматического форматирования кода после каждого редактирования, блокировки опасных команд перед их запуском, записи каждого вызова инструмента в файл, отправки настольного уведомления, когда агент ожидает ввод, запуска CI-задачи при завершении сессии или трансляции каждого промпта в бэкенд наблюдаемости. Любую shell-команду, которую вы можете написать, можно подключить к хуку Claude Code.
Поскольку хуки живут в самом проекте (.claude/settings.json закоммичен в git), они путешествуют с вашей кодовой базой. Каждый разработчик в команде и каждый AI-агент, порождённый из этого проекта, наследует одну и ту же сеть безопасности. AgentsRoom уважает эту модель от начала до конца: настольное приложение не переписывает ваши хуки, оно запускает настоящий Claude Code CLI как дочерний процесс, который автоматически подхватывает вашу конфигурацию хуков — точно так же, как если бы вы запустили claude code из терминала.
Каждая сессия агента Claude Code запускает события хуков в чётко определённых точках. Вот что означает каждое событие и что с ним можно делать.
Хук PreToolUse срабатывает перед тем, как Claude Code запустит любой инструмент (Bash, Edit, Write, Read, Grep и т. д.). Это идеальное место для защитных ограничений: блокируйте опасные команды, требуйте подтверждения для деструктивных операций, применяйте правила, специфичные для проекта, или переписывайте аргументы инструментов перед выполнением. Верните ненулевой код выхода из хука, чтобы полностью заблокировать вызов инструмента. PreToolUse — это хук Claude Code номер один для команд, заботящихся о безопасности.
Хук PostToolUse срабатывает сразу после завершения любого инструмента Claude Code. Здесь вы подключаете автоматическую постобработку: запускайте форматтер (Prettier, Black, rustfmt) после каждого Edit, запускайте линтер после каждого Write, обновляйте changelog при изменении файла или отправляйте события телеметрии. PostToolUse — это хлеб-с-маслом хук для превращения Claude Code в дисциплинированного члена команды, который оставляет кодовую базу чище, чем нашёл.
Хук UserPromptSubmit срабатывает каждый раз, когда новый промпт отправляется агенту Claude Code. Используйте его для записи каждого промпта для аудита и соответствия, переписывания промптов на лету (инъекция контекста, редактирование секретов), маршрутизации запросов к разным моделям или применения соглашений об именовании. В сочетании с многоагентной панелью AgentsRoom, UserPromptSubmit даёт вам полный аудит-след каждой инструкции, отправленной каждому агенту Claude Code.
Хук Stop срабатывает, когда сессия агента Claude Code заканчивается — либо потому, что работа выполнена, либо потому, что она была отменена. Это правильное место для запуска задач очистки, отправки финального резюме в систему отслеживания, коммита артефактов или уведомления человека о завершении сессии. AgentsRoom дополняет хук Stop собственной системой уведомлений, поэтому вы получаете уведомления как от вашего пользовательского хука, так и от настольных + мобильных push-уведомлений AgentsRoom.
Хук Notification срабатывает, когда Claude Code отправляет системное уведомление — обычно когда агент ожидает ввода пользователя или завершил долговременную задачу. Используйте его для маршрутизации уведомлений в Slack, Discord, Telegram, почту или любой webhook на ваш вкус. AgentsRoom уже нативно показывает уведомления Claude Code в своей многоагентной панели и как push-уведомления на телефоне, поэтому хук Notification — идеальное место для добавления пользовательских интеграций поверх.
Хук SubagentStop срабатывает, когда субагент Claude Code завершает свою работу и возвращает управление родителю. Если вы используете субагенты Claude Code, определённые в .claude/agents/*.md, для делегирования специализированных задач, SubagentStop позволяет вам записывать, что сделал каждый субагент, агрегировать их вывод или запускать последующий шаг. Внутри AgentsRoom события SubagentStop появляются в живой временной шкале агента, чтобы вы могли видеть точно, какие субагенты запускались внутри каждой сессии Claude Code.
Хуки превращают Claude Code из впечатляющего ИИ в production-уровень агента для кодинга, на которого может положиться вся ваша команда.
Промпты вероятностны и могут быть обойдены. Хуки Claude Code — это детерминированные shell-команды, которые всегда запускаются. Хук PreToolUse может заблокировать любой rm -rf, любой push --force, любую деструктивную миграцию — независимо от того, как агент формулирует свои рассуждения. Это золотой стандарт для критичных с точки зрения безопасности развёртываний Claude Code.
Подключите хуки Claude Code к вашим форматтерам, линтерам, тест-раннерам, проверкам типов и скриптам сборки. Каждое редактирование, которое делает агент, запускает те же проверки, что и ваш CI-пайплайн — локально, мгновенно, автоматически. Ваши агенты Claude Code становятся самодисциплинированными контрибьюторами, которые никогда не забывают запустить форматтер.
Каждый промпт, каждый вызов инструмента, каждое начало и остановка сессии могут быть записаны хуками Claude Code. Совместите это с визуальной временной шкалой AgentsRoom и вы получите полный аудит-след каждого действия AI-агента для кодинга — необходимо для команд с высокими требованиями к соответствию, компаний, заботящихся о безопасности, и всех, кто серьёзно относится к наблюдаемой AI-разработке.
Поскольку .claude/settings.json закоммичен в git, один набор хуков Claude Code применяет одни и те же соглашения для каждого разработчика в команде и каждого AI-агента, порождённого из проекта. Новые члены команды наследуют защитные ограничения в момент клонирования репозитория. Обновите поведение всей вашей AI-команды одним pull request'ом.
Хуки Claude Code производят события. AgentsRoom превращает эти события в визуальную ленту: каждое срабатывание хука, каждый вызов инструмента, каждое изменение статуса, транслируемое в реальном времени по каждому агенту и каждому проекту. Вам больше не нужно делать tail логов — вы наблюдаете, как ваш флот Claude Code работает в реальном времени.
Без хуков запуск Claude Code означает наблюдение за каждым вызовом инструмента. С хуками вы делегируете наблюдение детерминированному коду и контролируете на уровне исключений. AgentsRoom усиливает это: вы видите всех ваших защищённых хуками агентов Claude Code одновременно, и вмешиваетесь только тогда, когда что-то требует вашего внимания.
AgentsRoom — это визуальный центр управления для Claude Code и других CLI для AI-кодинга. Он не форкает Claude Code, не переопределяет хуки, не перехватывает вызовы инструментов. Он запускает настоящий Claude Code CLI как дочерний процесс внутри полноценного xterm.js терминала, что означает, что каждый хук, который вы определили в .claude/settings.json или .claude/settings.local.json, работает именно так, как его спроектировал Anthropic — без компромиссов, без сюрпризов, без невидимого промежуточного слоя.
AgentsRoom добавляет масштаб и видимость. Вы можете запускать десятки агентов Claude Code параллельно, в десятках проектов, каждый со своей конфигурацией хуков, и видеть срабатывание каждого хука на одной панели управления. В сочетании с уведомлениями AgentsRoom по каждому агенту, мобильным компаньоном и отслеживанием статуса в реальном времени, хуки Claude Code становятся слоем наблюдаемости первого класса для всей вашей операции по AI-кодингу.
AgentsRoom порождает реальные процессы claude CLI внутри полноценных xterm.js терминалов. Любой хук, настроенный в .claude/settings.json, .claude/settings.local.json или в пользовательских настройках, срабатывает автоматически — точно так же, как если бы вы запустили Claude Code из вашего терминала. Без патчинга, без переписывания, без потери точности.
Запускайте 10, 20, 50 агентов Claude Code параллельно с включёнными хуками. Многоагентная панель AgentsRoom выводит уведомления, вызванные хуками, и изменения статуса для каждого агента одновременно. Ваши защитные ограничения PreToolUse, форматтеры PostToolUse и обработчики Stop — все работают в масштабе флота.
Каждый проект в AgentsRoom имеет свой собственный .claude/settings.json и, следовательно, свою собственную конфигурацию хуков Claude Code. Боковая панель агрегирует живой статус по проектам, чтобы вы могли видеть, какие хуки срабатывают где, какие агенты заблокированы на вводе пользователя и какие хуки Stop только что завершили запуск.
AgentsRoom поставляется с нативными уведомлениями macOS и сквозным шифрованием мобильных push-уведомлений. Хук Notification, хук Stop и хук SubagentStop Claude Code — все производят сигналы, которые AgentsRoom выводит непосредственно на ваш десктоп и телефон. Вы можете отойти от компьютера и всё равно знать, когда хук говорит вам вернуться.
Скачайте AgentsRoom, откройте проект с хуками в .claude/settings.json, запустите агента Claude Code и наблюдайте, как каждое событие хука транслируется на панель управления в реальном времени.
Приложение-компаньон: следите за агентами на ходу
Работает с Claude, Codex, OpenCode, Gemini CLI и Aider