# Claude Code Remote Control: como programar no telemóvel com um código QR em 2026
> Instruções passo a passo para ligar o Claude Code ao telemóvel através de /rc e de um código QR. Comandos, limites, segurança e 6 erros comuns na primeira utilização.
Source: https://ailoot.ai/blog/pt-pt/claude-code-remote-control-phone/
Canonical: https://ailoot.ai/blog/pt-pt/claude-code-remote-control-phone/
Language: pt-PT
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-052
Revision: sha256-ead001cdcc466a07c341e4984d7a18d72171cc38fa7e213ce36abb76047603ed
Principal conclusão
Execute `claude --rc` no terminal, prima a barra de espaços e leia o código QR com a aplicação Claude no telemóvel. A sessão decorre no portátil; o telemóvel é apenas uma janela para ela. É útil para tarefas durante a noite e para trabalhar no sofá, mas não para editar código a sério. Precisa da versão 2.1.51+ e de uma subscrição Pro ou Max.
Há mais instruções na [documentação da Ailoot](https://ailoot.ai/docs/).
## O que é o Remote Control e porquê programar a partir do telemóvel?
Principal conclusão
O Remote Control é uma ponte entre o Claude Code no portátil e a aplicação Claude no telemóvel ou o navegador claude.ai/code. A sessão decorre na sua máquina; o telemóvel é apenas a interface. A execução e as ferramentas locais permanecem na máquina; o conteúdo das mensagens e dos resultados das ferramentas continua a passar pela Anthropic. É útil quando definiu uma tarefa demorada e quer continuar a orientá-la sem estar sentado ao portátil.
A Anthropic lançou o Remote Control a 24 de fevereiro de 2026. A Anthropic descreve-o como uma forma de continuar sessões locais a partir de qualquer dispositivo.
Em termos simples: inicia uma sessão no terminal como habitualmente. Ativa o Remote Control. Abre a aplicação Claude no telemóvel → o separador Code → e verá a sua sessão com um ponto verde. Toque nela, leia e responda. Pode escrever a partir do portátil, do telemóvel e do navegador, em qualquer combinação — tudo sincronizado.
A [documentação oficial do Remote Control](https://code.claude.com/docs/en/remote-control#connection-and-security) distingue execução local de tráfego de rede: os comandos e as operações sobre ficheiros são executados na sua máquina, enquanto a conversa é sincronizada através da Anthropic.
Essa é a principal diferença em relação ao Claude Code na Web, em que a sessão decorre numa máquina virtual na nuvem da Anthropic. Aqui, o Claude continua a funcionar no seu hardware, com todos os seus repositórios Git, variáveis de ambiente e chaves de bases de dados. O telemóvel é apenas um ecrã que utiliza para falar com ele.
### Porque é que um vibe coder poderá precisar disto
Três situações práticas que o autor utilizava todas as semanas:
1. **Uma refatorização longa durante a noite.** Peça ao Claude para atualizar 40 ficheiros para uma nova API. Afaste-se do portátil. De manhã, deite-se no sofá com o telemóvel, reveja o diff e diga: «Aceita os primeiros 12; mostra-me o resto em separado.» Não precisa de abrir o portátil.
2. **Aprovar uma etapa a caminho do trabalho.** Está no metro quando o Claude envia uma notificação push: «Preciso de uma decisão sobre a migração do esquema.» Abra-a, leia as duas alternativas e escreva: «Escolhe a primeira opção; não mexas nos testes.» A sessão continua enquanto viaja.
3. **Durante uma transmissão em direto ou uma reunião.** Durante uma reunião no Zoom, pode verificar no telemóvel se uma segunda sessão do Claude criou uma compilação de teste. Sem sair da videochamada com Alt+Tab.
## O que precisa para utilizar o Remote Control
Principal conclusão
Claude Code versão 2.1.51 ou posterior e uma subscrição Pro, Max, Team ou Enterprise. As chaves de API não funcionam. Precisa de uma rede com acesso de saída pela porta 443 (sem proxies de interceção). Inicie sessão uma vez no terminal através de claude.ai com `/login` e pode começar. Nos planos Team/Enterprise, um administrador também tem de ativar a opção nas definições da organização.
Tabela completa dos requisitos:
| Elemento | Versão mínima / requisito |
|----|----|
| CLI do Claude Code | v2.1.51 (lançada em 24.02.2026) |
| Extensão do VS Code | v2.1.79 |
| Notificações push | v2.1.110 |
| Subscrição | Pro, Max, Team ou Enterprise |
| Chave de API | Não funciona — apenas OAuth através de `/login` |
| Rede | HTTPS de saída pela porta 443 |
| SO | macOS, Linux, WSL |
| Confiança na área de trabalho | Execute `claude` na pasta do projeto pelo menos uma vez |
| Team/Enterprise | O administrador ativou o Remote Control nas definições de administração |
Verifique a sua versão com:
```bash
claude --version
```
Se for anterior à 2.1.51, atualize:
```bash
npm install -g @anthropic-ai/claude-code@latest
```
Se o seu ambiente tiver `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` ou `apiKeyHelper` definidos, o Remote Control não será iniciado. Desde a v2.1.139 (11.05.2026), a Anthropic bloqueia explicitamente a funcionalidade quando estas variáveis estão presentes. Execute `unset ANTHROPIC_API_KEY` e volte a iniciar sessão com `/login`.
## Como iniciar o Remote Control: 3 formas em 2 minutos
Principal conclusão
Há três formas de iniciar o Remote Control: o comando `claude remote-control`, sem opções, inicia um servidor para sessões remotas; a opção `claude --rc` inicia uma sessão normal com o Remote Control ativado; e o comando `/rc`, dentro de uma sessão ativa, converte-a numa sessão remota. O segundo método é mais prático para a maioria das tarefas.
### Método 1. Modo de servidor — um servidor dedicado a sessões remotas
1. #### Abra um terminal na pasta do projeto
Execute `cd` uma vez para aceder à pasta onde vai trabalhar. Se for uma pasta nova, execute `claude` como habitualmente para concluir a caixa de diálogo de Confiança na área de trabalho.
2. #### Inicie o servidor
```bash
claude remote-control
```
O terminal permanece em execução. Na parte inferior, aparece um URL da sessão e a indicação «Prima a barra de espaços para mostrar o código QR». O servidor fica à espera de ligações.
3. #### Ligue-se a partir do telemóvel
Prima a barra de espaços — aparece o código QR. Leia-o com a aplicação Claude ou com a câmara do iPhone para abrir a sessão.
Opcional: defina o nome e os parâmetros da sessão:
```bash
claude remote-control --name "Refactor API" --spawn worktree --capacity 4
```
- `--name` — o nome da sessão apresentado na lista do telemóvel.
- `--spawn worktree` — cada nova sessão abre no seu próprio worktree Git, para que sessões paralelas não interfiram umas com as outras.
- `--capacity 4` — máximo de 4 sessões remotas simultâneas no servidor. O valor predefinido é 32.
### Método 2. Modo interativo — a minha sessão com o Remote Control ativado
```bash
claude --remote-control
# or shorter:
claude --rc
```
Isto inicia uma sessão interativa normal no terminal, com o Remote Control ativado. Pode escrever ao Claude tanto no portátil como no telemóvel — a conversa é uma única sessão sincronizada.
Ao contrário do modo de servidor, trata-se de uma sessão. É útil se planeia trabalhar sobretudo no computador e quer o telemóvel como alternativa quando precisar de se afastar.
### Método 3. A partir de uma sessão ativa com `/rc`
Já está a trabalhar no Claude Code? Não termine a sessão. Basta escrever:
```
/remote-control
```
ou, mais curto:
```
/rc
```
A sessão passa a ser remota. Não perde o contexto. É útil quando percebe, a meio de uma tarefa, que precisa de se afastar.
## Código QR: ligue o telemóvel em 10 segundos
Principal conclusão
Depois de iniciar o Remote Control no terminal, prima a barra de espaços para mostrar o código QR. Abra a aplicação Claude no telemóvel (iOS ou Android), ou use simplesmente a câmara, e leia o código. A sessão abre na aplicação ou num navegador em claude.ai/code. No mesmo ecrã da aplicação, aparece na lista com um ponto verde que indica que está «online».
1. ### Instale a aplicação Claude
Se ainda não a tiver, escreva `/mobile` no Claude Code. Aparece um código QR para transferir a aplicação da App Store ou do Google Play. É mais rápido do que procurar manualmente.
2. ### Mostre o código QR da sessão no terminal
Depois de executar `claude --rc` ou `claude remote-control`, prima a **barra de espaços**. O código QR aparece diretamente no terminal.
3. ### Leia-o com o telemóvel
Abra a aplicação Claude → câmara, ou utilize a câmara normal do iPhone (as câmaras Android também o conseguem ler). Se não funcionar, aumente a largura da janela do terminal, mude para o iTerm2 ou Windows Terminal, ou copie o URL acima do código QR e cole-o manualmente no navegador.
4. ### Ative as notificações push
Escreva `/config` na sessão e ative «Enviar notificações quando o Claude decidir». O Claude Code tem de estar na versão 2.1.110 ou posterior.
### O que vai ver no telemóvel
O separador Code abre na aplicação Claude. A sessão aparece na lista com um ícone de computador e um ponto verde (online). Toque nela para entrar.
A partir daí, é como no claude.ai/code: pode ver as mensagens do Claude e os diffs dos ficheiros, aprová-los ou rejeitá-los, ou pedir alterações. Pode escrever um novo pedido. Tudo segue para a sua máquina, onde o Claude local o processa e devolve uma resposta.
Trabalhe em ambas as interfaces ao mesmo tempo: a conversa sincroniza-se entre todos os dispositivos ligados — escreva no terminal, no navegador ou no telemóvel, como preferir.
— Documentação da Anthropic, https://code.claude.com/docs/en/remote-control
### O que o Claude pode fazer com as notificações push
O Claude envia notificações push quando considera que são necessárias. Por predefinição, isso acontece em dois casos: termina uma tarefa longa ou o Claude precisa da sua decisão. Também pode pedir explicitamente: «Avisa-me quando os testes passarem», e ele enviará uma notificação.
Se as notificações push não chegarem:
- No iOS, verifique Definições → Notificações → Claude. Os modos de concentração podem silenciá-las.
- No Android, desative a otimização da bateria para a aplicação Claude.
- Se `/config` indicar «Nenhum dispositivo móvel registado», abra a aplicação Claude pelo menos uma vez para atualizar o token push.
## Trabalhar no sofá: 5 situações úteis
Principal conclusão
A verdadeira vantagem do Remote Control é não ter de voltar ao portátil para um único clique de aprovação. Ninguém planeia programar a sério a partir de um telemóvel. Eis cinco situações em que o autor utilizava a funcionalidade todas as semanas: rever uma execução durante a noite, aprovar uma etapa no metro, executar uma tarefa longa durante o almoço, tomar uma decisão de arquitetura num café e usar sessões paralelas em worktrees.
### Situação 1. Revisão no sofá — rever uma execução durante a noite
Antes de dormir, dê ao Claude uma tarefa como «Executa todo o repositório com as novas regras de lint e corrige tudo o que não for crítico; marca o resto como TODO». Execute `claude --rc` e deixe o terminal aberto.
De manhã, deite-se no sofá com o telemóvel. Abra a aplicação Claude → encontre a sessão com um ponto verde → veja 87 commits apresentados como diffs. Percorra-os; nos pontos duvidosos, escreva «reverte isto; vou corrigir manualmente», e nos que estão bem, «aceita tudo». Sem ter de «ir ao portátil» às 7 da manhã.
### Situação 2. Aprovar durante a deslocação — aprovar uma etapa no metro
Inicie de manhã uma migração longa do esquema da base de dados. Às 9:30, chega uma notificação push no metro: «Encontrei duas alternativas de migração; preciso de uma decisão.» Toque nela, leia as opções, escolha uma e acrescente: «Não apagues a tabela antiga até terminar toda a execução dos testes.» O Claude continua.
Sem o Remote Control, o Claude pararia nesse ponto e ficaria à espera em silêncio. Chega ao destino e abre o portátil — 40 minutos perdidos.
### Situação 3. Afastar-se um pouco — uma tarefa longa durante o almoço
Antes de almoçar, peça ao Claude: «Atualiza a documentação de todos os endpoints.» Vá até um café. Passados 25 minutos, chega uma notificação push: «Concluído, veja.» Toque uma vez em «aceitar» e volte à sopa. Sem o Remote Control, ou ficaria 25 minutos ao portátil, como um vigilante, ou voltaria e descobriria que o Claude não fez nada durante todo esse tempo por ter chegado a um ponto de decisão.
Este é um ponto importante. O Remote Control não torna o Claude mais autónomo — apenas lhe dá acesso a partir de qualquer lugar. Quanto menos pontos de decisão o Claude encontrar, menos notificações push receberá. Por isso, seja mais específico nas instruções da tarefa: «Faz assim; nestes casos, faz de outra forma; se for realmente pouco claro, para e envia uma notificação push.»
### Situação 4. Uma decisão de arquitetura num café
A meio de uma refatorização, o Claude encontra dois caminhos de migração e pede-lhe que escolha. Se estiver longe do computador, abra os diffs propostos no telemóvel, escolha uma opção e acrescente o comentário: «Mas não mexas na tabela user_settings — vou eliminá-la na próxima semana.» A sessão continua.
Isto funciona especialmente bem no modo worktree (`--spawn worktree`): cada tarefa paralela fica no seu próprio ramo, para não interferirem umas com as outras. No telemóvel, alterna entre elas como se fossem conversas.
### Situação 5. Várias sessões worktree ao mesmo tempo
Uma abordagem poderosa é combinar o modo de servidor com vários worktrees. Inicie isto no portátil:
```bash
claude remote-control --spawn worktree --capacity 4
```
Inicie sessões em diferentes ramos a partir do telemóvel: uma cria uma funcionalidade, outra corrige erros de uma lista e uma terceira executa testes de regressão. Todas decorrem em paralelo no portátil; nenhuma bloqueia outra.
Atenção
O modo de servidor utiliza recursos do portátil em proporção ao número de sessões simultâneas. Com 16 GB de RAM, quatro sessões paralelas do Claude já se fazem notar. Execute tantas quantas a sua máquina conseguir suportar.
## Segurança: o que fica no computador e o que é enviado
Principal conclusão
As mensagens de chat e os resultados das ferramentas passam pela Anthropic e podem conter código-fonte ou segredos. A execução local não impede essa divulgação. A ligação é apenas de saída pela porta 443, utiliza credenciais de curta duração e é encriptada com TLS. O portátil não abre portas de entrada e o telemóvel remoto não tem acesso direto ao sistema de ficheiros.
Antes de ligar um projeto sensível, decida que conteúdo pode entrar nos pedidos e nos resultados das ferramentas. Mantenha os segredos de produção fora do ambiente acessível ao agente; a tabela de transferências não prova que uma sessão concreta não os possa divulgar.
Uma sessão local do Claude Code faz apenas pedidos HTTPS de saída e nunca abre portas de entrada na sua máquina. Quando inicia o Remote Control, a sessão regista-se na API da Anthropic e consulta-a para saber se há trabalho.
— Documentação da Anthropic, https://code.claude.com/docs/en/remote-control
Em termos simples: o portátil pergunta à Anthropic «Tem alguma mensagem para mim?», recebe uma resposta e processa-a localmente. Ninguém de fora abre uma porta de entrada para a sua máquina. Uma firewall empresarial permite isto sem configuração especial.
### Que dados são enviados fisicamente para a Anthropic
| Tipo de dados | Onde ficam |
|----|----|
| Ficheiros de código-fonte | Guardados localmente; os excertos e diffs incluídos na conversa são transmitidos |
| `.env`, segredos, chaves de API | Podem ser divulgados se forem lidos para um pedido ou resultado de ferramenta; armazenamento local não restringe o acesso |
| Servidores MCP locais e configurações | Executados localmente; o conteúdo devolvido pode entrar na conversa |
| Bases de dados a que o Claude se liga | Permanecem no alojamento configurado; os resultados de consultas podem entrar na conversa |
| Texto das suas mensagens para o Claude | Na API da Anthropic; depois, a resposta regressa |
| Texto das respostas do Claude | Na API da Anthropic e, depois, no seu telemóvel |
| Diffs de ficheiros que o Claude lhe mostra | Através da API da Anthropic (como numa sessão normal do Claude.ai) |
| Imagens importadas e ficheiros através de `@` | Através da API da Anthropic |
O Remote Control acrescenta uma interface sincronizada, não um modo de inferência offline. A Anthropic guarda a transcrição da sessão ligada, incluindo mensagens, respostas e atividade das ferramentas, segundo a sua política de utilização de dados. Reveja tanto os dados enviados ao modelo como o acesso dos dispositivos ligados.
### Uma nota sobre credenciais
A ligação utiliza várias credenciais de curta duração, cada uma com um propósito e um período de validade independentes.
— Documentação da Anthropic, https://code.claude.com/docs/en/remote-control
Por outras palavras, circula um conjunto de tokens de curta duração entre o portátil, a Anthropic e o telemóvel, em vez de um único token de longa duração. Comprometer um deles não dá acesso a todos.
Há mais uma limitação importante: `--dangerously-skip-permissions` não funciona no Remote Control. Cada chamada de ferramenta (Bash, Write, Edit) continua a aguardar a sua aprovação. É deliberado — para impedir que a funcionalidade para telemóvel se transforme num «portátil em piloto automático sem supervisão».
Nota
Se quiser autonomia total («o Claude decide e trabalha sozinho durante 14 horas seguidas sem aprovação»), essa é outra funcionalidade: o modo `/goal`. Leia mais no [guia sobre /goal no Claude Code](https://ailoot.ai/blog/pt-pt/goal-mode-claude-code-codex/). O Remote Control faz outra coisa: permite-lhe orientar o trabalho a partir de qualquer lugar, sem acrescentar autonomia.
## Já iniciou o Remote Control? Agora configure tudo para o Claude não o interromper a cada 10 minutos
Principal conclusão
O Remote Control, por si só, resolve metade do problema: dá-lhe uma janela para a sessão no telemóvel. A outra metade consiste em configurar tudo para que o Claude saiba quando deve parar e perguntar e quando pode continuar sozinho. Pode fazê-lo com CLAUDE.md, uma instrução detalhada no início da tarefa e o modo `/goal`. Assim, recebe notificações push quando são importantes, não a cada 10 minutos.
`/rc` é uma forma prática de levar a sessão para o telemóvel. Mas, se o Claude escrever «Não percebo o que devo fazer» a cada 10 minutos, o problema não é o telemóvel; é a **engenharia de contexto**: a clareza com que define as regras no início.
## Seis problemas na primeira utilização e como os resolver
Principal conclusão
Os problemas mais comuns na primeira ligação são: «Os ambientes Remote Control não estão disponíveis para a sua conta» devido à definição de uma chave de API; o código QR não é lido porque aparece demasiado pequeno no terminal; a firewall bloqueia a porta 443; o Claude Code está desatualizado; as notificações push não se ouvem; ou o Remote Control falha na aplicação Claude Desktop. Cada problema demora 1–2 minutos a resolver.
### Problema 1. «Os ambientes Remote Control não estão disponíveis para a sua conta»
A queixa mais comum no repositório `anthropics/claude-code` (issue \#29449 e mais de uma dúzia de duplicados). Respondeu `y` à pergunta «ativar o Remote Control?» — a CLI devolveu um erro e deixou de oferecer uma nova tentativa.
**A causa é quase sempre a mesma:** `ANTHROPIC_API_KEY` ou `CLAUDE_CODE_OAUTH_TOKEN` está definido no ambiente. O Remote Control só funciona com autenticação OAuth completa através de `/login`, não com uma chave.
**Solução:**
```bash
unset ANTHROPIC_API_KEY
unset CLAUDE_CODE_OAUTH_TOKEN
unset apiKeyHelper
# check that the environment is clean:
env | grep -i anthropic
env | grep -i claude
# sign in again:
claude
/logout
/login
```
Depois de iniciar sessão através do navegador com `/login`, o Remote Control deverá iniciar-se.
### Problema 2. O telemóvel não consegue ler o código QR
A câmara do telemóvel aponta para o código, mas não reage ou diz «Não é possível ler».
**Causa:** o terminal apresenta o código QR demasiado pequeno ou com pouco contraste.
**Solução:**
1. Amplie a janela do terminal para ocupar o ecrã inteiro.
2. Se estiver a utilizar o Apple Terminal, mude para o iTerm2 (ou Warp). No Windows, utilize o Windows Terminal em vez do CMD.
3. Reduza o tamanho da letra do terminal em 1–2 pontos para o código QR aparecer maior.
4. Se isso não ajudar, copie o URL acima do código QR e abra-o no navegador do telemóvel.
### Problema 3. A firewall bloqueia a porta 443
Isto acontece normalmente em computadores empresariais com um proxy de interceção (Zscaler ou uma VPN empresarial com MITM).
Problema de rede ou proxy: uma firewall ou proxy pode bloquear pedidos HTTPS de saída. O Remote Control precisa de acesso à API da Anthropic pela porta 443.
— Documentação da Anthropic, https://code.claude.com/docs/en/remote-control
**Solução:** comece com registos detalhados e recolha o erro específico:
```bash
claude remote-control --verbose
```
Se vir «falha na verificação do certificado», há interceção MITM e tem de falar com o administrador da rede. Se vir «ligação recusada» / «tempo limite excedido», peça ao administrador que permita o acesso de saída a `*.anthropic.com:443`.
### Problema 4. O Claude Code está desatualizado
Verifique:
```bash
claude --version
```
Se for anterior à 2.1.51, atualize:
```bash
npm install -g @anthropic-ai/claude-code@latest
```
A extensão do VS Code requer, pelo menos, a v2.1.79. As notificações push requerem a v2.1.110.
### Problema 5. As notificações push não chegam
Situação: o Remote Control funciona, mas o telemóvel permanece em silêncio quando o Claude termina uma tarefa longa.
**Lista de verificação:**
1. Execute `/config` na sessão. Se indicar «Nenhum dispositivo móvel registado», abra a aplicação Claude no telemóvel pelo menos uma vez para atualizar o token push.
2. iOS: Definições → Notificações → Claude → confirme que as notificações estão ativadas e não são silenciadas pelo modo de concentração.
3. Android: abra as definições da bateria e exclua o Claude da otimização da bateria.
4. Se o Resumo de notificações do iOS estiver ativado, a notificação push poderá chegar, mas aparecer no resumo horário. Desative o Resumo para o Claude.
### Problema 6. O Claude Desktop interfere com `/remote-control`
Se executar `/remote-control` dentro da aplicação Claude Desktop, recebe o erro «O Remote Control requer um token de início de sessão com âmbito total» (GitHub issue \#48378).
**Causa:** o Claude Desktop injeta um token OAuth com permissões limitadas (apenas inferência).
**Solução:** execute o Claude Code num terminal normal do sistema, não no terminal integrado no Claude Desktop. É uma limitação conhecida; a Anthropic está a trabalhar numa solução.
### Bónus. A reconexão automática falha silenciosamente em sessões longas
Sintoma: uma sessão Remote Control decorre durante 30–60 minutos e, depois, o telemóvel desliga-se silenciosamente, sem qualquer indicador (issue \#34255). Resolva manualmente: `/remote-control` → Desligar → iniciar novamente. Não é ideal, mas a funcionalidade ainda está em pré-visualização de investigação.
Só em maio de 2026, a Anthropic lançou oito correções especificamente para o Remote Control — a funcionalidade está a ser ativamente melhorada. Pode queixar-se, mas é razoável esperar que a maioria destes problemas desapareça dentro de alguns meses.
## Remote Control vs. bots do Telegram e SSH+tmux
Principal conclusão
O Remote Control é uma janela oficial e sincronizada para uma sessão local do Claude. Os bots do Telegram através dos Anthropic Channels são um canal reativo em que «um evento externo solicita uma ação ao Claude». SSH+tmux no telemóvel é uma shell universal, mas desliga-se quando o Mac entra em suspensão e torna penosa a revisão de diffs num ecrã de 6 polegadas. Escolha conforme a tarefa: oriente uma sessão com o Remote Control, reaja a um evento com Channels ou utilize SSH+tmux quando precisar de uma shell arbitrária.
### Tabela comparativa
| Elemento | Remote Control | Channels (TG/Discord) | SSH + tmux |
|----|----|----|----|
| Quem inicia | Abro a sessão | Um evento externo aciona o Claude | Ligo-me |
| Interface | Interface completa do claude.ai/code | Mensagens de chat | Terminal no telemóvel |
| Onde decorre a sessão | Na minha máquina | Na minha máquina | Num servidor |
| Revisão de diffs | Prática (interface nativa) | No chat, como texto | Letras minúsculas |
| Suporte de CLI | Apenas Claude Code | Qualquer comando através de um bot | Qualquer comando |
| Preço | Incluído no Pro/Max | Grátis (plugin Channels) | Grátis |
| Reação à perda de rede | Reconexão automática | Reativo (push) | Desliga-se ao mudar de aplicação |
| Quando a sessão termina | Terminal fechado / mais de 10 minutos sem rede | O bot funciona continuamente | O tmux preserva a sessão |
### Quando escolher cada opção
- **Remote Control** — a configuração predefinida para «afastar-se do portátil e continuar a orientar o trabalho». Interface completa, sincronização entre dispositivos e sem serviços de terceiros.
- **Channels (bot do Telegram)** — quando quer que uma falha de CI, uma nova reclamação de um cliente ou uma mensagem de chat solicite automaticamente ao Claude que investigue. É «evento → Claude reage» em vez de «oriento o Claude a partir do telemóvel». Leia mais no [guia sobre o Telegram e o Claude Code](https://ailoot.ai/blog/pt-pt/claude-code-telegram-channels/).
- **SSH + tmux** — quando precisa de uma shell arbitrária no telemóvel para executar os seus próprios comandos (implementar uma versão, consultar um registo, reiniciar um serviço). Uma shell universal fora do Claude Code. Para tarefas pontuais, funciona através do Termux/Blink.
- **Outros agentes de programação** — O Anthropic Remote Control só funciona com o Claude Code. Para comparar o Claude com alternativas, consulte [Cursor vs Claude Code](https://ailoot.ai/blog/pt-pt/cursor-vs-claude-code/).
Channels: envie eventos a partir de uma aplicação de chat, como o Telegram ou o Discord, ou do seu próprio servidor. Útil para reagir a eventos externos — por exemplo, falhas de CI ou mensagens de chat.
— Documentação da Anthropic, https://code.claude.com/docs/en/remote-control
A documentação da própria Anthropic distingue, assim, estas duas funcionalidades pelo caso de utilização: o Remote Control serve para controlar; o Channels, para reagir.
## Novidades do Remote Control entre maio de 2026 e junho de 2026
Principal conclusão
Em mês e meio, a Anthropic lançou oito correções e melhorias específicas para o Remote Control: bloquear a funcionalidade quando há uma chave de API no ambiente; corrigir o redirecionamento dos conectores MCP durante a rotação de tokens; substituir «Opening your options» por uma proposta de upgrade adequada quando se atinge o limite; apresentar uma etiqueta persistente no rodapé em vez de uma mensagem de arranque; corrigir notificações push em sessões SDK; e apresentar mensagens de erro adequadas na primeira ligação. Em 03.06.2026, a versão atual é a 2.1.162.
Cronologia completa das correções:
| Versão | Data | O que mudou |
|----|----|----|
| v2.1.51 | 24.02.2026 | Primeiro lançamento do Remote Control |
| v2.1.79 | março de 2026 | Suporte na extensão do VS Code |
| v2.1.110 | abril de 2026 | As notificações push tornaram-se uma funcionalidade oficial |
| v2.1.126 | 01.05.2026 | A mensagem vazia «Opening your options...» foi substituída por uma proposta de upgrade adequada ao atingir o limite de utilização |
| v2.1.139 | 11.05.2026 | O Remote é bloqueado quando `ANTHROPIC_API_KEY` ou `apiKeyHelper` está presente |
| v2.1.140 | 12.05.2026 | As definições geridas repetem o pedido com um token atualizado à força após um 401 |
| v2.1.141 | 13.05.2026 | Corrigidas falhas dos conectores MCP com 401 durante a rotação do token da sessão de trabalho |
| v2.1.149 | 22.05.2026 | Corrigida a mensagem errada «Mobile push not sent» em sessões SDK |
| v2.1.151 | 27.05.2026 | O Remote Control passou a ser uma etiqueta persistente no rodapé |
| v2.1.152 | 27.05.2026 | Corrigido o bloqueio de `/remote-control` em «connecting...» |
| v2.1.154 | 28.05.2026 | O preenchimento automático mostra «Desligar» quando a funcionalidade já está ativa |
| v2.1.162 | 03.06.2026 | Versão atual, melhorias gerais nas métricas, no tratamento paralelo de ferramentas, entre outras |
Oito correções específicas do Remote Control num mês é normal para uma funcionalidade em pré-visualização de investigação. A Anthropic está claramente a responder ao feedback e a resolver casos-limite.
Se a funcionalidade se comportar de forma estranha, o primeiro passo é verificar a versão e atualizá-la. É provável que o problema já tenha sido corrigido.
## Lista de verificação: configure e ponha a funcionar em 5 minutos
Principal conclusão
Para que o Remote Control funcione de forma fiável à primeira, siga os sete passos abaixo. Resolvem 90% dos problemas da primeira utilização e permitem aprovar a primeira notificação push no telemóvel até cinco minutos depois de começar.
1. ### Verifique a versão do Claude Code
`claude --version` — deverá ser 2.1.51 ou posterior. Caso contrário, execute `npm install -g @anthropic-ai/claude-code@latest`.
2. ### Remova as chaves de API do ambiente
Execute `unset ANTHROPIC_API_KEY` e `unset CLAUDE_CODE_OAUTH_TOKEN`. Depois, execute `/logout` → `/login` através do navegador.
3. ### Instale a aplicação Claude no telemóvel
Execute `/mobile` numa sessão do Claude Code para mostrar um código QR para a App Store / Google Play.
4. ### Inicie o Remote Control
Execute `claude --rc` ou `/rc` dentro de uma sessão. Aparecerá um URL e a indicação «Prima a barra de espaços para mostrar o código QR».
5. ### Leia o código QR com o telemóvel
Prima a barra de espaços no terminal → use a câmara ou a aplicação Claude. Aumente a janela do terminal se o código não for lido.
6. ### Ative as notificações push
`/config` → «Enviar notificações quando o Claude decidir». Se indicar «Nenhum dispositivo móvel registado», abra a aplicação Claude pelo menos uma vez.
7. ### Inicie uma tarefa longa e afaste-se
Seja específico na instrução: «Faz assim; nestes casos, faz de outra forma; se houver dúvidas, envia uma notificação push.» Depois, trabalhe a partir do telemóvel com as notificações push.
Num exemplo prático, demorou 3–5 minutos desde o início até à primeira conversa a partir do sofá.
### Fontes
- [Continue sessões locais a partir de qualquer dispositivo com o Remote Control — documentação do Claude Code](https://code.claude.com/docs/en/remote-control) — documentação oficial da Anthropic e principal fonte sobre comandos, requisitos e limitações.
- [Registo de alterações do Claude Code](https://code.claude.com/docs/en/changelog) — histórico de versões da 2.1.51 à 2.1.162, incluindo todas as correções do Remote Control.
Quando estiver pronto, conheça a [Ailoot](https://ailoot.ai/).
## Perguntas frequentes
### O Remote Control mantém toda a conversa fora da nuvem?
Não. Os comandos e o acesso aos ficheiros são executados localmente, mas as mensagens, respostas, diffs e atividade das ferramentas são sincronizados através da Anthropic. Os excertos de código ou segredos incluídos nesse conteúdo podem, por isso, sair da máquina.
### Porque precisa o computador de permanecer ligado durante o Remote Control?
O telemóvel funciona como interface para o processo do Claude Code no computador. Mantenha esse processo em execução e a máquina disponível; abrir a aplicação no telemóvel não transfere a execução local para uma VM na nuvem.
## Ailoot · A empresa e a sua carteira de projetos
A Ailoot assenta numa experiência operacional consolidada, numa ampla base de clientes, num serviço estável e no acompanhamento contínuo dos KPI.
A empresa e a sua carteira de projetos: milhões de clientes; vendas mensais na ordem dos milhares de milhões.
A Ailoot aplica essa experiência operacional ao acesso por API a funcionalidades de IA nos produtos dos clientes, agentes, aplicações e automatizações.