Conecta tu móvil a Claude Code en Mac, Windows o Linux

01Qué consigues al vincular

Con el móvil vinculado, Claude Code puede avisarte cuando te necesita:

• Un push de "Claude ha terminado" en cuanto acaba un turno.
• Solicitudes de permiso que puedes permitir una vez, permitir para la sesión o denegar.
• Preguntas que puedes responder eligiendo una opción.
• Una instrucción de seguimiento que puedes enviar justo cuando Claude termina.

Antes de vincular, ccn ya muestra notificaciones de escritorio en el ordenador para esos mismos momentos. Al vincular, se suma el móvil.

Claude Code Notifier es una herramienta independiente creada por TouchTap Ltd. No está creada por Anthropic ni afiliada con ella. Funciona mediante los hooks de Claude Code, así que cubre cualquier sesión de claude en cualquier terminal, incluidas las terminales integradas en VS Code, Cursor y los IDE de JetBrains.

02Antes de empezar

Necesitas:

• Claude Code instalado y funcionando en el ordenador.
• La app Claude Code Notifier en tu móvil, desde la App Store o Google Play. Si escaneas primero el código QR sin tener la app, el móvil te llevará a la tienda.
• Conexión a internet en ambos dispositivos.

La app se descarga gratis y requiere una suscripción o una compra vitalicia para usarla, con prueba gratuita en el plan anual. Consulta los precios.

03Dos formas de vincular

Hay dos opciones. Las dos llevan al mismo resultado, así que elige la que te resulte más cómoda.

Los enlaces QR y los códigos de 6 dígitos duran 24 horas.

04Opción 1: escanear un código QR

En Mac o Linux

1. Abre una terminal e instala ccn:

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

O con Homebrew:

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

2. Ejecuta ccn (o ccn pair). Instala los hooks si hace falta y muestra un código QR y un enlace.
3. Apunta la cámara del teléfono al código QR y abre el enlace. Si tienes la app instalada, se abre y se vincula. Si no, el teléfono te lleva primero a la App Store o a Google Play; instala la app y la vinculación continúa.
4. La terminal confirma que el teléfono está vinculado.

En Windows

1. Abre PowerShell e instala ccn (el soporte para Windows está en beta):

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

2. Ejecuta ccn pair. PowerShell muestra un código QR y un enlace.
3. Escanéalo con la cámara del teléfono, igual que antes.
4. PowerShell confirma que el teléfono está vinculado.

Con Node.js o como plugin, en cualquier sistema operativo

Si tienes Node.js, esto instala e inicia la vinculación de una vez:

npx @touchtap/ccn

O desde Claude Code, instálalo como plugin y ejecuta su comando de configuración:

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

05Opción 2: escribir un código de 6 dígitos

Esta opción empieza en el teléfono, y viene bien cuando no ves bien la pantalla del ordenador o cuando Claude Code se ejecuta en un servidor al que accedes por SSH.

1. Abre la app Claude Code Notifier y ve a Computers > Add a computer.
2. La app muestra un código de 6 dígitos y la línea exacta que debes ejecutar en tu sistema operativo.
3. Ejecuta esa línea en el ordenador. Si ya tienes ccn instalado, es simplemente:

ccn pair 482913

Usa tu propio código en lugar de 482913.

Instalar y vincular en una sola línea

Todas las líneas de instalación aceptan el código, así que en un ordenador nuevo basta con un solo comando.

En Mac o Linux:

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

En Windows, en PowerShell:

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

Como plugin de Claude Code, pasa el código al comando de configuración: /ccn:setup 482913.

06Comprueba que funciona

Dos comandos confirman que todo está listo:

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

Luego pruébalo de verdad. Inicia claude, dale una tarea pequeña y aléjate del teclado. Cuando termine, te llegará un push al teléfono.

Ten en cuenta que ccn detecta cuándo estás en el ordenador. Si has escrito en los últimos 30 segundos, los prompts de permisos y las preguntas aparecen en la terminal como siempre y el teléfono recibe como mucho un aviso. Aléjate para ver cómo el teléfono toma el relevo.

07Vincular más de un dispositivo

• Varios ordenadores, un teléfono. Repite los pasos en cada ordenador. Tu Mac del trabajo, tu equipo Linux de casa y tu portátil Windows pueden avisar al mismo teléfono. Ejecutar varias sesiones de Claude Code explica cómo distinguirlas.
• Varios teléfonos, un ordenador. Vincula cada teléfono con el mismo ordenador.
• Ver o quitar teléfonos. ccn devices lista los teléfonos vinculados y ccn devices revoke <name> elimina uno.

08Scripts y máquinas remotas

ccn pair --no-wait muestra el código QR y termina al momento, ideal para scripts y aprovisionamiento. En un servidor por SSH, la opción de 6 dígitos suele ser la más sencilla, ya que escribes el código en la misma sesión SSH que usas para Claude Code. Notificaciones de Claude Code en un servidor remoto por SSH explica el resto de esa configuración.

09Si la vinculación no funciona

• Se rechazó el código. Los códigos duran 24 horas. Genera uno nuevo en la app o usa la opción del QR.
• El código QR no se escanea. Agranda la ventana del terminal o abre en el móvil el enlace que aparece impreso.
• No se encuentra ccn después de instalarlo. Abre un terminal nuevo para que se actualice tu PATH.
• Está emparejado, pero no llega ningún push. Ejecuta ccn doctor y luego ccn test, y comprueba en los ajustes del móvil que la app tiene permitidas las notificaciones.

Tienes la lista completa en ¿No funcionan las notificaciones de Claude Code? Una checklist.

10¿Aún no quieres emparejar?

No pasa nada. Las notificaciones de escritorio funcionan desde que instalas ccn. Mientras no haya un móvil emparejado, ccn te sugerirá de vez en cuando ccn pair. Para quitar las sugerencias:

ccn config set pair_nudges off

11Preguntas frecuentes