O Claude Code a partir do telemóvel

O que é e porque importa

Estás no comboio e lembras-te da coisa que tens de corrigir. Mas o projeto está no computador, em casa. O Remote Control é a funcionalidade oficial do Claude Code para isto: liga a app Claude no telemóvel (iOS ou Android), ou o claude.ai/code num browser, a uma sessão do Claude Code que corre no teu computador.

O que conta: o Claude trabalha no teu computador, não na nuvem. Ficheiros, ferramentas, servidores MCP e definições do projeto ficam lá. O telemóvel é só uma janela para essa sessão, e a conversa é a mesma em todo o lado: podes escrever no terminal, no browser e no telemóvel, alternando.

O Remote Control saiu da research preview, a fase de testes. Nada de bots caseiros e nenhuma porta aberta no computador. O preço: o computador fica ligado, com o Claude Code aberto.

1. O que precisas

• Uma subscrição Pro, Max, Team ou Enterprise. Com uma chave de API não funciona.
• Em Team e Enterprise, primeiro um Owner da organização liga o interruptor Remote Control nas definições de administração do Claude Code: por defeito está desligado.
• Ter sessão iniciada com a tua conta claude.ai: no Claude Code escreve /login.
• O Claude Code ligado diretamente à API da Anthropic. Não funciona com Amazon Bedrock, Google Cloud ou Microsoft Foundry, nem se ANTHROPIC_BASE_URL apontar para outro endereço, como um gateway ou um proxy.
• A app Claude no telemóvel, com a mesma conta. Se não a tens, escreve /mobile no Claude Code: aparece um QR que abre a loja certa.

Se alguma coisa não arranca, escreve claude doctor no terminal: diz-te que verificação falhou.

2. Liga-o no computador: três formas

Modo servidor: claude remote-control

É o que uso para o telemóvel. Na pasta do projeto escreve:

claude remote-control

O terminal fica à espera e mostra-te o link da sessão. Carrega na barra de espaço e aparece um QR: lês com o telemóvel e abre na app Claude. Neste modo não escreves no terminal: mostra o estado da ligação e o que o Claude está a fazer. Em troca podes abrir várias sessões ao mesmo tempo.

Sessão normal: claude --remote-control

Abre a sessão do costume no terminal, onde podes escrever, e também fica acessível a partir do telemóvel. A forma curta é claude --rc, e podes dar-lhe um nome: claude --remote-control "O meu projeto".

A partir de uma sessão já aberta: /remote-control

Já estás a trabalhar e tens de sair? Escreve /remote-control (ou /rc) na sessão: continuas no telemóvel com toda a conversa até aí. Também funciona na app de desktop do Claude e na extensão do VS Code.

3. A primeira vez: as perguntas a não saltar

Da primeira vez, o claude remote-control explica o que faz e pergunta Enable Remote Control? (y/n). Responde y. Se disseres que não, sai sem arrancar e volta a perguntar da próxima vez.

Se ainda não confiaste nessa pasta, diz-te o que fica ligado ao confiar e pergunta Trust <pasta>? [y/N]. A resposta fica guardada, exceto na tua pasta pessoal: aí pergunta em cada arranque. Por isso lanças no diretório do projeto.

Também pode perguntar como criar as sessões. Com same-dir trabalham todas na mesma pasta, e se duas mexerem no mesmo ficheiro atrapalham-se. Com worktree cada sessão nova tem a sua própria cópia do projeto (um worktree do git). Se abres uma sessão de cada vez, same-dir serve. Enquanto corre, mudas carregando em w.

4. No telemóvel: o cartão do teu computador

1. Abre a app Claude e toca em Code.
2. No topo encontras o teu computador como cartão de dispositivo. Está lá enquanto o claude remote-control estiver a correr.
3. Toca nele, escolhe a pasta do projeto, e arranca uma sessão lá, no teu computador.
4. As sessões já abertas estão na lista abaixo: as do Remote Control têm o ícone de um computador, com uma bolinha verde quando estão online.

Agora escreve como farias no computador; com @ completas os nomes dos ficheiros do projeto. Podes anexar uma foto ou um ficheiro, mesmo sem texto: o Claude vê as fotos diretamente na mensagem, e os outros ficheiros o Claude Code descarrega-os no computador e passa-os ao Claude. Perfeito para um bug que vês no telemóvel:

Envio-te a captura de um erro que vejo no telemóvel. Descobre de onde vem no código, corrige-o e corre os testes. Quando os testes acabarem, manda-me uma notificação com o resultado.

5. As notificações no telemóvel

O Claude pode mandar-te uma notificação quando acaba um trabalho longo ou quando precisa de uma decisão tua. Ligam-se assim:

1. Na app Claude, entra com a mesma conta e a mesma organização que usas no Claude Code.
2. Aceita a permissão de notificações quando o telemóvel pedir.
3. No terminal escreve /config e liga Push when Claude decides (as notificações que o Claude decide enviar), Push when actions required (permissões e perguntas), ou as duas.

Se no /config vês No mobile registered, abre a app Claude no telemóvel: atualiza a ligação para as notificações. E enquanto escreves no terminal ligado não chegam, porque já lá estás.

6. Computador ligado, rede que falha

• Se o portátil entra em suspensão ou a rede falha, o Claude Code volta a ligar-se sozinho quando o computador volta a estar online. Enquanto dorme, porém, o Claude não trabalha.
• Se o computador está ligado mas fica muito tempo sem rede, em modo servidor o Claude Code desiste ao fim de cerca de 10 minutos e o claude remote-control fecha: tens de o lançar outra vez. Uma sessão normal continua a tentar até a rede voltar.
• Se fechares o terminal ou parares o servidor com Ctrl+C, a sessão fica offline. Se voltares a lançar o claude remote-control na mesma pasta dentro de cerca de quatro horas, recuperas as sessões de antes.

Para manter um Mac acordado há o caffeinate, um comando que já vem com o macOS: lançado assim, impede a suspensão por inatividade enquanto o servidor estiver aberto. Mas deixa a tampa aberta.

caffeinate -i claude remote-control

Os erros mais comuns

• Ter a ANTHROPIC_API_KEY definida: a sessão usa a chave em vez da subscrição e o Remote Control não arranca. Tira-a do terminal ou do bloco env do settings.json.
• Lançar o claude remote-control a partir da pasta pessoal: a pergunta de confiança volta em cada arranque e a sessão não arranca no projeto.
• Fechar o portátil e esperar que o Claude continue. Só trabalha enquanto o computador está acordado e o comando aberto.
• Esperar notificações sem as ter ligado no /config. No iPhone verifica também os modos de Foco e o resumo de notificações, que as podem bloquear ou atrasar.

Checklist

• Tenho um plano Pro, Max, Team ou Enterprise, e em Team ou Enterprise o Owner ligou o Remote Control
• Fiz /login com a conta claude.ai, sem chaves de API definidas
• O claude remote-control está aberto na pasta do projeto
• Na app Claude, em Code, vejo o meu computador no topo
• Enviei uma foto do telemóvel e o Claude viu-a
• As notificações estão ligadas no /config
• O computador fica ligado e não entra em suspensão

Perguntas frequentes