Einführung

Was ist PRECC?

PRECC (Prädiktive Fehlerkorrektur für Claude Code) ist ein Rust-Tool, das Claude Code Bash-Befehle über den offiziellen PreToolUse-Hook-Mechanismus abfängt. Es behebt Fehler bevor sie auftreten, spart Token und eliminiert Wiederholungsschleifen.

Kostenlos für Community-Nutzer.

Das Problem

Claude Code verschwendet erhebliche Token durch vermeidbare Fehler:

Falsche Verzeichnisse – cargo build in einem übergeordneten Verzeichnis ohne Cargo.toml ausführen und nach dem Lesen des Fehlers erneut versuchen.
Wiederholungsschleifen – Ein fehlgeschlagener Befehl erzeugt ausführliche Ausgabe, Claude liest sie, denkt darüber nach und versucht es erneut.
Ausführliche Ausgabe – Befehle wie find oder ls -R erzeugen tausende Zeilen, die Claude verarbeiten muss.

Die vier Säulen

Kontextkorrektur (cd-prepend)

Erkennt, wenn Befehle wie cargo build oder npm test im falschen Verzeichnis ausgeführt werden, und stellt cd /korrekter/pfad && voran.

GDB-Debugging

Erkennt Möglichkeiten, GDB für tieferes Debugging von Segfaults und Abstürzen anzuhängen und liefert strukturierte Debug-Informationen.

Session-Mining

Analysiert Claude Code-Sitzungsprotokolle nach Fehler-Fix-Paaren. Bei wiederkehrenden Fehlern kennt PRECC die Lösung bereits und wendet sie automatisch an.

Automatisierungsskills

Eine Bibliothek eingebauter und geminter Skills, die Befehlsmuster erkennen und umschreiben. Skills werden als TOML-Dateien oder SQLite-Zeilen definiert.

So funktioniert es (30-Sekunden-Version)

Claude Code ist im Begriff, einen Bash-Befehl auszuführen.
Der PreToolUse-Hook sendet den Befehl als JSON an precc-hook über stdin.
precc-hook verarbeitet den Befehl durch die Pipeline (Skills, Verzeichniskorrektur, Komprimierung) in unter 3 Millisekunden.
Der korrigierte Befehl wird als JSON auf stdout zurückgegeben.
Claude Code führt den korrigierten Befehl aus.

Claude sieht den Fehler nie. Keine Token verschwendet.

Adaptive Komprimierung

Wenn ein Befehl nach der Komprimierung fehlschlägt, überspringt PRECC automatisch die Komprimierung beim erneuten Versuch, damit Claude die vollständige unkomprimierte Ausgabe zum Debuggen erhält.

Live-Nutzungsstatistiken

Metrik	Wert
Hook-Aufrufe	–
Gesparte Token	–
Sparquote	–%
RTK-Umschreibungen	–
CD-Korrekturen	–
Hook-Latenz	– ms (p50)

Die Zahlen sind Schätzungen. Jeder verhinderte Fehler vermeidet einen vollständigen Wiederholungszyklus: Fehlerausgabe, Modell-Reasoning und Wiederholungsbefehl. Diese Zahlen werden automatisch aus anonymisierter Telemetrie aktualisiert.

PRECC User Guide