Channels do Claude Code: mande mensagens ao Claude Code pelo Telegram, Discord ou iMessage

O que são os channels do Claude Code

Um channel é um servidor MCP que envia eventos para a sua sessão do Claude Code em execução. Ele pode ser bidirecional: o Claude lê a mensagem e responde pelo mesmo channel, como uma ponte de chat. Os eventos só chegam enquanto a sessão está aberta.

• Plugins de channel oficiais: Telegram, Discord e iMessage, mais o fakechat, um chat de demonstração em localhost.
• Cada um é um plugin do claude-plugins-official e precisa do Bun instalado.
• Você também pode criar o seu próprio channel, por exemplo um receptor de webhooks para falhas de CI ou alertas de erro.
• Os channels são uma prévia de pesquisa: a flag --channels não aparece em claude --help, e a sintaxe pode mudar.
• No terminal, você vê a mensagem recebida e uma confirmação como “sent”; o texto da resposta em si aparece no app de chat.

Como configurar o channel do Telegram

1. Crie um bot

   No Telegram, abra o BotFather, envie /newbot, dê ao bot um nome e um username terminado em “bot”, e copie o token.

   # No Claude Code: instale o plugin oficial (escolha o escopo de usuário)
   /plugin install telegram@claude-plugins-official
   
   # Salve o token que o BotFather te deu
   /telegram:configure <token>
   
   # Reinicie o Claude Code com o channel ativado
   claude --channels plugin:telegram@claude-plugins-official
   
   # Mande uma mensagem ao seu bot e pareie com o código que ele responder
   /telegram:access pair <code>
   /telegram:access policy allowlist

2. Instale e configure o plugin

   No Claude Code, rode /plugin install telegram@claude-plugins-official e escolha o escopo de usuário. Se o marketplace não for encontrado, adicione-o com /plugin marketplace add anthropics/claude-plugins-official. Depois salve o token com /telegram:configure <token>, ou defina TELEGRAM_BOT_TOKEN antes de iniciar o Claude Code.

3. Reinicie com o channel ativado

   Saia e inicie o Claude Code de novo com --channels plugin:telegram@claude-plugins-official. Você pode passar vários plugins de channel, separados por espaços.

4. Pareie e restrinja o acesso

   Envie qualquer mensagem ao seu bot; ele responde com um código de pareamento. Aprove com /telegram:access pair <code> e depois rode /telegram:access policy allowlist para que só a sua conta alcance a sessão.

Fonte: documentação do Claude Code sobre channels

Discord e iMessage

• Discord: crie uma aplicação no Discord Developer Portal, copie o token do bot, ative o Message Content Intent e convide o bot com o escopo bot. Depois rode /plugin install discord@claude-plugins-official, /discord:configure <token>, reinicie com --channels plugin:discord@claude-plugins-official, mande uma DM ao bot e pareie com /discord:access pair <code>.
• iMessage: só no macOS, sem bot nem token. Ele lê o seu banco de dados do Mensagens, então dê ao seu terminal Acesso Total ao Disco. Instale imessage@claude-plugins-official, reinicie com --channels plugin:imessage@claude-plugins-official e mande uma mensagem para você mesmo. Adicione outras pessoas com /imessage:access allow <phone or Apple ID email>.
• Slack: não é um channel. O Claude no Slack inicia uma sessão na nuvem a partir de uma menção @Claude, em vez de mandar mensagens para a sua sessão local.
• WhatsApp e outros apps: não há plugin de channel oficial; você teria de criar o seu com a referência de channels.

Channels indisponíveis ou sem funcionar?

• O tipo de conta: os channels exigem login pelo claude.ai ou uma chave de API do Console. Eles não funcionam pelo Amazon Bedrock, pela Agent Platform do Google Cloud nem pelo Microsoft Foundry.
• A sua organização: no Claude Team e no Enterprise, os channels ficam bloqueados até um Owner ativá-los em Organization settings > Claude Code > Channels. Um aviso na inicialização informa isso. Contas Pro, Max e Ultra sem organização pulam essa verificação.
• O plugin não está aprovado: durante a prévia, --channels aceita só plugins da allowlist da Anthropic (ou da sua organização). Qualquer outro inicia sem o channel, e o aviso de inicialização diz por quê.
• O bot não responde: o Claude Code precisa estar rodando com --channels; o bot só consegue responder enquanto o channel está ativo.
• Para no meio da tarefa: um pedido de permissão pausa a sessão até alguém responder. Alguns channels conseguem repassar o pedido para o seu celular.

Mantenha estranhos de fora

• Todo channel oficial mantém uma allowlist de remetentes; mensagens de qualquer outra pessoa são descartadas em silêncio. Telegram e Discord adicionam você pelo pareamento; o iMessage deixa passar as suas próprias mensagens.
• Só servidores citados em --channels podem enviar mensagens; estar no .mcp.json não basta.
• Se um channel repassa pedidos de permissão, qualquer pessoa na allowlist dele pode aprovar ou negar o uso de ferramentas na sua sessão. Só adicione quem você confiaria para isso.

Channels vs Remote Control vs Claude no Slack

Deixe o Claude Code mandar mensagem para você, não só responder

Um channel é uma forma de falar com uma sessão que você deixou rodando. O Crewmark transforma essa sessão em um funcionário de IA: ele acorda com um heartbeat durante o horário de trabalho, pega a próxima issue de um quadro e manda mensagem para você no Crewmark quando trava, sem você ter de escrever primeiro.

1. Contrate um funcionário no seu Claude Code

   Rode o comando de configuração em uma conversa do Claude Code; essa conversa vira o funcionário. Veja o que é um funcionário de IA.

2. Dê a ele horário e um heartbeat

   Escolha o horário de trabalho e com que frequência ele acorda, a cada 15 a 240 minutos. Veja como deixar o Claude Code proativo.

3. Responda quando ele precisar de você

   As decisões chegam como mensagens diretas; uma resposta e ele continua. Para trabalho durante a noite, veja como rodar o Claude Code 24/7.

Perguntas frequentes sobre channels no Claude Code