Seja notificado quando o Claude Code precisar de aprovação ou terminar

O Claude Code envia uma notificação quando conclui uma tarefa ou quando faz uma pausa aguardando aprovação de permissão enquanto você parece estar ausente. Você pode exibi-la como notificação na área de trabalho, aviso sonoro no terminal ou qualquer ação que um hook Notification possa executar. O método ideal depende do seu terminal e de quantas sessões você costuma rodar.

1. Notificações na área de trabalho

No Ghostty, Kitty e iTerm2, as notificações do Claude Code aparecem na área de trabalho sem necessidade de nenhuma configuração.

No iTerm2, se não aparecerem, abra Settings > Profiles > Terminal, ative Notification Center Alerts e, em Filter Alerts, marque a opção para permitir alertas gerados por sequências de escape. Verifique também se o aplicativo de terminal tem permissão de notificação nas configurações do seu sistema operacional.

Essas notificações também chegam até você a partir de uma sessão remota via SSH.

No aplicativo para computador do Claude, a aba Code envia sua própria notificação na área de trabalho quando uma sessão termina uma tarefa enquanto você não está olhando para ela. Uma sessão iniciada pelo Dispatch no celular envia uma notificação push quando termina ou quando precisa da sua aprovação.

Se o seu terminal implementar o protocolo de status de programa OSC 7501, o Claude Code 2.1.295 ou posterior também informa se cada sessão interativa está trabalhando, aguardando você ou concluída, sem precisar ativar nada. A documentação do seu terminal informa se ele é compatível com o protocolo e onde o status é exibido.

2. O aviso sonoro do terminal

Outros terminais, como o Apple Terminal, o Warp ou o terminal integrado do VS Code, não recebem a notificação na área de trabalho. Você pode optar por um sinal sonoro. Adicione isto ao arquivo ~/.claude/settings.json:

{
  "preferredNotifChannel": "terminal_bell"
}

Se você usa tmux, inclua set -g allow-passthrough on no arquivo ~/.tmux.conf para que a notificação passe para o terminal externo.

Se as suas sessões rodam dentro do Subsistema do Windows para Linux, consulte Claude Code WSL notifications: get alerts on Windows para configurações de aviso sonoro no Windows Terminal e hooks do PowerShell.

3. Um hook Notification

Um hook executa seu próprio comando quando o Claude precisa de você: um som, uma notificação na tela ou uma mensagem no celular. Ele é executado junto com a notificação padrão. No Mac, isto reproduz um som:

{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          { "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }
        ]
      }
    ]
  }
}

O evento Notification possui tipos para filtros, incluindo permission_prompt e idle_prompt, permitindo diferenciar "aguardando aprovação" de "aguardando sua próxima mensagem". Um hook Stop separado é executado quando o Claude termina de responder. Nenhum desses tipos cobre as perguntas de múltipla escolha do Claude. Consulte Know when Claude Code asks you a question or wants a plan approved para ver o hook apropriado.

Se você executa sessões em segundo plano, a visualização de agentes (claude agents, uma prévia de pesquisa) também avisa quando uma delas precisa de dados, termina ou falha, desde que a tela esteja aberta. Ela dispara o hook Notification com o tipo agent_needs_input ou agent_completed, permitindo que um script reaja a esses avisos. Consulte Visualização de agentes no Claude Code: execute e acompanhe sessões em segundo plano para aprender a iniciar sessões em segundo plano e responder a elas.

Para ver como o evento Notification se integra a PreToolUse, PostToolUse, Stop e outros eventos de hook, leia Claude Code hooks: events, matchers, settings and handlers.

Qual opção utilizar

Quando notificações não são suficientes

Uma notificação avisa que uma sessão precisa de você. Com quatro sessões abertas, você ainda precisa procurar qual é a correta, e depois de fechar o aviso ele desaparece.

Para uma comparação mais ampla entre tmux, hooks, visualização de agentes, painéis de IDE e pads de status, consulte How to monitor multiple Claude Code sessions.

O Orbtile exibe cada sessão como uma tecla individual em um iPhone, um celular Android ou no Logitech MX Creative Keypad. Uma sessão que está aguardando acende com a cor de alerta do seu agente e vai para a frente, a tecla mostra o que está sendo solicitado e você pode responder a pedidos compatíveis direto pelo teclado: toque em Negar ou segure Permitir por 0,6 segundo. Ele utiliza os hooks do Claude Code por meio de seu próprio plugin, mantendo suas notificações funcionando normalmente.

Se você também utiliza o Kimi Code, consulte Kimi Code notifications: hooks, NotifyUser and TUI settings para ver o funcionamento dos hooks e atualizações de progresso.