Claude Code no Telegram: o caminho mais curto, e o que ele não faz

Quem usa Claude Code chega cedo numa vontade: falar com ele da rua. Você está no ônibus, lembra de uma coisa, e o Claude que resolveria está sentado no computador de casa. A ideia é boa, e no Telegram ela é mais simples de realizar do que em qualquer outro aplicativo de mensagem, por um motivo que é estrutural, não opinião.

Este texto explica por quê, mostra o que funciona hoje, o que não funciona, e os três avisos que ninguém deveria descobrir depois de ligar.

Por que o Telegram é o caminho mais curto

O Telegram tem uma API oficial de bots, gratuita, aberta a qualquer pessoa. Você cria um bot conversando com o @BotFather, a conta oficial do Telegram pra isso: manda /newbot, escolhe um nome, escolhe um usuário terminado em bot, e recebe uma linha de texto chamada token. Pronto: existe um bot seu, com endereço próprio, sem número de telefone novo e sem chip.

Compare com o WhatsApp. Lá não existe API oficial pra conta pessoal; o que existe é uma ponte que imita o WhatsApp Web. Funciona, mas carrega risco formal de restrição da conta (contamos isso com todas as letras no artigo sobre Claude Code no WhatsApp). No Telegram, o bot é cidadão de primeira classe: a plataforma foi desenhada pra ele existir.

O token é a senha do bot. Quem tem o token fala em nome dele. Guarde como guardaria uma senha de banco: em arquivo de configuração no seu computador, nunca em grupo, print ou mensagem.

Como a mensagem chega no seu computador

Aqui mora a parte que parece mágica e não é. O bot em si não pensa: ele é só uma caixa de correio dentro do Telegram. Quem pensa é um programa pequeno rodando no seu computador, que fica perguntando ao Telegram, o tempo todo, se chegou mensagem nova naquela caixa. Chegou, ele entrega pro Claude Code instalado na máquina, espera a resposta e devolve pelo mesmo caminho.

Esse jeito de trabalhar (o computador busca, em vez de receber) tem uma consequência prática ótima pra quem não é técnico: não precisa abrir porta no roteador, não precisa de endereço público, não precisa de servidor alugado. Um computador comum, atrás da internet de casa, dá conta.

E tem uma consequência que precisa ficar clara: o computador precisa estar ligado. Desligou, o bot recebe a mensagem e fica em silêncio até a máquina voltar. Não é defeito, é o desenho: a inteligência mora na sua máquina, não na nuvem de ninguém.

O que dá pra fazer

1. Conversar com contexto, de onde estiver. Pedir um texto, um resumo, um plano, uma resposta difícil de e-mail. O programa guarda as últimas trocas, então a conversa tem continuidade: "agora encurta", "troca o tom", "lista o que ficou pendente".

2. Lembretes que chegam no Telegram. "Me lembra 18:30 de ligar pro dentista" vira uma mensagem sua chegando às 18:30. Isso nem precisa do Claude: é o programa no computador cumprindo horário.

3. Usar o que está no computador. Como o Claude Code enxerga as pastas da máquina, um bot bem montado pode pedir a ele que leia um arquivo ou gere um documento e te avise quando terminar. Aqui vale um cuidado: cada poder a mais que você dá ao bot é uma decisão de segurança a mais, porque quem controla o bot passa a controlar o computador. Comece com conversa e lembretes; amplie quando confiar no que montou.

Os três avisos honestos

1. O bot é público por natureza. Qualquer pessoa que descubra o usuário do seu bot consegue abrir uma conversa com ele. O programa no seu computador precisa ignorar todo mundo que não seja você, filtrando pelo número da sua conta no Telegram (o chat_id). Bot sem esse filtro é um Claude aberto pra estranhos, gastando a sua assinatura.

2. Conversa com bot não é criptografada de ponta a ponta. No Telegram, só os chats secretos entre duas pessoas têm essa proteção; mensagem pra bot passa pelos servidores do Telegram e chega ao seu programa em texto. A regra prática: não mande pro bot nada que você não mandaria num chat comum do Telegram. Senha, documento e dado de cliente ficam fora.

3. A conversa gasta a cota da sua assinatura. O Claude Code responde usando o plano do Claude que você já paga, o mesmo que você usa no computador. Não há cobrança nova, mas há um limite compartilhado: uma tarde de conversa pelo celular é uma tarde a menos de cota no computador. Comandos fixos, como o de lembrete, não gastam nada.

O que isso não é

Não é o aplicativo do Claude no celular. O app oficial conversa com o Claude na nuvem, e é ótimo pra isso, mas não enxerga o seu computador: não lê as suas pastas, não roda a sua rotina, não sabe o que o Claude Code de casa aprendeu sobre o seu trabalho. O bot no Telegram é o contrário: um controle remoto pro Claude que vive na sua máquina.

Também não é chatbot de atendimento. Se a dor é responder cliente em volume, o mercado é outro, com API do WhatsApp Business e cobrança por conversa. O assunto aqui é você falando com o seu próprio assistente.

Quando vale um agente pronto

Dá pra montar tudo isso na mão? Dá, e é um projeto bom pra quem gosta de fuçar: token, filtro de chat, memória da conversa, agendador de lembrete, iniciar junto com o computador. É justamente essa lista que um agente pronto empacota.

O Tico, Assistente no Telegram da Contrate Agentes, é isso montado: roda no seu computador, usa a assinatura do Claude que você já paga, sem chave de API e sem servidor de terceiro. Conversa com memória das últimas trocas (/limpa zera quando quiser), lembretes por comando (/lembra, /lembretes, /cancela), e só responde ao seu chat: mensagem de qualquer outra pessoa é ignorada. Quem instala é o seu próprio Claude, conversando com você, e ele guia passo a passo até a criação do bot no BotFather. Dois pontos honestos: nesta versão o Tico não acessa a internet (notícia e cotação ele diz que não sabe; pensar, escrever, resumir, planejar e lembrar, ele faz), e lembrete que venceu com o computador desligado chega assim que a máquina liga. No beta aberto, o download é grátis: só o e-mail, sem cartão.

Preciso de um número de telefone novo?

Não. O bot é uma conta própria, criada pelo @BotFather, sem chip e sem número. Você fala com ele pelo seu Telegram de sempre.

Outra pessoa pode falar com o meu Claude pelo bot?

Pode tentar: bot é público por usuário. O que impede é o programa no seu computador responder só ao seu chat e ignorar o resto. Confira isso antes de ligar qualquer bot; é o primeiro item da lista de segurança.

O que eu escrevo pro bot fica privado?

O processamento acontece no seu computador, mas a mensagem passa pelos servidores do Telegram, sem criptografia de ponta a ponta. Trate o bot como um chat comum do Telegram: bom pra ideia, texto e lembrete; ruim pra senha e documento.

Precisa de chave de API da Anthropic?

Não neste caminho. O programa usa o Claude Code já instalado, que entra com a sua assinatura. Chave de API é outro caminho, com cobrança por uso, e faz sentido pra quem já a tem por outro motivo.

Preciso deixar o computador ligado?

Sim. É o computador que responde; o Telegram só entrega a mensagem. Desligado, a conversa espera. No Tico, lembrete que venceu nesse intervalo chega assim que a máquina liga.