Назад в блог

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

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 символов последнего ответа Claudedefault
Запрос разрешенияClaude needs you · apiClaude needs your permissionhigh
Ожидание вводаClaude needs you · apiClaude is waiting for your inputhigh
Ошибка APIClaude stopped · apiAPI error: rate_limithigh

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 сообщит вам, когда придёт ваша очередь.

Поделиться статьёй