Conecte seu celular ao Claude Code no Mac, Windows ou Linux

01O que o pareamento oferece

Depois que o celular está pareado, o Claude Code consegue falar com você quando precisar:

• Um push de "o Claude terminou" assim que um turno acaba.
• Pedidos de permissão que você pode permitir uma vez, permitir para a sessão ou negar.
• Perguntas que você responde escolhendo uma opção.
• Uma nova instrução que você pode enviar logo depois que o Claude termina.

Antes de parear, o ccn já mostra notificações no desktop do computador nesses mesmos momentos. O pareamento adiciona o celular.

O Claude Code Notifier é uma ferramenta independente feita pela TouchTap Ltd. Não é feita pela Anthropic nem tem vínculo com ela. Ele funciona pelos hooks do Claude Code, então cobre toda sessão do claude em qualquer terminal, incluindo os terminais dentro das IDEs VS Code, Cursor e JetBrains.

02Antes de começar

Você precisa de:

• Claude Code instalado e funcionando no computador.
• O app Claude Code Notifier no celular, da App Store ou do Google Play. Se você escanear o QR code antes de ter o app, o celular já abre a loja para você.
• Conexão de rede nos dois dispositivos.

O app é grátis para baixar e exige uma assinatura ou compra vitalícia para usar, com teste grátis no plano anual. Veja os preços.

03Duas formas de parear

Há dois caminhos. Os dois chegam ao mesmo resultado, então escolha o mais fácil para você.

Os links do QR code e os códigos de 6 dígitos valem por 24 horas.

04Opção 1: escanear um QR code

No Mac ou no Linux

1. Abra um terminal e instale o ccn:

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

Ou com Homebrew:

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

2. Execute ccn (ou ccn pair). Ele instala os hooks, se necessário, e exibe um QR code e um link.
3. Aponte a câmera do celular para o QR code e abra o link. Se o app estiver instalado, ele abre e faz o pareamento. Se não estiver, o celular oferece primeiro a App Store ou o Google Play; instale o app e o pareamento continua.
4. O terminal confirma que o celular foi pareado.

No Windows

1. Abra o PowerShell e instale o ccn (o suporte ao Windows está em beta):

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

2. Execute ccn pair. O PowerShell mostra um QR code e um link.
3. Escaneie com a câmera do celular, como acima.
4. O PowerShell confirma que o celular foi pareado.

Com Node.js ou como plugin, em qualquer sistema

Se você tem Node.js, este comando instala e já inicia o pareamento:

npx @touchtap/ccn

Ou, dentro do Claude Code, instale como plugin e execute o comando de configuração:

/plugin install ccn --marketplace touch-tap/ccn
/ccn:setup

05Opção 2: digitar um código de 6 dígitos

Esta opção começa pelo celular, o que ajuda quando você não consegue ver bem a tela do computador ou quando o Claude Code roda em um servidor que você acessa via SSH.

1. Abra o app Claude Code Notifier e vá em Computers > Add a computer.
2. O app mostra um código de 6 dígitos e a linha exata a executar no seu sistema operacional.
3. Execute essa linha no computador. Se o ccn já estiver instalado, basta:

ccn pair 482913

Use o seu próprio código no lugar de 482913.

Instale e pareie em uma linha

Todas as linhas de instalação aceitam o código, então um computador novo precisa de um único comando.

No Mac ou no Linux:

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

No Windows, no PowerShell:

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

Como plugin do Claude Code, passe o código para o comando de configuração: /ccn:setup 482913.

06Confira se funciona

Dois comandos confirmam que está tudo certo:

ccn doctor   # checks hooks, credentials, server connection and presence detection
ccn test     # sends a test notification to your phone

Depois, teste de verdade. Inicie o claude, dê uma tarefa pequena e saia de perto do teclado. Quando ele terminar, seu celular recebe um push.

O ccn percebe quando você está no computador. Se você digitou algo nos últimos 30 segundos, pedidos de permissão e perguntas aparecem no terminal normalmente, e o celular recebe no máximo um aviso. Saia de perto para ver o celular assumir.

07Pareando mais de um dispositivo

• Vários computadores, um celular. Repita os passos em cada computador. Seu Mac do trabalho, a máquina Linux de casa e o notebook Windows podem notificar o mesmo celular. Executando várias sessões do Claude Code explica como diferenciá-las.
• Vários celulares, um computador. Pareie cada celular com o mesmo computador.
• Ver ou remover celulares. ccn devices lista os celulares pareados, e ccn devices revoke <name> remove um deles.

08Scripts e máquinas remotas

ccn pair --no-wait exibe o QR code e retorna na hora, o que é ideal para scripts e provisionamento. Em um servidor via SSH, a opção do código de 6 dígitos costuma ser a mais simples, já que você digita o código na mesma sessão SSH que usa para o Claude Code. Notificações do Claude Code em um servidor remoto via SSH cobre o resto dessa configuração.

09Se o pareamento não funcionar

• O código foi recusado. Os códigos valem por 24 horas. Gere um novo no app ou use a opção do QR code.
• O QR code não é lido. Aumente a janela do terminal ou abra no celular o link exibido.
• ccn não é encontrado após a instalação. Abra um novo terminal para que o seu PATH seja atualizado.
• Pareado, mas nenhum push chega. Rode ccn doctor, depois ccn test, e confira nas configurações do celular se as notificações do app estão permitidas.

A lista completa está em Notificações do Claude Code não funcionam? Um checklist.

10Ainda não quer parear?

Sem problema. As notificações no desktop funcionam assim que o ccn é instalado. Enquanto nenhum celular estiver pareado, o ccn sugere de vez em quando o ccn pair. Para desativar as sugestões:

ccn config set pair_nudges off

11Perguntas frequentes