Pular para o conteúdo principal
Os canais estão em visualização de pesquisa e exigem Claude Code v2.1.80 ou posterior. Eles exigem login em claude.ai. A autenticação por console e chave de API não é suportada. As organizações Team e Enterprise devem habilitá-los explicitamente.
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: 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.
Veja o código-fonte completo do plugin Telegram.
1

Criar um bot do Telegram

Abra BotFather no Telegram e envie /newbot. Dê a ele um nome de exibição e um nome de usuário único terminando em bot. Copie o token que BotFather retorna.
2

Instalar o plugin

No Claude Code, execute:
/plugin install telegram@claude-plugins-official
Se Claude Code relatar que o plugin não foi encontrado em nenhum marketplace, seu marketplace está ausente ou desatualizado. Execute /plugin marketplace update claude-plugins-official para atualizá-lo, ou /plugin marketplace add anthropics/claude-plugins-official se você ainda não o adicionou. Em seguida, tente novamente a instalação.Após instalar, execute /reload-plugins para ativar o comando de configuração do plugin.
3

Configurar seu token

Execute o comando de configuração com o token do BotFather:
/telegram:configure <token>
Isso o salva em ~/.claude/channels/telegram/.env. Você também pode definir TELEGRAM_BOT_TOKEN em seu ambiente de shell antes de iniciar Claude Code.
4

Reiniciar com canais habilitados

Saia do Claude Code e reinicie com a flag de canal. Isso inicia o plugin Telegram, que começa a pesquisar mensagens do seu bot:
claude --channels plugin:telegram@claude-plugins-official
5

Emparelhar sua conta

Abra o Telegram e envie qualquer mensagem para seu bot. O bot responde com um código de emparelhamento.
Se seu bot não responder, certifique-se de que Claude Code está em execução com --channels da etapa anterior. O bot só pode responder enquanto o canal está ativo.
De volta ao Claude Code, execute:
/telegram:access pair <code>
Em seguida, bloqueie o acesso para que apenas sua conta possa enviar mensagens:
/telegram:access policy allowlist
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
  • Bun instalado. Os plugins de canal pré-construídos são scripts Bun. Verifique com bun --version; se isso falhar, instale Bun.
  • Usuários de Team/Enterprise: seu administrador de organização deve habilitar canais nas configurações gerenciadas
1

Instalar o plugin de canal fakechat

Inicie uma sessão Claude Code e execute o comando de instalação:
/plugin install fakechat@claude-plugins-official
Se Claude Code relatar que o plugin não foi encontrado em nenhum marketplace, seu marketplace está ausente ou desatualizado. Execute /plugin marketplace update claude-plugins-official para atualizá-lo, ou /plugin marketplace add anthropics/claude-plugins-official se você ainda não o adicionou. Em seguida, tente novamente a instalação.
2

Reiniciar com o canal habilitado

Saia do Claude Code e reinicie com --channels e passe o plugin fakechat que você instalou:
claude --channels plugin:fakechat@claude-plugins-official
O servidor fakechat inicia automaticamente.
Você pode passar vários plugins para --channels, separados por espaço.
3

Enviar uma mensagem

Abra a interface fakechat em http://localhost:8787 e digite uma mensagem:
hey, what's in my working directory?
A mensagem chega em sua sessão Claude Code como um evento <channel source="fakechat">. Claude a lê, faz o trabalho e chama a ferramenta reply do fakechat. A resposta aparece na interface de chat.
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.

​
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 em planos Team e Enterprise sua organização controla a disponibilidade com channelsEnabled. 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

Em planos Team e Enterprise, os canais estão desabilitados por padrão. Os administradores controlam a disponibilidade através de duas configurações gerenciadas que os usuários não podem substituir:
ConfiguraçãoPropósitoQuando não configurado
channelsEnabledChave mestra. Deve ser true para que qualquer canal entregue mensagens. Defina através do toggle do console de administração claude.ai ou diretamente nas configurações gerenciadas. Bloqueia todos os canais, incluindo a flag de desenvolvimento quando desativado.Canais bloqueados
allowedChannelPluginsQuais plugins podem se registrar uma vez que os canais estão habilitados. Substitui a lista mantida pela Anthropic quando definido. Aplica-se apenas quando channelsEnabled é true.A lista padrão da Anthropic se aplica
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 Test during the research preview 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:
RecursoO que fazBom para
Claude Code na webExecuta tarefas em uma nova sandbox na nuvem, clonada do GitHubDelegar trabalho assíncrono independente que você verifica depois
Claude no SlackGera uma sessão web a partir de uma menção @Claude em um canal ou threadIniciar tarefas diretamente do contexto de conversa da equipe
Servidor MCP padrãoClaude o consulta durante uma tarefa; nada é enviado para a sessãoDar ao Claude acesso sob demanda para ler ou consultar um sistema
Remote ControlVocê dirige sua sessão local de claude.ai ou do aplicativo móvel ClaudeDirigir uma sessão em andamento enquanto está longe de sua mesa
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: