Sistema de Correção Automática Usa Claude Code Headless para Detectar e Corrigir Erros de Produção

Como o Sistema de Correção Automática Funciona

Um desenvolvedor construiu um sistema automatizado que detecta e corrige erros de produção usando o Claude Code CLI em modo headless. O sistema está em execução há várias semanas e é descrito como gratuito e de código aberto, exigindo apenas uma assinatura do Claude.

Arquitetura do Sistema

O fluxo de trabalho segue esta sequência:

• Os logs de produção são monitorados
• Um observador identifica erros, agrupa duplicatas e classifica a gravidade
• Janela de estabilização de 30 segundos
• A detecção de erros Críticos/Altos aciona o sistema
• Worktree do git criado (ramo isolado que nunca toca o main)
• Claude Code iniciado em modo headless, com escopo para o erro específico
• Notificação no Telegram: "Novo Erro — Aprovar Correção?" com opções Aprovar/Ignorar
• PR criado automaticamente se aprovado

Detalhes Principais de Implementação

O desenvolvedor identificou os worktrees do git como um componente crítico — cada erro recebe sua própria cópia isolada do repositório. O Claude pode ler, editar, executar testes e realizar outras operações dentro deste ambiente isolado. Se uma correção for insatisfatória, o worktree pode ser excluído sem afetar o branch principal.

As sessões do Claude recebem prompts focados contendo:

• Mensagem de erro
• Rastreamento da pilha (stack trace)
• Caminho afetado
• Nível de gravidade

A sessão headless é executada com ferramentas de escopo: Leitura, Escrita, Edição, Glob, Grep e Bash. Um exemplo de prompt fornecido: "Corrija este erro de produção na base de código LevProductAdvisor. Erro: MongoServerError: pool de conexões fechado. Stack: em MongoClient.connect (mongo-client.ts:88). Caminho: POST /api/products/list. Gravidade: CRÍTICO."

Resultados e Desempenho

De acordo com o desenvolvedor:

• Erros críticos de infraestrutura (conexão com banco de dados, autenticação): Claude corrige 70-80% corretamente
• Bugs de lógica com rastreamentos claros da pilha: Desempenho sólido
• Erros vagos sem bons rastreamentos da pilha: Resultados variados, geralmente ignorados

O sistema lida efetivamente com problemas diretos como verificações nulas ausentes ou lógica de consulta ruim, frequentemente acertando na primeira tentativa.

Recursos Adicionais

O desenvolvedor construiu um painel interativo no Telegram para monitoramento:

• Status da Fila
• Erros Recentes
• Status do Sistema
• Capacidade de Atualização

A visualização /errors busca do MongoDB e exibe informações de status como "corrigindo • há 5m", "detectado • há 12m" ou "corrigido • há 2h".

Stack Técnico

O sistema usa TypeScript, Express, MongoDB, node-telegram-bot-api e Claude Code CLI. O desenvolvedor observa que usar o CLI headless evita custos de API, exigindo apenas uma assinatura do Claude executada localmente. Cada sessão tem escopo e isolamento em um worktree, minimizando riscos.

O desenvolvedor planeja publicar o repositório no GitHub, descrevendo-o como genérico — os usuários direcionam o observador para seus arquivos de log e configuram padrões de gravidade.