Como ligar o Claude Code ao Telegram
Ligue o Claude Code ao Telegram com o plugin oficial Channels: emparelhamento do bot, pedidos de permissão remotos, limites da sessão e opções mais seguras.
O Claude Code tem uma integração oficial com o Telegram chamada Channels. É uma boa opção quando quer enviar uma tarefa para uma sessão que já tem a correr, receber a resposta no Telegram e tratar das aprovações de ferramentas habituais sem abrir o portátil.
A restrição importante é simples: o Telegram não executa o Claude Code. Quem faz o trabalho continua a ser um processo do Claude Code no seu computador ou servidor, e esse processo tem de se manter online.
Resposta rápida
Crie um bot privado com o BotFather do Telegram, instale o plugin oficial do Telegram no Claude Code, configure o respetivo token, inicie o Claude com o canal ativado e emparelhe a sua conta do Telegram. Mantenha o bot restrito a uma lista de permissões em vez de o tornar público.
De momento, a integração é uma research preview (uma pré-visualização para investigação). Consulte a documentação dos Channels da Anthropic antes de a automatizar numa máquina sensível, porque os comandos e as capacidades podem mudar.
O que precisa
- Uma instalação atual do Claude Code, autenticada com uma conta da Anthropic suportada.
- O Bun instalado na máquina anfitriã; o plugin oficial do canal corre sobre o Bun.
- Uma conta do Telegram e um token de bot obtido através do @BotFather.
- Um terminal que possa ficar aberto, ou uma sessão persistente como o
tmux.
Trate o token do bot como uma palavra-passe. Não o cole num repositório, num histórico da shell partilhado com outros utilizadores nem numa captura de ecrã.
1. Crie um bot privado do Telegram
Abra o BotFather no Telegram, envie /newbot e siga as instruções. O nome de
utilizador do bot tem de terminar em bot. Copie o token para um sítio
temporário e privado.
Numa sessão de programação pessoal, não há motivo para adicionar o bot a um grupo. Com mensagens diretas e uma lista de permissões, é mais fácil perceber o que se passa.
2. Instale o plugin oficial
No Claude Code, instale o plugin do Telegram:
/plugin install telegram@claude-plugins-official
Se o marketplace ainda não estiver registado, adicione-o e tente novamente:
/plugin marketplace add anthropics/claude-plugins-official
/plugin install telegram@claude-plugins-official
/reload-plugins
Use o nome do marketplace oficial e não um pacote de terceiros com um nome parecido.
3. Configure o token do bot
Execute o comando do plugin dentro do Claude Code:
/telegram:configure <BOT_TOKEN>
O plugin guarda o token na configuração local do canal. Se o token tiver aparecido em registos ou numa conversa, revogue-o através do BotFather e configure um novo.
4. Inicie o Claude Code com o Telegram ativado
Saia da sessão atual e volte a iniciá-la com o canal:
claude --channels plugin:telegram@claude-plugins-official
Execute o comando dentro do repositório em que o Claude deve trabalhar. Numa
máquina sempre ligada, inicie-o numa sessão tmux com nome, para que uma
desconexão do SSH não termine o processo:
tmux new -s claude-telegram
claude --channels plugin:telegram@claude-plugins-official
O tmux preserva o processo; não impede um portátil de entrar em suspensão nem
repõe uma ligação de rede que falhou.
5. Emparelhe a sua conta e adicione-a à lista de permissões
Envie uma mensagem ao bot. Este responde com um código de emparelhamento. No terminal do Claude Code, aprove esse código e mantenha o acesso restrito:
/telegram:access pair <PAIRING_CODE>
/telegram:access policy allowlist
Faça um teste com um pedido só de leitura, como pedir ao Claude que resuma o diretório atual. Confirme que a mensagem aparece na sessão pretendida antes de conceder um acesso mais amplo às ferramentas.
Como funcionam agora os pedidos de permissão
Descrições mais antigas dos Channels dizem muitas vezes que cada pedido de permissão obriga a voltar ao terminal. Isso já não é verdade. A versão atual do plugin oficial do Telegram declara a capacidade de retransmissão de permissões do Claude Code e pode enviar pedidos de ferramentas suportados para o Telegram com os botões Allow e Deny.
Isso não torna as aprovações sem supervisão isentas de risco. Um pequeno cartão numa conversa pode esconder contexto que seria óbvio num diff no terminal. Leia o comando e o caminho afetado, evite regras amplas do tipo «permitir sempre» e use uma conta com poucos privilégios numa sessão sempre ligada. A confiança inicial no projeto, o consentimento MCP e a configuração do plugin podem continuar a exigir interação no terminal local.
Limites que contam na prática
- O processo na máquina anfitriã tem de se manter ativo. Se fechar o Claude Code, o canal deixa de funcionar.
- O Telegram é um fluxo de eventos, não um armazenamento de sessões. A Bot API entrega as atualizações novas; não dá ao plugin um histórico completo e pesquisável.
- A resposta fica no Telegram. O terminal pode mostrar o evento recebido e o estado da entrega, em vez de uma transcrição idêntica à conversa.
- É exclusivo do Claude. O plugin não expõe o Codex nem outros agentes.
- É software em pré-visualização. Volte a consultar a documentação oficial depois de cada atualização e evite depender de comportamentos não documentados.
Channels vs. Remote Control
O Remote Control da Anthropic é uma opção à parte. Permite que o Claude na web ou na aplicação para iOS/Android comande uma sessão na máquina anfitriã. Os ficheiros e as ferramentas ficam na máquina anfitriã e o telemóvel funciona como interface remota.
Escolha os Channels quando o Telegram for a interface que quer ou quando houver eventos externos que devam chegar a uma sessão. Escolha o Remote Control quando quiser a interface oficial do Claude e uma visão mais próxima da sessão ativa. Ambos continuam a depender do processo na máquina anfitriã.
Quando faz sentido outra camada remota
O plugin nativo é normalmente a resposta mais simples para uma sessão do Claude. Uma configuração diferente torna-se relevante quando os requisitos mudam – por exemplo, um terminal completo no browser, vários agentes de programação ou um VPS sempre ligado e gerido separadamente de um portátil.
O Chatcode é uma dessas opções: liga um servidor a um terminal no browser e ao Telegram e pode executar o Claude Code a par do Codex, do Gemini e do OpenCode. Isso acrescenta um intermediário de terceiros e a responsabilidade de gerir um servidor, por isso não é uma melhoria automática. A configuração prática e as contrapartidas estão descritas em Claude Code no Telegram com o Chatcode.
Perguntas frequentes
O Claude Code tem uma integração oficial com o Telegram?
Sim. Os Channels do Claude Code incluem um plugin oficial para o Telegram, que liga um bot do Telegram com lista de permissões a uma sessão do Claude Code que continua a correr no seu computador ou servidor.
Posso aprovar pedidos de permissão do Claude Code a partir do Telegram?
Sim. A versão atual do plugin oficial do Telegram retransmite os pedidos de permissão de ferramentas suportados sob a forma de botões Allow e Deny. A confiança inicial no projeto, o consentimento do plugin e parte da configuração local continuam a exigir o terminal.
Qual é a diferença entre os Channels e o Remote Control?
Os Channels permitem que o Telegram ou outro serviço envie eventos para uma sessão do Claude Code em execução. O Remote Control expõe a sessão através do Claude na web ou no telemóvel. Ambos usam um processo do Claude na máquina anfitriã, mas a interface e o modelo de acionamento são diferentes.
O bot do Telegram funciona com o Claude Code fechado?
Não. O servidor do canal corre juntamente com a sessão do Claude Code. Mantenha o processo ativo num terminal persistente ou numa máquina sempre ligada se precisar que continue acessível.