O ccn é um pequeno programa que o Claude Code executa por meio de seus hooks, no macOS, Windows ou Linux. Instale-o e você recebe uma notificação no desktop assim que o Claude termina, precisa de uma permissão ou faz uma pergunta. Conecte o celular quando quiser: os mesmos momentos chegam também como notificação push, e de lá você pode aprovar, negar ou responder. Nada roda em segundo plano e funciona em qualquer terminal.

tem um código? Veio do app do celular com um código de 6 dígitos? Pule para Conectar o celular: cada linha de instalação aceita o código e conecta no mesmo passo. Ainda não tem o app? Baixe para iOS ou Android.

01Instalar

macOS e Linux

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

Windows (PowerShell)

irm https://claudecodenotifier.com/web/install.ps1 | iex

O suporte ao Windows está em beta. Pacotes para winget e Scoop estão a caminho.

Homebrew

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

Para quem tem Node.js

npx @touchtap/ccn pair

Cada linha instala o ccn e seus hooks, então na próxima vez que o Claude Code terminar ou precisar de você, uma notificação aparece neste computador. Não precisa de celular e nada roda em segundo plano. O ccn adiciona sete entradas a ~/.claude/settings.json e deixa o resto do arquivo como estava. Tem um código do app do celular? As linhas em Conectar o celular instalam e conectam de uma vez.

02Conectar o celular

Conectar é opcional e nunca trava nada: o ccn continua notificando este computador com ou sem celular conectado. Quando houver um, cada notificação chega também ao celular como push, e de lá você pode aprovar, negar ou responder. Há duas formas de conectar.

Escanear um código QR pelo terminal

ccn pair

Execute ccn ou ccn pair. Ele mostra um código QR e um link válidos por 24 horas: escaneie o código com a câmera do celular ou abra o link no celular. Sem o app, o link oferece primeiro a loja; com ele, o celular se conecta sozinho. ccn pair --no-wait mostra os dois e retorna na hora, para você continuar trabalhando e escanear depois.

Digitar o código do app

ccn pair 482913

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. Se o ccn estiver instalado, basta ccn pair seguido do código. Caso contrário, cada linha de instalação aceita o código e instala e conecta de uma vez:

InstaladorLinha a executar

macOS e Linuxcurl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913

Windows (PowerShell)irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913

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

Para quem tem Node.jsnpx @touchtap/ccn pair 482913

Troque 482913 pelo código do seu celular. Os códigos duram 24 horas; o app gera um novo quando expira.

Depois de dez notificações no desktop sem celular conectado, o ccn acrescenta uma linha sugerindo ccn pair. ccn config set pair_nudges off desativa isso.

03O que você recebe

Sozinho, o ccn mostra uma notificação neste computador quando o Claude termina, precisa de uma permissão ou faz uma pergunta. Com um celular conectado, você também 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.

04Comandos

ComandoO que faz

ccn pairMostra um código QR e um link para conectar um celular (válidos por 24 horas) e aguarda

ccn pair CODEConecta com o código de 6 dígitos do app

ccn pair --no-waitMostra o código QR e o link e retorna na hora

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 config set pair_nudges offDesativa a sugestão de conectar após as notificações no desktop

ccn syncBusca agora os ajustes alterados no celular

ccn upgradeAtualiza o ccn para a versão mais recente agora

ccn config set auto_update offDesativa a verificação diária de atualizações

ccn unlockCompra uma licença e desbloqueia este computador (veja Licença)

05Licença

Uma licença comprada em claudecodenotifier.com/licence desbloqueia todo celular conectado a até 3 computadores. Ela fica no computador: você digita a chave no ccn, nunca no app do celular.

ccn unlockCompra uma licença no navegador e desbloqueia este computador (--lifetime para pagar uma vez)

ccn activate KEYUsa sua chave neste computador (--replace NAME libera a vaga de outro computador)

ccn deactivateLibera a vaga deste computador para usar a chave em outro lugar

ccn licenceMostra o plano, a data de renovação e os computadores que usam a chave

Sem licença, o ccn pode mostrar uma linha por dia no Claude Code, e uma notificação no desktop, explicando como desbloquear. CCN_NO_NUDGE=1 desativa isso.

06Atualizações

ccn upgrade

O ccn se mantém atualizado sozinho: uma vez por dia, verifica em segundo plano se há uma versão nova e a instala. ccn upgrade atualiza na hora, e ccn config set auto_update off desativa a verificação diária. Se você instalou com Homebrew ou npm, o ccn deixa a atualização para o seu gerenciador de pacotes e informa o comando a executar.

07O 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 disparar webhooks, 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.

08Desinstalar

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.

ccn forget

Exclui este computador do servidor de retransmissão e remove o ccn.