# Aviso quando o Claude Code termina ou precisa de você

URL: https://agentvera.dev/pt/blog/claude-code-notifications/ · Publicado: 2026-10-24

Notificação do Claude Code: receba alertas no desktop, no celular e no Telegram quando um agente de código termina um turno, falha ou espera sua aprovação.

**Resumo:**

- O AgentVera envia uma notificação no desktop quando um agente precisa de aprovação, termina um turno com mais de 15 segundos, conclui a tarefa ou para com um erro.
- No celular, o Telegram avisa quando um agente termina ou falha e deixa você aprovar ou negar direto na mensagem; o app móvel do AgentVera acrescenta notificações push.
- Uma aprovação sem resposta é repetida até três vezes, e o badge do Dock conta os agentes esperando por você. Funciona para todo agente CLI que você roda no AgentVera.

**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:

1. Qual agente parou?
2. Ele terminou, falhou ou pediu permissão?
3. 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.

1. Vá em **Settings → Notifications → Phone notifications**.
2. 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.
3. 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.
4. 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](/pt/blog/control-claude-code-from-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](/pt/features/review-from-phone/) 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](/pt/blog/claude-code-mobile-app/).

## 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](/pt/features/auto-approval/) (Pro e Team) em vez de responder todos à mão. Nosso guia sobre [permissões do Claude Code](/pt/blog/claude-code-skip-permissions/) 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](/pt/blog/claude-code-hooks-guide/) 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](/pt/features/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](/pt/blog/run-claude-code-overnight/).

## Comece agora

[Baixe o AgentVera](/pt/download/), 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](/pt/pricing/) para saber o que o Pro e o Team acrescentam.

## Perguntas frequentes

**Como recebo uma notificação quando o Claude Code termina?** Rode o Claude Code dentro do AgentVera e deixe as notificações no desktop ligadas. Quando um turno com mais de 15 segundos termina e o agente espera sua resposta, você recebe uma notificação; clicar nela abre aquele agente. Para o celular, conecte o Telegram em Settings → Notifications.

**Por que não vejo notificação enquanto estou olhando para o AgentVera?** As notificações no desktop aparecem enquanto o app está em segundo plano. Quando o AgentVera está em primeiro plano, você já vê o status do agente no grid, e o badge do Dock e a barra de status mostram quantos agentes esperam uma aprovação.

**Posso aprovar um pedido de permissão pelo celular?** Sim. Com o Telegram conectado, uma aprovação pendente chega com os botões Approve, Deny e Always allow. O app móvel do AgentVera também deixa você responder aprovações por uma notificação push, depois que Control from your phone for ligado em Settings.

**A notificação inclui o meu código?** O Telegram pode incluir um trecho curto da resposta do agente, e você pode desligar isso para que só “finished its turn” seja enviado. As notificações push do app móvel não levam código nem texto de mensagens.

**Funciona com o Codex e outros agentes, não só com o Claude Code?** Sim. As notificações vêm do AgentVera observando o terminal de cada agente, então funcionam para Claude Code, Codex, Copilot CLI e os outros agentes CLI que você roda no app.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/