Para receber uma notificação quando o Claude Code termina, rode-o dentro do AgentVera: você recebe uma notificação no desktop quando um turno acaba, um erro para o agente ou ele espera sua aprovação, e os mesmos eventos podem chegar ao seu celular pelo Telegram ou pelo app móvel do AgentVera. Você não precisa escrever um script de hook nem manter o terminal à vista. Os alertas funcionam do mesmo jeito para Codex, Copilot CLI e todos os outros agentes CLI do app.
Este post cobre o que dispara cada notificação, como configurar alertas no desktop e no celular, como funcionam os lembretes de aprovação e como reduzir o barulho.
Por que você precisa de notificações para agentes de código
Um agente de código passa minutos em uma tarefa e depois para por um de dois motivos: terminou, ou precisa de você. Se você está em outra janela, os dois parecem iguais: nada acontece. O agente esperando um sim para npm install é o caro, porque não trabalha até você perceber.
Boas notificações respondem a três perguntas sem abrir o terminal:
- Qual agente parou?
- Ele terminou, falhou ou pediu permissão?
- Consigo responder daqui?
O que dispara uma notificação
O AgentVera observa o terminal de cada agente e o estado dele, então sabe quando um agente está trabalhando, esperando uma resposta ou esperando uma aprovação.
| Evento | Desktop | Telegram | App móvel |
|---|---|---|---|
| Aprovação necessária | Sim | Sim, com os botões Approve, Deny e Always allow | Sim, push |
| Turno do agente terminado | Sim, turnos com mais de 15 segundos | Sim, duração mínima de turno que você define | Sim, push |
| Agente terminou e saiu | Sim (“Task completed”) | ||
| Erro | Sim | Sim (“Agent failed”) | Sim, push |
| Achado importante da revisão de código | Sim, médio ou alto | ||
| Alertas de conta e de limite | Sim | Limites de uso acima de 90% | |
| Tarefa agendada falhou | Sim |
Cada evento do desktop e do Telegram pode ser ligado ou desligado separadamente.
Configure as notificações no desktop
Abra Settings → Notifications. A parte On this computer tem:
- Desktop notifications, com os quatro eventos: Approval needed, Agent turn finished, Task completed e Error. Todos vêm ligados por padrão.
- Dock badge, o número de agentes esperando uma aprovação ou uma resposta, no ícone do app.
- Keep the computer awake, ligado por padrão. Enquanto o AgentVera está aberto, o computador não entra em repouso, como com o
caffeinate; a tela ainda pode desligar. Isso importa em execuções longas: um agente não consegue terminar se o notebook estiver dormindo.
As notificações no desktop aparecem enquanto o AgentVera está em segundo plano. Clique em uma e o app abre aquele agente, pronto para a sua resposta.
Dentro do app, a barra de status mostra quantas aprovações estão esperando, e ⇧⌘A pula para o agente que está esperando há mais tempo.
Receba avisos no celular com o Telegram
O Telegram é o jeito mais rápido de receber alertas de agentes no celular, e precisa só de uma conta gratuita no AgentVera.
- Vá em Settings → Notifications → Phone notifications.
- Pressione Connect Telegram e abra o link ou escaneie o QR code. O link funciona uma vez e vale por 10 minutos. Se preferir, você pode usar o seu próprio bot; o token dele fica criptografado no seu keychain.
- Em When to notify, escolha os eventos. Para turnos terminados, defina a duração mínima do turno (60 segundos por padrão) para que respostas curtas não te chamem.
- Pressione Send test para conferir se chega.
Duas opções definem o que você recebe. Include a short excerpt of the agent’s reply acrescenta o final da resposta; desligue e só “finished its turn” é enviado, sem código nem conteúdo do projeto. A separate topic per agent dá a cada agente um tópico próprio no chat do bot, e tudo o que você escreve ali vai direto para aquele agente.
O Telegram faz bem mais do que notificar: você pode iniciar agentes e enviar mensagens, fotos e arquivos. Isso está em controle o Claude Code pelo Telegram; este post fica nos alertas.
Notificações push no app móvel
O app móvel do AgentVera para iOS e Android envia notificações push para pedidos de aprovação, turnos terminados, falhas, lembretes de tarefas e limites de uso acima de 90%. As notificações não levam código nem texto de mensagens. Para vincular, faça login dos dois lados e ligue Control from your phone nas configurações do app desktop. Os apps ainda não estão na App Store nem no Google Play.
Sem o app, a visão pelo celular no navegador do seu celular mostra o status de cada agente, a última resposta dele e o diff do que ele terminou. Mais sobre o app no nosso post sobre o app móvel do Claude Code.
Nunca perca uma aprovação
Uma aprovação que ninguém responde é um agente travado. O AgentVera tem um lembrete exatamente para isso: Settings → Orchestration → Pending approval alert, com Remind me about agents waiting for approval ligado por padrão.
- O primeiro lembrete chega depois de 5 minutos sem resposta, como notificação no desktop e mensagem no Telegram com botões de aprovação.
- Ele se repete a cada 15 minutos até você responder, até três vezes.
- Cada lembrete chama mais atenção que o anterior (o ícone pula no Dock ou pisca na barra de tarefas).
Os dois tempos são ajustáveis. Se você vive aprovando os mesmos comandos seguros, reduza os pedidos na origem com regras de aprovação automática (Pro e Team) em vez de responder todos à mão. Nosso guia sobre permissões do Claude Code explica o equilíbrio.
Notificações vs hooks do Claude Code
O Claude Code pode rodar um script em eventos pelos hooks dele, e você pode montar um notificador assim. A diferença é o alcance.
| Hooks do Claude Code | Notificações do AgentVera | |
|---|---|---|
| Configuração | Um script por evento nas suas configurações | Chaves em Settings |
| Agentes | Só o Claude Code | Todo agente CLI no app |
| Celular | Você mesmo monta | Telegram e app móvel já embutidos |
| Responder uma aprovação de longe | Só se você construir | Botões Approve e Deny |
Hooks continuam sendo a ferramenta certa para checagens que precisam rodar em toda edição. Veja o guia de hooks do Claude Code para esses casos.
Reduza o barulho
- Aumente a duração mínima do turno no Telegram se respostas rápidas ficam vibrando seu celular.
- Deixe erros e aprovações ligados. São os alertas que destravam o trabalho.
- Use um tópico por agente para que um agente agitado não soterre os outros.
- Deixe o turno da noite reportar de manhã. Durante um night shift (Pro e Team), o relatório da manhã chega como notificação no desktop e resumo no Telegram, em vez de um aviso por tarefa; veja rode o Claude Code durante a noite.
Comece agora
Baixe o AgentVera, abra um projeto e inicie o Claude Code ou qualquer outro agente. As notificações no desktop funcionam na hora; conecte o Telegram em Settings quando quiser recebê-las no celular. Notificações e aprovações fazem parte do plano gratuito; veja os preços para saber o que o Pro e o Team acrescentam.