Instale pelo terminal

ccn · macOS, Linux e Windows · gratuito

O ccn é um pequeno programa que o Claude Code executa por meio de seus hooks. Ele envia uma notificação push ao seu celular quando o Claude termina ou precisa de você e permite aprovar, negar ou responder de lá. Nada roda em segundo plano e funciona em qualquer terminal.

o código Abra o Claude Code Notifier no celular e adicione um computador. O app mostra um código de 6 dígitos e o comando exato a executar, já com o código. Ainda não tem o app? Baixe para iOS ou Android.

01Instalar e conectar

macOS e Linux

curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913

Windows (PowerShell)

irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913

O suporte ao Windows está em beta.

Homebrew

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913

Para quem tem Node.js

npx @touchtap/ccn pair 482913

Cada linha instala o ccn e o conecta de uma vez. Para instalar sem código, omita-o (| sh ou a parte antes de &&) e execute ccn pair CODE depois. Troque 482913 pelo código do seu celular. Os códigos duram 5 minutos; o app gera um novo quando expira. A conexão adiciona sete entradas a ~/.claude/settings.json e deixa o resto do arquivo como estava.

02O que você recebe

  • O Claude terminou: uma notificação push assim que um turno acaba.
  • Permissões: permitir uma vez, permitir na sessão ou negar, pelo celular.
  • Perguntas: escolha uma resposta quando o Claude pedir que você decida.
  • Uma instrução seguinte: logo depois que o Claude termina, envie a próxima instrução pelo celular.

Se você digitou nos últimos 30 segundos, nada fica esperando: o terminal pergunta como de costume e o celular recebe um aviso. Se você está ausente, o terminal espera pelo celular e para de esperar assim que você toca no teclado. Você pode ajustar os tempos de cada computador no app.

03Comandos

ComandoO que faz
ccn pair CODEConecta ao celular e instala os hooks
ccn doctorVerifica os hooks, a conexão com o celular e a rede
ccn testEnvia uma notificação de teste
ccn devicesLista os celulares conectados ou revoga um
ccn config showMostra os ajustes deste computador
ccn syncBusca agora os ajustes alterados no celular

04O app para Mac

O app Claude Code Notifier para a barra de menus do Mac continua funcionando e é gratuito. Se você prefere um app a um terminal, baixe-o ou execute brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier. Diferente do ccn, ele pode mostrar notificações do Mac e disparar webhooks sem um celular, e precisa de iTerm2, kitty ou tmux para responder pelo celular. Não use os dois no mesmo Mac, ou cada notificação chega duas vezes. Para trocar o app pelo ccn, conecte com ccn pair CODE --replace-mac-app, que remove os hooks do app, e depois feche o app.

05Desinstalar

ccn uninstall

Isso remove os hooks de settings.json, revoga as conexões e apaga o estado local. Depois, exclua o binário: ~/.local/bin/ccn no macOS e Linux, %LOCALAPPDATA%\Programs\ccn no Windows ou brew uninstall ccn.