Claude Code Hooks (voice) — плагин
Набор хуков Claude Code с голосовыми сигналами: звук на старте сессии, вызове инструмента, ответе агента и других событиях.
- 567 ★ репозитория
- Последний коммит
- MIT
Минимальный доступ
Почему такой уровень
- Скрипт на Python запускается на каждом событии хуков с правами вашего пользователя.
Установка
- Работает в
Ручная установка
git clone https://github.com/shanraisshan/claude-code-hooks.git temp-hooksИз `install/README-mac.md`: после клонирования копируют `.claude/hooks` в проект и переносят ключи `hooks` в `.claude/settings.json`.
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Скрипт на Python запускается на каждом событии хуков с правами вашего пользователя.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий показывает все 30 хуков Claude Code на рабочем примере: скрипт `hooks.py` реагирует на события жизненного цикла и проигрывает короткий звук для каждого. Сигналы различаются по событию: например, отдельные звуки для запроса разрешения, начала и конца вызова инструмента, остановки агента. Установка ручная: папка `.claude/hooks` копируется в проект, а ключи `disableAllHooks` и `hooks` из файла настроек `install/settings-mac.json` переносятся в `.claude/settings.json`. Для Linux и Windows есть свои инструкции и файлы настроек. В `.claude/agents` лежит демо-агент для проверки хуков агента.
Для кого. Разработчики на Claude Code, которым нужен звуковой сигнал о паузе агента или готовом ответе, а также авторы, изучающие хуки на примере.
Подходит, если
- Агент работает в фоне, а звук сообщает о запросе разрешения.
- Нужен готовый образец, как подключить хуки в `.claude/settings.json`.
- Хочется услышать, на каких событиях жизненного цикла срабатывают хуки.
- Команда сверяет список поддерживаемых хуков с версией Claude Code.
Не подходит, если
- Работа идет в общем офисе, где звук мешает.
- Нужны хуки для блокировки опасных команд, а не для сигналов.
- Python 3 недоступен.
Пример запроса к агенту
Подключи голосовые хуки из этого репозитория к моему проекту на macOS и проверь, что звук играет на старте сессии.Ограничения
Нужен Python 3; на macOS используется встроенный `afplay`, для других систем действуют свои инструкции. Без выполненных условий Claude Code выдает ошибку `SessionStart:startup hook error`. Хуки выполняют скрипт на каждом событии с правами вашего пользователя: прочитайте `hooks.py` до подключения. Звуки привязаны к событиям, а не к смыслу ответа, поэтому часть сигналов быстро надоедает: отключайте лишние в конфигурации. Последний коммит — 4 июня 2026.
Как отключить. Удалите ключ `hooks` из `.claude/settings.json` или установите `disableAllHooks` в `true`, затем удалите папку `.claude/hooks`.
Частые вопросы
Сколько хуков поддерживается?
30, весь список приведен в `HOOKS-README.md` внутри `.claude/hooks`.
Как проверить, что все работает?
Запустите `claude` и отправьте любой запрос, например `Hi`: прозвучат сигналы старта сессии, вызова инструмента и ответа.
Что делать с ошибкой SessionStart?
Ошибка `SessionStart:startup hook error` значит, что не выполнены требования: проверьте Python 3 и аудиоплеер для вашей системы.
Есть ли версия для Windows и Linux?
Да, для каждой системы есть своя инструкция в `install/` и свой файл настроек, потому что различаются команда Python и путь к скрипту.
Как отключить хуки?
Удалите ключ `hooks` из `.claude/settings.json` или поставьте `disableAllHooks` в `true`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныГотовая сборка для Claude Code: агенты, слеш-команды, скиллы, защитные хуки, правила и MCP-подключения одной установкой
Готовая инфраструктура для Claude Code: авто-активация скиллов через хуки, набор скиллов, агенты, слэш-команды и мастер установки в ваш проект
Набор утилит для Claude Code: фоновые скиллы, экспертные агенты, слэш-команды и шаблоны промптов для разработки
Три плагина для Claude Code: оркестратор savvy-flow с субагентами по уровням и два мода с панелью прогресса и таймером кэша
Claude Code Skills and Agents
Claude Code Skills & Agents
Плагин Claude Code с набором скиллов и субагентов: глубокое исследование, генерация картинок, работа с GitHub, разбор кода и переключение моделей
Стартовый набор для Claude Code: шаблон CLAUDE.md с системой памяти, готовые хуки, сабагенты и скиллы, которые копируются в проект
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Claude Code Hooks (voice) (эта карточка) | нет | 567 | |
| claude-code-hooks | нет | 576 | другой набор хуков Claude Code, без озвучки событий; здесь каждое из 30 событий озвучивается и служит образцом настройки |
| Claude Hooks (Prompt Injection Defender) | нет | 273 | хук проверки вывода на скрытые инструкции; здесь голосовые сигналы жизненного цикла без проверки содержимого |
Коротко о README
README ведет к инструкциям установки для Mac, Linux и Windows, затем двумя шагами проверяет звук и перечисляет по датам добавленные хуки Claude Code.