Guia

Como executar o Claude Code a partir do telemóvel

Cinco formas práticas de usar o Claude Code no telemóvel, com as contrapartidas de configuração, segurança, disponibilidade, permissões e interface móvel.

A forma fiável de usar o Claude Code a partir do telemóvel é executá-lo num computador ou servidor e tratar o telemóvel como uma interface remota. Assim, o ambiente de desenvolvimento fica intacto e evita-se a tentativa de transformar o iOS ou o Android numa estação de trabalho completa.

Seguem-se cinco abordagens úteis, ordenadas da experiência oficial mais simples até à infraestrutura remota mais configurável.

Antes de escolher uma interface

Decida onde o agente deve correr:

  • No seu portátil: não precisa de mais nenhum servidor, mas o acesso remoto deixa de funcionar quando o portátil entra em suspensão.
  • Num servidor em casa: sempre disponível, desde que a rede e a eletricidade sejam fiáveis.
  • Num VPS: acessível e normalmente sempre ligado, mas exige atualizações de segurança, cópias de segurança e limites cuidadosos para as credenciais.

A máquina anfitriã consegue ler tudo o que a conta do agente consegue ler. Evite copiar credenciais de produção com permissões amplas para uma máquina sempre ligada só porque a interface no telemóvel é prática.

1. Remote Control da Anthropic

O Remote Control do Claude Code liga uma sessão local em execução ao Claude na web ou na aplicação para iOS/Android. Inicie-o na máquina anfitriã:

claude remote-control

Abra o link da sessão ou leia o código QR na aplicação Claude. O repositório, os servidores MCP e as ferramentas locais continuam na máquina anfitriã.

Indicado para: o caminho suportado mais curto e uma interface oficial pensada para o telemóvel.

Cuidado com: o processo do Claude e a máquina têm de continuar a correr, e o fluxo de trabalho é exclusivo do Claude Code.

2. O canal oficial do Telegram

Os Channels do Claude Code permitem ligar um bot do Telegram com lista de permissões (allowlist) a uma sessão em execução. Pode enviar tarefas, receber respostas e tratar dos pedidos de permissão de ferramentas suportados com os botões Allow e Deny.

Indicado para: quem já usa o Telegram e quer interações curtas, em forma de conversa.

Cuidado com: a segurança do token do bot, um processo na máquina que tem de se manter ativo e uma interface de conversa que não é um terminal completo.

A instalação completa e o modelo de permissões estão descritos em Como ligar o Claude Code ao Telegram.

3. SSH a partir de um terminal no telemóvel

Um cliente SSH para telemóvel liga-se diretamente à máquina de desenvolvimento. Acrescente o tmux para que uma falha de rede não termine o agente:

ssh dev@example-host
tmux new -As claude

Indicado para: acesso total à shell, ferramentas padrão e uma recuperação fácil quando uma interface especializada falha.

Cuidado com: a gestão das chaves SSH, o reforço da segurança da máquina, a acesso à máquina pela rede e a ergonomia pouco prática de uma interface de terminal num ecrã pequeno. Prefira uma VPN ou uma rede overlay a uma porta pública exposta sem grandes cuidados.

4. Um terminal no browser

Ferramentas como o ttyd permitem expor um terminal através do browser. Coloque o terminal atrás de uma rede privada ou de um túnel de saída autenticado e confirme que um pedido não autenticado não lhe consegue chegar.

Indicado para: dispositivos em que um browser é mais prático do que um cliente SSH.

Cuidado com: isto continua a ser acesso remoto a uma shell. A autenticação, os cabeçalhos do proxy, os cookies, as regras de origem, as atualizações e os tempos limite das sessões passam todos a fazer parte da fronteira de segurança.

5. Chatcode

O Chatcode liga um servidor seu a um terminal no browser e ao Telegram através de um gateway com ligação de saída. Pode alojar sessões do Claude Code, Codex, Gemini e OpenCode na mesma interface.

Indicado para: um fluxo de trabalho sempre ligado, com vários agentes, em que o acesso pelo browser e pelo Telegram é um requisito.

Cuidado com: o servidor continua a precisar de administração, e o gateway e o intermediário do Chatcode tornam-se dependências adicionais em que tem de confiar. O SSH continua a ser útil como via de recuperação separada.

O processo passo a passo está em Claude Code no Telegram com o Chatcode.

Que opção escolher?

Necessidade Comece por
Experiência oficial do Claude Remote Control
Mensagens e aprovações no Telegram Plugin oficial Channels
Terminal completo e infraestrutura padrão SSH + tmux
Terminal em qualquer browser móvel Terminal no browser atrás de um túnel privado
Browser + Telegram com vários agentes Chatcode

Comece pelo mínimo de infraestrutura que responda à necessidade. Se o Remote Control servir, há pouco a ganhar em montar um túnel. Se precisa de uma shell sem restrições, um bot de conversa vai parecer limitado, por mais polido que seja.

Perguntas frequentes

O Claude Code pode correr diretamente num telemóvel?

As configurações práticas executam o Claude Code num computador ou servidor e usam o telemóvel como interface remota. A máquina anfitriã guarda o repositório, as ferramentas, as credenciais e o processo do agente.

O que acontece quando a máquina entra em suspensão?

A sessão remota fica indisponível. Use uma máquina sempre ligada, ajuste com cuidado as definições de suspensão ou aceite que um fluxo de trabalho baseado num portátil só funciona enquanto o portátil está acordado e ligado à rede.

Partilhe este guia