Koppel je telefoon aan Claude Code op Mac, Windows of Linux

01Wat koppelen je oplevert

Zodra je telefoon gekoppeld is, kan Claude Code je bereiken als het je nodig heeft:

• Een push "Claude is klaar" zodra een beurt eindigt.
• Permission requests die je eenmalig of voor de hele sessie kunt toestaan, of kunt weigeren.
• Vragen die je beantwoordt door een optie te kiezen.
• Een vervolginstructie die je direct kunt sturen nadat Claude klaar is.

Ook vóór het koppelen toont ccn al desktopmeldingen op de computer voor dezelfde momenten. Koppelen voegt je telefoon toe.

Claude Code Notifier is een onafhankelijke tool van TouchTap Ltd. Hij is niet gemaakt door en niet verbonden aan Anthropic. Hij werkt via de hooks van Claude Code, dus hij dekt elke claude-sessie in elke terminal, ook de terminals in VS Code, Cursor en JetBrains-IDE's.

02Voordat je begint

Je hebt nodig:

• Claude Code, geïnstalleerd en werkend op de computer.
• De Claude Code Notifier-app op je telefoon, uit de App Store of Google Play. Scan je de QR-code zonder dat de app erop staat, dan stuurt je telefoon je naar de store.
• Een netwerkverbinding op beide apparaten.

De app is gratis te downloaden; voor gebruik heb je een abonnement of een lifetime-aankoop nodig, met een gratis proefperiode bij het jaarabonnement. Zie prijzen.

03Twee manieren om te koppelen

Er zijn twee routes. Ze komen op hetzelfde uit, dus kies wat jou het makkelijkst lijkt.

QR-links en 6-cijferige codes zijn allebei 24 uur geldig.

04Route 1: scan een QR-code

Op Mac of Linux

1. Open een terminal en installeer ccn:

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

Of met Homebrew:

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

2. Voer ccn (of ccn pair) uit. Het installeert zo nodig de hooks en toont een QR-code en een link.
3. Richt de camera van je telefoon op de QR-code en open de link. Is de app geïnstalleerd, dan opent die en wordt de koppeling gemaakt. Zo niet, dan stuurt je telefoon je eerst naar de App Store of Google Play; installeer de app en het koppelen gaat gewoon verder.
4. De terminal bevestigt dat de telefoon gekoppeld is.

Op Windows

1. Open PowerShell en installeer ccn (ondersteuning voor Windows is in bèta):

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

2. Voer ccn pair uit. PowerShell toont een QR-code en een link.
3. Scan die met de camera van je telefoon, zoals hierboven.
4. PowerShell bevestigt dat de telefoon gekoppeld is.

Met Node.js of als plugin, op elk OS

Heb je Node.js, dan installeer je hiermee en start je het koppelen in één keer:

npx @touchtap/ccn

Of installeer het vanuit Claude Code als plugin en voer het setup-commando uit:

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

05Route 2: typ een 6-cijferige code

Deze route begin je op de telefoon. Handig als je het scherm van de computer slecht kunt zien, of als Claude Code draait op een server die je via SSH bereikt.

1. Open de Claude Code Notifier-app en ga naar Computers > Add a computer.
2. De app toont een 6-cijferige code en precies de regel die je voor jouw besturingssysteem moet uitvoeren.
3. Voer die regel uit op de computer. Is ccn al geïnstalleerd, dan is het gewoon:

ccn pair 482913

Vervang 482913 door je eigen code.

Installeren en koppelen in één regel

Elke installatieregel accepteert de code, dus op een nieuwe computer heb je maar één commando nodig.

Op Mac of Linux:

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

Op Windows, in PowerShell:

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

Als Claude Code-plugin geef je de code mee aan het setup-commando: /ccn:setup 482913.

06Controleer of het werkt

Met twee commando's check je of alles goed staat:

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

Probeer het daarna echt. Start claude, geef een kleine taak en loop weg van je toetsenbord. Als het klaar is, krijg je een push op je telefoon.

Let op: ccn merkt wanneer je achter de computer zit. Heb je in de laatste 30 seconden getypt, dan verschijnen permission prompts en vragen gewoon in de terminal en krijgt je telefoon hooguit een melding. Loop weg om de telefoon het te laten overnemen.

07Meer dan één apparaat koppelen

• Meerdere computers, één telefoon. Herhaal de stappen op elke computer. Je Mac op het werk, je Linux-machine thuis en je Windows-laptop kunnen allemaal dezelfde telefoon bereiken. In Meerdere Claude Code-sessies draaien lees je hoe je ze uit elkaar houdt.
• Meerdere telefoons, één computer. Koppel elke telefoon aan dezelfde computer.
• Telefoons bekijken of verwijderen. ccn devices toont gekoppelde telefoons en ccn devices revoke <name> verwijdert er een.

08Scripts en remote machines

ccn pair --no-wait toont de QR-code en stopt meteen, handig voor scripts en provisioning. Op een server via SSH is de 6-cijferige route meestal het makkelijkst, omdat je de code intypt in dezelfde SSH-sessie die je voor Claude Code gebruikt. Notificaties van Claude Code op een remote server via SSH behandelt de rest van die setup.

09Als koppelen niet lukt

• De code werd geweigerd. Codes zijn 24 uur geldig. Maak een nieuwe aan in de app, of gebruik de QR-route.
• De QR-code wil niet scannen. Maak het terminalvenster groter, of open de getoonde link op je telefoon.
• ccn wordt niet gevonden na installatie. Open een nieuwe terminal zodat je PATH wordt bijgewerkt.
• Gekoppeld, maar er komt geen push binnen. Voer ccn doctor uit en daarna ccn test, en controleer in de instellingen van je telefoon of meldingen voor de app zijn toegestaan.

De volledige lijst vind je in Werken je Claude Code-meldingen niet? Een checklist.

10Nog niet klaar om te koppelen?

Geen probleem. Desktopmeldingen werken zodra ccn is geïnstalleerd. Zolang er geen telefoon gekoppeld is, stelt ccn af en toe ccn pair voor. Zo zet je die suggesties uit:

ccn config set pair_nudges off

11FAQ