Como Controlar o Claude Code pelo Telegram

5 passos. 10 minutos. E você nunca mais vai depender do seu terminal no computador pra pedir algo pra IA.

A integração que transformou o Claude Code num assistente de bolso

Imagina o seguinte cenário.

Você tá no almoço. No carro. Na fila do banco. E tem uma ideia. Precisa pedir algo pra IA. Mas ela tá lá, presa no computador, esperando você abrir o terminal.

Você anota pra fazer depois. Depois vira amanhã. Amanhã vira nunca.

Agora imagina outra coisa.

Você abre o Telegram no celular. Manda uma mensagem. A IA responde, com acesso total aos seus projetos, seus arquivos, seu contexto. E te entrega o resultado ali mesmo, no chat.

Sem abrir notebook. Sem ligar computador. Sem perder a ideia.

É exatamente isso que eu faço hoje. E vou te ensinar como configurar em 10 minutos.

O que é essa integração?

O Claude Code tem um sistema chamado Channels: canais de comunicação que conectam a IA a plataformas externas. O Telegram é um desses canais.

Na prática, você cria um bot no Telegram e conecta ele direto no Claude Code. Quando você manda uma mensagem pro bot, o Claude Code recebe, processa (com acesso a todos os seus arquivos e projetos) e responde ali mesmo no Telegram.

Não é um chatbot genérico. É o mesmo Claude Code que roda no seu terminal, só que acessível pelo celular.

O que eu consigo fazer pelo Telegram:

• Pedir status de projetos
• Criar copies e criativos
• Revisar código
• Consultar arquivos do meu workspace
• Executar comandos e workflows

Tudo pelo celular. Tudo em tempo real.

O que você precisa antes de começar

Três coisas:

• Claude Code instalado e funcionando no seu computador
• Conta no Telegram (provavelmente você já tem)
• Node.js instalado (se você usa Claude Code, provavelmente já tem também)

Se você ainda não usa Claude Code, essa newsletter não é pra você, ainda. Primeiro instala o Claude Code, explora, entende como funciona. Depois volta aqui.

Passo 1, Criar o bot no Telegram

Todo bot do Telegram é criado pelo @BotFather: é o bot oficial do Telegram pra gerenciar bots (sim, um bot que cria bots).

• Abre o Telegram e busca por @BotFather
• Manda /newbot
• Ele vai te pedir um nome pro bot, pode ser qualquer coisa (ex: “Meu Assistente AI”)
• Depois pede um username: precisa terminar em bot (ex: meu_assistente_ai_bot)
• Pronto. O BotFather te dá um token parecido com isso: 7123456789:AAF-xxxxxxxxxxxxxxxxxxxxxxxxxxx

Copia esse token e guarda. Você vai precisar dele no próximo passo.

Esse token é como a senha do seu bot. Não compartilha com ninguém.

Passo 2, Instalar o plugin de Telegram no Claude Code

Agora volta pro computador. Abre o terminal no diretório do projeto onde você usa Claude Code e roda:

npx @anthropic-ai/claude-code-plugin-telegram

Ele vai pedir o token do bot que você acabou de criar. Cola e confirma.

É isso. Plugin instalado.

Passo 3, Configurar o acesso

Ainda no Claude Code, roda:

/telegram:configure

Esse comando confirma que o bot tá conectado e te mostra a política de acesso, quem pode mandar mensagem pro bot e receber resposta.

Por padrão, ninguém tem acesso. Você precisa autorizar manualmente (próximo passo).

Passo 4, Parear o seu chat

Essa é a parte mais importante. Você precisa “apresentar” o seu Telegram pro Claude Code.

• Abre o Telegram no celular
• Busca pelo username do bot que você criou (ex: @meu_assistente_ai_bot)
• Manda qualquer mensagem, pode ser “oi”
• Volta pro Claude Code no computador e roda:

/telegram:access

• Vai aparecer uma solicitação de pareamento. Aprova.

Pronto. Seu Telegram agora tá conectado ao Claude Code.

Passo 5, Testar

Manda uma mensagem pro bot no Telegram:

Se o Claude Code tiver rodando no computador, ele vai processar e responder direto no Telegram. Com acesso real aos seus arquivos.

A primeira vez que funciona é um momento mágico. Sério.

Passo 6, Quando iniciar o Claude Code

Abra o seu terminal e digite:

claude --channels plugin:telegram

O que você precisa saber

Algumas coisas importantes antes de sair usando:

O Claude Code precisa estar rodando. O bot do Telegram não funciona sozinho, ele depende de uma sessão ativa do Claude Code no computador. Se você fechar o terminal, o bot para de responder. Se você deixar aberto, funciona 24/7.

Você controla quem tem acesso. Cada pessoa que quiser usar o bot precisa ser pareada via /telegram:access. Ninguém acessa sem sua autorização.

O bot tem o mesmo poder que o terminal. Ele não é uma versão limitada. É o mesmo Claude Code, com acesso aos mesmos arquivos, projetos e contextos. Isso é o que torna essa integração tão poderosa (e por que você precisa controlar o acesso).

Funciona com qualquer projeto. Se você trabalha com múltiplos projetos no Claude Code, o bot acessa todos. Basta especificar na mensagem o que você precisa.

Por que isso importa

A maioria das pessoas usa IA só quando tá sentada na frente do computador. Mas as melhores ideias não aparecem no horário comercial.

Ter a IA no bolso, com acesso real ao seu ambiente de trabalho, muda a equação. Você para de anotar “fazer depois” e começa a fazer agora.

Eu uso isso todo dia. No carro, no almoço, antes de dormir. Mando uma mensagem e resolvo.

10 minutos de setup. E a forma como você trabalha com IA muda pra sempre.

Se configurar, me manda uma mensagem. Quero ver funcionando no seu projeto.

Até a próxima.

, Vini