Ponte do Discord para Sessões Autônomas de Código Claude

Um desenvolvedor construiu uma ponte para Discord para sessões autônomas do Claude Code, resolvendo a limitação baseada em pull, onde o Claude só age quando ferramentas são acionadas ou entrada CLI é enviada. O sistema permite chat bidirecional em tempo real via WebSocket com enfileiramento de arquivos locais e notificações push em eventos de parada/erro.

Arquitetura

Fluxo de entrada: Discord → WebSocket → bridge.js → discord-inbox.jsonl → hook PostToolUse → Claude

Fluxo de saída: Claude → Discord MCP → #claude-code-chat → notificação push no telefone

Componentes

• bridge.js (~50 linhas, discord.js v14): WebSocket persistente para o gateway do Discord que escuta um canal dedicado e grava mensagens como JSONL em um arquivo de entrada local sem verificação de API.
• Hook PostToolUse: Lê a entrada local em cada chamada de ferramenta sem chamadas de rede ou limitação — apenas uma leitura de arquivo que leva microssegundos versus o intervalo de verificação de 2 minutos usado anteriormente.
• Hook PreToolUse: Inicia automaticamente a ponte na primeira chamada de ferramenta de cada sessão, silenciosamente não fazendo nada se já estiver em execução.
• Webhook de saída: Envia atualizações de STATUS estruturadas em eventos de Parada/Erro com threads nomeadas por sessão criadas automaticamente via parâmetro thread_name do Discord (requer ?wait=true para obter channel_id de volta — o padrão retorna 204 vazio).

Decisões de Design Principais

A principal mudança arquitetônica foi usar uma fila de arquivos locais em vez de verificação de API. JSONL com truncamento atômico evita condições de corrida. A ponte é agnóstica à sessão — o histórico do Discord persiste através de falhas e reinicializações, permitindo que múltiplos agentes compartilhem o mesmo canal.

Limitações

Solicitações de aprovação de permissão (1/2/3) ainda exigem entrada de terminal, já que o Claude está inativo nesse ponto e as ferramentas não estão sendo acionadas. Isso funciona para redirecionar durante execução ativa, mas não para responder a prompts parados.

Resultados de Teste

Testado em 27 mil linhas analisadas durante a noite em duas sessões paralelas, encontrando 15 bugs e entregando um roteiro de 6 meses às 5:42 da manhã. A configuração requer três arquivos bash e aproximadamente vinte minutos.