Introduction

Qu’est-ce que PRECC ?

PRECC (Correction prédictive des erreurs pour Claude Code) est un outil Rust qui intercepte les commandes bash de Claude Code via le mécanisme officiel PreToolUse hook. Il corrige les erreurs avant qu’elles ne se produisent, économisant des tokens et éliminant les boucles de réessai.

Gratuit pour les utilisateurs communautaires.

Le problème

Claude Code gaspille des tokens importants sur des erreurs évitables :

• Erreurs de mauvais répertoire – Exécuter cargo build dans un répertoire parent sans Cargo.toml, puis réessayer après avoir lu l’erreur.
• Boucles de réessai – Une commande échouée produit une sortie verbeuse, Claude la lit, l’analyse et réessaie. Chaque cycle consomme des centaines de tokens.
• Sortie verbeuse – Des commandes comme find ou ls -R produisent des milliers de lignes que Claude doit traiter.

Les quatre piliers

Correction de contexte (cd-prepend)

Détecte quand des commandes comme cargo build ou npm test sont exécutées dans le mauvais répertoire et ajoute cd /bon/chemin && avant l’exécution.

Débogage GDB

Détecte les opportunités d’attacher GDB pour un débogage plus approfondi des segfaults et plantages, fournissant des informations de débogage structurées au lieu de core dumps bruts.

Exploration de sessions

Explore les journaux de session Claude Code à la recherche de paires échec-correction. Quand la même erreur réapparaît, PRECC connaît déjà la correction et l’applique automatiquement.

Compétences d’automatisation

Une bibliothèque de compétences intégrées et explorées qui correspondent aux modèles de commandes et les réécrivent. Les compétences sont définies comme fichiers TOML ou lignes SQLite, ce qui les rend faciles à inspecter, modifier et partager.

Comment ça marche (version 30 secondes)

1. Claude Code s’apprête à exécuter une commande bash.
2. Le hook PreToolUse envoie la commande à precc-hook au format JSON via stdin.
3. precc-hook traite la commande via le pipeline (compétences, correction de répertoire, compression) en moins de 3 millisecondes.
4. La commande corrigée est renvoyée au format JSON via stdout.
5. Claude Code exécute la commande corrigée à la place.

Les erreurs triviales sont fusionnées ; la raison de la réécriture est incluse dans la réponse du hook, de sorte que chaque correction est auditable, pas silencieuse.

Limite de sécurité

PRECC ne réécrit que lorsque l’équivalence sémantique est prouvablement préservée ou vérifiable par l’utilisateur. Les commandes destructrices (rm, git push --force, git reset --hard) ne sont jamais réécrites, même si une compétence correspond. Chaque mutation doit être bornée — la commande réécrite doit toujours contenir les tokens essentiels de la commande originale. Les réécritures non bornées sont automatiquement annulées. Chaque réécriture appliquée est journalisée et affichée pour que vous puissiez l’auditer, la désactiver ou l’annuler.

Compression adaptative

Si une commande échoue après compression, PRECC ignore automatiquement la compression lors de la prochaine tentative pour que Claude obtienne la sortie complète non compressée pour le débogage.

Statistiques d’utilisation en direct

Version actuelle –:

Économies mesurées (données réelles)

Économies par version

Ces chiffres se mettent à jour automatiquement à partir de la télémétrie anonymisée.

Liens

• GitHub: https://github.com/peria-ai/precc-cc
• Site web: https://peria.ai
• Documentation: https://precc.cc