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)

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

Triviale Fehler werden zusammengefasst; der Grund der Umschreibung fährt in der Hook-Antwort mit, sodass jede Korrektur überprüfbar ist und nicht stillschweigend erfolgt.

Sicherheitsgrenze

PRECC schreibt nur um, wenn die semantische Äquivalenz nachweisbar erhalten bleibt oder vom Benutzer überprüfbar ist. Destruktive Befehle (rm, git push --force, git reset --hard) werden nie umgeschrieben, selbst wenn ein Skill passt. Jede Mutation muss beschränkt sein — der umgeschriebene Befehl muss die Kern-Tokens des Originals noch enthalten. Unbeschränkte Umschreibungen werden automatisch rückgängig gemacht. Jede angewandte Umschreibung wird protokolliert und angezeigt, sodass Sie sie prüfen, deaktivieren oder rückgängig machen können.

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

Aktuelle Version –:

Gemessene Einsparungen (Realdaten)

Einsparungen pro Version

Diese Zahlen werden automatisch aus anonymisierter Telemetrie aktualisiert.

Links

• GitHub: https://github.com/peria-ai/precc-cc
• Webseite: https://peria.ai
• Dokumentation: https://precc.cc