Recibe una notificación push cuando Claude Code termine

Realizar una refactorización compleja o un análisis de código a gran escala con un agente de IA toma tiempo. Si quieres recibe una notificación push cuando Claude Code termine su tarea, necesitas un flujo de trabajo que conecte tu entorno de terminal local con un sistema de alertas móviles. Esta guía explora los diferentes métodos para monitorear sesiones de agentes de larga duración sin tener que mirar fijamente una ventana de terminal durante veinte minutos.

El problema de las tareas largas de IA

Cuando activas un comando en Claude Code para migrar un módulo antiguo o escribir una suite de pruebas de integración, el agente a menudo entra en un ciclo de pensamiento, escritura y ejecución. Durante este período, tu estación de trabajo principal está efectivamente ocupada o tu atención se divide. Los desarrolladores suelen cambiar a otras pestañas o alejarse de sus escritorios, solo para regresar más tarde y darse cuenta de que el agente terminó hace diez minutos o, lo que es peor, se detuvo porque requería una confirmación manual.

Automatizar una notificación cuando el proceso se completa te permite mantener el estado de flujo. Puedes ocuparte de otras tareas y volver a tu código exactamente cuando el agente esté listo para tu revisión. Esto es particularmente importante para los agentes que operan en la terminal, donde las señales visuales se limitan a la salida de la consola.

Uso de ganchos de finalización de shell estándar

La forma más directa de recibir una notificación es añadiendo un comando secundario a la ejecución de tu agente. En la mayoría de los entornos tipo Unix, puedes usar el operador && para ejecutar un script de notificación inmediatamente después de que el proceso principal termine con éxito.

Podrías usar un comando curl simple hacia un servicio de webhooks o un pitido del sistema local. Sin embargo, estos carecen de contexto. Un simple sonido en tu escritorio no ayuda si estás en otra habitación. Los desarrolladores más avanzados suelen escribir pequeños scripts que capturan el código de salida del proceso de Claude y envían un mensaje a una plataforma de mensajería. Si bien esto funciona, requiere administrar llaves de API para servicios de terceros y asegurar que tu entorno local tenga los permisos de red necesarios para alcanzar esos puntos finales externos.

Integración con un ecosistema móvil

Para una experiencia más integrada, usar un espacio de trabajo especializado para desarrolladores puede simplificar el flujo de notificaciones. Deska ofrece una aplicación mobile que te permite monitorear tus sesiones de terminal local directamente desde tu teléfono. Debido a que Deska es local-first, la comunicación ocurre a través de un relevo seguro que no requiere que abras puertos ni configures firewalls complejos.

Cuando ejecutas Claude Code dentro de una de las terminals en el espacio de trabajo de Deska, el estado de esa sesión es accesible a través del dispositivo móvil vinculado. No necesitas escribir scripts personalizados para recibir una alerta. El espacio de trabajo gestiona la conectividad entre tu máquina Mac, Windows o Linux y tu dispositivo móvil, asegurando que te mantengas informado sobre el progreso de tus coding agents.

Configuración de notificaciones en Deska

Para recibir una notificación push cuando Claude Code termine en Deska, debes seguir un proceso de configuración sencillo dentro de los ajustes de la aplicación.

1. Abre la aplicación de escritorio Deska y ve al panel de settings.
2. Asegúrate de que tu dispositivo móvil esté emparejado usando el código QR que se encuentra en la sección móvil.
3. Abre un panel de terminal y lanza tu agente.
4. Habilita las alertas de sesión para esa ventana de terminal específica.

El asistente ask-deska también puede ayudarte a gestionar estas sesiones. Puedes pedirle al asistente que te notifique cuando una terminal específica quede inactiva. Esto es útil porque cubre no solo las finalizaciones exitosas, sino también los casos en los que el agente se queda esperando una entrada del usuario. La integración entre el lienzo o canvas de escritorio y el relevo móvil asegura que la notificación te llegue dondequiera que estés.

Métodos alternativos mediante scripts

Si prefieres quedarte totalmente dentro de un emulador de terminal estándar como iTerm2 o Alacritty, puedes usar herramientas como ntfy o pushover. Estos servicios proporcionan una herramienta de línea de comandos en la que puedes canalizar la salida. Por ejemplo, podrías ejecutar un comando como claude-code "refactorizar esto" ; ntfy publish mi_tema "Claude ha terminado".

La desventaja de este enfoque es la falta de interactividad. Recibes la notificación, pero no puedes ver qué hizo realmente el agente hasta que regresas a tu computadora. Las herramientas modernas para desarrolladores buscan resolver esto proporcionando una ventana a la sesión remota. Al usar las capacidades de remote-access de un espacio de trabajo unificado, no solo puedes recibir la notificación push, sino también ver la salida de la terminal e incluso escribir comandos de seguimiento desde tu teléfono.

Consideraciones de seguridad para notificaciones de agentes

Al configurar cualquier forma de notificación para un agente de IA, debes considerar la seguridad de los datos que se envían. Los webhooks estándar a menudo envían datos a través de canales públicos de internet en texto plano o dependen de las políticas de privacidad de terceros. Si tu notificación incluye fragmentos de tu código o nombres de archivos, esto podría ser un riesgo de seguridad.

Es por esto que se prefiere un enfoque local-first para el desarrollo profesional. Los sistemas que establecen un enlace directo y cifrado entre tu estación de trabajo y tu dispositivo móvil evitan que tu código fuente se almacene en servidores externos. Cuando recibes una notificación, es una señal de que tu máquina local ha completado una tarea, en lugar de un volcado de datos a un proveedor en la nube. Puedes leer más sobre cómo se manejan los datos en la documentación de privacy.

FAQ

¿Cómo recibir una notificación cuando un comando termina en la terminal?

Puedes usar un sufijo de comando como && say "listo" en macOS o usar una utilidad como notify-send en Linux. Para alertas móviles, puedes usar una llamada curl a un servicio de push o usar el sistema de notifications integrado en Deska que conecta tus terminales de escritorio con tu teléfono móvil automáticamente.

¿Puede Claude Code enviar alertas móviles de forma nativa?

Hasta la versión actual, Claude Code es una herramienta de línea de comandos que no tiene una aplicación móvil nativa ni un servicio de notificaciones push. Para recibir alertas en tu teléfono, debes envolver la ejecución en un script o ejecutarlo dentro de un espacio de trabajo como Deska que soporte monitoreo mobile.

¿Es seguro usar webhooks para el estado de un agente de IA?

Usar webhooks genéricos es generalmente seguro para mensajes simples de "proceso terminado". Sin embargo, debes evitar enviar datos de código sensibles o rutas internas a través de estos webhooks. Usar un relevo cifrado como el que proporciona Deska asegura que tus data and storage permanezcan privados mientras mantienes la conveniencia de las alertas remotas.

Comienza con mejores flujos de trabajo para agentes

Monitorear tus agentes de IA no debería requerir que estés atado a tu escritorio. Al usar la combinación correcta de herramientas locales e integración móvil, puedes aumentar significativamente tu productividad y manejar tareas de refactorización más grandes con confianza.

Puedes descargar (download) la aplicación de escritorio Deska de forma gratuita para Mac, Windows y Linux para comenzar a ejecutar tus agentes en un lienzo infinito con sincronización móvil integrada. Es una forma potente de gestionar múltiples hilos de agentes (agent threads) y asegurar que siempre sepas exactamente cuándo tu trabajo está listo para el siguiente paso.