Smartphone mit Claude Code verbinden (Mac, Windows, Linux)

Q: Ändert das Koppeln meine Claude Code-Einstellungen?

Bei der Installation fügt ccn sieben Hook-Einträge zu ~/.claude/settings.json hinzu, lässt alles andere unverändert und legt einmalig ein Backup daneben ab. Das Koppeln selbst verbindet nur das Handy. ccn uninstall entfernt die Hooks, Kopplungen und den lokalen Zustand.

Q: Wie entkopple ich ein Handy?

Mit ccn devices siehst du die gekoppelten Handys, danach führst du ccn devices revoke aus. ccn forget löscht zusätzlich den Computer vom Server.

Um dein Smartphone mit Claude Code zu verbinden, installierst du die App Claude Code Notifier auf deinem iPhone oder Android-Smartphone und das kostenlose Kommandozeilen-Tool ccn auf deinem Computer und koppelst beide. Führ ccn pair aus und scann den angezeigten QR-Code, oder öffne in der App Computer > Computer hinzufügen und führ ccn pair mit dem dort angezeigten 6-stelligen Code aus. Das funktioniert auf Mac, Windows und Linux gleich und dauert etwa eine Minute.

01Was dir das Koppeln bringt

Sobald ein Smartphone gekoppelt ist, kann Claude Code dich erreichen, wenn es dich braucht:

Eine Push-Nachricht „Claude ist fertig“, sobald ein Turn endet.
Berechtigungsanfragen, die du einmal erlauben, für die Session erlauben oder ablehnen kannst.
Fragen, die du per Auswahl einer Option beantwortest.
Eine Folgeanweisung, die du direkt nach dem Abschluss von Claude schicken kannst.

Schon vor dem Koppeln zeigt ccn für dieselben Momente Desktop-Benachrichtigungen auf dem Computer an. Das Koppeln fügt das Smartphone hinzu.

Claude Code Notifier ist ein unabhängiges Tool von TouchTap Ltd. Es stammt nicht von Anthropic und ist nicht mit Anthropic verbunden. Es arbeitet über die Hooks von Claude Code und deckt so jede claude-Session in jedem Terminal ab, auch in den Terminals von VS Code, Cursor und JetBrains-IDEs.

02Bevor du loslegst

Du brauchst:

Claude Code, installiert und lauffähig auf dem Computer.
Die App Claude Code Notifier auf deinem Smartphone, aus dem App Store oder von Google Play. Scannst du den QR-Code zuerst ohne App, bietet dir dein Smartphone den Store an.
Eine Netzwerkverbindung auf beiden Geräten.

Der Download der App ist kostenlos, für die Nutzung brauchst du ein Abo oder einen Lifetime-Kauf. Für das Jahresabo gibt es eine kostenlose Testphase. Siehe Preise.

03Zwei Wege zum Koppeln

Es gibt zwei Wege. Beide führen zum gleichen Ergebnis, nimm also einfach den bequemeren.

WegStart aufIdeal, wenn

QR-Codedem Computerdu den Bildschirm des Computers vor dir hast

6-stelliger CodeDas SmartphoneDu arbeitest auf einem Remote-Rechner, per SSH, oder der QR-Code lässt sich nicht scannen

QR-Links und 6-stellige Codes sind jeweils 24 Stunden gültig.

04Weg 1: QR-Code scannen

Auf dem Mac oder unter Linux

Öffne ein Terminal und installiere ccn:

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

Oder mit Homebrew:

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

Führe ccn (oder ccn pair) aus. Falls nötig, werden die Hooks installiert, danach erscheinen ein QR-Code und ein Link.
Richte die Kamera deines Smartphones auf den QR-Code und öffne den Link. Ist die App installiert, öffnet sie sich und koppelt das Gerät. Falls nicht, bietet dir das Smartphone zuerst den App Store bzw. Google Play an; installiere die App, dann geht das Pairing einfach weiter.
Das Terminal bestätigt, dass dein Smartphone gekoppelt ist.

Unter Windows

Öffne PowerShell und installiere ccn (die Unterstützung für Windows ist noch in der Beta):

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

Führe ccn pair aus. PowerShell zeigt einen QR-Code und einen Link an.
Scanne ihn wie oben beschrieben mit der Kamera deines Smartphones.
PowerShell bestätigt, dass dein Smartphone gekoppelt ist.

Mit Node.js oder als Plugin, auf jedem Betriebssystem

Wenn du Node.js hast, installierst du damit alles und startest direkt das Pairing:

npx @touchtap/ccn

Oder du installierst es direkt in Claude Code als Plugin und führst den Setup-Befehl aus:

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

05Weg 2: 6-stelligen Code eingeben

Dieser Weg startet auf dem Smartphone. Praktisch, wenn du den Bildschirm des Computers schlecht siehst oder Claude Code auf einem Server läuft, den du per SSH erreichst.

Öffne die App Claude Code Notifier und geh zu Computers > Add a computer.
Die App zeigt dir einen 6-stelligen Code und genau die Zeile, die du für dein Betriebssystem ausführen musst.
Führe diese Zeile auf dem Computer aus. Ist ccn schon installiert, reicht einfach:

ccn pair 482913

Ersetze 482913 durch deinen eigenen Code.

Installieren und koppeln in einer Zeile

Jede Installationszeile nimmt den Code direkt mit, ein neuer Computer braucht also nur einen einzigen Befehl.

Auf dem Mac oder unter Linux:

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

Unter Windows in PowerShell:

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

Als Claude Code-Plugin übergibst du den Code an den Setup-Befehl: /ccn:setup 482913.

06Prüfen, ob es funktioniert

Mit zwei Befehlen prüfst du, ob alles eingerichtet ist:

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

Dann probier es richtig aus: Starte claude, gib ihm eine kleine Aufgabe und geh weg von der Tastatur. Sobald es fertig ist, bekommt dein Smartphone einen Push.

Beachte: ccn merkt, wenn du am Computer sitzt. Hast du in den letzten 30 Sekunden getippt, erscheinen Berechtigungsabfragen und Fragen wie gewohnt im Terminal, und das Smartphone bekommt höchstens einen Hinweis. Geh kurz weg, dann übernimmt das Smartphone.

07Mehrere Geräte koppeln

Mehrere Computer, ein Smartphone. Wiederhole die Schritte auf jedem Computer. Dein Arbeits-Mac, dein Linux-Rechner zu Hause und dein Windows-Laptop können alle dasselbe Smartphone erreichen. Unter Mehrere Claude Code-Sessions ausführen erfährst du, wie du sie auseinanderhältst.
Mehrere Smartphones, ein Computer. Koppel jedes Smartphone mit demselben Computer.
Smartphones anzeigen oder entfernen. ccn devices listet gekoppelte Smartphones auf, ccn devices revoke <name> entfernt eines.

08Skripte und Remote-Rechner

ccn pair --no-wait gibt den QR-Code aus und kehrt sofort zurück, ideal für Skripte und Provisioning. Auf einem Server per SSH ist der Weg mit dem 6-stelligen Code meist am einfachsten, weil du den Code in derselben SSH-Session eingibst, in der du auch Claude Code nutzt. Den Rest der Einrichtung findest du unter Benachrichtigungen von Claude Code auf einem Remote-Server per SSH.

09Wenn das Pairing nicht klappt

Der Code wurde abgelehnt. Codes sind 24 Stunden gültig. Erstell in der App einen neuen oder nutz den Weg über den QR-Code.
Der QR-Code lässt sich nicht scannen. Mach das Terminal-Fenster größer oder öffne stattdessen den angezeigten Link auf deinem Handy.
ccn wird nach der Installation nicht gefunden. Öffne ein neues Terminal, damit dein PATH aktualisiert wird.
Gekoppelt, aber es kommt kein Push an. Führ ccn doctor und danach ccn test aus und prüf in den Einstellungen deines Handys, ob Benachrichtigungen für die App erlaubt sind.

Die vollständige Liste findest du unter Claude Code-Benachrichtigungen funktionieren nicht? Eine Checkliste.

10Noch nicht bereit zum Koppeln?

Kein Problem. Desktop-Benachrichtigungen funktionieren, sobald ccn installiert ist. Solange kein Handy gekoppelt ist, schlägt ccn gelegentlich ccn pair vor. So schaltest du die Hinweise ab:

ccn config set pair_nudges off

11FAQ

Brauche ich zum Koppeln einen Account?

Nein. Claude Code Notifier hat keine Accounts. Beim Koppeln werden Computer und Handy ohne Registrierung verbunden. Benachrichtigungen laufen über ein verschlüsseltes Relay und werden innerhalb von 48 Stunden gelöscht. Mehr dazu in der Datenschutzerklärung.

Wie lange ist ein Kopplungscode gültig?

Sowohl der 6-stellige Code aus der App als auch der QR-Link von ccn pair sind 24 Stunden gültig. Danach erstellst du einfach einen neuen.

Kann ich einen Computer ohne Bildschirm koppeln?

Ja. Nimm den Weg über den 6-stelligen Code: Öffne in der App Computer > Computer hinzufügen und führ auf dem Rechner ccn pair mit dem Code aus, zum Beispiel per SSH.

Ändert das Koppeln meine Claude Code-Einstellungen?

Bei der Installation fügt ccn sieben Hook-Einträge zu ~/.claude/settings.json hinzu, lässt alles andere unverändert und legt einmalig ein Backup daneben ab. Das Koppeln selbst verbindet nur das Handy. ccn uninstall entfernt die Hooks, Kopplungen und den lokalen Zustand.

Wie entkopple ich ein Handy?

Mit ccn devices siehst du die gekoppelten Handys, danach führst du ccn devices revoke <name> aus. ccn forget löscht zusätzlich den Computer vom Server.

Claude Code Notifier Bekomm einen Push aufs Handy, wenn Claude Code fertig ist oder dich braucht, und genehmige, lehne ab oder antworte direkt von dort. Das Kommandozeilentool ccn ist kostenlos für Mac, Windows und Linux.

Für iOS laden Für Android laden ccn installieren