Самописные уведомления от Claude Code в Telegram

07.02.2026 • Хабр

В материале показано, как настроить Telegram-уведомления для Claude Code через hooks в настройках, чтобы агент сигнализировал о завершении задач и запросах разрешений. Это переводит «тихие ожидания» в явные сигналы и может дополняться краткой выжимкой от подагента.

Проблема описана как простои из-за «тихих ожиданий», когда Claude Code ждёт пользователя вне режима авто-пилота.
Решение опирается на механизм hooks в файле ~/.claude/settings.json, где на события агента назначаются коллбэки.
В тексте приведён перечень событий (например SessionStart, PreToolUse, PostToolUseFailure, Stop и другие) и объяснение, когда они срабатывают.
В примере используются два типа действий: запуск системной команды и запуск подагента, который затем присылает краткий отчёт.
Для доставки сообщений задействуется Telegram Bot API: создаётся бот через BotFather, берутся token и chat_id, после чего отправляются сообщения.

Почему это важно: Обычно такой подход даёт простой канал наблюдаемости за работой агента вне IDE и снижает вероятность пропустить момент, когда требуется участие человека. В тексте подчёркивается, что hooks детерминированы и позволяют подключать инструменты операционной системы к пайплайну работы агента.

На что обратить внимание: В тексте отдельно отмечены риски вариантов с прямым размещением вызовов API в CLAUDE.md и вопросы надёжности. Также поднимается тема масштабируемости: обёртка в skill названа громоздкой для привязки к конкретным событиям цикла агента. В примере первые уведомления вешаются на завершение задачи и запрос разрешения, а чувствительным местом остаётся хранение токена бота и формулировки сообщений.

Коротко

Механика hooks превращает события агента в уведомления: статус работы становится видимым даже когда пользователь не смотрит в IDE.
В тексте подчёркнута уязвимость прямых вызовов API с токеном: в подобных схемах обычно важны хранение секретов и доступ к конфигам.
Подагент с краткой выжимкой помогает понять контекст без переключения, но автор ограничивает длину отчёта, чтобы не упереться в лимиты Telegram.
Список событий показывает, что хук может срабатывать не только в конце задачи: это открывает возможность точечной автоматизации в ходе сессии.
Автор рассматривает альтернативы (готовая библиотека, системный звук, skill) и выбирает минимальный конфиг как более масштабируемую основу.

FAQ

Зачем вообще подключать уведомления в Telegram к Claude Code, если агент работает в IDE и может просто ждать следующего ввода пользователя?

В тексте это описано как способ уменьшить «тихие ожидания»: агент сообщает, когда требуется участие пользователя, и когда задача завершена.

Где в Claude Code настраивается такая отправка сообщений и какой механизм используется, чтобы привязывать внешние действия к событиям работы агента?

Пример строится на hooks в файле ~/.claude/settings.json: к событиям можно привязать вызов команд и других действий.

Какие варианты действий показаны в хуках и чем отличается отправка сигнала через системную команду от сценария, где запускается подагент с краткой выжимкой?

Показаны варианты с запуском системной команды и с запуском подагента. Во втором случае подагент формирует краткую выжимку и отправляет её сообщением.

Какая исходная проблема описана в начале и почему варианты через CLAUDE.md, skill или готовую библиотеку автор счёл менее подходящими для своей задачи?

Упоминаются простои из-за ожиданий вне автопилота. Вариант с вызовом через CLAUDE.md назван не секьюрным и потенциально ненадёжным, а обёртка в skill и готовая библиотека — избыточными или громоздкими для задачи.

PubMag