Introduzione

Cos’è PRECC?

PRECC (Correzione predittiva degli errori per Claude Code) è uno strumento Rust che intercetta i comandi bash di Claude Code tramite il meccanismo ufficiale PreToolUse hook. Corregge gli errori prima che si verifichino, risparmiando token ed eliminando i cicli di ritentativi.

Gratuito per sempre per gli utenti community.

Il problema

Claude Code spreca molti token in errori prevenibili:

• Errori di directory sbagliata – Eseguire cargo build in una directory padre senza Cargo.toml, e riprovare dopo aver letto l’errore.
• Cicli di ritentativi – Un comando fallito produce output verboso, Claude lo legge, ragiona su di esso e riprova. Ogni ciclo brucia centinaia di token.
• Output verboso – Comandi come find o ls -R stampano migliaia di righe che Claude deve elaborare.

I quattro pilastri

Correzione contesto (cd-prepend)

Rileva quando comandi come cargo build o npm test vengono eseguiti nella directory errata e prepone cd /correct/path && prima dell’esecuzione.

Debug GDB

Rileva opportunità per allegare GDB per un debug più profondo di segfault e crash, fornendo informazioni di debug strutturate invece di core dump grezzi.

Estrazione di sessioni

Estrae i log di sessione Claude Code per coppie errore-correzione. Quando lo stesso errore si ripete, PRECC conosce già la correzione e la applica automaticamente.

Competenze di automazione

Una libreria di competenze incorporate ed estratte che corrispondono ai pattern dei comandi e li riscrivono. Le competenze sono definite come file TOML o righe SQLite, rendendole facili da ispezionare, modificare e condividere.

Come funziona (versione di 30 secondi)

1. Claude Code sta per eseguire un comando bash.
2. L’hook PreToolUse invia il comando a precc-hook come JSON tramite stdin.
3. precc-hook esegue il comando attraverso la pipeline (competenze, correzione directory, compressione) in meno di 3 millisecondi.
4. Il comando corretto viene restituito come JSON tramite stdout.
5. Claude Code esegue il comando corretto al posto dell’originale.

Gli errori banali vengono accorpati; la ragione della riscrittura viaggia nella risposta dell’hook, quindi ogni correzione è verificabile — non silenziosa.

Limite di sicurezza

PRECC riscrive solo quando l’equivalenza semantica è dimostrabilmente preservata o verificabile dall’utente. I comandi distruttivi (rm, git push --force, git reset --hard) non vengono mai riscritti, anche se corrisponde una competenza. Ogni mutazione deve essere limitata — il comando riscritto deve contenere i token essenziali dell’originale. Le riscritture illimitate vengono annullate automaticamente. Ogni riscrittura applicata viene registrata e visualizzata per poterla controllare, disabilitare o annullare.

Compressione adattiva

Se un comando fallisce dopo la compressione, PRECC salta automaticamente la compressione al tentativo successivo, così Claude riceve l’output completo non compresso per il debug.

Statistiche di utilizzo in tempo reale

Versione attuale –:

Measured Savings (Ground Truth)

Risparmi per versione

Questi numeri si aggiornano automaticamente dalla telemetria anonimizzata.

Link

• GitHub: https://github.com/peria-ai/precc-cc
• Sito web: https://peria.ai
• Documentazione: https://precc.cc