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.