ccn ist ein kleines Programm, das Claude Code über seine Hooks aufruft, auf macOS, Windows oder Linux. Installiere es, und du bekommst eine Desktop-Mitteilung, sobald Claude fertig ist, eine Berechtigung braucht oder eine Frage stellt. Koppel dein Handy, wann du willst, dann kommen dieselben Momente auch als Push an, und du kannst dort genehmigen, ablehnen oder antworten. Im Hintergrund läuft nichts, und es funktioniert in jedem Terminal.
01Installieren
macOS und Linux
curl -fsSL https://claudecodenotifier.com/web/install.sh | sh
Windows (PowerShell)
irm https://claudecodenotifier.com/web/install.ps1 | iex
Windows-Unterstützung ist in der Beta. Pakete für winget und Scoop kommen bald.
Homebrew
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn
Für alle mit Node.js
npx @touchtap/ccn pair
Jede Zeile installiert ccn und seine Hooks. Wenn Claude Code das nächste Mal fertig ist oder dich braucht, erscheint eine Mitteilung auf diesem Computer. Ein Handy ist nicht nötig, und im Hintergrund läuft nichts. ccn fügt sieben Einträge in ~/.claude/settings.json ein, alles andere in der Datei bleibt unverändert. Hast du einen Code aus der Handy-App? Die Zeilen unter Handy koppeln installieren und koppeln in einem Rutsch.
02Handy koppeln
Das Koppeln ist optional und hält nichts auf: ccn benachrichtigt diesen Computer weiter, ob ein Handy gekoppelt ist oder nicht. Sobald eines gekoppelt ist, kommt jede Mitteilung zusätzlich als Push auf dein Handy, und du kannst von dort genehmigen, ablehnen oder antworten. Es gibt zwei Wege zum Koppeln.
QR-Code aus dem Terminal scannen
ccn pair
Führe ccn oder ccn pair aus. Es zeigt einen QR-Code und einen Link, die 24 Stunden gültig bleiben: Scanne den Code mit der Kamera deines Handys oder öffne den Link auf dem Handy. Ohne App führt der Link zuerst in den Store; mit App verbindet sich das Handy von selbst. ccn pair --no-wait zeigt beides an und kehrt sofort zurück, sodass du weiterarbeiten und später scannen kannst.
Den Code aus der App eingeben
ccn pair 482913
Öffne Claude Code Notifier auf deinem Handy und füge einen Computer hinzu. Die App zeigt einen 6-stelligen Code und die genaue Zeile zum Ausführen, mit dem Code schon darin. Ist ccn installiert, reicht ccn pair gefolgt vom Code. Andernfalls nimmt jede Installationszeile den Code und installiert und koppelt in einem Rutsch:
curl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913npx @touchtap/ccn pair 482913Ersetze 482913 durch den Code auf deinem Handy. Codes gelten 24 Stunden; danach erzeugt die App einen neuen.
Nach zehn Desktop-Mitteilungen ohne gekoppeltes Handy ergänzt ccn eine Zeile, die ccn pair vorschlägt. ccn config set pair_nudges off schaltet sie ab.
03Das bekommst du
Für sich allein zeigt ccn eine Mitteilung auf diesem Computer, wenn Claude fertig ist, eine Berechtigung braucht oder eine Frage stellt. Mit einem gekoppelten Handy bekommst du zusätzlich:
- Claude ist fertig: eine Push-Benachrichtigung, sobald ein Durchlauf endet.
- Berechtigungen: einmal erlauben, für die Sitzung erlauben oder ablehnen, direkt vom Handy.
- Fragen: wähle eine Antwort, wenn Claude dich um eine Entscheidung bittet.
- Eine Anschlussanweisung: gleich nachdem Claude fertig ist, schickst du vom Handy die nächste Anweisung.
Hast du in den letzten 30 Sekunden getippt, wartet nichts: Das Terminal fragt wie gewohnt und das Handy bekommt einen Hinweis. Bist du weg, wartet das Terminal auf dein Handy und hört auf, sobald du die Tastatur berührst. Die Zeiten kannst du für jeden Computer in der App ändern.
04Befehle
ccn pairQR-Code und Link zum Koppeln eines Handys zeigen (24 Stunden gültig) und darauf wartenccn pair CODEMit dem 6-stelligen Code aus der App koppelnccn pair --no-waitQR-Code und Link ausgeben und sofort zurückkehrenccn doctorHooks, Kopplung und Verbindung prüfenccn testEine Testbenachrichtigung sendenccn devicesGekoppelte Handys auflisten oder eines entfernenccn config showDie Einstellungen dieses Computers anzeigenccn config set pair_nudges offDen Koppel-Vorschlag nach Desktop-Mitteilungen abschaltenccn syncAm Handy geänderte Einstellungen jetzt abrufenccn upgradeccn jetzt auf die neueste Version aktualisierenccn config set auto_update offDie tägliche Update-Prüfung abschaltenccn unlockEine Lizenz kaufen und diesen Computer freischalten (siehe Lizenz)05Lizenz
Eine Lizenz von claudecodenotifier.com/licence schaltet jedes Handy frei, das mit bis zu 3 Computern gekoppelt ist. Sie gehört zum Computer: Du gibst den Schlüssel in ccn ein, nie in die Handy-App.
ccn unlockLizenz im Browser kaufen und diesen Computer freischalten (--lifetime für den Einmalkauf)ccn activate KEYDeinen Schlüssel auf diesem Computer nutzen (--replace NAME gibt den Platz eines anderen Computers frei)ccn deactivateDen Platz dieses Computers freigeben, damit der Schlüssel woanders nutzbar istccn licencePlan, Verlängerungsdatum und die Computer mit diesem Schlüssel anzeigenOhne Lizenz zeigt ccn eventuell einmal am Tag eine Zeile in Claude Code und eine Desktop-Mitteilung, wie du freischaltest. CCN_NO_NUDGE=1 schaltet das ab.
06Updates
ccn upgrade
ccn hält sich selbst aktuell: Einmal am Tag prüft es im Hintergrund, ob es eine neue Version gibt, und installiert sie. ccn upgrade aktualisiert sofort, und ccn config set auto_update off schaltet die tägliche Prüfung ab. Hast du mit Homebrew oder npm installiert, überlässt ccn das Aktualisieren deinem Paketmanager und nennt dir den Befehl dafür.
07Die Mac-App
Die Mac-Menüleisten-App von Claude Code Notifier funktioniert weiterhin und ist kostenlos. Wenn du eine App einem Terminal vorziehst, lade sie oder führe brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier aus. Anders als ccn kann sie Webhooks auslösen, und sie braucht iTerm2, kitty oder tmux, um vom Handy aus zu antworten. Betreibe nicht beide auf demselben Mac, sonst kommt jede Mitteilung doppelt an. Zum Wechsel von der App zu ccn koppelst du mit ccn pair CODE --replace-mac-app, was die Hooks der App entfernt, und beendest danach die App.
08Deinstallieren
ccn uninstall
Das entfernt die Hooks aus settings.json, hebt die Kopplungen auf und löscht den lokalen Status. Lösche danach die Programmdatei: ~/.local/bin/ccn auf macOS und Linux, %LOCALAPPDATA%\Programs\ccn auf Windows oder brew uninstall ccn.
ccn forget
Löscht diesen Computer vom Relay-Server und entfernt ccn.