Powiadomienie, gdy agent programistyczny skończy pracę lub poprosi o zgodę

Aby dostać powiadomienie, gdy agent programistyczny skończy pracę albo poprosi o zgodę, włącz jego wbudowane powiadomienia lub dodaj hook uruchamiany przy tych zdarzeniach. Jeśli nie będzie Cię przy komputerze, kieruj powiadomienia na telefon. Przetestuj całość przed wyjściem, bo agent czekający na zgodę nic nie robi, dopóki nie odpowiesz.

Przykłady w tym poradniku dotyczą Claude Code. Jak nie dopuścić do uśpienia komputera, opisuje osobny poradnik. Mono firmy Reunified wysyła takie powiadomienia dla agentów uruchamianych w Mono, ale ta metoda działa w każdej konfiguracji.

1. Zdecyduj, które zdarzenia agenta wymagają powiadomienia

Liczą się trzy zdarzenia:

Jeśli ustawiasz tylko jedno powiadomienie, niech dotyczy próśb o zgodę.

2. Włącz powiadomienia w Claude Code

Claude Code wysyła powiadomienie, gdy skończy pracę albo zatrzyma się w oczekiwaniu na zgodę, a wygląda na to, że nie ma Cię przy komputerze. Domyślnie pokazuje powiadomienia na pulpicie tylko w Ghostty, Kitty i iTerm2 (konfiguracja terminala). W innych terminalach ustaw preferredNotifChannel na "terminal_bell" w ~/.claude/settings.json, żeby rozległ się dzwonek terminala. W tmux dodaj set -g allow-passthrough on do ~/.tmux.conf i wczytaj ten plik ponownie.

Jeśli chcesz własny dźwięk lub polecenie, dodaj do tego samego pliku hooki. Zdarzenie Notification przyjmuje matchery, na przykład permission_prompt (prośba o zgodę czeka od około sześciu sekund) i idle_prompt (Claude skończył mniej więcej minutę temu, a Ty od tego czasu nic nie wpisałeś). Na Macu ta konfiguracja odtwarza inny dźwięk dla każdego z nich:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Hero.aiff" }]
      }
    ]
  }
}

Przewodnik po hookach zawiera też polecenia wyświetlające powiadomienia na pulpicie w macOS, Linuksie i Windows. Inni agenci działają inaczej, więc sprawdź ich dokumentację.

3. Wysyłaj powiadomienia na telefon

Do telefonu prowadzą trzy drogi:

• Własna aplikacja agenta. Gdy w Claude Code działa Remote Control, uruchom /config i włącz powiadomienia push wysyłane, gdy Claude uzna to za potrzebne („Push when Claude decides”), gdy wymagane jest Twoje działanie („Push when actions required”), albo obie opcje. Wymaga to planu, który obejmuje tę funkcję, oraz aplikacji Claude zalogowanej na to samo konto, z włączonymi powiadomieniami.
• Hook, który wysyła wiadomość push, na przykład przez curl do usługi push, której aplikację masz na telefonie.
• Aplikacja towarzysząca, która przekazuje zdarzenia sesji z komputera.

Każda z tych dróg wymaga włączonego, nieuśpionego komputera z dostępem do sieci, na którym agent nadal działa. Token używany przez hook trzymaj w ~/.claude/settings.json, a nie w projektowym .claude/settings.json, który może trafić do repozytorium razem z commitem.

4. Chroń treść powiadomień na ekranie blokady

Każdy, kto jest blisko zablokowanego telefonu, może przeczytać podglądy powiadomień. Nie umieszczaj w wiadomościach z hooków sekretów, zawartości plików ani wierszy logów. Wysyłaj tylko zdarzenie i nazwę projektu: dla fikcyjnego projektu „invoice-export” wystarczy „invoice-export: potrzebna zgoda”. Na iPhonie otwórz Ustawienia > Powiadomienia i ustaw Pokazuj podglądy na Gdy odblokowany. Android też potrafi ukrywać poufne treści na ekranie blokady, choć nazwa tej opcji zależy od telefonu.

W Mono powiadomienie o zakończeniu pracy pokazuje ostatnią wiadomość agenta, skróconą, jeśli jest długa. Powiadomienie z prośbą o uprawnienia przedstawia ją tak, jak opisuje ją agent, często w postaci samego polecenia.

5. Przetestuj na nieszkodliwym zadaniu przed wyjściem

Na domowym komputerze uruchom sesję o nazwie „test invoice-export” i poproś agenta, żeby uruchomił testy i zgłosił ewentualne błędy, nie zmieniając plików. Agent pyta przed uruchomieniem poleceń, więc poprosi o zgodę na npm test. Na komputerze przejdź do innego ekranu lub innej aplikacji, a potem zablokuj telefon i przejdź do innego pokoju.

W Mono zobaczysz:

1. Powiadomienie „Prośba agenta o uprawnienia” z nazwą polecenia testowego.
2. Naciśnięcie powiadomienia otwiera tę sesję, w której wybierasz Zezwól. Każda kolejna prośba przychodzi w osobnym powiadomieniu.
3. Powiadomienie „Agent zakończył pracę w sesji «test invoice-export»” z ostatnią wiadomością agenta, na przykład „Jeden test w dates.test.ts nie przechodzi z powodu stref czasowych. Nie zmieniłem żadnych plików.”

Potem uruchom drugie zadanie, mając sesję otwartą na telefonie: dopóki na nią patrzysz, nie dostaniesz żadnego powiadomienia. Zanim wyjdziesz, upewnij się, że żadne urządzenie nie ma tej sesji na ekranie.

6. Napraw powiadomienia, które nie docierają

W Mono otwórz Ustawienia > Powiadomienia i sprawdź „Wszystkie powiadomienia”, „Code” (zakończone i zatrzymane sesje), „Prośby o uprawnienia” oraz „Wysyłaj na pozostałe urządzenia”. Wszystkie są domyślnie włączone. Powiadomienia wysyła komputer, na którym działa agent, więc Mono musi tam cały czas działać.

Zanim zatwierdzisz prośbę z telefonu, przeczytaj, co sprawdzić w prośbie o uprawnienia. Resztę konfiguracji opisuje poradnik pracy z agentami programistycznymi z telefonu. Mono nie jest jeszcze dostępny, ale możesz dołączyć do listy oczekujących.