Recibe notificaciones cuando un agente de programación termina o pide aprobación

Para recibir un aviso cuando un agente de programación termina o necesita tu aprobación, activa sus alertas integradas o añade un hook que se ejecute con esos eventos. Si vas a estar lejos del ordenador, envía la alerta al móvil. Pruébalo antes de irte, porque un agente que espera tu aprobación no hace nada hasta que respondes.

Los ejemplos de esta guía usan Claude Code. Mantener el ordenador despierto tiene su propia guía. Mono de Reunified envía estas alertas para los agentes que ejecutas con él, pero el método sirve con cualquier configuración.

1. Decide qué eventos del agente necesitan una alerta

Hay tres eventos que importan:

Si solo configuras una alerta, que sea la de permisos.

2. Activa las alertas en Claude Code

Claude Code envía una notificación cuando termina o se detiene a pedir permiso mientras parece que no estás. Por defecto, solo muestra notificaciones de escritorio en Ghostty, iTerm2 y Kitty (configuración de la terminal). En las demás, pon preferredNotifChannel en "terminal_bell" dentro de ~/.claude/settings.json para que suene la campana de la terminal. En tmux, añade set -g allow-passthrough on a ~/.tmux.conf y vuelve a cargarlo.

Si quieres tu propio sonido o comando, añade hooks al mismo archivo. El evento Notification acepta matchers como permission_prompt (una aprobación lleva unos seis segundos esperando) o idle_prompt (Claude terminó hace más o menos un minuto y no has escrito nada desde entonces). En un Mac, esto reproduce un sonido distinto para cada uno:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "permission_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      },
      {
        "matcher": "idle_prompt",
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Hero.aiff" }]
      }
    ]
  }
}

La guía de hooks también incluye comandos de notificaciones de escritorio para macOS, Linux y Windows. Otros agentes funcionan de otra manera, así que consulta su documentación.

3. Envía la alerta al móvil

Hay tres formas de que llegue al móvil:

• La app del propio agente. Con Remote Control de Claude Code activo, ejecuta /config y activa las notificaciones push cuando Claude lo decida («Push when Claude decides»), cuando haga falta una acción tuya («Push when actions required») o ambas. Necesitas un plan compatible y la app de Claude con la sesión iniciada en la misma cuenta y las notificaciones permitidas.
• Un hook que envía una notificación push, por ejemplo con curl a un servicio de notificaciones push cuya app tengas en el móvil.
• Una app complementaria que retransmite los eventos de la sesión desde el ordenador.

En todos los casos, el ordenador tiene que estar encendido, despierto y conectado a internet, con el agente todavía en marcha. Guarda el token de cualquier hook en ~/.claude/settings.json, no en el .claude/settings.json del proyecto, que puede acabar en un commit del repositorio.

4. Mantén privado el texto de las alertas en la pantalla de bloqueo

Cualquiera que esté cerca de un móvil bloqueado puede leer sus previsualizaciones. No pongas secretos, contenido de archivos ni líneas de registro en los mensajes de los hooks. Envía solo el evento y el nombre del proyecto: para un proyecto inventado llamado «invoice-export», basta con «invoice-export: aprobación pendiente». En el iPhone, abre Ajustes > Notificaciones y pon «Mostrar previsualizaciones» en «Si está desbloqueado». Android también puede ocultar el contenido sensible en la pantalla de bloqueo, aunque el nombre de la opción cambia según el móvil.

En Mono, la alerta de tarea terminada muestra el último mensaje del agente, acortado si es largo. La alerta de permiso muestra la solicitud tal como la describe el agente, que a menudo es el comando.

5. Haz una prueba con una tarea inofensiva antes de irte

En el ordenador de casa, inicia una sesión llamada «comprobación invoice-export» y pide al agente que ejecute las pruebas e informe de cualquier fallo sin cambiar archivos. El agente pregunta antes de ejecutar comandos, así que pide permiso para npm test. En el ordenador, cambia a otra pantalla u otra app; después bloquea el móvil y vete a otra habitación.

En Mono, deberías ver esto:

1. Una alerta «Solicitud de permiso del agente» con el comando de las pruebas.
2. Al pulsar la alerta se abre esa sesión, donde eliges Permitir. Una solicitud posterior envía su propia alerta.
3. «El agente ha terminado en “comprobación invoice-export”» con el último mensaje del agente, por ejemplo: «Una prueba de dates.test.ts falla con las zonas horarias. No he cambiado ningún archivo».

Después ejecuta una segunda tarea con la sesión abierta en el móvil: mientras la miras, no llega ninguna alerta. Antes de salir, asegúrate de que ningún dispositivo tenga la sesión en pantalla.

6. Soluciona las alertas que no llegan

En Mono, abre Ajustes > Notificaciones y comprueba «Todas las notificaciones», «Code» (sesiones terminadas y detenidas), «Peticiones de permiso» y «Enviar a tus otros dispositivos». Todas vienen activadas por defecto. Las alertas salen del ordenador que ejecuta el agente, así que mantén Mono abierto en él.

Antes de aprobar algo desde el móvil, lee qué revisar en una solicitud de permiso. Agentes de programación desde el móvil explica el resto de la configuración. Mono aún no está disponible, pero puedes apuntarte a la lista de espera.