Saltar al contenido principal
Los channels están en vista previa de investigación. Requieren autenticación de Anthropic a través de claude.ai o una clave API de Console, y no están disponibles en Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry. 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. Si administra una organización de Team, Enterprise o Console, consulte Habilitar channels para su organización. 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.
Vea el código fuente completo de Telegram.
1

Crear un bot de Telegram

Abre BotFather en Telegram y envía /newbot. Asígnale un nombre para mostrar y un nombre de usuario único que termine en bot. Copia el token que devuelve BotFather.
2

Instalar el plugin

Inicia Claude Code ejecutando claude en tu terminal y luego ingresa esto en su prompt:
Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:
  • Marketplace "claude-plugins-official" not found: agrega el marketplace con /plugin marketplace add anthropics/claude-plugins-official y luego reintenta la instalación.
  • Plugin "<name>" not found in marketplace "claude-plugins-official": es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con /plugin marketplace update claude-plugins-official y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta Plugin no encontrado en el marketplace.
Cuando la instalación solicite un alcance de instalación, elige la opción de alcance de usuario para que el plugin esté disponible en todos tus proyectos. Revisa el resumen de instalación: si reporta Run /reload-plugins to apply., consulta Aplicar cambios de plugin sin reiniciar para que el comando de configuración del plugin esté disponible.
3

Configurar tu token

Ejecuta el comando de configuración con el token de BotFather:
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 canales habilitados

Salga de Claude Code y reinicie con la bandera de canal. Esto inicia el plugin de Telegram, que comienza a sondear mensajes de su bot:
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 canal está activo.
De vuelta en Claude Code, ejecute:
Luego bloquee el acceso para que solo su cuenta pueda enviar mensajes:

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
1

Instalar el plugin de canal fakechat

Inicia Claude Code ejecutando claude en tu terminal y luego escribe el comando de instalación en su prompt:
Si la instalación falla, haga coincidir el mensaje que Claude Code reporta:
  • Marketplace "claude-plugins-official" not found: agrega el marketplace con /plugin marketplace add anthropics/claude-plugins-official y luego reintenta la instalación.
  • Plugin "<name>" not found in marketplace "claude-plugins-official": es posible que tu copia local del catálogo del marketplace esté desactualizada. Actualízala con /plugin marketplace update claude-plugins-official y luego reintenta la instalación. Si el reintento muestra el mismo mensaje, consulta Plugin not found in marketplace.
Cuando la instalación solicite un alcance de instalación, elija la opción de alcance de usuario para que el plugin esté disponible en todos sus proyectos.Si el resumen de instalación reporta Run /reload-plugins to apply., no necesitas hacer nada al respecto aquí, porque al reiniciar en el siguiente paso se carga el plugin.
2

Reiniciar con el channel habilitado

Salga de Claude Code y reinicie con --channels y pase el plugin fakechat que instaló:
El servidor fakechat se inicia automáticamente. La pantalla de inicio muestra un aviso de channels indicando que los mensajes de plugin:fakechat@claude-plugins-official se inyectan directamente en esta sesión. Si el plugin no está instalado o no está en la lista de permitidos aprobada, una línea de advertencia que nombra el problema aparece debajo de ese aviso.
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:
El mensaje llega a su sesión de Claude Code. La terminal lo muestra como una línea de channel entrante como ← fakechat · web: what's in my working directory?, mientras que el modelo lo recibe como un evento <channel source="plugin:fakechat:fakechat">, utilizando el nombre del servidor con alcance del plugin. Claude lo lee, hace el trabajo y llama a la herramienta reply de fakechat. Si Claude Code solicita permiso para la primera respuesta, apruébalo. 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 la mayoría de los mensajes, pero solo úselo en entornos en los que confíe. Incluso entonces, las acciones que ningún modo aprueba automáticamente aún se aplican. 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 Owner los habilite.
  • 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 habilite para la sesión con --channels. Los usuarios de Pro, Max y Ultra sin una organización omiten estas comprobaciones por completo: los canales están disponibles y los usuarios los habilitan por sesión con --channels.

Habilitar channels para su organización

Habilita los canales para tu organización desde Configuración de la organización > Claude Code > Channels, que requiere el rol de Owner, 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:
Si establece 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, deje channelsEnabled sin establecer en su lugar. Este ajuste requiere channelsEnabled: true. Si un usuario pasa a --channels un plugin que no está en tu lista, Claude Code se inicia normalmente pero el canal no se registra, y el aviso de inicio explica que el plugin no está en la lista aprobada de la organización. En el runtime del cliente MCP v2, un canal también puede no registrarse porque Claude Code no registra un servidor de canal que negocia la revisión de protocolo 2026-07-28.

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. Ni --channels ni --dangerously-load-development-channels aparecen en claude --help mientras la característica está en vista previa. Las banderas funcionan aunque no estén listadas. 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, páselo a --dangerously-load-development-channels en la forma plugin:<name>@<marketplace> o server:<name>. 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: