ccn est un petit programme que Claude Code exécute via ses hooks, sur macOS, Windows ou Linux. Installe-le et tu reçois une notification sur le bureau dès que Claude termine, a besoin d’une autorisation ou pose une question. Jumelle ton téléphone quand tu veux : les mêmes moments arrivent alors aussi en push, et tu peux approuver, refuser ou répondre depuis là. Rien ne tourne en arrière-plan, et il fonctionne dans n’importe quel terminal.

tu as un code ? Tu viens de l’app du téléphone avec un code à 6 chiffres ? Va directement à Jumeler ton téléphone : chaque ligne d’installation accepte le code et jumelle dans la foulée. Pas encore d’app ? Installe-la pour iOS ou Android.

01Installer

macOS et Linux

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

Windows (PowerShell)

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

La prise en charge de Windows est en bêta. Les paquets winget et Scoop arrivent.

Homebrew

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

Pour tous ceux qui ont Node.js

npx @touchtap/ccn pair

Chaque ligne installe ccn et ses hooks : la prochaine fois que Claude Code termine ou a besoin de toi, une notification apparaît sur cet ordinateur. Pas besoin de téléphone, et rien ne tourne en arrière-plan. ccn ajoute sept entrées à ~/.claude/settings.json et laisse tout le reste du fichier intact. Tu as un code de l’app du téléphone ? Les lignes sous Jumeler ton téléphone installent et jumellent en une seule fois.

02Jumeler ton téléphone

Le jumelage est facultatif et ne bloque jamais rien : ccn continue de notifier cet ordinateur, qu’un téléphone soit jumelé ou non. Une fois qu’il y en a un, chaque notification arrive aussi sur ton téléphone en push, et tu peux approuver, refuser ou répondre depuis là. Il y a deux façons de jumeler.

Scanner un QR code depuis le terminal

ccn pair

Lance ccn ou ccn pair. Il affiche un QR code et un lien valables 24 heures : scanne le code avec l’appareil photo de ton téléphone, ou ouvre le lien sur le téléphone. Sans l’app, le lien propose d’abord le store ; avec, le téléphone se connecte tout seul. ccn pair --no-wait les affiche et rend la main tout de suite, pour que tu continues à travailler et scannes plus tard.

Saisir le code de l’app

ccn pair 482913

Ouvre Claude Code Notifier sur ton téléphone et ajoute un ordinateur. L’app affiche un code à 6 chiffres et la commande exacte à lancer, avec le code déjà dedans. Si ccn est installé, ccn pair suivi du code suffit. Sinon, chaque ligne d’installation accepte le code et installe et jumelle en une seule fois :

InstallationLigne à lancer

macOS et Linuxcurl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913

Windows (PowerShell)irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913

Homebrewbrew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913

Pour tous ceux qui ont Node.jsnpx @touchtap/ccn pair 482913

Remplace 482913 par le code affiché sur ton téléphone. Les codes durent 24 heures ; l’app en génère un nouveau quand il expire.

Après dix notifications sur le bureau sans téléphone jumelé, ccn ajoute une ligne qui suggère ccn pair. ccn config set pair_nudges off la désactive.

03Ce que tu obtiens

Seul, ccn affiche une notification sur cet ordinateur quand Claude termine, a besoin d’une autorisation ou pose une question. Avec un téléphone jumelé, tu obtiens aussi :

Claude a terminé : une notification push dès qu’un tour se termine.
Autorisations : autoriser une fois, autoriser pour la session ou refuser, depuis le téléphone.
Questions : choisis une réponse quand Claude te demande de trancher.
Une consigne : juste après la fin de Claude, envoie la suivante depuis le téléphone.

Si tu as tapé au clavier dans les 30 dernières secondes, rien n’attend : le terminal pose sa question comme d’habitude et le téléphone reçoit une note. Si tu es absent, le terminal attend ton téléphone, et cesse d’attendre dès que tu touches le clavier. Tu peux régler les délais de chaque ordinateur dans l’app.

04Commandes

CommandeCe qu’elle fait

ccn pairAffiche un QR code et un lien pour jumeler un téléphone (valables 24 heures) et attend

ccn pair CODEJumelle avec le code à 6 chiffres de l’app

ccn pair --no-waitAffiche le QR code et le lien, puis rend la main tout de suite

ccn doctorVérifie les hooks, le jumelage et la connexion

ccn testEnvoie une notification de test

ccn devicesListe les téléphones jumelés, ou en révoque un

ccn config showAffiche les réglages de cet ordinateur

ccn config set pair_nudges offDésactive la suggestion de jumelage après les notifications sur le bureau

ccn syncRécupère maintenant les réglages modifiés sur le téléphone

ccn upgradeMet ccn à jour vers la dernière version maintenant

ccn config set auto_update offDésactive la vérification quotidienne des mises à jour

ccn unlockAchète une licence et déverrouille cet ordinateur (voir Licence)

05Licence

Une licence achetée sur claudecodenotifier.com/licence débloque chaque téléphone jumelé avec jusqu’à 3 ordinateurs. Elle est liée à l’ordinateur : tu saisis la clé dans ccn, jamais dans l’app du téléphone.

ccn unlockAchète une licence dans le navigateur et déverrouille cet ordinateur (--lifetime pour payer une fois)

ccn activate KEYUtilise ta clé sur cet ordinateur (--replace NAME libère l’emplacement d’un autre ordinateur)

ccn deactivateLibère l’emplacement de cet ordinateur pour utiliser la clé ailleurs

ccn licenceAffiche l’offre, la date de renouvellement et les ordinateurs qui utilisent la clé

Sans licence, ccn peut afficher une ligne par jour dans Claude Code, et une notification sur le bureau, pour expliquer comment déverrouiller. CCN_NO_NUDGE=1 les désactive.

06Mises à jour

ccn upgrade

ccn se tient à jour tout seul : une fois par jour, il vérifie en arrière-plan s’il existe une nouvelle version et l’installe. ccn upgrade met à jour tout de suite, et ccn config set auto_update off désactive la vérification quotidienne. Si tu l’as installé avec Homebrew ou npm, ccn laisse la mise à jour à ton gestionnaire de paquets et t’indique la commande à lancer.

07L’app Mac

L’app Claude Code Notifier de la barre des menus Mac fonctionne toujours, et elle est gratuite. Si tu préfères une app à un terminal, télécharge-la ou lance brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier. Contrairement à ccn, elle peut déclencher des webhooks, et elle nécessite iTerm2, kitty ou tmux pour répondre depuis le téléphone. Ne lance pas les deux sur le même Mac, sinon chaque notification arrive en double. Pour passer de l’app à ccn, jumelle avec ccn pair CODE --replace-mac-app, qui supprime les hooks de l’app, puis quitte l’app.

08Désinstaller

ccn uninstall

Cela retire les hooks de settings.json, révoque les jumelages et supprime l’état local. Supprime ensuite le binaire : ~/.local/bin/ccn sur macOS et Linux, %LOCALAPPDATA%\Programs\ccn sur Windows, ou brew uninstall ccn.

ccn forget

Supprime cet ordinateur du serveur relais et retire ccn.