Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Introduktion

Vad är PRECC?

PRECC (Prediktiv felkorrigering för Claude Code) är ett Rust-verktyg som fångar upp Claude Codes bash-kommandon via den officiella PreToolUse hook-mekanismen. Det åtgärdar fel innan de inträffar, sparar tokens och eliminerar omförsöksloopar.

Gratis för community-användare.

Problemet

Claude Code slösar betydande mängder tokens på fel som kan undvikas:

  • Fel-katalog-fel – Att köra cargo build i en överkatalog utan Cargo.toml, och sedan försöka igen efter att ha läst felet.
  • Omförsöksloopar – Ett misslyckat kommando producerar omfattande utdata, Claude läser det, resonerar kring det och försöker igen. Varje cykel förbrukar hundratals tokens.
  • Omfattande utdata – Kommandon som find eller ls -R producerar tusentals rader som Claude måste bearbeta.

De fyra pelarna

Kontextkorrigering (cd-prepend)

Upptäcker när kommandon som cargo build eller npm test körs i fel katalog och lägger till cd /correct/path && före körning.

GDB-felsökning

Upptäcker möjligheter att ansluta GDB för djupare felsökning av segfaults och krascher och tillhandahåller strukturerad felsökningsinformation istället för råa core dumps.

Sessionsbrytning

Bryter Claude Code-sessionsloggar efter fel-åtgärd-par. När samma fel återkommer känner PRECC redan till åtgärden och tillämpar den automatiskt.

Automatiseringsfärdigheter

Ett bibliotek med inbyggda och brutna färdigheter som matchar kommandomönster och skriver om dem. Färdigheter definieras som TOML-filer eller SQLite-rader, vilket gör dem lätta att inspektera, redigera och dela.

Så fungerar det (30-sekundersversion)

  1. Claude Code är på väg att köra ett bash-kommando.
  2. PreToolUse hook skickar kommandot till precc-hook som JSON via stdin.
  3. precc-hook kör kommandot genom pipelinen (färdigheter, katalogkorrigering, komprimering) på under 3 millisekunder.
  4. Det korrigerade kommandot returneras som JSON via stdout.
  5. Claude Code kör det korrigerade kommandot istället.

Triviala fel slås ihop; orsaken till omskrivningen följer med i hook-svaret, så varje korrigering är granskbar — inte tyst.

Säkerhetsgräns

PRECC skriver bara om när semantisk ekvivalens bevisligen bevaras eller är användarverifierbar. Destruktiva kommandon (rm, git push --force, git reset --hard) skrivs aldrig om, även om en färdighet matchar. Varje mutation måste vara avgränsad — det omskrivna kommandot måste fortfarande innehålla originalkommandots kärntokens. Oavgränsade omskrivningar återställs automatiskt. Varje tillämpad omskrivning loggas och visas så att du kan granska, inaktivera eller ångra den.

Adaptiv komprimering

Om ett kommando misslyckas efter komprimering hoppar PRECC automatiskt över komprimering vid omförsöket så att Claude får den fullständiga okomprimerade utdatan för felsökning.

Live-användningsstatistik

Aktuell version :

MätvärdeVärde
Hook-anrop
Sparade tokens
Besparingsgrad%
RTK-omskrivningar
CD-korrigeringar
Hook-latens ms (p50)
Användare

Measured Savings (Ground Truth)

Besparingar per version

Dessa siffror uppdateras automatiskt från anonymiserad telemetri.

Länkar