Puente de Discord para Sesiones Autónomas de Código Claude

Un desarrollador ha construido un puente de Discord para sesiones autónomas de Claude Code para resolver la limitación basada en extracción donde Claude solo actúa cuando se activan las herramientas o se envía entrada CLI. El sistema permite un chat bidireccional en tiempo real mediante WebSocket con encolado de archivos locales y notificaciones push en eventos de parada/error.

Arquitectura

Flujo entrante: Discord → WebSocket → bridge.js → discord-inbox.jsonl → gancho PostToolUse → Claude

Flujo saliente: Claude → Discord MCP → #claude-code-chat → notificación push en teléfono

Componentes

• bridge.js (~50 líneas, discord.js v14): WebSocket persistente a la puerta de enlace de Discord que escucha un canal dedicado y escribe mensajes como JSONL en un archivo de bandeja de entrada local sin sondeo de API.
• Gancho PostToolUse: Lee la bandeja de entrada local en cada llamada de herramienta sin llamadas de red ni limitación — solo una lectura de archivo que toma microsegundos versus el intervalo de sondeo de 2 minutos utilizado anteriormente.
• Gancho PreToolUse: Inicia automáticamente el puente en la primera llamada de herramienta de cada sesión, sin hacer nada silenciosamente si ya está en ejecución.
• Webhook saliente: Envía actualizaciones de ESTADO estructuradas en eventos de Parada/Error con hilos nombrados por sesión creados automáticamente mediante el parámetro thread_name de Discord (requiere ?wait=true para obtener channel_id de vuelta — por defecto devuelve 204 vacío).

Decisiones de Diseño Clave

El principal cambio arquitectónico fue usar una cola de archivos locales en lugar del sondeo de API. JSONL con truncamiento atómico previene condiciones de carrera. El puente es agnóstico a la sesión — el historial de Discord persiste a través de caídas y reinicios, permitiendo que múltiples agentes compartan el mismo canal.

Limitaciones

Las solicitudes de aprobación de permisos (1/2/3) aún requieren entrada de terminal ya que Claude está inactivo en ese punto y las herramientas no se están activando. Esto funciona para redirigir durante una ejecución activa pero no para responder a solicitudes detenidas.

Resultados de Pruebas

Probado en 27K líneas analizadas durante la noche a través de dos sesiones paralelas, encontrando 15 errores y entregando una hoja de ruta de 6 meses a las 5:42 AM. La configuración requiere tres archivos bash y aproximadamente veinte minutos.