Enviar eventos a una sesión en ejecución con channels

Utilice channels para enviar mensajes, alertas y webhooks a su sesión de Claude Code desde un servidor MCP. Reenvíe resultados de CI, mensajes de chat y eventos de monitoreo para que Claude pueda reaccionar mientras está fuera.

Un channel es un servidor MCP que envía eventos a su sesión de Claude Code en ejecución, para que Claude pueda reaccionar a cosas que suceden mientras no está en la terminal. Los channels pueden ser bidireccionales: Claude lee el evento y responde a través del mismo channel, como un puente de chat. Los eventos solo llegan mientras la sesión está abierta, por lo que para una configuración siempre activa, ejecuta Claude en un proceso de fondo o terminal persistente.

A diferencia de las integraciones que generan una sesión en la nube nueva o esperan a ser consultadas, el evento llega a la sesión que ya tiene abierta: vea cómo se comparan los channels.

Instala un channel como un plugin y lo configura con tus propias credenciales. Telegram, Discord e iMessage se incluyen en la vista previa de investigación.

Cuando Claude responde a través de un channel, ve el mensaje entrante en su terminal pero no el texto de respuesta. La terminal muestra la llamada de herramienta y una confirmación (como "enviado"), y la respuesta real aparece en la otra plataforma.

Esta página cubre:

• Channels compatibles: configuración de Telegram, Discord e iMessage
• Instalar y ejecutar un channel con fakechat, una demostración de localhost
• Quién puede enviar mensajes: listas de permitidos del remitente y cómo se empareja
• Habilitar channels para su organización si administra una organización de Team, Enterprise o Console
• Cómo se comparan los channels con sesiones web, Slack, MCP y Control Remoto

Para crear su propio channel, consulte la referencia de Channels.

Canales compatibles

Cada canal compatible es un plugin que requiere Bun. Para una demostración práctica del flujo de plugins antes de conectar una plataforma real, pruebe el inicio rápido de 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

También puede crear su propio canal para sistemas que aún no tienen un plugin.

Inicio rápido

Fakechat es un channel de demostración oficialmente compatible que ejecuta una interfaz de chat en localhost, sin nada que autenticar y sin servicio externo que configurar.

Una vez que instale y habilite fakechat, puede escribir en el navegador y el mensaje llega a su sesión de Claude Code. Claude responde y la respuesta aparece de nuevo en el navegador. Después de haber probado la interfaz de fakechat, pruebe Telegram, Discord o iMessage.

Para probar la demostración de fakechat, necesitará:

• Claude Code instalado y autenticado con una cuenta de claude.ai o una clave API de Claude Console
• Bun instalado. Los plugins de channel precompilados son scripts de Bun. Verifique con bun --version; si eso falla, instale Bun.
• Organización de Team, Enterprise o Console administrada: su administrador debe habilitar channels en la configuración administrada

/plugin install fakechat@claude-plugins-official

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

hey, what's in my working directory?

Si Claude encuentra un mensaje de permiso mientras está fuera de la terminal, la sesión se pausa hasta que responda. Los servidores de channel que declaran la capacidad de retransmisión de permisos pueden reenviarle estos mensajes para que pueda aprobar o denegar de forma remota. Para uso desatendido, --dangerously-skip-permissions evita los mensajes por completo, pero solo úselo en entornos en los que confíe.

Cuando ejecuta channels en modo no interactivo con -p, las herramientas que necesitan entrada de terminal, como preguntas de opción múltiple y aprobación de plan mode, se deshabilitan para que la sesión nunca se quede esperando entrada.

Seguridad

Cada plugin de channel aprobado mantiene una lista de permitidos del remitente: solo los ID que ha agregado pueden enviar mensajes, y todos los demás se descartan silenciosamente.

Telegram y Discord inician la lista mediante emparejamiento:

1. Encuentre su bot en Telegram o Discord y envíele cualquier mensaje
2. El bot responde con un código de emparejamiento
3. En su sesión de Claude Code, apruebe el código cuando se le solicite
4. Su ID de remitente se agrega a la lista de permitidos

iMessage funciona de manera diferente: enviarse un mensaje a sí mismo evita la puerta automáticamente, y agrega otros contactos por identificador con /imessage:access allow.

Además de eso, controla qué servidores están habilitados en cada sesión con --channels, y su organización controla la disponibilidad con channelsEnabled en planes de Team y Enterprise de claude.ai y en organizaciones de Console que implementan configuración administrada.

Estar en .mcp.json no es suficiente para enviar mensajes: un servidor también tiene que estar nombrado en --channels.

La lista de permitidos también controla la retransmisión de permisos si el channel la declara. Cualquiera que pueda responder a través del channel puede aprobar o denegar el uso de herramientas en su sesión, por lo que solo agregue remitentes de lista de permitidos en los que confíe con esa autoridad.

Controles empresariales

Los administradores controlan la disponibilidad a través de dos configuraciones administradas que los usuarios no pueden anular. El valor predeterminado depende de cómo se autentique:

• claude.ai Team y Enterprise: los channels se bloquean hasta que un administrador los habilita.
• Anthropic Console con autenticación de clave API: los channels se permiten de forma predeterminada. Solo necesita esta configuración si su organización implementa configuración administrada.

En todos los casos, ningún channel se ejecuta hasta que un usuario lo opte por la sesión con --channels.

Los usuarios de Pro y Max sin una organización omiten estas comprobaciones por completo: los channels están disponibles y los usuarios optan por participar por sesión con --channels.

Habilitar channels para su organización

Los administradores pueden habilitar channels desde claude.ai → Configuración de administrador → Claude Code → Channels, o estableciendo channelsEnabled en true en la configuración administrada.

Una vez habilitado, los usuarios de su organización pueden usar --channels para optar por servidores de channel en sesiones individuales. Si la configuración está deshabilitada o no está establecida, el servidor MCP aún se conecta y sus herramientas funcionan, pero los mensajes de channel no llegarán. Un mensaje de advertencia de inicio le dice al usuario que un administrador habilite la configuración.

Restringir qué plugins de channel pueden ejecutarse

De forma predeterminada, cualquier plugin en la lista de permitidos mantenida por Anthropic puede registrarse como un channel. Los administradores en planes de Team y Enterprise pueden reemplazar esa lista de permitidos con la suya propia estableciendo allowedChannelPlugins en la configuración administrada. Úselo para restringir qué plugins oficiales están permitidos, aprobar channels de su propio marketplace interno, o ambos. Cada entrada nombra un plugin y el marketplace del que proviene:

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

Cuando allowedChannelPlugins está establecido, reemplaza completamente la lista de permitidos de Anthropic: solo los plugins listados pueden registrarse. Déjelo sin establecer para volver a la lista de permitidos predeterminada de Anthropic. Una matriz vacía bloquea todos los plugins de channel de la lista de permitidos, pero --dangerously-load-development-channels aún puede omitirlo para pruebas locales. Para bloquear channels completamente incluida la bandera de desarrollo, déjelo sin establecer en su lugar.

Esta configuración requiere channelsEnabled: true. Si un usuario pasa un plugin a --channels que no está en su lista, Claude Code se inicia normalmente pero el channel no se registra, y el aviso de inicio explica que el plugin no está en la lista aprobada de la organización.

Vista previa de investigación

Los channels son una característica de vista previa de investigación. La disponibilidad se está implementando gradualmente, y la sintaxis de la bandera --channels y el contrato de protocolo pueden cambiar según los comentarios.

Durante la vista previa, --channels solo acepta plugins de una lista de permitidos mantenida por Anthropic, o de la lista de permitidos de su organización si un administrador ha establecido allowedChannelPlugins. Los plugins de channel en claude-plugins-official son el conjunto aprobado predeterminado. Si pasa algo que no está en la lista de permitidos efectiva, Claude Code se inicia normalmente pero el channel no se registra, y el aviso de inicio le dice por qué.

Para probar un channel que está creando, use --dangerously-load-development-channels. Vea Probar durante la vista previa de investigación para obtener información sobre cómo probar channels personalizados que cree.

Informe de problemas o comentarios en el repositorio de GitHub de Claude Code.

Cómo se comparan los channels

Varias características de Claude Code se conectan a sistemas fuera de la terminal, cada una adecuada para un tipo diferente de trabajo:

Los channels cierran la brecha en esa lista al enviar eventos de fuentes que no son de Claude a su sesión local ya en ejecución.

• Puente de chat: pregúntele a Claude algo desde su teléfono a través de Telegram, Discord o iMessage, y la respuesta regresa en el mismo chat mientras el trabajo se ejecuta en su máquina contra sus archivos reales.
• Receptor de webhook: un webhook de CI, su rastreador de errores, una canalización de implementación u otro servicio externo llega donde Claude ya tiene sus archivos abiertos y recuerda lo que estaba depurando.

Próximos pasos

Una vez que tenga un channel en ejecución, explore estas características relacionadas:

• Crear su propio channel para sistemas que aún no tienen plugins
• Control Remoto para conducir una sesión local desde su teléfono en lugar de reenviar eventos a ella
• Tareas programadas para sondear en un temporizador en lugar de reaccionar a eventos enviados