Saltar al contenido
claudemods

Mods de notificaciones para Claude Code: toasts, sonidos y alertas

Los mods de notificaciones para Claude Code te avisan cuando acaba un turno largo, se acerca un límite o algo falla, con toasts, sonido o alertas de escritorio.

Aviso de finalización funcionando en Claude Code

Aviso de finalización

Un toast «Done in 2m 14s» y un sonido al terminar un turno largo de Claude, más un aviso de escritorio opcional.

  • aviso
  • Ejecuta comandos
  • Modifica la interfaz
  • Reproduce sonido

probado con v2.1.291

Los mods de notificaciones para Claude Code te avisan de que algo ha pasado mientras mirabas a otro lado: ha terminado un turno largo, la ventana de contexto está casi llena, se ha bloqueado un comando o ha fallado una ejecución de tests. Usan toasts breves dentro de Claude Code, un sonido opcional y, a veces, una notificación del sistema para que te enteres desde otra ventana.

¿Cómo funcionan los mods de notificaciones para Claude Code?

La mayoría escuchan turn.complete, que se dispara cuando Claude termina un turno e incluye la duración del turno, si se interrumpió, el motivo de parada y un agentId para los turnos de subagentes. Después el mod llama a $.ui.toast('...') para mostrar un mensaje dentro de la aplicación y a $.audio.play(...) para reproducir un clip de sonido incluido. Los avisos sobre límites suelen salir de $.session.usage(), leído tras un turno, y un mod de seguridad puede mostrar un toast desde su hook tool.call cuando rechaza un comando.

No existe una llamada dedicada a notificaciones de escritorio en la API de mods. Un mod que quiera usar el Centro de notificaciones de macOS o una ventana emergente de libnotify en Linux ejecuta osascript o notify-send con $.process.run. Pasar los argumentos como un array argv, en lugar de una cadena de shell, evita problemas de comillas con el texto de las respuestas de Claude.

¿Qué deberías revisar antes de instalar uno?

Un mod que solo muestra toasts debería mostrar Modifica la interfaz y quizá Reproduce sonido. Si además ves Ejecuta comandos, comprueba que solo llama a un programa de notificaciones y solo cuando tú has activado las notificaciones del sistema. Si un mod incluye parte de la respuesta de Claude en la notificación, recuerda que ese texto quedará después en el historial de notificaciones de tu sistema operativo.

Luego fíjate en el umbral. Un buen mod de notificaciones no dice nada en los turnos cortos, los interrumpidos y los de subagentes, y te deja cambiar la duración mínima en /config.

¿Toast, sonido o notificación del sistema?

Usa un toast cuando de todas formas estás en la terminal. Añade un sonido cuando te vas al navegador durante los turnos largos. Activa las notificaciones del sistema cuando trabajas entre varios escritorios o con aplicaciones a pantalla completa y no verías la terminal en absoluto. La mayoría de la gente deja activadas solo las dos primeras opciones.

Preguntas frecuentes

¿Hay una API de notificaciones de escritorio para los mods de Claude Code?
No. La API de mods tiene $.ui.toast para toasts dentro de la aplicación y $.audio para el sonido. Un mod que lanza una notificación de macOS o Linux ejecuta osascript o notify-send mediante $.process.run, y por eso muestra la insignia Ejecuta comandos.
¿Cuánto tiempo se queda un toast en pantalla?
Unos cuatro segundos por defecto. Los toasts están pensados para datos breves como "Listo en 2m 14s", no para nada que necesites leer dos veces.
¿Se dispara un mod de notificaciones en los turnos de subagentes?
Solo si está escrito para ello. El evento turn.complete incluye un agentId en los turnos de subagentes, y los buenos mods de notificaciones los ignoran para que oigas un aviso por respuesta, no uno por subagente.