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

> Получайте push-уведомление на телефон, когда Claude Code завершит задачу, будет ждать разрешения или остановится из-за ошибки. Один скрипт-хук, три события, без плагинов.

*11.10.2026*

<!-- source: https://pocketalert.app/ru/blog/claude-code-push-notifications -->

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-ключи](/account/apikeys). Бесплатного тарифа достаточно.
- Приложение Pocket Alert на [iPhone или Android](/get-app), в которое вы вошли.

## Шаг 1. Скрипт хука

Claude Code передаёт каждому хуку JSON-объект через stdin. Нужны поля `hook_event_name`, `cwd`, `last_assistant_message` для Stop, `message` для Notification и `error` для StopFailure. Скрипт превращает их в push-уведомление:

```bash
#!/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` и сделайте исполняемым:

```bash
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](/tools/cli) версии 2.0 или новее, блок с curl сводится к одной команде. CLI сам экранирует текст и берёт ключ из `POCKETALERT_API_KEY` (его задаёт блок `env` ниже) или из `pocketalert auth`:

```bash
pocketalert send -t "$title" -m "${message:0:300}" -l "$level" -q >/dev/null 2>&1 || true
```

Используйте `-t` и `-m`, а не позиционные аргументы: ответ, начинающийся с дефиса, например Markdown-список, иначе будет принят за опцию.

## Шаг 2. Зарегистрируйте хуки

Добавьте хуки в `~/.claude/settings.json`, чтобы они работали во всех проектах. Если в файле уже есть ключ `hooks`, объедините с ним эти записи:

```json
{
  "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` ещё не показывает новые хуки, начните новую сессию). Дайте ему простое задание:

```text
> List the files in this directory and stop.
```

Когда Claude закончит, на телефоне появится **Claude finished · your-project** с началом его ответа. Если ничего не пришло, выполните `/hooks` внутри Claude Code и посмотрите зарегистрированные хуки.

Чтобы проверить скрипт отдельно, передайте ему тестовое событие:

```bash
echo '{"hook_event_name":"Stop","cwd":"/tmp/demo","last_assistant_message":"Hook test"}' \
  | POCKETALERT_API_KEY=YOUR_API_KEY ~/.claude/hooks/pocketalert.sh
```

## Что приходит на телефон

<div class="cmp-table-wrap">
<table class="cmp-table">
<thead><tr><th>Событие</th><th>Заголовок</th><th>Текст</th><th>Уровень</th></tr></thead>
<tbody>
<tr><th>Задача выполнена</th><td>Claude finished · api</td><td>Первые 300 символов последнего ответа Claude</td><td>default</td></tr>
<tr><th>Запрос разрешения</th><td>Claude needs you · api</td><td>Claude needs your permission</td><td>high</td></tr>
<tr><th>Ожидание ввода</th><td>Claude needs you · api</td><td>Claude is waiting for your input</td><td>high</td></tr>
<tr><th>Ошибка API</th><td>Claude stopped · api</td><td>API error: rate_limit</td><td>high</td></tr>
</tbody>
</table>
</div>

`high` на iPhone приходит как важное по времени, поэтому запрос разрешения пройдёт через Фокусирование, а обычные сообщения о завершении останутся тихими. Каждое push-уведомление также сохраняется в истории приложения и в [веб-панели](/messages), так что можно просмотреть, что Claude делал за ночь.

## Настройте под себя

**Только когда вас нет на месте.** Stop срабатывает после каждого ответа, в том числе после быстрых, за которыми вы наблюдаете. Добавьте переключатель в начало скрипта:

```bash
[ -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 может не уйти.

**Продолжение с телефона.** На платном тарифе [кнопка действия](https://info.pocketalert.app/features/action-buttons.html) типа `copy` с ID сессии позволит скопировать `claude --resume <id>` с телефона и вставить эту команду, когда вы вернётесь к компьютеру.

## Или пусть Claude отправляет через MCP

Хуки работают детерминированно: они срабатывают независимо от того, помнит ли о них Claude. Другой вариант — дать Claude инструмент для уведомлений и позволить ему решать, когда им пользоваться. Добавьте [MCP-сервер Pocket Alert](/tools/mcp):

```bash
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 для сообщений с конкретным содержанием. О подтверждении перед рискованными шагами читайте в статье [уведомления с участием человека](/blog/human-in-the-loop-notifications).

## Если ничего не приходит

- **Проверьте ключ.** Выполните тестовую команду выше. Код `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-ключ](/signup), добавьте скрипт, и пусть Claude сообщит вам, когда придёт ваша очередь.
