Existem cinco formas de receber notificações do Claude Code: a notificação nativa do terminal, um hook escrito por você que mostra um alerta no desktop, um hook que envia um push por um serviço como ntfy, Telegram, Slack ou Discord, o próprio Remote Control da Anthropic com o app mobile do Claude, e uma ferramenta de notificação dedicada. As três primeiras são gratuitas e avisam que algo aconteceu. O Remote Control e as ferramentas dedicadas também permitem responder pelo celular. A melhor opção depende de você só precisar saber ou também precisar agir.
01Visão geral das opções
preferredNotifChannel)No terminal do seu computadorNãoNenhuma, ou uma configuraçãoosascript, notify-send, PowerShell)No seu computadorNãoAlgumas linhas no settings.json02Nativo: o terminal avisa você
O Claude Code já dispara uma notificação quando termina ou fica esperando um prompt de permissão e parece que você não está por perto. Por padrão, ele envia uma notificação de desktop no iTerm2, Ghostty e Kitty, toca o bell no Apple Terminal só em um caso específico e não faz nada nos outros terminais. A configuração preferredNotifChannel muda isso, por exemplo para "terminal_bell", para que todo terminal receba o caractere de bell.
Pontos fortes: não precisa instalar nada e funciona via SSH em terminais que repassam a notificação. Limitações: só chega ao computador à sua frente, muitos terminais (incluindo os de IDE) não recebem nada por padrão e você não consegue responder. Os detalhes estão no guia do terminal bell.
03Seus próprios hooks: alertas no desktop
Os hooks permitem que o Claude Code execute um comando em pontos definidos. Um hook Notification dispara quando o Claude precisa da sua atenção (um prompt de permissão esperando há cerca de seis segundos, ou o Claude ocioso por uns 60 segundos depois de terminar). Um hook Stop dispara no instante em que um turno termina. Aponte qualquer um deles para o comando de notificação da sua plataforma e você terá alertas no Mac, Windows e Linux em qualquer terminal. O guia para ser notificado quando o Claude terminar mostra o passo a passo.
Pontos fortes: grátis, privado, totalmente sob seu controle e sem precisar de rede. Limitações: continua restrito àquele computador, e num servidor headless ou via SSH o comando de desktop não tem onde aparecer (veja notificações via SSH).
04Seus próprios hooks: push no celular
O mesmo hook pode chamar um serviço de push. As opções mais comuns:
- ntfy: publique num tópico com uma linha de
curle receba no app ntfy no iPhone ou Android. É grátis no ntfy.sh, e você pode hospedar seu próprio servidor. Veja o guia do ntfy. - Pushover: uma API com uma cota mensal gratuita de mensagens e apps próprios. As mensagens têm limite de 1.024 caracteres.
- Telegram, Slack ou Discord: um bot ou um incoming webhook posta uma mensagem num chat que você já acompanha. Veja o guia de Telegram, Slack e Discord.
Pontos fortes: chega ao seu celular onde você estiver, é barato ou grátis, e você vê exatamente o que é enviado. Limitações: é só de ida. O celular avisa que o Claude está esperando, mas a sessão continua aguardando você voltar ao teclado. Você também precisa cuidar de segredos (nomes de tópicos, tokens, URLs de webhook) e decidir quando não enviar, porque o hook dispara esteja você na mesa ou não.
05Remote Control da Anthropic e o app do Claude
O Remote Control conecta o app do Claude no iPhone e Android, ou o claude.ai/code no navegador, a uma sessão do Claude Code rodando no seu computador. Você vê a conversa inteira e pode digitar nela, e os prompts de permissão e as perguntas do AskUserQuestion são encaminhados para o celular. Com Push when actions required e Push when Claude decides ativados em /config, o app envia notificações push. Ele não as envia enquanto você está digitando no terminal conectado ou com ele em foco.
Pontos fortes: feito pela Anthropic, a sessão completa no celular, sem terceiros. Limitações (segundo a documentação da Anthropic): exige um plano Pro, Max, Ultra, Team ou Enterprise com login pelo claude.ai, não suporta API keys e não está disponível com Amazon Bedrock, Agent Platform do Google Cloud, Microsoft Foundry ou um ANTHROPIC_BASE_URL personalizado. No Team e no Enterprise, um Owner precisa ativá-lo. A sessão precisa ser iniciada com o Remote Control (ou configurada para conectar na inicialização), e é o Claude que decide quando enviar os pushes "decides"; não há configuração por evento além das duas opções.
06Ferramentas dedicadas de notificação
Várias ferramentas são construídas sobre os hooks acima e adicionam uma forma de responder.
- claude-remote-approver é um pacote npm open source (MIT) que usa o hook
PermissionRequeste o ntfy. Cada pedido de permissão vira uma notificação com botões Approve e Deny, e as opções doAskUserQuestiontambém viram botões. Se nada voltar dentro do timeout (120 segundos por padrão), o Claude Code volta para o prompt no terminal. - Pushary é um serviço hospedado configurado com
npx pushary@latest setup. Ele instala hooks do Claude Code, envia um push quando o Claude termina e permite aprovar ou responder pelo celular. - Claude Code Notifier (o nosso) é o
ccn, uma ferramenta de linha de comando gratuita para Mac, Windows e Linux, mais apps para iPhone e Android. É independente e não é feito pela Anthropic.
Outros projetos open source enviam alertas para o ntfy, o Discord ou o desktop com um script pronto. Vale a pena conferir se você quer fazer por conta própria sem escrever o script.
07Onde o Claude Code Notifier se encaixa
Se alertas de mão única são tudo o que você precisa, um hook de dez linhas com ntfy ou o notificador do seu desktop resolve muito bem, e não custa nada.
O Claude Code Notifier é para o momento depois do alerta. Instalado sozinho, o ccn mostra uma notificação no desktop do Mac, Windows ou Linux quando o Claude termina, precisa de uma permissão ou faz uma pergunta. Com um celular pareado, você pode:
- permitir uma vez, permitir para a sessão ou negar um pedido de permissão pelo celular
- escolher uma resposta quando o Claude pedir que você decida
- enviar a próxima instrução logo depois que o Claude terminar
Ele também detecta sua presença. Se você digitou nos últimos 30 segundos, nada fica esperando: o terminal pergunta normalmente e o celular recebe no máximo um aviso. Se você está longe, o terminal espera a resposta do celular até um limite que você define, e para de esperar assim que você toca no teclado. Como é um hook, funciona em qualquer terminal, incluindo os de IDE, e não precisa do Remote Control ativado na sessão. Os apps de celular exigem uma assinatura ou uma compra vitalícia; veja os preços. Instale pela página do ccn.
08Como escolher
- Você fica no computador e quer só um toque: a notificação nativa ou um hook de desktop.
- Você quer que o celular vibre e vai voltar até o computador para responder: ntfy ou um webhook de chat.
- Você quer a conversa inteira no celular e faz login com um plano do claude.ai: Remote Control.
- Você quer aprovar, responder e continuar pelo celular, com alertas que ficam em silêncio enquanto você está no teclado: uma ferramenta dedicada como o Claude Code Notifier.
09Perguntas frequentes
O Claude Code tem notificações nativas?
Sim. Ele envia uma notificação de desktop no iTerm2, Ghostty e Kitty, e você pode definir preferredNotifChannel como "terminal_bell" para ter o bell em qualquer terminal. Só chega ao computador que está rodando o terminal. Para push no celular, a Anthropic oferece o Remote Control com o app do Claude.
Qual é a forma gratuita de receber notificações do Claude Code no celular?
Um hook Notification ou Stop que roda curl para um tópico gratuito do ntfy, mais o app ntfy no celular. O guia do ntfy tem uma configuração pronta para copiar e colar. Ele avisa que o Claude está esperando, mas não responde por você.
Posso aprovar pedidos de permissão do Claude Code pelo celular?
Sim, com o Remote Control ou com uma ferramenta construída sobre o hook PermissionRequest, como o claude-remote-approver ou o Claude Code Notifier. Veja como aprovar permissões pelo celular.
Posso usar várias dessas opções ao mesmo tempo?
Sim, hooks de fontes diferentes rodam todos. Evite duas ferramentas que respondam a pedidos de permissão, e conte com alertas duplicados se duas ferramentas notificarem o mesmo evento.