Saltar al contenido principal
Los channels están en vista previa de investigación y requieren Claude Code v2.1.80 o posterior. Requieren inicio de sesión en claude.ai. La autenticación de consola y clave API no es compatible. Las organizaciones de Team y Enterprise deben habilitarlos explícitamente.
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: Para crear su propio channel, consulte la referencia de Channels.

​
Channels compatibles

Cada channel 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.
Vea el código fuente completo de Telegram.
1

Crear un bot de Telegram

Abra BotFather en Telegram y envíe /newbot. Asígnele un nombre para mostrar y un nombre de usuario único que termine en bot. Copie el token que devuelve BotFather.
2

Instalar el plugin

En Claude Code, ejecute:
/plugin install telegram@claude-plugins-official
Si Claude Code informa que el plugin no se encuentra en ningún marketplace, su marketplace falta o está desactualizado. Ejecute /plugin marketplace update claude-plugins-official para actualizarlo, o /plugin marketplace add anthropics/claude-plugins-official si no lo ha agregado antes. Luego reintente la instalación.Después de instalar, ejecute /reload-plugins para activar el comando de configuración del plugin.
3

Configurar su token

Ejecute el comando de configuración con el token de BotFather:
/telegram:configure <token>
Esto lo guarda en ~/.claude/channels/telegram/.env. También puede establecer TELEGRAM_BOT_TOKEN en su entorno de shell antes de lanzar Claude Code.
4

Reiniciar con channels habilitados

Salga de Claude Code y reinicie con la bandera de channel. Esto inicia el plugin de Telegram, que comienza a sondear mensajes de su bot:
claude --channels plugin:telegram@claude-plugins-official
5

Emparejar su cuenta

Abra Telegram y envíe cualquier mensaje a su bot. El bot responde con un código de emparejamiento.
Si su bot no responde, asegúrese de que Claude Code se esté ejecutando con --channels del paso anterior. El bot solo puede responder mientras el channel está activo.
De vuelta en Claude Code, ejecute:
/telegram:access pair <code>
Luego bloquee el acceso para que solo su cuenta pueda enviar mensajes:
/telegram:access policy allowlist
También puede crear su propio channel 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
  • Bun instalado. Los plugins de channel precompilados son scripts de Bun. Verifique con bun --version; si eso falla, instale Bun.
  • Usuarios de Team/Enterprise: el administrador de su organización debe habilitar channels en la configuración administrada
1

Instalar el plugin de channel fakechat

Inicie una sesión de Claude Code y ejecute el comando de instalación:
/plugin install fakechat@claude-plugins-official
Si Claude Code informa que el plugin no se encuentra en ningún marketplace, su marketplace falta o está desactualizado. Ejecute /plugin marketplace update claude-plugins-official para actualizarlo, o /plugin marketplace add anthropics/claude-plugins-official si no lo ha agregado antes. Luego reintente la instalación.
2

Reiniciar con el channel habilitado

Salga de Claude Code y reinicie con --channels y pase el plugin fakechat que instaló:
claude --channels plugin:fakechat@claude-plugins-official
El servidor fakechat se inicia automáticamente.
Puede pasar varios plugins a --channels, separados por espacios.
3

Enviar un mensaje

Abra la interfaz de fakechat en http://localhost:8787 y escriba un mensaje:
hey, what's in my working directory?
El mensaje llega a su sesión de Claude Code como un evento <channel source="fakechat">. Claude lo lee, hace el trabajo y llama a la herramienta reply de fakechat. La respuesta aparece en la interfaz de chat.
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.

​
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 en planes de Team y Enterprise su organización controla la disponibilidad con channelsEnabled. 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

En planes de Team y Enterprise, los channels están deshabilitados de forma predeterminada. Los administradores controlan la disponibilidad a través de dos configuraciones administradas que los usuarios no pueden anular:
ConfiguraciónPropósitoCuando no está configurado
channelsEnabledInterruptor maestro. Debe ser true para que cualquier channel entregue mensajes. Establézcalo a través del botón de alternancia de la consola de administrador de claude.ai o directamente en la configuración administrada. Bloquea todos los channels incluida la bandera de desarrollo cuando está desactivado.Channels bloqueados
allowedChannelPluginsQué plugins pueden registrarse una vez que los channels están habilitados. Reemplaza la lista mantenida por Anthropic cuando se establece. Solo se aplica cuando channelsEnabled es true.Se aplica la lista predeterminada de Anthropic
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:
CaracterísticaQué haceBueno para
Claude Code en la webEjecuta tareas en una nueva sandbox en la nube, clonada desde GitHubDelegar trabajo asincrónico independiente que verifica más tarde
Claude en SlackGenera una sesión web desde una mención @Claude en un canal o hiloIniciar tareas directamente desde el contexto de conversación del equipo
Servidor MCP estándarClaude lo consulta durante una tarea; nada se envía a la sesiónDar a Claude acceso bajo demanda para leer o consultar un sistema
Control RemotoConduce su sesión local desde claude.ai o la aplicación móvil de ClaudeDirigir una sesión en progreso mientras está fuera de su escritorio
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: