Introducere

Ce este PRECC?

PRECC (Corecție predictivă a erorilor pentru Claude Code) este un instrument Rust care interceptează comenzile bash ale Claude Code prin mecanismul oficial PreToolUse hook. Corectează erorile înainte ca acestea să apară, economisind tokeni și eliminând buclele de reîncercare.

Gratuit pentru utilizatorii comunității.

Problema

Claude Code irosește tokeni semnificativi pe greșeli care pot fi prevenite:

• Erori de director greșit – Rularea cargo build într-un director părinte fără Cargo.toml, apoi reîncercarea după citirea erorii.
• Bucle de reîncercare – O comandă eșuată produce ieșire detaliată, Claude o citește, raționează asupra ei și reîncearcă. Fiecare ciclu consumă sute de tokeni.
• Ieșire detaliată – Comenzi precum find sau ls -R afișează mii de linii pe care Claude trebuie să le proceseze.

Cei patru piloni

Corecție context (cd-prepend)

Detectează când comenzi precum cargo build sau npm test rulează în directorul greșit și adaugă cd /correct/path && înainte de execuție.

Depanare GDB

Detectează oportunități de a atașa GDB pentru depanare mai profundă a segfault-urilor și a blocărilor, oferind informații de depanare structurate în loc de core dumps brute.

Minerit de sesiuni

Extrage din jurnalele de sesiune Claude Code perechi eroare-corectare. Când aceeași greșeală reapare, PRECC știe deja corectarea și o aplică automat.

Abilități de automatizare

O bibliotecă de abilități încorporate și extrase care corespund modelelor de comenzi și le rescriu. Abilitățile sunt definite ca fișiere TOML sau rânduri SQLite, facilitând inspectarea, editarea și partajarea.

Cum funcționează (versiunea de 30 de secunde)

1. Claude Code este pe cale să ruleze o comandă bash.
2. Hook-ul PreToolUse trimite comanda la precc-hook ca JSON prin stdin.
3. precc-hook rulează comanda prin pipeline (abilități, corectare director, comprimare) în mai puțin de 3 milisecunde.
4. Comanda corectată este returnată ca JSON prin stdout.
5. Claude Code execută comanda corectată în locul celei originale.

Erorile triviale sunt comasate; motivul rescrierii călătorește în răspunsul hook-ului, astfel încât fiecare corecție este auditabilă, nu tăcută.

Limita de siguranță

PRECC rescrie doar când echivalența semantică este demonstrabil păstrată sau verificabilă de utilizator. Comenzile distructive (rm, git push --force, git reset --hard) nu sunt niciodată rescrise, chiar dacă o abilitate se potrivește. Fiecare mutație trebuie să fie limitată — comanda rescrisă trebuie să conțină token-urile esențiale ale originalului. Rescrierile nelimitate sunt revocate automat. Fiecare rescriere aplicată este înregistrată și afișată pentru a putea fi auditată, dezactivată sau anulată.

Comprimare adaptivă

Dacă o comandă eșuează după comprimare, PRECC omite automat comprimarea la reîncercare, astfel încât Claude primește ieșirea completă necomprimată pentru depanare.

Statistici de utilizare în timp real

Versiunea curentă –:

Measured Savings (Ground Truth)

Economii pe versiune

Aceste numere se actualizează automat din telemetria anonimizată.

Linkuri

• GitHub: https://github.com/peria-ai/precc-cc
• Site web: https://peria.ai
• Documentație: https://precc.cc