notify-before-bash — хук для Claude Code: что делает и как установить
Выводит оповещение в консоль перед каждым запуском Bash-команды в Claude Code. Помогает отслеживать обращения ассистента к системному терминалу.
npx claude-code-templates@latest --hook pre-tool/notify-before-bashЧто делает 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-bash2Вручную: положить файлы
.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