Enviar eventos para uma sessão em execução com canais

Use canais para enviar mensagens, alertas e webhooks para sua sessão Claude Code de um servidor MCP. Encaminhe resultados de CI, mensagens de chat e eventos de monitoramento para que Claude possa reagir enquanto você está ausente.

Um canal é um servidor MCP que envia eventos para sua sessão Claude Code em execução, para que Claude possa reagir a coisas que acontecem enquanto você não está no terminal. Os canais podem ser bidirecionais: Claude lê o evento e responde através do mesmo canal, como uma ponte de chat. Os eventos chegam apenas enquanto a sessão está aberta, portanto, para uma configuração sempre ativa, você executa Claude em um processo de fundo ou terminal persistente.

Ao contrário das integrações que geram uma nova sessão na nuvem ou aguardam para serem consultadas, o evento chega na sessão que você já tem aberta: veja como os canais se comparam.

Você instala um canal como um plugin e o configura com suas próprias credenciais. Telegram, Discord e iMessage estão incluídos na visualização de pesquisa.

Quando Claude responde através de um canal, você vê a mensagem de entrada em seu terminal, mas não o texto da resposta. O terminal mostra a chamada de ferramenta e uma confirmação (como "enviado"), e a resposta real aparece na outra plataforma.

Esta página cobre:

• Canais suportados: configuração de Telegram, Discord e iMessage
• Instalar e executar um canal com fakechat, uma demonstração localhost
• Quem pode enviar mensagens: listas de permissão de remetentes e como você emparelha
• Habilitar canais para sua organização se você gerencia uma organização Team, Enterprise ou Console
• Como os canais se comparam com sessões web, Slack, MCP e Remote Control

Para criar seu próprio canal, consulte a referência de Canais.

Canais suportados

Cada canal suportado é um plugin que requer Bun. Para uma demonstração prática do fluxo de plugin antes de conectar uma plataforma real, tente o quickstart fakechat.

/plugin install telegram@claude-plugins-official

/telegram:configure <token>

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

/telegram:access pair <code>

/telegram:access policy allowlist

/plugin install discord@claude-plugins-official

/discord:configure <token>

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

/discord:access pair <code>

/discord:access policy allowlist

/plugin install imessage@claude-plugins-official

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

/imessage:access allow +15551234567

Você também pode criar seu próprio canal para sistemas que ainda não têm um plugin.

Quickstart

Fakechat é um canal de demonstração oficialmente suportado que executa uma interface de chat no localhost, sem nada para autenticar e nenhum serviço externo para configurar.

Depois de instalar e habilitar fakechat, você pode digitar no navegador e a mensagem chega em sua sessão Claude Code. Claude responde e a resposta aparece de volta no navegador. Depois de testar a interface fakechat, tente Telegram, Discord ou iMessage.

Para tentar a demonstração fakechat, você precisará de:

• Claude Code instalado e autenticado com uma conta claude.ai ou uma chave de API do Console Claude
• Bun instalado. Os plugins de canal pré-construídos são scripts Bun. Verifique com bun --version; se isso falhar, instale Bun.
• Organização Team, Enterprise ou Console gerenciada: seu administrador deve habilitar canais nas configurações gerenciadas

/plugin install fakechat@claude-plugins-official

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

hey, what's in my working directory?

Se Claude atingir um prompt de permissão enquanto você está longe do terminal, a sessão pausa até que você responda. Os servidores de canal que declaram a capacidade de retransmissão de permissão podem encaminhar esses prompts para você para que você possa aprovar ou negar remotamente. Para uso sem supervisão, --dangerously-skip-permissions ignora prompts completamente, mas use apenas em ambientes em que você confia.

Quando você executa canais em modo não interativo com -p, ferramentas que precisam de entrada de terminal, como perguntas de múltipla escolha e aprovação de modo de plano, são desabilitadas para que a sessão nunca fique travada aguardando entrada.

Segurança

Cada plugin de canal aprovado mantém uma lista de permissão de remetentes: apenas IDs que você adicionou podem enviar mensagens, e todos os outros são silenciosamente descartados.

Telegram e Discord inicializam a lista por emparelhamento:

1. Encontre seu bot no Telegram ou Discord e envie-lhe qualquer mensagem
2. O bot responde com um código de emparelhamento
3. Em sua sessão Claude Code, aprove o código quando solicitado
4. Seu ID de remetente é adicionado à lista de permissão

iMessage funciona de forma diferente: enviar uma mensagem para si mesmo ignora a porta automaticamente, e você adiciona outros contatos por identificador com /imessage:access allow.

Além disso, você controla quais servidores estão habilitados em cada sessão com --channels, e sua organização controla a disponibilidade com channelsEnabled em planos Team e Enterprise de claude.ai e em organizações Console que implantam configurações gerenciadas.

Estar em .mcp.json não é suficiente para enviar mensagens: um servidor também deve ser nomeado em --channels.

A lista de permissão também controla a retransmissão de permissão se o canal a declarar. Qualquer pessoa que possa responder através do canal pode aprovar ou negar o uso de ferramentas em sua sessão, portanto, apenas adicione à lista de permissão remetentes em quem você confia com essa autoridade.

Controles empresariais

Os administradores controlam a disponibilidade através de duas configurações gerenciadas que os usuários não podem substituir. O padrão depende de como você se autentica:

• claude.ai Team e Enterprise: os canais são bloqueados até que um administrador os habilite.
• Anthropic Console com autenticação de chave de API: os canais são permitidos por padrão. Você só precisa dessa configuração se sua organização implanta configurações gerenciadas.

Em todos os casos, nenhum canal é executado até que um usuário o opte para a sessão com --channels.

Usuários Pro e Max sem uma organização ignoram essas verificações completamente: os canais estão disponíveis e os usuários optam por sessão com --channels.

Habilitar canais para sua organização

Os administradores podem habilitar canais em claude.ai → Admin settings → Claude Code → Channels, ou definindo channelsEnabled como true nas configurações gerenciadas.

Uma vez habilitado, os usuários em sua organização podem usar --channels para optar por servidores de canal em sessões individuais. Se a configuração estiver desabilitada ou não definida, o servidor MCP ainda se conecta e suas ferramentas funcionam, mas as mensagens de canal não chegarão. Um aviso de inicialização informa ao usuário para ter um administrador habilitar a configuração.

Restringir quais plugins de canal podem ser executados

Por padrão, qualquer plugin na lista de permissão mantida pela Anthropic pode se registrar como um canal. Os administradores em planos Team e Enterprise podem substituir essa lista de permissão pela sua própria definindo allowedChannelPlugins nas configurações gerenciadas. Use isso para restringir quais plugins oficiais são permitidos, aprovar canais do seu próprio marketplace interno, ou ambos. Cada entrada nomeia um plugin e o marketplace de onde vem:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

Quando allowedChannelPlugins é definido, ele substitui completamente a lista de permissão da Anthropic: apenas os plugins listados podem se registrar. Deixe-o indefinido para voltar à lista de permissão padrão da Anthropic. Uma matriz vazia bloqueia todos os plugins de canal da lista de permissão, mas --dangerously-load-development-channels ainda pode contorná-lo para testes locais. Para bloquear canais completamente, incluindo a flag de desenvolvimento, deixe channelsEnabled indefinido.

Esta configuração requer channelsEnabled: true. Se um usuário passar um plugin para --channels que não esteja em sua lista, Claude Code inicia normalmente, mas o canal não se registra, e o aviso de inicialização explica que o plugin não está na lista aprovada da organização.

Visualização de pesquisa

Os canais são um recurso de visualização de pesquisa. A disponibilidade está sendo lançada gradualmente, e a sintaxe da flag --channels e o contrato de protocolo podem mudar com base no feedback.

Durante a visualização, --channels aceita apenas plugins de uma lista de permissão mantida pela Anthropic, ou da lista de permissão da sua organização se um administrador tiver definido allowedChannelPlugins. Os plugins de canal em claude-plugins-official são o conjunto aprovado padrão. Se você passar algo que não esteja na lista de permissão efetiva, Claude Code inicia normalmente, mas o canal não se registra, e o aviso de inicialização informa por quê.

Para testar um canal que você está criando, use --dangerously-load-development-channels. Veja Testar durante a visualização de pesquisa para informações sobre como testar canais personalizados que você cria.

Relate problemas ou feedback no repositório GitHub do Claude Code.

Como os canais se comparam

Vários recursos do Claude Code se conectam a sistemas fora do terminal, cada um adequado para um tipo diferente de trabalho:

Os canais preenchem a lacuna nessa lista enviando eventos de fontes não-Claude para sua sessão local já em execução.

• Ponte de chat: pergunte algo ao Claude do seu telefone via Telegram, Discord ou iMessage, e a resposta volta no mesmo chat enquanto o trabalho é executado em sua máquina contra seus arquivos reais.
• Receptor de webhook: um webhook de CI, seu rastreador de erros, um pipeline de implantação ou outro serviço externo chega onde Claude já tem seus arquivos abertos e se lembra do que você estava depurando.

Próximas etapas

Depois de ter um canal em execução, explore esses recursos relacionados:

• Criar seu próprio canal para sistemas que ainda não têm plugins
• Remote Control para dirigir uma sessão local do seu telefone em vez de encaminhar eventos para ela
• Tarefas agendadas para pesquisar em um cronômetro em vez de reagir a eventos enviados