Mods de notificação para Claude Code: toasts, sons e alertas

Os mods de notificação para Claude Code avisam que algo aconteceu enquanto você olhava para outro lugar: um turno longo terminou, a janela de contexto está quase cheia, um comando foi bloqueado ou uma execução de testes falhou. Eles usam toasts curtos dentro do Claude Code, um som opcional e, às vezes, uma notificação do sistema para que você perceba mesmo estando em outra janela.

Como funcionam os mods de notificação para Claude Code?#

A maioria escuta turn.complete, que dispara quando o Claude termina um turno e traz a duração do turno, se ele foi interrompido, o motivo da parada e um agentId nos turnos de subagentes. Em seguida, o mod chama $.ui.toast('...') para uma mensagem dentro do app e $.audio.play(...) para um clipe de som incluído no pacote. Os avisos sobre limites normalmente vêm de $.session.usage(), lido depois de um turno, e um mod de segurança pode exibir um toast de dentro do seu hook tool.call quando recusa um comando.

Não existe uma chamada dedicada a notificações de desktop na API de mods. Um mod que queira usar a Central de Notificações do macOS ou um popup libnotify no Linux executa osascript ou notify-send com $.process.run. Passar os argumentos como um array argv, em vez de uma string de shell, evita problemas de escape com o texto da resposta do Claude.

O que você deve verificar antes de instalar um?#

Um mod que só usa toasts deve mostrar Altera a interface e talvez Reproduz som. Se você também vir Executa comandos, confira se ele só chama um programa de notificação e apenas quando você ativou as notificações do sistema. Se um mod incluir parte da resposta do Claude na notificação, lembre-se de que esse texto passa a aparecer no histórico de notificações do seu sistema operacional.

Depois, observe o limite mínimo. Um bom mod de notificação fica em silêncio nos turnos curtos, nos interrompidos e nos de subagentes, e deixa você mudar a duração mínima em /config.

Toast, som ou notificação do sistema?#

Use um toast quando você já estiver no terminal. Acrescente um som quando você costuma ir para o navegador durante turnos longos. Ative as notificações do sistema quando você trabalha com vários desktops ou apps em tela cheia e não veria o terminal de jeito nenhum. A maioria das pessoas mantém ligadas só as duas primeiras opções.