Como configurar os channels do Claude Code com Telegram

O que são os channels

Um channel é um servidor MCP. Ele envia eventos para uma sessão do Claude Code que já está rodando. Ele pode funcionar nos dois sentidos. O Claude lê a mensagem, trabalha e responde pelo mesmo chat. A documentação da Anthropic lista Telegram, Discord e iMessage no research preview (code.claude.com/docs/en/channels, outubro de 2026).

Isso é diferente do Remote Control. O Remote Control deixa você controlar a sua sessão pelo app do Claude. Os channels trazem mensagens de outras plataformas, e também webhooks, como uma execução de CI que falhou.

Requisitos

• Claude Code conectado com uma conta claude.ai ou uma API key do Console. Os channels não funcionam no Amazon Bedrock, Google Cloud ou Microsoft Foundry.
• Nos planos Team e Enterprise, um administrador precisa ativar os channels primeiro. Usuários Pro e Max sem organização podem usar direto. A documentação também diz que a liberação está sendo feita aos poucos.
• Bun. Os plugins de channel são scripts Bun.
• Um token de bot do Telegram gerado pelo BotFather, para o channel do Telegram.

Instale as peças

Instale o Claude Code e o Bun com os scripts oficiais.

curl -fsSL https://claude.ai/install.sh | bash
curl -fsSL https://bun.com/install | bash

No Telegram, abra o BotFather e envie o comando newbot. Escolha um nome e um username terminado em bot. Copie o token que ele devolve. Depois instale o plugin. Dentro do Claude Code, é um comando de barra.

/plugin install telegram@claude-plugins-official

Em um shell comum, a CLI de plugins faz a mesma coisa. Se o marketplace estiver faltando, adicione primeiro.

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install telegram@claude-plugins-official

Rodamos isso em uma máquina macOS 26 hospedada pelo GitHub em 2 de outubro de 2026, sem login. A instalação funcionou. Isto é o que ela mostrou.

$ claude --version
2.1.287 (Claude Code)
$ bun --version
1.4.2
$ claude plugin install telegram@claude-plugins-official
Successfully installed plugin: telegram@claude-plugins-official (scope: user)
$ claude plugin list
  telegram@claude-plugins-official
    Version: 0.0.7
    Scope: user
    Status: enabled

Conecte o bot e faça o pareamento

Dentro do Claude Code, salve o seu token. Ele fica guardado na pasta telegram, dentro de channels, na pasta de configuração do Claude.

/telegram:configure <token>

Depois saia e inicie o Claude Code de novo pelo shell, com a flag de channel.

claude --channels plugin:telegram@claude-plugins-official

Mande qualquer mensagem para o seu bot. Ele responde com um código de pareamento. Aprove o código no Claude Code e depois restrinja o bot só à sua conta.

/telegram:access pair <code>
/telegram:access policy allowlist

Duas coisas confundem as pessoas aqui. A flag de channel não aparece na saída de ajuda durante o preview, mas funciona. E o terminal mostra a mensagem recebida e uma nota de envio, não o texto da resposta. A resposta aparece no Telegram.

Discord em vez de Telegram

Os passos do Discord seguem o mesmo formato. Crie um aplicativo no Discord Developer Portal e copie o token do bot. Ative Message Content Intent. Convide o bot para o seu servidor com permissão para ver canais, enviar mensagens e ler o histórico. Depois instale, configure e faça o pareamento do mesmo jeito. A linha do reinício roda no shell. As outras linhas rodam dentro do Claude Code.

/plugin install discord@claude-plugins-official
/discord:configure <token>
claude --channels plugin:discord@claude-plugins-official
/discord:access pair <code>
/discord:access policy allowlist

Você pode passar vários plugins para a flag de channels, separados por espaços. Assim uma sessão escuta os dois apps.

Mantenha a sessão aberta o dia inteiro

Os eventos só chegam a uma sessão aberta. Feche o terminal, deixe o Mac entrar em repouso ou reinicialize, e o bot fica em silêncio. Três coisas resolvem isso. Desligue o repouso. Rode o Claude Code dentro do tmux. Inicie essa sessão do tmux no login.

sudo pmset -a sleep 0
sudo pmset -a disksleep 0
sudo pmset -a displaysleep 10

Este LaunchAgent inicia uma sessão do tmux chamada channels com o Claude Code e o channel do Telegram. Ele confere a cada minuto e não faz nada se a sessão já existir. Salve como dev.local.claude-channels.plist na sua pasta LaunchAgents.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key><string>dev.local.claude-channels</string>
  <key>ProgramArguments</key>
  <array>
    <string>/bin/zsh</string>
    <string>-lc</string>
    <string>export PATH="$HOME/.local/bin:$HOME/.bun/bin:/opt/homebrew/bin:$PATH"; tmux has-session -t channels 2>/dev/null || tmux new -d -s channels -c "$HOME" "claude --channels plugin:telegram@claude-plugins-official"</string>
  </array>
  <key>RunAtLoad</key><true/>
  <key>StartInterval</key><integer>60</integer>
</dict>
</plist>

Instale o tmux primeiro se você não tiver. Depois carregue o agente e conecte à sessão para ver o Claude.

brew install tmux
launchctl load ~/Library/LaunchAgents/dev.local.claude-channels.plist
tmux attach -t channels

Testamos exatamente este arquivo em uma máquina macOS 26 hospedada pelo GitHub em 2 de outubro de 2026. Vinte segundos depois de carregar, o launchd tinha criado a sessão na pasta pessoal, com o Claude Code esperando dentro dela.

$ tmux ls
channels: 1 windows (created Fri Oct  2 04:21:09 2026)
$ tmux capture-pane -pt channels
Welcome to Claude Code v2.1.287

A sessão começa na sua pasta pessoal. Coloque o caminho do seu projeto no lugar da variável home se quiser que o Claude comece lá. Na primeira vez, conecte à sessão, responda às perguntas iniciais e faça login.

Mais uma parada para prever. Se o Claude encontrar um pedido de permissão enquanto você está fora, a sessão espera por você. A documentação cita uma flag para pular permissões em máquinas confiáveis. Leia como rodar o Claude Code sem supervisão com segurança antes de usar.

Notas de segurança

• Cada channel mantém uma lista de remetentes permitidos. Mensagens de qualquer outra pessoa são descartadas em silêncio.
• Qualquer pessoa na lista de permissão pode conduzir a sua sessão. Se o plugin repassa pedidos de permissão, ela também pode aprovar o uso de ferramentas. Adicione só pessoas a quem você confiaria a sua máquina.
• O token do seu bot é uma senha. Se ele vazar, revogue no BotFather e configure o novo.
• O iMessage lê o banco de dados do Messages e precisa de Full Disk Access. Em um Mac alugado, isso significa entrar com o seu Apple ID no Messages em um hardware que não é seu. Telegram ou Discord evitam isso.

Rodando em um Mac da MacRun

Nosso plano agente já tem o Claude Code instalado. Você faz login com o seu próprio plano do Claude. O Mac nunca entra em repouso e a sessão sobrevive a reinicializações. Você adiciona o Bun e o plugin, o que leva poucos minutos. Depois o seu notebook pode ser fechado, e o bot continua respondendo.

Quem não precisa disso. Se você só quer conduzir uma sessão pelo celular, o Remote Control do app do Claude faz isso sem bot. E se o administrador do seu plano Team não ativou os channels, um Mac novo não muda isso.

Para ver o quadro completo, leia como rodar o Claude Code 24/7 em um Mac.