Le système Auto-Fix utilise Claude Code Headless pour détecter et corriger les erreurs de production.

Comment fonctionne le système de correction automatique

Un développeur a créé un système automatisé qui détecte et corrige les erreurs de production en utilisant Claude Code CLI en mode headless. Le système fonctionne depuis plusieurs semaines et est décrit comme gratuit et open source, ne nécessitant qu'un abonnement Claude.

Architecture du système

Le flux de travail suit cette séquence :

• Les logs de production sont surveillés
• Un observateur identifie les erreurs, regroupe les doublons et classe la gravité
• Fenêtre de stabilisation de 30 secondes
• La détection d'erreurs critiques/élevées déclenche le système
• Création d'un worktree git (branche isolée qui ne touche jamais la branche principale)
• Lancement de Claude Code en mode headless, limité à l'erreur spécifique
• Notification Telegram : "Nouvelle erreur — Approuver la correction ?" avec options Approuver/Passer
• Création automatique d'une PR si approuvée

Détails clés de l'implémentation

Le développeur a identifié les worktrees git comme un composant crucial — chaque erreur obtient sa propre copie isolée du dépôt. Claude peut lire, modifier, exécuter des tests et effectuer d'autres opérations dans cet environnement isolé. Si une correction est insatisfaisante, le worktree peut être supprimé sans affecter la branche principale.

Les sessions Claude reçoivent des instructions ciblées contenant :

• Message d'erreur
• Trace de la pile
• Chemin affecté
• Niveau de gravité

La session headless s'exécute avec des outils limités : Lecture, Écriture, Édition, Glob, Grep et Bash. Un exemple d'instruction fourni : "Corrigez cette erreur de production dans la base de code LevProductAdvisor. Erreur : MongoServerError : pool de connexion fermé. Trace : à MongoClient.connect (mongo-client.ts:88). Chemin : POST /api/products/list. Gravité : CRITIQUE."

Résultats et performances

Selon le développeur :

• Erreurs d'infrastructure critiques (connexion base de données, authentification) : Claude corrige 70-80% correctement
• Bugs logiques avec traces de pile claires : Bonnes performances
• Erreurs vagues sans bonnes traces de pile : Résultats variables, généralement ignorées

Le système gère efficacement les problèmes simples comme les vérifications nulles manquantes ou la logique de requête incorrecte, souvent en les résolvant du premier coup.

Fonctionnalités supplémentaires

Le développeur a créé un tableau de bord Telegram interactif pour la surveillance :

• État de la file d'attente
• Erreurs récentes
• État du système
• Capacité de rafraîchissement

La vue /errors récupère les données de MongoDB et affiche des informations d'état comme "en correction • il y a 5 min", "détectée • il y a 12 min" ou "corrigée • il y a 2 h".

Stack technique

Le système utilise TypeScript, Express, MongoDB, node-telegram-bot-api et Claude Code CLI. Le développeur note que l'utilisation du CLI headless évite les coûts d'API, ne nécessitant qu'un abonnement Claude exécuté localement. Chaque session est limitée et isolée dans un worktree, minimisant les risques.

Le développeur prévoit de publier le dépôt sur GitHub, le décrivant comme générique — les utilisateurs pointent l'observateur vers leurs fichiers de logs et configurent les modèles de gravité.