К основному содержанию
хук

notify-before-bash — хук для Claude Code: что делает и как установить

Выводит оповещение в консоль перед каждым запуском Bash-команды в Claude Code. Помогает отслеживать обращения ассистента к системному терминалу.

Установить в Claude Code · Через claude-code-templates Все способы и платформы ↓
npx claude-code-templates@latest --hook pre-tool/notify-before-bash
Открыть на GitHub

Что делает notify-before-bash

Хук перехватывает событие PreToolUse для встроенного инструмента Bash. Перед тем как Claude Code выполнит инструкцию в командной строке, в терминал печатается строка 🔔 About to run bash command....

Внутри конфигурации используется стандартный вызов echo. Никаких сторонних скриптов или внешних зависимостей скачивать не требуется, поэтому хук работает сразу после добавления в настройки.

Уведомление работает только как информационный сигнал в консоли и само по себе не проверяет аргументы команды и не блокирует запуск.

Какие задачи решает

  • вовремя замечать запуск терминальных команд ассистентом
  • контролировать моменты обращения к системной оболочке
  • упростить визуальный аудит действий агента в терминале

Примеры запросов агенту

  • Запусти тесты в проекте через npm test
  • Собери проект и покажи статус сборки

Как установить notify-before-bash

1Через claude-code-templates

npx claude-code-templates@latest --hook pre-tool/notify-before-bash

2Вручную: положить файлы

.claude/settings.json

Блок hooks: событие (PreToolUse, PostToolUse, Stop…) → команда. Личные — ~/.claude/settings.json

По шагам, с командами для каждой платформы: Хуки Claude Code: что это, где настраивать и как запретить опасную команду

Вопросы о notify-before-bash

Как установить notify-before-bash в Claude Code?

Выполните команду npx claude-code-templates@latest --hook pre-tool/notify-before-bash либо вручную пропишите хук в .claude/settings.json.

Что делает notify-before-bash?

Он перехватывает вызов инструмента Bash через событие PreToolUse и выводит предупреждающую строку перед выполнением команды.

Останавливает ли этот хук небезопасные команды?

Нет, хук только печатает сообщение в терминал и не прерывает выполнение перехваченной инструкции.

Исходный текст

notify-before-bash.json · MIT
{
  "description": "Show notification before any Bash command execution for security awareness. This hook displays a simple echo message '🔔 About to run bash command...' before Claude executes any bash command, giving you visibility into when system commands are about to run. Useful for monitoring and auditing command execution.",
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "echo '🔔 About to run bash command...'"
          }
        ]
      }
    ]
  }
}

© davila7 · MIT · davila7/claude-code-templates

Похожие хуки

Все хуки по теме «Безопасность» →

Из того же набора804

Весь набор →
env-file-protection Хук блокирует вызовы Write к файлам .env*, чтобы агент случайно не перезаписал секреты. Ставится одной командой в настройки Claude. 279установок slack-notifications Отправляет сообщение в Slack, когда Claude закончил работу или завершился субагент. Пригодится, если вы уходите от терминала и хотите знать, что задача готова. 279установок worktree-ghostty Открывает в Ghostty три панели при создании worktree: Claude слева, lazygit и yazi справа. Только macOS. 249установок scope-guard Хук для Claude Code предупреждает о правках файлов, не вошедших в спецификацию задачи. 247установок discord-notifications Отправляет сообщение в Discord, когда Claude закончил работу или завершил субагента. Пригодится, если вы уходите от терминала и хотите знать, что задача готова. 217установок shell-wrapper-guard Перехватывает опасные команды, спрятанные в оболочках вроде sh -c и python3 -c. Помогает закрыть обходы прямых проверок команд. 212установок desktop-notification-on-stop Хук показывает уведомление на рабочем столе, когда Claude Code заканчивает ответ. Пригодится, если вы переключаетесь в другое окно и ждёте продолжения. 211установок langsmith-tracing Отправляет трейсы диалогов Claude Code в LangSmith для мониторинга и отладки сессий. Срабатывает автоматически в фоне после каждого ответа модели. 204установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой