push-уведомления от Claude Code: узнавайте, когда задача завершена

Claude Code может часами работать самостоятельно. Проблема в том, что за эти часы вам приходится либо сидеть и следить за терминалом, либо уйти и вернуться, чтобы обнаружить, что с третьей минуты он ждёт подтверждения разрешения.
Хуки решают обе проблемы. Claude Code выполняет shell-команду в определённых точках своего жизненного цикла, и три из них именно те, что нужны на телефоне:
- Stop: Claude закончил ответ. Задача выполнена или у него есть вопрос.
- Notification: Claude ждёт вас. Запрос разрешения или он простаивает в ожидании ввода.
- StopFailure: ход завершился ошибкой API, например из-за лимита запросов или проблемы с оплатой.
Это руководство подключает все три события к Pocket Alert одним скриптом. Настройка займёт около пяти минут.
Что понадобится
- Claude Code, любая свежая версия.
jqиcurl. Оба есть в большинстве дистрибутивов Linux; на macOS установитеjqкомандойbrew install jq.- Аккаунт Pocket Alert и API-ключ из раздела API-ключи. Бесплатного тарифа достаточно.
- Приложение Pocket Alert на iPhone или Android, в которое вы вошли.
Шаг 1. Скрипт хука
Claude Code передаёт каждому хуку JSON-объект через stdin. Нужны поля hook_event_name, cwd, last_assistant_message для Stop, message для Notification и error для StopFailure. Скрипт превращает их в push-уведомление:
#!/usr/bin/env bash
payload=$(cat)
project=$(basename "$(jq -r '.cwd' <<<"$payload")")
case "$(jq -r '.hook_event_name' <<<"$payload")" in
Stop)
title="Claude finished · $project"
message=$(jq -r '.last_assistant_message // "Task complete"' <<<"$payload")
level=default ;;
Notification)
title="Claude needs you · $project"
message=$(jq -r '.message' <<<"$payload")
level=high ;;
StopFailure)
title="Claude stopped · $project"
message=$(jq -r '"API error: " + (.error // "unknown")' <<<"$payload")
level=high ;;
*) exit 0 ;;
esac
jq -n --arg t "$title" --arg m "${message:0:300}" --arg l "$level" \
'{title: $t, message: $m, level: $l}' |
curl -sS --max-time 10 https://api.pocketalert.app/v1/messages \
-H "Token: $POCKETALERT_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @- >/dev/null || true
exit 0
Сохраните его как ~/.claude/hooks/pocketalert.sh и сделайте исполняемым:
mkdir -p ~/.claude/hooks
chmod +x ~/.claude/hooks/pocketalert.sh
Две строки здесь важнее, чем кажутся:
jq -nформирует JSON. В последнем сообщении Claude много кавычек, обратных кавычек и переносов строк. Если вставить его в JSON-строку вручную, всё сломается на первой кавычке;jqэкранирует текст правильно.exit 0в конце и|| trueпосле curl. Для хука Stop код выхода 2 означает «не останавливайся, продолжай». Хук уведомлений никогда не должен блокировать Claude, даже если сеть недоступна.
Или с Pocket Alert CLI
Если установлен Pocket Alert CLI версии 2.0 или новее, блок с curl сводится к одной команде. CLI сам экранирует текст и берёт ключ из POCKETALERT_API_KEY (его задаёт блок env ниже) или из pocketalert auth:
pocketalert send -t "$title" -m "${message:0:300}" -l "$level" -q >/dev/null 2>&1 || true
Используйте -t и -m, а не позиционные аргументы: ответ, начинающийся с дефиса, например Markdown-список, иначе будет принят за опцию.
Шаг 2. Зарегистрируйте хуки
Добавьте хуки в ~/.claude/settings.json, чтобы они работали во всех проектах. Если в файле уже есть ключ hooks, объедините с ним эти записи:
{
"env": {
"POCKETALERT_API_KEY": "YOUR_API_KEY"
},
"hooks": {
"Stop": [
{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }] }
],
"StopFailure": [
{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }] }
],
"Notification": [
{
"matcher": "permission_prompt|idle_prompt",
"hooks": [{ "type": "command", "command": "~/.claude/hooks/pocketalert.sh" }]
}
]
}
}
Блок env передаёт API-ключ хуку, не записывая его в профиль shell. Если POCKETALERT_API_KEY уже экспортируется где-то в другом месте, этот блок можно не добавлять.
matcher у Notification фильтрует по типу уведомления. permission_prompt срабатывает, когда запрос разрешения ждёт ответа около шести секунд, а idle_prompt срабатывает примерно через минуту после того, как Claude закончил, если вы с тех пор ничего не вводили. В терминальной сессии оба срабатывают, только когда вы, похоже, отошли от компьютера, поэтому во время работы за ним телефон не вибрирует. У Stop matcher нет: он срабатывает каждый раз, когда Claude завершает ответ.
Чтобы ограничить хуки одним репозиторием, добавьте тот же блок hooks в .claude/settings.json этого репозитория или в .claude/settings.local.json, если не хотите отслеживать его в git.
Шаг 3. Проверьте
Claude Code обычно сам подхватывает изменения в файле настроек (если /hooks ещё не показывает новые хуки, начните новую сессию). Дайте ему простое задание:
> List the files in this directory and stop.
Когда Claude закончит, на телефоне появится Claude finished · your-project с началом его ответа. Если ничего не пришло, выполните /hooks внутри Claude Code и посмотрите зарегистрированные хуки.
Чтобы проверить скрипт отдельно, передайте ему тестовое событие:
echo '{"hook_event_name":"Stop","cwd":"/tmp/demo","last_assistant_message":"Hook test"}' \
| POCKETALERT_API_KEY=YOUR_API_KEY ~/.claude/hooks/pocketalert.sh
Что приходит на телефон
| Событие | Заголовок | Текст | Уровень |
|---|---|---|---|
| Задача выполнена | Claude finished · api | Первые 300 символов последнего ответа Claude | default |
| Запрос разрешения | Claude needs you · api | Claude needs your permission | high |
| Ожидание ввода | Claude needs you · api | Claude is waiting for your input | high |
| Ошибка API | Claude stopped · api | API error: rate_limit | high |
high на iPhone приходит как важное по времени, поэтому запрос разрешения пройдёт через Фокусирование, а обычные сообщения о завершении останутся тихими. Каждое push-уведомление также сохраняется в истории приложения и в веб-панели, так что можно просмотреть, что Claude делал за ночь.
Настройте под себя
Только когда вас нет на месте. Stop срабатывает после каждого ответа, в том числе после быстрых, за которыми вы наблюдаете. Добавьте переключатель в начало скрипта:
[ -f ~/.claude/away ] || exit 0
Затем выполняйте touch ~/.claude/away, когда уходите от компьютера, и rm ~/.claude/away, когда возвращаетесь. Запросы разрешения в любом случае стоит получать, поэтому проверку можно поместить только внутрь ветки Stop).
Группировка по проектам. Создайте в Pocket Alert приложение для каждого проекта и добавьте application_id в JSON. Тогда приложение будет фильтровать сообщения по проекту, и для каждого можно задать свой уровень по умолчанию.
Не блокировать Claude совсем. Добавьте "async": true рядом с "type": "command", и хук будет работать в фоне. В безголовом режиме (claude -p) этого делать не стоит: фоновые хуки завершаются вместе с сессией, и push может не уйти.
Продолжение с телефона. На платном тарифе кнопка действия типа copy с ID сессии позволит скопировать claude --resume <id> с телефона и вставить эту команду, когда вы вернётесь к компьютеру.
Или пусть Claude отправляет через MCP
Хуки работают детерминированно: они срабатывают независимо от того, помнит ли о них Claude. Другой вариант — дать Claude инструмент для уведомлений и позволить ему решать, когда им пользоваться. Добавьте MCP-сервер Pocket Alert:
claude mcp add --transport http pocketalert https://mcp.pocketalert.app/mcp \
--scope user --header "Authorization: Bearer YOUR_API_KEY"
Теперь можно сказать: «выполни миграцию и пришли мне количество строк, когда закончишь», и Claude вызовет create_message с сообщением, которое сам составит под этот случай. Инструмент также принимает level и actions, а list_messages позволяет Claude просмотреть отправленное ранее.
Используйте оба подхода: хуки для гарантированных «готово» и «нужно вмешательство», MCP для сообщений с конкретным содержанием. О подтверждении перед рискованными шагами читайте в статье уведомления с участием человека.
Если ничего не приходит
- Проверьте ключ. Выполните тестовую команду выше. Код
401от curl означает, что API-ключ неверный; уберите>/dev/null, чтобы увидеть ответ. - Проверьте, загрузились ли хуки. Выполните
/hooks. Изменения в файле настроек обычно подхватываются в течение нескольких секунд; если хуков нет в списке, перезапустите Claude Code. - Проверьте, что
jqесть в PATH, который использует Claude Code. Хуки выполняются с окружением Claude, а редактор, запущенный из графического интерфейса, может не видеть/opt/homebrew/binот Homebrew. - Проверьте дневной лимит. На бесплатном тарифе отправляется 50 сообщений в день. Длинная сессия с множеством коротких ходов может исчерпать его; поможет переключатель отсутствия, описанный выше.
Вопросы и ответы
Работает ли это в расширениях VS Code и JetBrains?
Да. Расширения запускают Claude Code внутри себя и читают тот же ~/.claude/settings.json, поэтому хуки срабатывают и там.
Может ли Claude увидеть API-ключ?
В диалоге — нет: хуки выполняются вне него, а их вывод для Stop и Notification модели не показывается. Однако блок env действует на всю сессию, поэтому команда Bash, которую выполняет Claude, теоретически может прочитать переменную. Если это важно, храните ключ в файле, доступном только вам, например ~/.config/pocketalert/key с правами 600, и в скрипте используйте -H "Token: $(cat ~/.config/pocketalert/key)".
Чем это отличается от звукового сигнала терминала?
Звуковой сигнал и уведомления на рабочем столе требуют, чтобы вы находились у компьютера. Push-уведомление доходит до телефона где бы вы ни были, сохраняет историю и может быть настроено так, чтобы пробиваться через Фокусирование для запросов, которые блокируют Claude.
Можно ли получить весь ответ, а не 300 символов?
Push-уведомление передаёт текст длиной до примерно 3 000 символов. Можно поднять ограничение 0:300, но push-уведомление нужно, чтобы решить, возвращаться ли к компьютеру, а не чтобы читать полный ответ.
Это бесплатно?
Да. Хуки входят в Claude Code, а бесплатный тариф Pocket Alert покрывает 50 сообщений в день на одно устройство. Платные тарифы добавляют больше сообщений, устройств и кнопок действий.
Получите API-ключ, добавьте скрипт, и пусть Claude сообщит вам, когда придёт ваша очередь.