Notificación cuando Claude Code termina: toast y sonido

Aviso de finalización te da una notificación cuando Claude Code termina: cuando acaba un turno que ha llevado un buen rato, un toast muestra Done in 2m 14s y suena un breve aviso de dos notas. Si el turno termina con un error, el mensaje es Stopped on an error after 2m 14s. Los turnos cortos, los interrumpidos y los de subagentes no hacen ruido, así que el sonido significa «vuelve, tu respuesta está lista».

Si trabajas en otra ventana durante las tareas largas, activa la opción de notificación del sistema y el mismo mensaje aparecerá en el Centro de notificaciones de macOS o como una ventana emergente de notify-send en Linux. Requiere Claude Code 2.1.287 o posterior.

La grabación envía a Claude una tarea que tarda más que el umbral. Cuando el turno termina, el toast con la duración del turno aparece en la parte inferior de la pantalla.

Elige uno de los métodos del bloque de instalación. El sonido funciona en macOS sin configurar nada; las notificaciones del sistema hay que activarlas.

El mod tiene un único hook. Extraído de hooks/register.ts:

on('turn.complete', async ($, e, next) => {
  const result = await next(e)
  if (!shouldNotify(e, minSeconds)) return result

  const text = toastText(e, includeAnswerPreview)
  $.ui.toast(text)

  if (sound) {
    $.audio.play({ asset: 'sounds/done.wav' }).catch(() => undefined)
  }

  if (systemNotification) {
    platform ??= $.process
      .run(['uname', '-s'], { timeoutMs: 5000 })
      .then(ran => (ran.exitCode === 0 ? parseUname(ran.stdout) : undefined))
      .catch(() => undefined)
    platform
      .then(found =>
        found === undefined ? undefined : $.process.run(notificationArgv(found, 'Claude Code', text), { timeoutMs: 10000 }),
      )
      .catch(() => undefined)
  }

  return result
})

turn.complete se dispara cuando Claude termina un turno. El hook espera primero a next(e), así que nunca retrasa el resultado del turno. shouldNotify, en hooks/format.ts, devuelve false para los turnos de subagentes (los que tienen agentId), los turnos abortados y cualquier turno más corto que minSeconds. toastText formatea la duración como 45s, 2m 14s o 1h 3m.

El sonido es sounds/done.wav, incluido con el mod y reproducido con $.audio.play. La API de mods no tiene un campo de plataforma ni una llamada de notificación, así que, cuando las notificaciones del sistema están activadas, el mod pregunta una vez a uname -s y guarda la respuesta. Después ejecuta osascript -e 'display notification …' en macOS o notify-send en Linux. Los argumentos se pasan como un array argv sin shell, de modo que las comillas en la respuesta de Claude no pueden escaparse. El sonido y la notificación se lanzan sin esperar resultado; los errores se ignoran.

Cambia estas opciones en /config. Para usar tu propio sonido, sustituye sounds/done.wav en la carpeta del mod o cambia la ruta asset en el hook. El texto del toast lo genera toastText en hooks/format.ts, y el título de la notificación, 'Claude Code', es el segundo argumento de notificationArgv.

Modifica la interfaz cubre el toast. Reproduce sonido cubre el aviso sonoro. Ejecuta comandos aparece porque $.process.run está en el código, pero solo se usa si activas systemNotification: entonces ejecuta uname -s una vez y, después, osascript o notify-send con argumentos fijos. Con la configuración por defecto no se inicia ningún proceso.

El mod no intercepta llamadas a herramientas, no lee tus prompts, no toca archivos ni usa la red. Desactívalo con /plugin disable cm-done-toast, o inicia una sesión con todos los mods desactivados usando claude --safe-mode.

Probado con Claude Code 2.1.291 en la terminal de macOS. Si no pasa nada al terminar un turno:

• Comprueba que claude --version sea 2.1.287 o posterior y que el mod esté habilitado en /plugin.
• Ejecuta /reload-plugins después de instalar desde la shell.
• Puede que el turno haya sido más corto que minSeconds.
• Que no haya sonido fuera de macOS es lo esperado.
• En macOS, permite las notificaciones de tu aplicación de terminal en Ajustes del Sistema si la notificación del sistema nunca aparece.
• En Linux, instala libnotify (notify-send) para las notificaciones del sistema.