Enviar eventos para uma sessão em execução por meio de canais

• Os Channels do Claude Code são um recurso que entrega diretamente mensagens, notificações ou webhooks de sistemas externos a uma sessão em execução, permitindo que o Claude reaja imediatamente
• Os eventos são enviados por meio de um servidor MCP, e o Claude pode lê-los e responder pelo mesmo canal; como os eventos só chegam enquanto a sessão estiver aberta, é necessário um ambiente de execução persistente
• Telegram e Discord têm suporte nativo em prévia de pesquisa, e é obrigatório fazer login em claude.ai; autenticação por chave de API não é permitida
• Cada canal é fornecido na forma de um plugin baseado em Bun, e é possível fazer testes locais com fakechat
• Esse recurso atua para conectar diretamente eventos externos a sessões locais, preenchendo a lacuna entre recursos existentes como Slack, MCP e Remote Control

---

Recurso Channels para enviar eventos a uma sessão em execução

• Os Channels do Claude Code são um recurso que entrega diretamente mensagens, alertas e webhooks gerados em sistemas externos a uma sessão em execução, permitindo que o Claude reaja imediatamente
• Os eventos são entregues por meio de um servidor MCP, e o Claude pode lê-los e responder pelo mesmo canal
• Os eventos só chegam enquanto a sessão estiver aberta, então, para uso contínuo, é necessário executar em um processo em segundo plano ou terminal persistente
• Telegram e Discord têm suporte nativo na fase de prévia de pesquisa, e é obrigatório fazer login em claude.ai
• Console e autenticação por chave de API não são suportados, e em organizações Team/Enterprise o administrador deve ativar explicitamente o recurso

Canais compatíveis

• Cada canal é fornecido como um plugin baseado em Bun, e é possível testá-lo localmente com fakechat
• Canais compatíveis: Telegram, Discord

• Procedimento de configuração do Telegram

  • No BotFather, crie um bot com o comando /newbot e copie o token
  • No Claude Code, instale o plugin com o comando /plugin install telegram@claude-plugins-official
  • Configure o token com o comando /telegram:configure <token>
  • Ative o canal com o comando claude --channels plugin:telegram@claude-plugins-official
  • Envie uma mensagem ao bot no Telegram para receber um código de pareamento e conecte com /telegram:access pair <code>
  • Restrinja as contas autorizadas com /telegram:access policy allowlist

• Procedimento de configuração do Discord

  • No Discord Developer Portal, crie uma nova aplicação e copie o token do bot
  • Ative Message Content Intent
  • Em OAuth2 > URL Generator, conceda o escopo bot e as permissões relacionadas a mensagens, depois convide o bot para o servidor
  • Instale o plugin com /plugin install discord@claude-plugins-official
  • Configure o token com /discord:configure <token>
  • Execute o canal com claude --channels plugin:discord@claude-plugins-official
  • Envie uma DM ao bot para receber o código de pareamento e conecte com /discord:access pair <code>
  • Restrinja o acesso com /discord:access policy allowlist
  • Também é possível desenvolver um canal personalizado para sistemas que não tenham plugin próprio

Início rápido

• Fakechat é um canal de demonstração oficial que pode ser executado localmente sem autenticação nem configuração externa
• É necessário ter o Claude Code e o Bun instalados, e usuários Team/Enterprise precisam que o administrador ative o recurso de canais
• Instale com /plugin install fakechat@claude-plugins-official e depois execute com claude --channels plugin:fakechat@claude-plugins-official
• Ao acessar http://localhost:8787 no navegador e digitar uma mensagem, ela será entregue à sessão do Claude Code
• A resposta do Claude será exibida na interface do navegador, e se houver solicitações de permissão, será necessário aprová-las no terminal
• Em execução não assistida, é possível pular a confirmação de permissões com a opção --dangerously-skip-permissions (recomendado apenas em ambientes confiáveis)

Segurança

• Cada plugin de canal mantém uma lista de permissões de remetentes (allowlist), e apenas IDs registrados podem enviar mensagens
• Telegram e Discord inicializam a allowlist por meio de um código de pareamento
  1. Envie uma mensagem ao bot
  2. O bot responde com um código de pareamento
  3. Aprove o código na sessão do Claude Code
  4. O ID do remetente é adicionado à allowlist
• Ao iniciar a sessão, é preciso especificar com --channels quais servidores serão ativados e, em planos Team/Enterprise, o uso é controlado pela configuração da organização (channelsEnabled)

Controles empresariais

• O recurso de canais é gerenciado pela configuração channelsEnabled
  • Pro/Max (usuários individuais): disponível por padrão, com ativação por sessão usando --channels
  • Team/Enterprise: desativado por padrão; o administrador deve ativá-lo explicitamente

• Ativar canais na organização

  • É possível configurar em claude.ai → Admin settings → Claude Code → Channels
  • Ou definir channelsEnabled: true nas configurações administrativas
  • Quando ativado, os usuários podem adicionar servidores de canal a sessões individuais com a opção --channels
  • Quando desativado, a conexão com o servidor MCP é mantida, mas as mensagens do canal não são entregues

Prévia de pesquisa

• Channels é um recurso em prévia de pesquisa, com implantação gradual em andamento
• A sintaxe da flag --channels e o protocolo podem mudar com base no feedback
• No momento, apenas plugins incluídos na allowlist gerenciada pela Anthropic podem ser usados
• Se um plugin não oficial for especificado, o Claude Code será executado normalmente, mas o canal não será registrado
• Para testar canais em desenvolvimento, use a opção --dangerously-load-development-channels
• Problemas ou feedback podem ser enviados para o repositório GitHub do Claude Code

Comparação entre Channels e outros recursos

Recurso	Função	Uso mais adequado
Claude Code on the web	Executar tarefas em uma nova sandbox em nuvem clonada do GitHub	Delegação assíncrona de tarefas independentes
Claude in Slack	Criar uma sessão web ao chamar @Claude em um canal ou thread	Iniciar tarefas imediatamente no contexto de uma conversa em equipe
Servidor MCP	O Claude faz consultas quando necessário; não envia eventos para a sessão	Consulta de dados do sistema ou acesso somente leitura
Remote Control	Controlar uma sessão local pelo claude.ai ou aplicativo móvel	Operar remotamente uma sessão em andamento

• O Channels** preenche a lacuna entre esses recursos**, entregando diretamente eventos externos à sessão local

  • Ponte de chat: faça perguntas ao Claude via Telegram ou Discord e veja as respostas na mesma conversa
  • Receptor de webhook: o Claude recebe imediatamente, em uma sessão aberta, webhooks de serviços externos como CI, rastreadores de erro e pipelines de deploy

Próximos passos

• Desenvolver seu próprio canal para sistemas sem plugin
• Usar Remote Control para controlar a sessão remotamente em vez de apenas encaminhar eventos
• Montar automações baseadas em polling periódico com Scheduled tasks

[GN⁺]

Comentários do Hacker News

• Foi surpreendente ver a integração com Telegram sair antes de Slack ou Teams
  Mas, pesquisando, vi que o Telegram tem cerca de 1 bilhão de MAU (usuários ativos mensais), muito mais do que Slack (50 milhões) ou Teams (300 milhões)
  Fiquei tão surpreso quanto quando descobri que o Snapchat tinha o dobro de usuários do Twitter

  • Aposto que, entre esses 300 milhões do Teams, não há uma única pessoa que queira passar mais tempo lá
    Já o Telegram é uma plataforma que as pessoas de fato consideram útil e agradável
  • A bot API do Telegram é a mais amigável que já usei até hoje
    É a primeira ferramenta em que penso para enviar notificações do servidor para o celular
    Dá para configurar de forma tão simples quanto o ntfy.sh, mas sem quebrar toda semana no iOS
  • Eu também não uso Telegram para mensagens, mas uso bastante para implantar bots
    Com poucas linhas, dá para implementar comandos, upload de imagens, respostas etc., e só precisa de uma conta
    É um ambiente perfeito para criar ferramentas simples rapidamente
  • Se você gastar só 5 minutos pesquisando como criar um chatbot, vai ver que o Telegram é praticamente a única opção viável
    O iMessage é fechado, o WhatsApp é pago, e Discord ou Slack são pesados e complexos demais
    O Telegram trata bots como cidadãos de primeira classe (first-class), então é realmente muito fácil criar um
  • É engraçado que uma big tech de dezenas de bilhões de dólares, com milhares de engenheiros e os melhores modelos,
    ainda esteja atrás de um projeto open source de uma pessoa só, o Pi Coding Agent, que já implementou vários plugins com essa mesma funcionalidade
    Já existem mais de 700 pacotes do Pi, e, se precisar, dá para criar uma nova extensão com uma única linha de prompt

• É interessante que o Claude esteja mirando uma arquitetura de integração local baseada em sessão
  Neste momento, parece estar na fase de construir integrações usando as credenciais de autenticação do usuário
  Mais adiante, talvez o Claude possa migrar as sessões para um ecossistema próprio

  • Essa abordagem parece responder a exigências de segurança corporativa
    Os dispositivos empresariais já são fechados, então não há necessidade de uma camada extra de segurança de API externa
  • Seria ótimo se o Claude para iOS pudesse fazer pull/commit de Markdown ou diagramas draw.io em repositórios Git pessoais
  • A configuração de MCP da Amazon era parecida
    Todas as permissões eram gerenciadas com tokens OAuth, e o acesso era controlado por esses tokens
    Mas era trabalhoso definir permissões detalhadas por usuário

• Essa mudança favorece muito o projeto claws
  Antes, a Anthropic proibia o uso de tokens OAuth no SDK, então era preciso usar chaves de API caras
  Agora ficou oficialmente permitido conectar o canal desejado via MCP
  Estruturalmente, é o oposto do claws anterior: o código do Claude executa diretamente o servidor MCP e se torna o agente principal da comunicação
  Eu modifiquei meu fork do nanoclaw para rodar como PID 1 em um contêiner Docker,
  e assim consegui me comunicar diretamente com o canal por meio dos logs stdout do código do Claude

• Sinceramente, parece que essas ferramentas movidas a hype foram lançadas às pressas demais
  Não gosto muito da empresa Anthropic, mas o modelo Claude em si é excelente e passa uma sensação humana
  Fico curioso para ver até que ponto OpenAI e outras vão conseguir alcançar isso
  Por enquanto, somos obrigados a usar ecossistemas fechados, mas espero que foquem em melhorar o modelo em si
  Na verdade, esses recursos parecem algo que um desenvolvedor júnior fez em um dia conversando com o Claude Opus 5

  • Concordo totalmente. O Claude é bom, mas a empresa Anthropic é ruim

• O recurso de canais é exatamente o motivo de eu rodar o nanoclaw na empresa
  Ele aciona o Claude Code com base em eventos e fecha o loop com feedback, revisão e análise
  Não sei por que o MCP é necessário, mas vou testar imediatamente

• A limitação atual continua sendo a necessidade de um terminal
  Seria bom poder rodar o Claude Code em modo daemon em segundo plano

  • Dá para mandar para segundo plano com Ctrl-Z e o comando bg, ou manter a sessão com tmux
  • Já existe também um ambiente em nuvem, mas a estabilidade é muito baixa
  • Basta iniciar em uma sessão tmux e deixar rodando
  • Eu registrei o comando de servidor do opencode como uma unidade systemd e rodo no meu home server
    Uso conectado por clientes de desktop e mobile
    O recurso de “remote control” do CC é parecido, mas no momento é exclusivo para Mac

• O Claude alcançou muito rápido
  O valor central do OpenClaw está em canais, heartbeat e ecossistema open source

  • Agora já chegou quase ao nível de ClaudeClaw
    O próximo passo provavelmente será hospedagem em nuvem para execução contínua
  • Acho melhor construir uma estrutura integrada como o OpenClaw do que copiar recursos isolados
  • A verdadeira conquista do OpenClaw é só o fato de ter sido o primeiro a aparecer
    O código em si é famoso por engenharia excessiva, bugs e falta de documentação
  • Heartbeat custa caro, então até rodando em intervalos de 30 minutos já dá para consumir todo o plano
  • Na prática, dá para implementar heartbeat no Claude Code ou no Codex com o comando /loop

• Eu criei o agent-http, que usa o recurso de canais para fazer um wrapper de API HTTP
  Ele oferece a mesma interface da Agent API,
  mas se comunica diretamente com o código do Claude em vez de fazer scraping de terminal
  Agora dá para controlar o Claude em modo headless só com uma assinatura

  • O link do código está aqui
  • Houve uma pergunta pedindo para compartilhar o link

• Parece que a Anthropic está lançando experimentalmente um produto novo toda semana
  Fico em dúvida sobre quantos desses recursos ainda existirão daqui a um ano

  • Mesmo assim, parece ser uma fase de testar, com vários experimentos, o que funciona no mercado

• Qualquer software que ganhe recursos remotos acaba abrindo risco de exploração como backdoor
  Por isso, soluções corporativas de segurança precisam ter meios de distinguir instâncias legítimas do Claude Code
  de instâncias maliciosas