Guia
Como ser avisado quando o Claude Code termina ou precisa da sua aprovação
Resposta curta: Quatro formas de ser avisado quando o Claude Code termina ou precisa de um sim ou não, e como responder de qualquer janela sem vigiar o terminal.
O Claude Code trabalha sozinho e depois para: ou terminou, ou precisa do seu OK para executar algo. Se você está em outra janela, isso pode passar despercebido por minutos. Estas são as formas como as pessoas são avisadas e o que cada uma oferece.
Quatro formas de ser avisado
| Forma | O que você ganha | Ressalva |
|---|---|---|
| Sino do terminal | Um bipe quando algo acontece | Sem mensagem, sem projeto, e fácil de perder |
| Seu próprio script de hook | Uma notificação de desktop que você mesmo projeta | Você escreve e mantém o script; ele avisa, mas você ainda troca de janela para responder |
| Os alertas do próprio terminal | Notificações do app em que você roda o Claude Code | O suporte depende do terminal, e cobre apenas o Claude Code |
| Herdbell | Um brilho, som ou notificação, mais um card para responder ali mesmo | Um app para Mac (macOS 14 ou posterior), pago uma única vez |
O Claude Code pode executar um comando à sua escolha quando termina ou pede permissão (hooks como Stop e PermissionRequest). É nisso que tanto o script caseiro quanto o Herdbell se baseiam. Veja Hooks do Claude Code, explicados.
Com o Herdbell
Som e notificações do sistema são opcionais e vêm desligados, então você escolhe o volume. Tudo fica no seu Mac.
- Conecte o Claude Code na configuração inicial (ou na página Agentes). O Herdbell faz backup das configurações dele antes.
- Inicie um chat como de costume. Quando o Claude Code termina, seu ponteiro brilha em verde. Quando precisa de permissão, brilha em âmbar e um card mostra o comando.
- Pressione Return para permitir ou D para negar, ou digite uma resposta para enviá-la direto ao mesmo chat.
Qual você deve escolher?
Se você roda só um chat em um terminal de que gosta, um script de hook é um ótimo começo gratuito. Se roda vários chats, usa vários agentes ou quer responder em vez de apenas ser avisado, um popup que funciona em todo lugar poupa a troca de janelas.
Perguntas frequentes
O Claude Code me avisa por conta própria?
Depende da sua configuração e do terminal. Os alertas integrados não são iguais em todo lugar, e é por isso que muita gente adiciona um script de hook ou uma ferramenta como o Herdbell.
O Claude Code pode tocar um som quando termina?
Sim. O Herdbell pode tocar um som curto (opcional, desligado por padrão) quando o Claude Code termina, pede permissão, tem uma pergunta ou falha. Ative em Settings.
Posso receber notificações do Claude Code no celular?
Não com o Herdbell: ele é um app de Mac e avisa você no Mac, com um brilho, um som opcional e notificações do sistema opcionais.
Posso responder ao Claude Code sem abrir o terminal?
Sim, com o Herdbell. Uma solicitação de permissão aparece como um card no cursor e você responde com uma tecla, e pode responder quando ele termina.