Agentes de código rendem mais em tarefas longas, e tarefas longas são justamente as que você não quer ficar assistindo. O problema é que os agentes param para perguntar coisas. O Claude Code quer permissão para rodar um comando, termina um turno e espera a próxima instrução, ou bate em um erro. Se você está em uma reunião ou saiu para almoçar, o agente fica parado até você voltar para a mesa.
Controlar o Claude Code pelo celular resolve essa lacuna. Neste post mostro como faço isso com o Telegram e o AgentVera: notificações que dizem o que aconteceu, aprovações com um toque, agentes novos iniciados pelo chat e trabalhos maiores repassados com /team e /night.
O que você pode fazer pelo celular
Veja o que a conexão com o Telegram cobre, para saber o que esperar antes de configurar:
| Pelo celular | Como |
|---|---|
| Saber quando um agente termina ou falha | Uma notificação com um pequeno trecho da resposta |
| Aprovar ou recusar um pedido | Botões ✅ Approve e ✖️ Deny na mensagem |
| Escrever para um agente em execução | Escreva no tópico dele ou responda à notificação |
| Ver o que mudou | 🧾 Changes envia o diff como arquivo |
| Iniciar um agente novo | /new com um projeto e uma tarefa |
| Rodar uma equipe paralela | /team e depois aprove o plano |
| Deixar trabalho na fila para a noite | /night e depois ➕ Add task |
Os agentes continuam rodando no seu computador, no app desktop. O celular é um controle remoto: envia instruções e recebe atualizações, então o app precisa ficar aberto e o computador acordado.
Conectando o bot
A configuração leva um minuto:
- Entre na sua conta do AgentVera no app desktop (Settings → Account). Uma conta gratuita basta.
- Vá em Settings → Notifications → Phone notifications e escolha Connect with the AgentVera bot.
- Clique em Connect Telegram. O app mostra um link t.me e um QR code.
- Abra o link ou escaneie o código no celular e toque em Start no Telegram.
- Use Send test para confirmar que uma mensagem chega.
O link vale por 10 minutos e funciona uma vez só. Algumas coisas sobre privacidade que vale saber:
- Nada fica guardado no caminho. As mensagens passam pelo servidor do AgentVera e esperam só na memória até o app desktop buscá-las.
- Só chat privado. O bot funciona apenas em um chat privado com você e nunca entra em grupos.
- Só você controla. Tanto o chat quanto o remetente são verificados, então só a conta pareada pode controlar seus agentes.
Se preferir rodar seu próprio bot, escolha I want to use my own bot e cole o token dele. O token fica criptografado no keychain do sistema e as mensagens vão direto para o Telegram.
O bot escreve no idioma do app desktop, inglês ou turco. Os comandos também têm apelidos em turco, como /ajanlar e /yeni.
Notificações que valem a pena
Uma notificação só é útil se diz se você precisa agir. As configurações de notificações permitem escolher quais eventos chegam ao seu celular. Todos estes vêm ligados por padrão:
- Agente terminou o turno
- Agente falhou
- Aprovações pendentes
- Um achado importante da revisão de código
- Atualizações de equipes paralelas
- Alertas de conta e de limite
- Uma tarefa agendada falhou
Duas configurações definem o quanto de barulho você recebe:
- Uma duração mínima de turno. Por padrão, só turnos de pelo menos 60 segundos mandam a mensagem de “terminou”. Idas e vindas rápidas ficam em silêncio.
- Incluir um pequeno trecho da resposta do agente. Ligado por padrão. Desligue e o celular só fica sabendo que um turno terminou, sem código nem conteúdo do projeto.
Com A separate topic per agent ligado (o padrão), cada agente ganha seu próprio tópico no chat do bot, então um dia longo com vários agentes não vira uma conversa interminável.
Aprovando pedidos com um toque
Quando um agente pede permissão, a mensagem chega com os botões ✅ Approve e ✖️ Deny. Se a aprovação automática estiver ligada no app desktop, você também recebe um botão de sempre permitir, por exemplo ♾️ Always allow: … para um comando ou ♾️ Always allow edits in the project. O celular nunca liga a aprovação automática sozinho; essa continua sendo uma decisão do desktop.
Se você perder um pedido, o AgentVera lembra você. Os lembretes começam depois de 5 minutos e se repetem a cada 15 minutos, no máximo três vezes, e chegam ao Telegram com os mesmos botões. Aprovações de flows chegam do mesmo jeito.
Conversando com os agentes pelo chat
Use /agents para listar seus agentes em execução. Cada um aparece como um cartão com botões:
- 📄 Last reply mostra o que o agente disse por último.
- 🧾 Changes envia as mudanças atuais como um arquivo
changes.diff. - ⏸ Pause interrompe o turno atual, e ▶️ Continue manda ele seguir.
- ↩️ Undo last turn reverte os arquivos do último turno, depois de uma confirmação.
- ✍️ Write envia uma mensagem ao agente.
- ⏹ Close agent fecha o agente.
Para escrever a um agente, digite no tópico dele ou responda a uma das notificações dele. Se o agente estiver ocupado, ele recebe a mensagem quando o turno terminar. Você também pode mandar fotos e documentos de até 20 MB, como um print de um bug. Mensagens de voz e vídeo não são suportadas.
No sentido contrário, os agentes podem mandar arquivos para o seu celular com a ferramenta phone_send quando Let agents send to your phone está ligado. Eles só podem enviar arquivos da própria pasta, e segredos como arquivos .env e chaves são bloqueados.
Iniciando trabalho novo: /new, /team e /night
/new: um agente, uma tarefa
O /new pede para você escolher um projeto recente e depois escrever a tarefa. Ele inicia um agente Claude Code com o nome da tarefa, com um 📱 na frente para você saber que veio do celular. Se você sabe o nome do projeto, /new Project: task faz tudo em uma mensagem.
/team: uma equipe paralela pelo celular
Para trabalhos maiores, o /team inicia uma equipe paralela. Escolha um projeto e descreva o pedido em detalhes. O bot responde que está preparando o plano e, quando ele fica pronto, você recebe uma mensagem 🧩 Plan ready com as partes, quantas rodam ao mesmo tempo e o comando de verificação final. Nada roda até você tocar em 🚀 Start the team.
Durante a execução, você fica sabendo dos momentos que importam:
- Uma parte que precisa de ajuda chega com os botões 🔁 Retry, ⏭ Skip e 📥 Accept.
- Quando a equipe termina, você recebe quantas partes entraram no merge, o nome da branch e, se ainda não houver pull request, um botão 🔀 Open PR.
- Se a equipe parar, você também é avisado.
Se quiser entender o que acontece dentro de uma execução paralela, agentes de código em paralelo e git worktree para agentes em paralelo explicam a ideia.
/night: fila de trabalho para o turno da noite
O /night mostra o estado do turno da noite: se está ligado e em quais horários, além das tarefas na fila. ➕ Add task pede um projeto e uma tarefa, e ▶️ Start now inicia a fila na hora se o turno ainda não estiver rodando.
Durante a noite, os agentes fazem commit do trabalho, mas não fazem push, e pedidos de aprovação não são aprovados por você. De manhã, você recebe uma notificação no desktop e um resumo curto no Telegram com as contagens. O turno da noite faz parte do plano Pro.
/status, /help e /cancel
O /status lista rapidamente os agentes em execução, o /help explica o que o bot sabe fazer e o /cancel descarta uma pergunta que o bot está esperando.
Telegram ou o app móvel do AgentVera?
O AgentVera também tem um app móvel para iOS e Android. Os dois alcançam os agentes do seu computador pelo servidor do AgentVera, e você pode usar ambos ao mesmo tempo.
- O Telegram é para coisas rápidas: uma notificação, uma aprovação com um toque, uma resposta curta, uma tarefa nova com /new.
- O app móvel é o controle remoto completo: chat, terminal e diff para cada agente, arquivos, fotos e mensagens de voz, Git e Docker, desfazer, tarefas e o turno da noite. Ligue Control from your phone nas configurações do app desktop e entre no app com a mesma conta.
O guia do app móvel do AgentVera mostra como configurá-lo e o que cada tela faz.
Erros comuns
- Deixar o computador dormir. Os agentes rodam na sua máquina. Se ela dormir, nada acontece até você acordá-la.
- Ligar todas as notificações e depois silenciar o chat. Mantenha a duração mínima de turno e desligue o que você nunca usa, para que as mensagens que chegam valham a pena abrir.
- Mandar tarefas vagas pelo celular. Digitar no celular empurra você para tarefas curtas. “Arrume o login” não basta para /new ou /team; diga o arquivo, o bug e como verificar.
- Aprovar no escuro. Antes de tocar em Approve em um comando que você não reconhece, abra 📄 Last reply ou 🧾 Changes para ver o que o agente está fazendo.
- Esperar que o Telegram substitua o desktop. Revisar um diff grande ou resolver um conflito é trabalho para a mesa, ou pelo menos para a tela de diff do app móvel. O Telegram mantém os agentes andando até você chegar lá.
Checklist
- Login feito no AgentVera pelo app desktop
- Bot conectado e Send test recebido
- Eventos de notificação escolhidos, duração mínima de turno definida
- Trecho da resposta ligado ou desligado, conforme o que você aceita enviar
- Um tópico separado por agente ligado
- Computador configurado para não dormir enquanto os agentes trabalham
Conclusão
Controlar o Claude Code pelo celular tem menos a ver com programar em uma tela pequena e mais com não deixar agentes esperando. As notificações avisam quando algo precisa de você, as aprovações levam um toque, e /new, /team e /night permitem repassar o próximo trabalho enquanto você está fora. E não se limita ao Claude Code: o /agents também lista o Codex e os outros agentes que você roda no AgentVera, com os mesmos cartões. Se você quer construir algo com o Telegram em vez de usá-lo como controle remoto, veja criar um bot do Telegram com IA.
Você pode começar com o AgentVera de graça e conferir os planos quando precisar do turno da noite ou de equipes paralelas.