Claude Code Hooks

Claude Code Hooks, візуалізовані.

Хуки Claude Code дозволяють запускати детерміновані shell-команди на кожну ключову подію в життєвому циклі Claude Code: перед використанням інструменту, після використання інструменту, коли подається запит, коли агент зупиняється або коли надсилається сповіщення. AgentsRoom є візуальним командним центром, який дозволяє спостерігати за кожним спрацьовуванням хука в реальному часі через десятки агентів Claude Code у десятках проєктів.

Хуки є офіційним способом Anthropic для додавання детермінованої автоматизації, захисних механізмів, аудиторських слідів та користувацьких побічних ефектів до Claude Code. AgentsRoom не замінює ваші хуки. Він запускає реальний Claude Code CLI, тому кожен хук, який ви налаштували в .claude/settings.json, працює точно так, як задумано. Те, що додає AgentsRoom, - це видимість: жива панель, де ви можете бачити кожен тригер хука, по агенту, по проєкту, по запуску.

Що таке хуки Claude Code?

Хуки Claude Code - це визначені користувачем shell-команди, які Claude Code автоматично виконує в певні моменти під час сесії агента. Вони налаштовуються в .claude/settings.json (спільний, комітиться в git) або .claude/settings.local.json (особистий, ігнорується git), і вони дають вам детермінований контроль над поведінкою ваших агентів Claude Code. Де запит є ймовірнісним, хук є на 100% детермінованим: він запускається кожного разу, коли спрацьовує відповідна подія, без винятків.

Хуки є відповіддю Anthropic на потребу в захисних механізмах, автоматизації, телеметрії, аудиторському логуванні та користувацьких інтеграціях. Ви можете використовувати хуки Claude Code для автоматичного форматування коду після кожного редагування, блокування небезпечних команд перед їх виконанням, логування кожного виклику інструменту у файл, надсилання сповіщення на робочий стіл, коли агент чекає на введення, запуску CI-завдання, коли сесія закінчується, або потокового передавання кожного запиту в бекенд спостереження. Будь-яку shell-команду, яку ви можете написати, ви можете підключити до хука Claude Code.

Оскільки хуки знаходяться в самому проєкті (.claude/settings.json комітиться в git), вони подорожують разом з вашим кодом. Кожен розробник у команді та кожен AI-агент, створений з цього проєкту, успадковує ту саму захисну сітку. AgentsRoom поважає цю модель від початку до кінця: настільний додаток не переписує ваші хуки, він запускає реальний Claude Code CLI як дочірній процес, який автоматично підхоплює вашу конфігурацію хука, так само, як якщо б ви запускали claude code з терміналу.

6 подій хука Claude Code

Кожна сесія агента Claude Code викликає події хука в чітко визначених точках. Ось що означає кожна подія і що ви можете з нею зробити.

PreToolUse

Хук PreToolUse спрацьовує перед тим, як Claude Code запускає будь-який інструмент (Bash, Edit, Write, Read, Grep тощо). Це ідеальне місце для захисних механізмів: блокування небезпечних команд, вимагання підтвердження для руйнівних операцій, дотримання специфічних для проєкту правил або переписування аргументів інструменту перед виконанням. Поверніть ненульовий код виходу з хука, щоб повністю заблокувати виклик інструменту. PreToolUse - це хук Claude Code №1 для команд, які дбають про безпеку.

PostToolUse

Хук PostToolUse спрацьовує відразу після завершення будь-якого інструменту Claude Code. Тут ви можете налаштувати автоматичну пост-обробку: запускати форматер (Prettier, Black, rustfmt) після кожного редагування, запускати лінтер після кожного запису, оновлювати changelog, коли файл змінено, або відправляти події телеметрії. PostToolUse - це основний хук для перетворення Claude Code на дисциплінованого члена команди, який залишає кодову базу чистішою, ніж вона була.

UserPromptSubmit

Хук UserPromptSubmit спрацьовує щоразу, коли новий запит надсилається агенту Claude Code. Використовуйте його для логування кожного запиту для аудиту та відповідності, переписування запитів на льоту (вставка контексту, редагування секретів), маршрутизації запитів до різних моделей або дотримання конвенцій іменування. У поєднанні з багатозадачною панеллю AgentsRoom, UserPromptSubmit надає вам повний аудиторський слід кожної інструкції, надісланої кожному агенту Claude Code.

Stop

Хук Stop спрацьовує, коли сесія агента Claude Code закінчується, або тому, що робота завершена, або тому, що вона була скасована. Це правильне місце для запуску завдань очищення, відправки фінального підсумку в систему відстеження, коміту артефактів або сповіщення людини про завершення сесії. AgentsRoom доповнює хук Stop власною системою сповіщень, тому ви отримуєте сповіщення як від вашого користувацького хука, так і від настільних + мобільних push-сповіщень AgentsRoom.

Notification

Хук Notification спрацьовує, коли Claude Code надсилає системне сповіщення, зазвичай коли агент чекає на введення користувача або завершив тривале завдання. Використовуйте його для маршрутизації сповіщень у Slack, Discord, Telegram, електронну пошту або будь-який вебхук, який вам подобається. AgentsRoom вже відображає сповіщення Claude Code нативно на своїй багатозадачній панелі та як push-сповіщення на вашому телефоні, тому хук Notification - це ідеальне місце для додавання користувацьких інтеграцій зверху.

SubagentStop

Хук SubagentStop спрацьовує, коли субагент Claude Code завершує свою роботу і повертає контроль батьківському агенту. Якщо ви використовуєте субагенти Claude Code, визначені в .claude/agents/*.md для делегування спеціалізованих завдань, SubagentStop дозволяє вам логувати, що робив кожен субагент, агрегувати їхні виходи або запускати наступний крок. У AgentsRoom події SubagentStop з'являються в живій часовій шкалі агента, щоб ви могли точно бачити, які субагенти працювали в кожній сесії Claude Code.

Чому хуки Claude Code важливі

Хуки перетворюють Claude Code з вражаючого AI в агент кодування промислового рівня, на якого може покладатися вся ваша команда.

Детерміновані захисні механізми безпеки

Запити є ймовірнісними і можуть бути обійдені. Хуки 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-запитом.

Спостережуваність хуків у реальному часі

Хуки Claude Code генерують події. AgentsRoom перетворює ці події на візуальну стрічку: кожен тригер хуку, кожен виклик інструменту, кожна зміна статусу, транслюються в реальному часі для кожного агента і проекту. Вам більше не потрібно переглядати логи: ви спостерігаєте за роботою вашого флоту Claude Code в реальному часі.

Перехід від спостереження до нагляду

Без хуків запуск Claude Code означає спостереження за кожним викликом інструменту. З хуками ви делегуєте спостереження детермінованому коду і наглядаєте на рівні виключень. AgentsRoom підсилює це: ви бачите всіх ваших агентів Claude Code, захищених хуками, одночасно і втручаєтеся лише тоді, коли щось вимагає вашої уваги.

Хуки Claude Code + AgentsRoom

AgentsRoom є візуальним командним центром для Claude Code та інших AI-кодувальних CLI. Він не форкує Claude Code, не реалізує хуки заново, не перехоплює виклики інструментів. Він запускає реальний Claude Code CLI як дочірній процес всередині повного xterm.js терміналу, що означає, що кожен хук, який ви визначили в .claude/settings.json або .claude/settings.local.json, працює точно так, як це задумала Anthropic: без компромісів, без сюрпризів, без невидимого проміжного програмного забезпечення.

Те, що додає AgentsRoom, це масштаб і видимість. Ви можете запускати десятки агентів Claude Code паралельно, у десятках проектів, кожен з власною конфігурацією хуків, і бачити кожен тригер хуку на одній панелі. У поєднанні з повідомленнями AgentsRoom для кожного агента, мобільним додатком-компаньйоном і відстеженням статусу в реальному часі, хуки Claude Code стають першокласним шаром спостережуваності для всієї вашої AI-кодувальної операції.

Запускає реальний Claude Code CLI

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 постачається з нативними повідомленнями для настільних комп'ютерів і наскрізно зашифрованими мобільними push-повідомленнями. Хук Notification, хук Stop і хук SubagentStop Claude Code всі генерують сигнали, які AgentsRoom відображає безпосередньо на вашому робочому столі і телефоні. Ви можете відійти від комп'ютера і все одно знати, коли хук каже вам повернутися.

Часті запитання про хуки Claude Code

Що таке хуки Claude Code в одному реченні?+
Хуки Claude Code - це визначені користувачем shell-команди, які Claude Code запускає автоматично на певних подіях життєвого циклу (PreToolUse, PostToolUse, UserPromptSubmit, Stop, Notification, SubagentStop), надаючи вам детермінований контроль над поведінкою ваших AI-кодувальних агентів.
Де налаштовуються хуки Claude Code?+
Хуки Claude Code знаходяться в .claude/settings.json (комітиться в git, ділиться з командою) або .claude/settings.local.json (ігнорується git, особисте). Обидва файли автоматично підхоплюються Claude Code CLI. AgentsRoom запускає реальний Claude Code CLI, тому він поважає обидва файли без додаткової конфігурації.
Чи замінює AgentsRoom хуки Claude Code?+
Ні. AgentsRoom не замінює, не переписує і не перехоплює хуки Claude Code. Він запускає реальний Claude Code CLI як дочірній процес, що означає, що ваші хуки продовжують працювати точно так, як це задумала Anthropic. Роль AgentsRoom полягає в тому, щоб надати вам візуальний командний центр і багатозадачну панель на основі сесій Claude Code, керованих хуками.
Чи можу я відстежувати події хуків Claude Code в AgentsRoom?+
Так. AgentsRoom транслює вихід кожної сесії Claude Code в реальному часі, включаючи події, викликані хуками (вихід форматера, відхилення обмежень, повідомлення про сповіщення, зупинки субагентів). Багатозадачна панель агрегує статус по кожному працюючому агенту, щоб ви могли швидко побачити, які хуки спрацювали де.
З якого хуку Claude Code найкраще почати?+
Для більшості команд PostToolUse є найбільш цінним першим хуком: підключіть його до вашого форматера та лінтера, щоб кожне редагування миттєво очищалося. Для проектів з критичною безпекою PreToolUse є незамінним: блокуйте руйнівні команди Bash перед тим, як агент їх виконає. Після того, як ці хуки налаштовані, додайте UserPromptSubmit для аудиту логів та Stop для телеметрії завершення.
Чи можна безкоштовно використовувати AgentsRoom з хуками Claude Code?+
Так. AgentsRoom можна безкоштовно завантажити та використовувати з до 3 проектами. Використовуйте власну підписку Anthropic або API ключ. Кожен хук, кожен захист PreToolUse, кожен форматер PostToolUse, який ви налаштували в .claude/settings.json, працюватиме одразу: без додаткових налаштувань, без додаткових оплат.

Дивіться, як ваші хуки Claude Code виконуються в реальному часі

Завантажте AgentsRoom, відкрийте проект з хуками .claude/settings.json, запустіть агента Claude Code і спостерігайте, як кожна подія хуку транслюється на панель управління в реальному часі.

БезкоштовноЗавантажити AgentsRoom

Додаток-компаньйон: контролюйте своїх агентів на ходу

Використовуйте свого: Claude, Codex, Antigravity CLI або іншого AI-провайдера.

Отримати розширення
Chrome Web Store

Надсилайте баги та запити прямо у свій публічний беклог.

Погляд на AgentsRoom в дії.

Кілька проектів
Багато постачальників
Кілька агентів
Статус в реальному часі
Різниця файлів і коміт
Мобільний компаньйон
Попередній перегляд в реальному часі
Команди агентів
Автоматизація браузера
Розробка, орієнтована на беклог
Бібліотека підказок
Бібліотека навичок
Переглянути всі функції