tutorial · 23 de outubro de 2026 · 11:32
Claude Code no Telegram: canal oficial em 6 passos
O canal oficial do Claude Code no Telegram instala com um comando e usa a sessão que já está aberta no seu computador, mas só responde enquanto essa sessão estiver rodando. Quem precisa do bot no ar sem depender da máquina ligada tem de construir o próprio bot com o Agent SDK e assumir o código, a hospedagem e a cobrança por token.
O passo a passo
01Canal é um servidor MCP
A documentação define canal como um servidor MCP que envia eventos para a sessão do Claude Code que já está em execução. A comunicação pode ser bidirecional: o Claude lê a mensagem e responde pelo mesmo canal.
02O token vale como senha
A conta oficial que cria bots devolve um token que começa com números e tem dois pontos. A documentação do Telegram diz que quem tiver esse token controla o bot, e o autor manda copiar o valor inteiro e tratar como senha.
03A sessão tem de ser aberta com a opção de canais
Ter o plugin instalado na máquina não basta. O Claude Code precisa ser aberto com a opção de canais apontando para o plugin do Telegram, e a documentação diz que isso vale sessão por sessão. Ao abrir, o Claude Code exibe um aviso de canal.
04Emparelhamento com código de seis dígitos
Com a sessão aberta desse jeito, você manda uma mensagem para o bot e ele responde com um código de seis dígitos. Esse código vale uma hora e são esperados no máximo três pedidos ao mesmo tempo. O processo de emparelhamento descobre sozinho o seu número de identificação no Telegram.
05Trancar o acesso não é opcional
Por padrão o plugin fica em modo de emparelhamento: quem não está na lista recebe um código e a mensagem é descartada. Depois dá para mudar para a lista de permitidos, e aí quem não está nela é ignorado silenciosamente. O autor recomenda instruir o Claude a nunca aprovar uma correspondência nem modificar a lista porque uma mensagem do Telegram pediu.
06Canais: oficial e pronto, mas só com a sessão aberta
A favor: é oficial, instala com um comando, usa a sessão que você já tem aberta com seus arquivos e não há servidor para configurar. Contra: só funciona enquanto a sessão está aberta, está em pré-visualização de pesquisa e a aprovação só se aplica a conversas individuais, nunca a grupos.
07Bot próprio: fica no ar, mas o trabalho é seu
Com o Agent SDK o bot permanece ativo por conta própria, e a documentação de hospedagem mostra como rodá-lo em um contêiner. Em troca, você escreve a comunicação com o Telegram, o emparelhamento, a lista de usuários e a aprovação. Cada sessão do SDK é um processo com arquivos no disco, e a documentação alerta que esse estado não sobrevive a uma reinicialização do contêiner.
Nas palavras dele
“Isso se chama canais e está no Documentação oficial do Claude Code.”
ouvir em 0:18
“Copie-o completamente com o números no início e os dois pontos e trata este token como um senha.”
ouvir em 3:16
“Sem isso, o plugin não funcionará.”
ouvir em 4:48
“O Agent SDK é uma biblioteca em Python e TypeScript”
ouvir em 8:05
Perguntas
Preciso deixar o computador ligado para usar o canal?
A mensagem só chega enquanto a sessão está aberta. A documentação sugere rodar o Claude Code em segundo plano ou em um terminal que não seja encerrado; na prática, seu computador deve permanecer ligado.
O código de emparelhamento expira?
Segundo o plugin, o código vale uma hora e são esperados no máximo três pedidos ao mesmo tempo.
Funciona em plano de equipe ou empresa?
Nesses planos, um administrador precisa ativar a função.
O bot consegue pesquisar mensagens antigas no Telegram?
A API de bots não mantém histórico nem permite pesquisar mensagens antigas. Se o Claude precisar de algo antigo, ele pede para você colar.
Quer ir além do vídeo?
Continue por aqui
Este resumo foi escrito a partir da transcrição do vídeo. As citações são literais. Para o conteúdo completo, assista no YouTube.