notify-permission — плагин для Claude Code
Плагин notify-permission пересылает запросы разрешений и ожидания Claude Code в Slack через вебхук, чтобы не сидеть перед терминалом во время долгих задач.
MIT ★ 586 обновлён 2026-10-26
/plugin marketplace add karanb192/claude-code-hooks
/plugin install notify-permission@claude-code-hooksЧто делает notify-permission
Плагин вешает хук Notification на события permission_prompt, idle_prompt и elicitation_dialog. Как только сессия запрашивает подтверждение на запуск Bash, чтение, запись или правку файлов, скрипт собирает карточку Slack Block Kit и отправляет её через входящий вебхук. В карточку попадают имя проекта, укороченный ID сессии, путь к рабочей директории, время и текст запроса, обрезанный до 200 символов.
Для отправки уведомлений требуется задать переменную окружения CCH_SLA_WEBHOOK. Если переменная пустая, плагин тихо пишет статус NONE в лог и не обращается к сети. Скрипт всегда завершается с кодом 0 и пустым ответом {}, поэтому сбой сети или битый вебхук не прервут работу в терминале. Все вызовы и ошибки фиксируются локально в файлах ~/.claude/hooks-logs/<date>.jsonl.
Какие задачи решает
- получать оповещения в Slack при запросах на запуск Bash или правку файлов
- отслеживать остановки сессии Claude Code без постоянного контроля терминала
- видеть путь к проекту и текст подтверждения прямо на карточке в мессенджере
- логировать все события запросов разрешений в локальный JSONL-файл
Примеры запросов агенту
- Запусти миграции базы данных и обнови файл конфигурации
- Выполни сборку проекта через Bash и дождись подтверждения
- Проверь тесты и внеси правки в исходники сервиса
Как установить notify-permission
Через маркетплейс плагинов
/plugin marketplace add karanb192/claude-code-hooks/plugin install notify-permission@claude-code-hooksПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о notify-permission
Как установить notify-permission в Claude Code?
Выполните команду /plugin marketplace add karanb192/claude-code-hooks, затем запустите /plugin install notify-permission@claude-code-hooks и перезапустите Claude Code.
Что делает notify-permission?
Плагин перехватывает события ожидания ввода или подтверждения действий и отправляет структурированную карточку в Slack через входящий вебхук.
Что произойдёт, если вебхук Slack не настроен?
Если переменная CCH_SLA_WEBHOOK не задана, хук сделает запись в локальный лог и не пойдёт в сеть. Сессия не заблокируется, так как скрипт всегда возвращает код 0.
Исходный текст
notify-permission · MIT
# notify-permission
> Sends Slack alerts when Claude needs your input, so you stop babysitting the terminal.
A `Notification` hook fires on `permission_prompt`, `idle_prompt`, and `elicitation_dialog`, classifies the notification (from `notification_type` when the payload carries it, otherwise from keywords in the message), and posts a Slack Block Kit card to your webhook: an emoji plus a specific title (which tool needs permission: Bash, Write, Edit, or Read; Claude waiting; or a choice to make), the project name, a short session id, the message truncated to 200 chars, the full cwd, and a timestamp. Kick off a long task, walk away, and Slack pings you the moment Claude is blocked on you.
## Install
```
/plugin marketplace add karanb192/claude-code-hooks # once per machine
/plugin install notify-permission@claude-code-hooks
```
Restart Claude Code, done. (Or from a shell: `claude plugin install notify-permission@claude-code-hooks`.)
## What it does
| Event | Runs | What happens |
|-------|------|--------------|
| Notification (`permission_prompt\|idle_prompt\|elicitation_dialog`) | sync | Classifies the notification, posts a Slack card to `CCH_SLA_WEBHOOK`, logs the outcome. |
Every input, send, and failure is appended to `~/.claude/hooks-logs/<date>.jsonl`. The hook always exits 0 and prints `{}`; it never blocks your session, even on malformed input or a dead webhook.
## Configuration
One environment variable:
| Variable | Default | Purpose |
|----------|---------|---------|
| `CCH_SLA_WEBHOOK` | unset | Slack Incoming Webhook URL the alert card is posted to. Unset means the hook sends nothing and logs a `NONE` entry (nothing sent, no error). |
No safety levels, no ask mode; this is a notifier, not a guard. Discord and Telegram channels are planned but not wired up yet: today the hook sends to Slack only.
## Data & privacy
The only network call is the POST to the webhook you configure, and only when `CCH_SLA_WEBHOOK` is set. The card carries the notification message (truncated to 200 chars), the project directory path, and a 6-char session id prefix; everything else stays in the local log.
## Uninstall
```
/plugin uninstall notify-permission@claude-code-hooks
```
---
Part of [claude-code-hooks](https://github.com/karanb192/claude-code-hooks).
© Karan Bansal · MIT · karanb192/claude-code-hooks