Połącz telefon z Claude Code na Macu, Windows lub Linux

01Co daje parowanie

Po sparowaniu telefonu Claude Code może cię złapać, gdy cię potrzebuje:

• Push „Claude skończył” w chwili zakończenia tury.
• Prośby o uprawnienia, na które możesz zezwolić raz, na całą sesję albo odmówić.
• Pytania, na które odpowiadasz, wybierając opcję.
• Kolejne polecenie, które możesz wysłać zaraz po tym, jak Claude skończy.

Jeszcze przed parowaniem ccn pokazuje na komputerze powiadomienia w tych samych momentach. Parowanie dokłada do tego telefon.

Claude Code Notifier to niezależne narzędzie stworzone przez TouchTap Ltd. Nie jest tworzone przez Anthropic ani z nim powiązane. Działa przez hooki Claude Code, więc obejmuje każdą sesję claude w dowolnym terminalu, także w terminalach wbudowanych w VS Code, Cursor i IDE JetBrains.

02Zanim zaczniesz

Potrzebujesz:

• Zainstalowanego i działającego Claude Code na komputerze.
• Aplikacji Claude Code Notifier na telefonie, z App Store lub Google Play. Jeśli zeskanujesz kod QR bez aplikacji, telefon sam zaproponuje sklep.
• Połączenia z siecią na obu urządzeniach.

Aplikację pobierzesz za darmo, a do korzystania potrzebujesz subskrypcji lub zakupu dożywotniego; plan roczny ma darmowy okres próbny. Zobacz cennik.

03Dwa sposoby parowania

Są dwie drogi. Obie prowadzą do tego samego, więc wybierz wygodniejszą.

Linki z kodów QR i 6-cyfrowe kody są ważne 24 godziny.

04Sposób 1: zeskanuj kod QR

Na Macu lub Linux

1. Otwórz terminal i zainstaluj ccn:

curl -fsSL https://claudecodenotifier.com/install.sh | sh

Albo przez Homebrew:

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn

2. Uruchom ccn (lub ccn pair). W razie potrzeby zainstaluje hooki, a potem wyświetli kod QR i link.
3. Skieruj aparat telefonu na kod QR i otwórz link. Jeśli masz zainstalowaną aplikację, otworzy się i sparuje. Jeśli nie, telefon najpierw zaproponuje App Store lub Google Play; zainstaluj aplikację, a parowanie będzie kontynuowane.
4. Terminal potwierdzi, że telefon jest sparowany.

Na Windows

1. Otwórz PowerShell i zainstaluj ccn (obsługa Windows jest w wersji beta):

irm https://claudecodenotifier.com/install.ps1 | iex

2. Uruchom ccn pair. PowerShell wyświetli kod QR i link.
3. Zeskanuj go aparatem telefonu, tak jak wyżej.
4. PowerShell potwierdzi, że telefon jest sparowany.

Przez Node.js lub jako plugin, na dowolnym systemie

Jeśli masz Node.js, to polecenie za jednym zamachem instaluje i rozpoczyna parowanie:

npx @touchtap/ccn

Możesz też zainstalować go jako plugin w Claude Code i uruchomić jego polecenie konfiguracyjne:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05Sposób 2: wpisz 6-cyfrowy kod

Ten sposób zaczyna się na telefonie. Przydaje się, gdy słabo widzisz ekran komputera albo gdy Claude Code działa na serwerze, do którego łączysz się przez SSH.

1. Otwórz aplikację Claude Code Notifier i przejdź do Komputery > Dodaj komputer.
2. Aplikacja pokaże 6-cyfrowy kod i dokładne polecenie do uruchomienia na twoim systemie.
3. Uruchom to polecenie na komputerze. Jeśli masz już zainstalowane ccn, wystarczy:

ccn pair 482913

Zamiast 482913 wpisz swój kod.

Instalacja i parowanie jednym poleceniem

Każde polecenie instalacyjne przyjmuje kod, więc na nowym komputerze wystarczy jedno polecenie.

Na Macu lub Linux:

curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913

Na Windows, w PowerShell:

irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913

Jako plugin Claude Code – przekaż kod do polecenia konfiguracyjnego: /ccn:setup 482913.

06Sprawdź, czy działa

Dwa polecenia potwierdzą, że wszystko jest na miejscu:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

Potem sprawdź to w praktyce. Uruchom claude, daj mu małe zadanie i odejdź od klawiatury. Gdy skończy, dostaniesz push na telefon.

Pamiętaj, że ccn wykrywa, kiedy siedzisz przy komputerze. Jeśli pisałeś coś w ciągu ostatnich 30 sekund, prośby o uprawnienia i pytania pojawią się jak zwykle w terminalu, a telefon dostanie co najwyżej krótką informację. Odejdź od komputera, a telefon przejmie pałeczkę.

07Parowanie kilku urządzeń

• Kilka komputerów, jeden telefon. Powtórz kroki na każdym komputerze. Służbowy Mac, domowy Linux i laptop z Windows mogą wysyłać powiadomienia na ten sam telefon. Praca z kilkoma sesjami Claude Code wyjaśnia, jak je odróżnić.
• Kilka telefonów, jeden komputer. Sparuj każdy telefon z tym samym komputerem.
• Podgląd i usuwanie telefonów. ccn devices wyświetla sparowane telefony, a ccn devices revoke <name> usuwa wybrany.

08Skrypty i zdalne maszyny

ccn pair --no-wait wyświetla kod QR i od razu kończy działanie, co sprawdza się w skryptach i przy provisioningu. Na serwerze przez SSH zwykle najprościej użyć 6-cyfrowego kodu, bo wpisujesz go w tej samej sesji SSH, w której używasz Claude Code. Resztę konfiguracji opisuje Powiadomienia z Claude Code na zdalnym serwerze przez SSH.

09Jeśli parowanie nie działa

• Kod został odrzucony. Kody są ważne 24 godziny. Wygeneruj nowy w aplikacji albo użyj kodu QR.
• Kod QR się nie skanuje. Powiększ okno terminala albo otwórz wyświetlony link na telefonie.
• Po instalacji nie można znaleźć ccn. Otwórz nowy terminal, żeby zaktualizował się PATH.
• Sparowano, ale push nie przychodzi. Uruchom ccn doctor, potem ccn test, i sprawdź w ustawieniach telefonu, czy aplikacja ma zezwolenie na powiadomienia.

Pełną listę znajdziesz w artykule Powiadomienia Claude Code nie działają? Lista kontrolna.

10Nie chcesz jeszcze parować?

Nie ma problemu. Powiadomienia na pulpicie działają od razu po zainstalowaniu ccn. Dopóki nie sparujesz telefonu, ccn od czasu do czasu podpowie ccn pair. Żeby wyłączyć te podpowiedzi:

ccn config set pair_nudges off

11FAQ