Para recibir una notificación cuando Claude Code termina, ejecútalo dentro de AgentVera: recibes una notificación de escritorio cuando acaba un turno, un error detiene al agente o este espera tu aprobación, y los mismos eventos pueden llegar a tu móvil por Telegram o por la app móvil de AgentVera. No necesitas escribir un script de hook ni tener la terminal a la vista. Los avisos funcionan igual con Codex, Copilot CLI y cualquier otro agente CLI de la app.
Este artículo explica qué activa cada notificación, cómo configurar los avisos de escritorio y de móvil, cómo funcionan los recordatorios de aprobación y cómo reducir el ruido.
Por qué necesitas notificaciones para los agentes de programación
Un agente de programación dedica minutos a una tarea y luego se detiene por una de dos razones: ha terminado o te necesita. Si estás en otra ventana, ambas se ven igual: no pasa nada. El agente que espera un sí para npm install es el caro, porque no hace nada hasta que te das cuenta.
Unas buenas notificaciones responden tres preguntas sin abrir la terminal:
- ¿Qué agente se detuvo?
- ¿Terminó, falló o pidió permiso?
- ¿Puedo responder desde aquí?
Qué activa una notificación
AgentVera vigila la terminal de cada agente y su estado, así que sabe cuándo un agente está trabajando, esperando una respuesta o esperando una aprobación.
| Evento | Escritorio | Telegram | App móvil |
|---|---|---|---|
| Hace falta aprobación | Sí | Sí, con los botones Approve, Deny y Always allow | Sí, push |
| Turno del agente terminado | Sí, turnos de más de 15 segundos | Sí, con la duración mínima de turno que fijes | Sí, push |
| El agente terminó y salió | Sí («Task completed») | ||
| Error | Sí | Sí («Agent failed») | Sí, push |
| Hallazgo importante en una revisión de código | Sí, medio o alto | ||
| Alertas de cuenta y límites | Sí | Límites de uso por encima del 90 % | |
| Falló una tarea programada | Sí |
Cada evento de escritorio y de Telegram se puede activar o desactivar por separado.
Configura las notificaciones de escritorio
Abre Settings → Notifications. La parte On this computer tiene:
- Desktop notifications, con los cuatro eventos: Approval needed, Agent turn finished, Task completed y Error. Todos vienen activados por defecto.
- Dock badge, el número de agentes que esperan una aprobación o una respuesta, en el icono de la app.
- Keep the computer awake, activado por defecto. Mientras AgentVera está abierto, el ordenador no se suspende, como con
caffeinate; la pantalla sí puede apagarse. Importa en ejecuciones largas: un agente no puede terminar si el portátil está suspendido.
Las notificaciones de escritorio aparecen mientras AgentVera está en segundo plano. Haz clic en una y la app abre ese agente, listo para tu respuesta.
Dentro de la app, la barra de estado muestra cuántas aprobaciones esperan, y ⇧⌘A salta al agente que lleva más tiempo esperando.
Recibe avisos en el móvil con Telegram
Telegram es la forma más rápida de recibir los avisos de los agentes en el móvil, y solo necesita una cuenta gratuita de AgentVera.
- Ve a Settings → Notifications → Phone notifications.
- Pulsa Connect Telegram y abre el enlace o escanea el código QR. El enlace funciona una sola vez y es válido durante 10 minutos. Si lo prefieres, puedes usar tu propio bot; su token se guarda cifrado en tu llavero.
- En When to notify, elige los eventos. Para los turnos terminados, fija la duración mínima del turno (60 segundos por defecto) para que las respuestas cortas no te avisen.
- Pulsa Send test para comprobar que llega.
Dos opciones determinan lo que recibes. Include a short excerpt of the agent’s reply añade el final de la respuesta; si lo desactivas, solo se envía «terminó su turno», sin código ni contenido del proyecto. A separate topic per agent da a cada agente su propio tema en el chat del bot, y todo lo que escribas ahí va directo a ese agente.
Telegram hace mucho más que avisar: puedes iniciar agentes y enviar mensajes, fotos y archivos. Eso se explica en controla Claude Code desde Telegram; este artículo se centra en los avisos.
Notificaciones push en la app móvil
La app móvil de AgentVera para iOS y Android envía notificaciones push para peticiones de aprobación, turnos terminados, fallos, recordatorios de tareas y límites de uso por encima del 90 %. Las notificaciones no llevan código ni texto de mensajes. Para vincularla, inicia sesión en ambos lados y activa Control from your phone en los ajustes de la app de escritorio. Las apps todavía no están en la App Store ni en Google Play.
Sin la app, la vista de móvil en el navegador de tu teléfono muestra el estado de cada agente, su última respuesta y el diff de lo que terminó. Más sobre la app en nuestro artículo sobre la app móvil de Claude Code.
No te pierdas ninguna aprobación
Una aprobación que nadie responde es un agente parado. AgentVera tiene un recordatorio justo para eso: Settings → Orchestration → Pending approval alert, con Remind me about agents waiting for approval activado por defecto.
- El primer recordatorio llega tras 5 minutos sin respuesta, como notificación de escritorio y como mensaje de Telegram con botones de aprobación.
- Se repite cada 15 minutos hasta que respondas, hasta tres veces.
- Cada recordatorio es más llamativo que el anterior (rebote del Dock o parpadeo de la barra de tareas).
Ambos tiempos se pueden ajustar. Si apruebas siempre los mismos comandos seguros, reduce las peticiones en origen con reglas de aprobación automática (Pro y Team) en lugar de responderlas todas a mano. Nuestra guía de permisos de Claude Code explica la contrapartida.
Notificaciones frente a hooks de Claude Code
Claude Code puede ejecutar un script en ciertos eventos mediante sus hooks, y así puedes construir un notificador. La diferencia es el alcance.
| Hooks de Claude Code | Notificaciones de AgentVera | |
|---|---|---|
| Configuración | Un script por evento en tus ajustes | Interruptores en Settings |
| Agentes | Solo Claude Code | Cada agente CLI de la app |
| Móvil | Lo conectas tú mismo | Telegram y app móvil integrados |
| Responder una aprobación a distancia | Solo si lo construyes | Botones Approve y Deny |
Los hooks siguen siendo la herramienta adecuada para las comprobaciones que deben ejecutarse en cada edición. Para eso, consulta la guía de hooks de Claude Code.
Reduce el ruido
- Sube la duración mínima de turno de Telegram si las respuestas rápidas te hacen vibrar el móvil una y otra vez.
- Deja activados los errores y las aprobaciones. Son los avisos que desbloquean el trabajo.
- Usa un tema por agente para que un agente muy activo no entierre a los demás.
- Deja que el turno de noche informe por la mañana. Durante un turno de noche (Pro y Team), el informe de la mañana llega como notificación de escritorio y resumen de Telegram en lugar de un aviso por tarea; consulta ejecutar Claude Code por la noche.
Empieza ya
Descarga AgentVera, abre un proyecto e inicia Claude Code o cualquier otro agente. Las notificaciones de escritorio funcionan al instante; conecta Telegram en Settings cuando las quieras en el móvil. Las notificaciones y aprobaciones forman parte del plan gratuito; consulta los precios para ver qué añaden Pro y Team.