Notificação do Claude Code ao terminar: toast e som

O Aviso de conclusão dá a você uma notificação do Claude Code ao terminar: quando um turno que levou um bom tempo acaba, um toast diz Done in 2m 14s e toca um som curto de duas notas. Um turno que termina com erro mostra Stopped on an error after 2m 14s no lugar. Turnos curtos, turnos interrompidos e turnos de subagentes ficam em silêncio, então o som sempre significa "pode voltar, sua resposta está pronta".

Se você trabalha em outra janela durante tarefas longas, ative a opção de notificação do sistema e a mesma mensagem aparece na Central de Notificações do macOS ou como um popup notify-send no Linux. Requer Claude Code 2.1.287 ou posterior.

A gravação envia ao Claude uma tarefa que demora mais do que o limite configurado. Quando o turno termina, o toast com a duração do turno aparece na parte de baixo da tela.

Escolha um dos métodos do bloco de instalação. O som funciona no macOS sem configuração nenhuma; as notificações do sistema precisam ser ativadas por você.

O mod tem um único hook. Trecho 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 dispara quando o Claude termina um turno. O hook aguarda next(e) primeiro, então nunca atrasa o resultado do turno. shouldNotify em hooks/format.ts retorna false para turnos de subagentes (os que têm agentId), turnos abortados e qualquer coisa mais curta que minSeconds. toastText formata a duração como 45s, 2m 14s ou 1h 3m.

O som é sounds/done.wav, que vem junto com o mod e é tocado com $.audio.play. A API de mods não tem um campo de plataforma nem uma chamada de notificação, então, quando as notificações do sistema estão ativadas, o mod pergunta uname -s uma vez e guarda a resposta. Em seguida ele executa osascript -e 'display notification …' no macOS ou notify-send no Linux. Os argumentos são passados como um array argv, sem shell, então aspas na resposta do Claude não conseguem escapar do comando. O som e a notificação são disparados sem esperar resultado; os erros são simplesmente ignorados.

Altere estas opções em /config. Para usar o seu próprio som, substitua sounds/done.wav na pasta do mod ou mude o caminho asset no hook. O texto do toast vem de toastText em hooks/format.ts, e o título da notificação, 'Claude Code', é o segundo argumento de notificationArgv.

Altera a interface cobre o toast. Reproduz som cobre o som de conclusão. Executa comandos aparece porque $.process.run está no código, mas ele só é usado quando você ativa systemNotification: aí ele executa uname -s uma vez, seguido de osascript ou notify-send com argumentos fixos. Com as configurações padrão, nenhum processo é iniciado.

O mod não intercepta chamadas de ferramentas, não lê seus prompts, não mexe em arquivos e não usa a rede. Desative-o com /plugin disable cm-done-toast, ou inicie uma sessão com todos os mods desligados usando claude --safe-mode.

Testado com Claude Code 2.1.291 no macOS, no terminal. Se nada acontecer quando um turno terminar:

• Verifique se claude --version é 2.1.287 ou posterior e se o mod está ativado em /plugin.
• Execute /reload-plugins depois de instalar pelo shell.
• O turno pode ter sido mais curto que minSeconds.
• A ausência de som fora do macOS é esperada.
• No macOS, permita notificações para o seu app de terminal nos Ajustes do Sistema se a notificação do sistema nunca aparecer.
• No Linux, instale o libnotify (notify-send) para ter notificações do sistema.