Powiadomienia z Claude Code możesz dostawać na pięć sposobów: wbudowane powiadomienie terminala, własny hook pokazujący alert na pulpicie, hook wysyłający push przez usługę taką jak ntfy, Telegram, Slack czy Discord, Remote Control od Anthropic z aplikacją mobilną Claude oraz dedykowane narzędzie do powiadomień. Pierwsze trzy są darmowe i informują, że coś się stało. Remote Control i dedykowane narzędzia pozwalają też odpowiedzieć z telefonu. Wybór zależy od tego, czy chcesz tylko wiedzieć, czy też reagować.
01Opcje w skrócie
preferredNotifChannel)Terminal na twoim komputerzeNieBrak albo jedno ustawienieosascript, notify-send, PowerShell)Twój komputerNieKilka linijek w settings.json02Wbudowane: informuje cię terminal
Claude Code sam wysyła powiadomienie, gdy skończy pracę lub czeka na prompt o uprawnienia, a ty wyglądasz na nieobecnego. Domyślnie pokazuje powiadomienie na pulpicie w iTerm2, Ghostty i Kitty, w Apple Terminal dzwoni tylko w jednym konkretnym przypadku, a w innych terminalach nie robi nic. Ustawienie preferredNotifChannel to zmienia, np. na "terminal_bell", żeby każdy terminal dostawał znak dzwonka.
Zalety: nic nie trzeba instalować, działa przez SSH w terminalach, które przekazują powiadomienie. Ograniczenia: dociera tylko do komputera, przy którym siedzisz, wiele terminali (w tym terminale w IDE) domyślnie nic nie dostaje i nie możesz odpowiedzieć. Szczegóły znajdziesz w poradniku o dzwonku terminala.
03Własne hooki: powiadomienia na pulpicie
Hooki pozwalają Claude Code uruchamiać polecenie w określonych momentach. Hook Notification odpala się, gdy Claude potrzebuje twojej uwagi (prompt o uprawnienia czeka ok. sześciu sekund albo Claude jest bezczynny ok. 60 sekund po zakończeniu). Hook Stop odpala się w chwili, gdy kończy się tura. Podepnij którykolwiek z nich pod systemowe polecenie powiadomień i masz alerty na Macu, Windows i Linux w dowolnym terminalu. Krok po kroku opisuje to poradnik o powiadomieniach, gdy Claude skończy.
Zalety: za darmo, prywatnie, w pełni pod twoją kontrolą, bez sieci. Ograniczenia: nadal tylko na tym komputerze, a na serwerze headless lub przez SSH polecenie desktopowe nie ma pulpitu, na którym mogłoby się pokazać (zobacz powiadomienia przez SSH).
04Własne hooki: push na telefon
Ten sam hook może zamiast tego wywołać usługę push. Popularne opcje:
- ntfy: publikujesz jedną linijką
curldo topicu, a odbierasz w aplikacji ntfy na iPhone lub Android. Za darmo na ntfy.sh, możesz też postawić własny serwer. Zobacz poradnik ntfy. - Pushover: API z darmowym miesięcznym limitem wiadomości i własnymi aplikacjami. Wiadomości mogą mieć maksymalnie 1024 znaki.
- Telegram, Slack lub Discord: bot albo incoming webhook wysyła wiadomość na czat, który i tak śledzisz. Zobacz poradnik dla Telegram, Slack i Discord.
Zalety: dociera na telefon, gdziekolwiek jesteś, tanio albo za darmo, i widzisz dokładnie, co jest wysyłane. Ograniczenia: działa tylko w jedną stronę. Telefon powie ci, że Claude czeka, ale sesja i tak czeka, aż wrócisz do klawiatury. Musisz też zadbać o sekrety (nazwy topiców, tokeny, URL-e webhooków) i zdecydować, kiedy nie wysyłać, bo hook odpala się niezależnie od tego, czy siedzisz przy biurku.
05Remote Control od Anthropic i aplikacja Claude
Remote Control łączy aplikację Claude na iPhone i Android albo claude.ai/code w przeglądarce z sesją Claude Code działającą na twoim komputerze. Widzisz całą rozmowę i możesz w niej pisać, a prompty o uprawnienia i pytania AskUserQuestion trafiają na telefon. Gdy w /config włączysz Push when actions required i Push when Claude decides, aplikacja wysyła powiadomienia push. Pomija je, gdy piszesz w podłączonym terminalu lub masz na nim fokus.
Zalety: rozwiązanie od Anthropic, pełna sesja na telefonie, bez żadnej firmy trzeciej. Ograniczenia (według dokumentacji Anthropic): wymaga planu Pro, Max, Ultra, Team lub Enterprise z logowaniem przez claude.ai, klucze API nie są obsługiwane i nie działa z Amazon Bedrock, Google Cloud Agent Platform, Microsoft Foundry ani z własnym ANTHROPIC_BASE_URL. W planach Team i Enterprise musi to włączyć Owner. Sesję trzeba uruchomić z Remote Control (albo ustawić łączenie przy starcie), a o wysyłce pushy „decides” decyduje Claude; poza dwoma przełącznikami nie ma konfiguracji per zdarzenie.
06Dedykowane narzędzia do powiadomień
Kilka narzędzi bazuje na powyższych hookach i dodaje możliwość odpowiedzi.
- claude-remote-approver to open source'owy (MIT) pakiet npm, który używa hooka
PermissionRequesti ntfy. Każda prośba o uprawnienia staje się powiadomieniem z przyciskami Approve i Deny, a opcjeAskUserQuestionrównież zamieniają się w przyciski. Jeśli w czasie timeoutu (domyślnie 120 sekund) nie przyjdzie odpowiedź, Claude Code wraca do promptu w terminalu. - Pushary to usługa hostowana, którą konfigurujesz przez
npx pushary@latest setup. Instaluje hooki Claude Code, wysyła push, gdy Claude skończy, i pozwala zatwierdzać lub odpowiadać z telefonu. - Claude Code Notifier (nasz) to
ccn, darmowe narzędzie CLI na Maca, Windows i Linux, plus aplikacje na iPhone i Android. Jest niezależny i nie pochodzi od Anthropic.
Inne projekty open source wysyłają alerty do ntfy, Discord albo na pulpit gotowym skryptem. Warto na nie zerknąć, jeśli chcesz DIY bez pisania skryptu.
07Gdzie pasuje Claude Code Notifier
Jeśli wystarczą ci alerty w jedną stronę, dziesięciolinijkowy hook z ntfy albo systemowymi powiadomieniami w zupełności wystarczy i nic nie kosztuje.
Claude Code Notifier jest na moment po alercie. Sam ccn pokazuje powiadomienie na pulpicie na Macu, Windows lub Linux, gdy Claude skończy, potrzebuje uprawnień albo zadaje pytanie. Po sparowaniu telefonu możesz:
- z telefonu zezwolić raz, zezwolić na całą sesję albo odrzucić prośbę o uprawnienia
- wybrać odpowiedź, gdy Claude prosi cię o wybór
- wysłać kolejne polecenie zaraz po tym, jak Claude skończy
Wykrywa też twoją obecność. Jeśli pisałeś w ciągu ostatnich 30 sekund, nic nie czeka: terminal pyta jak zwykle, a telefon dostaje co najwyżej notkę. Jeśli cię nie ma, terminal czeka na odpowiedź z telefonu do ustalonego przez ciebie limitu i przestaje czekać, gdy tylko dotkniesz klawiatury. Ponieważ to hook, działa w każdym terminalu, także w IDE, i nie wymaga włączonego w sesji Remote Control. Aplikacje na telefon wymagają subskrypcji lub zakupu dożywotniego; zobacz cennik. Zainstaluj go ze strony ccn.
08Jak wybrać
- Siedzisz przy komputerze i chcesz tylko szturchnięcia: wbudowane powiadomienie albo hook desktopowy.
- Chcesz, żeby telefon zawibrował, a odpowiesz po powrocie do biurka: ntfy albo webhook czatu.
- Chcesz mieć całą rozmowę na telefonie i logujesz się planem claude.ai: Remote Control.
- Chcesz zatwierdzać, odpowiadać i kontynuować z telefonu, z alertami, które milczą, gdy siedzisz przy klawiaturze: dedykowane narzędzie, np. Claude Code Notifier.
09FAQ
Czy Claude Code ma wbudowane powiadomienia?
Tak. Wysyła powiadomienie na pulpicie w iTerm2, Ghostty i Kitty, a ustawiając preferredNotifChannel na "terminal_bell", dostaniesz dzwonek w każdym terminalu. Dociera to tylko do komputera, na którym działa terminal. Do pushy na telefon Anthropic oferuje Remote Control z aplikacją Claude.
Jak za darmo dostawać powiadomienia Claude Code na telefon?
Hook Notification lub Stop, który wywołuje curl na darmowy topic ntfy, plus aplikacja ntfy na telefonie. W poradniku ntfy znajdziesz konfigurację do skopiowania. Powie ci, że Claude czeka, ale nie pozwoli odpowiedzieć.
Czy mogę zatwierdzać prośby o uprawnienia Claude Code z telefonu?
Tak, przez Remote Control albo narzędzie oparte na hooku PermissionRequest, np. claude-remote-approver lub Claude Code Notifier. Zobacz zatwierdzanie uprawnień z telefonu.
Czy mogę używać kilku z nich naraz?
Tak, hooki z różnych źródeł uruchamiają się wszystkie. Unikaj dwóch narzędzi, które oba odpowiadają na prośby o uprawnienia, i licz się z duplikatami alertów, jeśli dwa narzędzia powiadamiają o tym samym zdarzeniu.