Aprueba solicitudes de permisos de Claude Code desde el móvil

01Por qué los prompts de permisos frenan tu trabajo

En el modo de permisos por defecto, Claude Code pregunta antes de ejecutar la mayoría de comandos de shell, editar archivos o descargar una página web. El prompt espera en el terminal hasta que alguien responde. Si te has ido a por un café, toda la tarea se queda parada en esa pregunta, y no te enteras hasta que vuelves.

Tienes tres formas de evitarlo:

• Aprobar menos a menudo. Añade reglas allow para los comandos en los que confías o usa un modo más permisivo. Va bien para el trabajo rutinario y se explica en Los modos de permisos de Claude Code explicados.
• Te avisan y vuelves. Un hook de notificación te avisa de que hay un prompt esperando. Aun así tienes que volver al teclado.
• Responde a distancia. Un hook PermissionRequest lleva la pregunta a tu móvil y devuelve tu respuesta a Claude Code.

Esta guía trata sobre la tercera opción.

02Cómo responde por ti el hook PermissionRequest

Claude Code lanza PermissionRequest cuando una llamada a una herramienta necesita una decisión de permisos. El hook recibe JSON por la entrada estándar con tool_name y tool_input (por ejemplo, el comando de Bash), y opcionalmente una lista permission_suggestions con las reglas que Claude Code ofrecería guardar.

El hook responde imprimiendo un JSON como este:

{
  "hookSpecificOutput": {
    "hookEventName": "PermissionRequest",
    "decision": {
      "behavior": "allow"
    }
  }
}

behavior es allow o deny. Si deniegas, puedes añadir un message, que le explica a Claude el motivo, e interrupt: true, que detiene a Claude por completo. Si apruebas, updatedPermissions puede aplicar reglas de permisos para que no te lo vuelva a preguntar. Si el hook no devuelve nada, Claude Code muestra su prompt habitual.

Así que un hook de aprobación remota tiene tres tareas: enviar la solicitud a un sitio donde la veas, esperar una respuesta e imprimir el JSON correcto antes de que el hook agote su tiempo. La lista completa de campos y un script funcional están en Responder a solicitudes de permiso desde un hook.

Registrar el hook

Los hooks se configuran en ~/.claude/settings.json (para todos los proyectos) o en .claude/settings.json (para un solo proyecto):

{
  "hooks": {
    "PermissionRequest": [
      {
        "matcher": "*",
        "hooks": [
          { "type": "command", "command": "/path/to/your-approval-script" }
        ]
      }
    ]
  }
}

El matcher filtra por nombre de herramienta, así que con "Bash" solo se enviarían a tu móvil los comandos de shell. Los hooks de tipo command tienen un timeout por defecto de 600 segundos, que limita cuánto puede esperarte un hook.

03Hacerlo tú mismo

Puedes montarte tu propia versión. Un diseño típico publica la solicitud en un servicio de push como ntfy, incluye dos botones de acción que llaman a un pequeño endpoint web, y hace que el hook consulte ese endpoint hasta que llegue una respuesta o se acabe el tiempo. Consulta Notificaciones push de Claude Code con ntfy para la parte del envío.

Lo que lleva tiempo son los casos límite:

• Estás en el teclado. Si el hook siempre espera al móvil, no puedes responder en el terminal mientras tanto. Un buen hook detecta que estás presente y se aparta.
• Timeouts. El hook debe rendirse antes del timeout de Claude Code y volver al comportamiento normal sin problemas.
• Confianza. Cualquiera que pueda acceder a tu endpoint de callback puede aprobar comandos en tu ordenador. Necesita autenticación.
• Varias sesiones. Cada solicitud tiene que llegar a la sesión correcta y volver a ella.

Si te gusta construir estas cosas, es un buen proyecto de fin de semana. Si lo quieres funcionando hoy, una herramienta ya hecha te ahorra el esfuerzo.

04Usar Claude Code Notifier

Claude Code Notifier es una herramienta independiente creada por TouchTap Ltd. No está creada por Anthropic ni afiliada a ella. Tiene dos partes: ccn, una herramienta de línea de comandos gratuita para Mac, Windows y Linux, y apps para iPhone y Android.

1. Instala ccn

En Mac y Linux:

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

En Windows, desde PowerShell (el soporte para Windows está en beta):

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

Las instalaciones con Homebrew, npm y como plugin están en la página de ccn. La instalación añade siete entradas de hook a ~/.claude/settings.json, cada una ejecutando ccn hook, y guarda una copia de seguridad del archivo. Una de ellas es el hook PermissionRequest. ccn se ejecuta unos milisegundos cuando Claude Code lo llama y luego termina. No hay nada ejecutándose en segundo plano, y funciona en cualquier terminal, incluidos los de los IDE.

2. Empareja tu móvil

Ejecuta ccn pair y escanea el código QR, o escribe el código de 6 dígitos que aparece en la app. Tienes las instrucciones paso a paso para cada sistema operativo en Conecta tu móvil a Claude Code.

3. Responde desde la notificación

Cuando Claude necesita un permiso y no estás, tu móvil te muestra lo que quiere hacer, por ejemplo el comando que quiere ejecutar. Puedes:

• Permitir una vez, solo para esta llamada.
• Permitir durante la sesión, para que no vuelva a preguntar por el mismo tipo de solicitud en esa sesión.
• Denegar, y Claude sigue sabiendo que se ha rechazado.

El hook devuelve tu respuesta y Claude continúa.

Qué pasa cuando estás en tu mesa

ccn comprueba si estás presente. Si has escrito algo en los últimos 30 segundos, no se espera nada: el terminal pregunta como siempre y el móvil recibe, como mucho, un aviso. Si no estás, el terminal espera la respuesta del móvil hasta un límite que tú eliges, y deja de esperar en cuanto tocas el teclado. Así siempre puedes responder desde donde te pille más cerca.

El límite es un ajuste:

ccn config set hold_ceiling_seconds 900

Admite de 30 a 3600 segundos y por defecto es 600. presence_threshold_seconds cambia la ventana de 30 segundos. La mayoría de los ajustes también se pueden cambiar para cada ordenador desde la app del móvil.

Comprobar que funciona

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

Las apps se descargan gratis y necesitan una suscripción o una compra de por vida para usarse. Consulta los precios. Sin móvil, ccn sigue mostrando gratis una notificación de escritorio en el ordenador cuando Claude necesita un permiso.

05Y aprueba menos cosas

La aprobación remota funciona mejor si la combinas con reglas allow razonables. Si apruebas npm test veinte veces al día, añade una regla como Bash(npm test *) a permissions.allow y deja el móvil para las solicitudes que merecen un vistazo. Antes de aprobar desde una pantalla pequeña, lee el comando. ¿Es seguro aprobar acciones de Claude Code desde el móvil? explica qué revisar.

06Preguntas frecuentes