ccn es un pequeño programa que Claude Code ejecuta mediante sus hooks, en macOS, Windows o Linux. Instálalo y recibirás una notificación en el escritorio en cuanto Claude termine, necesite un permiso o haga una pregunta. Vincula el móvil cuando quieras y esos mismos momentos llegarán también como notificación push, desde donde podrás aprobar, denegar o responder. No queda nada ejecutándose en segundo plano y funciona en cualquier terminal.

¿tienes un código? ¿Vienes de la app del móvil con un código de 6 dígitos? Salta a Vincular el móvil: cada línea de instalación acepta el código y vincula de paso. ¿Aún no tienes la app? Consíguela para iOS o Android.

01Instalar

macOS y Linux

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

Windows (PowerShell)

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

La compatibilidad con Windows está en beta. Los paquetes para winget y Scoop están en camino.

Homebrew

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

Para quien tenga Node.js

npx @touchtap/ccn pair

Cada línea instala ccn y sus hooks, así que la próxima vez que Claude Code termine o te necesite aparecerá una notificación en este ordenador. No hace falta móvil y nada queda en segundo plano. ccn añade siete entradas a ~/.claude/settings.json y deja todo lo demás de ese archivo como estaba. ¿Tienes un código de la app del móvil? Las líneas de Vincular el móvil instalan y vinculan de una vez.

02Vincular el móvil

Vincular es opcional y nunca bloquea nada: ccn sigue avisando en este ordenador haya o no un móvil vinculado. Cuando lo haya, cada notificación llegará también al móvil como push, y podrás aprobar, denegar o responder desde ahí. Hay dos formas de vincular.

Escanear un código QR desde la terminal

ccn pair

Ejecuta ccn o ccn pair. Muestra un código QR y un enlace válidos durante 24 horas: escanea el código con la cámara del móvil o abre el enlace en el móvil. Sin la app, el enlace ofrece primero la tienda; con ella, el móvil se conecta solo. ccn pair --no-wait los muestra y vuelve al instante, para que sigas trabajando y escanees más tarde.

Escribir el código de la app

ccn pair 482913

Abre Claude Code Notifier en el móvil y añade un ordenador. La app muestra un código de 6 dígitos y la línea exacta que debes ejecutar, con el código ya incluido. Si ccn está instalado, basta con ccn pair seguido del código. Si no, cada línea de instalación acepta el código e instala y vincula de una vez:

InstaladorLínea a ejecutar

macOS y 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

Para quien tenga Node.jsnpx @touchtap/ccn pair 482913

Sustituye 482913 por el código de tu móvil. Los códigos duran 24 horas; la app genera uno nuevo cuando caduca.

Tras diez notificaciones en el escritorio sin móvil vinculado, ccn añade una línea sugiriendo ccn pair. ccn config set pair_nudges off la desactiva.

03Qué obtienes

Por sí solo, ccn muestra una notificación en este ordenador cuando Claude termina, necesita un permiso o hace una pregunta. Con un móvil vinculado, además obtienes:

Claude ha terminado: una notificación push en cuanto acaba un turno.
Permisos: permitir una vez, permitir en la sesión o denegar, desde el móvil.
Preguntas: elige una respuesta cuando Claude te pida decidir.
Un seguimiento: justo después de que Claude termine, envía la siguiente instrucción desde el móvil.

Si has escrito en los últimos 30 segundos, nada espera: la terminal pregunta como siempre y el móvil recibe un aviso. Si no estás, la terminal espera a tu móvil y deja de esperar en cuanto tocas el teclado. Puedes cambiar los tiempos de cada ordenador en la app.

04Comandos

ComandoQué hace

ccn pairMuestra un código QR y un enlace para vincular un móvil (válidos 24 horas) y espera

ccn pair CODEVincula con el código de 6 dígitos de la app

ccn pair --no-waitMuestra el código QR y el enlace y vuelve al instante

ccn doctorComprueba los hooks, la vinculación y la conexión

ccn testEnvía una notificación de prueba

ccn devicesLista los móviles vinculados o revoca uno

ccn config showMuestra los ajustes de este ordenador

ccn config set pair_nudges offDesactiva la sugerencia de vincular tras las notificaciones en el escritorio

ccn syncObtiene ahora los ajustes cambiados en el móvil

ccn upgradeActualiza ccn a la última versión ahora

ccn config set auto_update offDesactiva la comprobación diaria de actualizaciones

ccn unlockCompra una licencia y desbloquea este ordenador (ver Licencia)

05Licencia

Una licencia comprada en claudecodenotifier.com/licence desbloquea todos los móviles vinculados a hasta 3 ordenadores. La licencia va en el ordenador: escribes la clave en ccn, nunca en la app del móvil.

ccn unlockCompra una licencia en el navegador y desbloquea este ordenador (--lifetime para pagar una vez)

ccn activate KEYUsa tu clave en este ordenador (--replace NAME libera el hueco de otro ordenador)

ccn deactivateLibera el hueco de este ordenador para usar la clave en otro

ccn licenceMuestra el plan, la fecha de renovación y los ordenadores que usan la clave

Sin licencia, ccn puede mostrar una línea al día en Claude Code, y una notificación en el escritorio, explicando cómo desbloquear. CCN_NO_NUDGE=1 lo desactiva.

06Actualizaciones

ccn upgrade

ccn se mantiene al día solo: una vez al día comprueba en segundo plano si hay una versión nueva y la instala. ccn upgrade actualiza al momento, y ccn config set auto_update off desactiva la comprobación diaria. Si lo instalaste con Homebrew o npm, ccn deja la actualización a tu gestor de paquetes y te indica el comando a ejecutar.

07La app para Mac

La app de Claude Code Notifier para la barra de menús de Mac sigue funcionando y es gratis. Si prefieres una app a una terminal, descárgala o ejecuta brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier. A diferencia de ccn, puede lanzar webhooks, y necesita iTerm2, kitty o tmux para responder desde el móvil. No uses las dos en el mismo Mac, o cada notificación llegará dos veces. Para pasar de la app a ccn, vincula con ccn pair CODE --replace-mac-app, que elimina los hooks de la app, y luego cierra la app.

08Desinstalar

ccn uninstall

Esto elimina los hooks de settings.json, revoca las vinculaciones y borra el estado local. Después borra el binario: ~/.local/bin/ccn en macOS y Linux, %LOCALAPPDATA%\Programs\ccn en Windows, o brew uninstall ccn.

ccn forget

Elimina este ordenador del servidor de retransmisión y quita ccn.