Wprowadzenie

Czym jest PRECC?

PRECC (Predykcyjna korekcja błędów dla Claude Code) to narzędzie Rust, które przechwytuje polecenia bash Claude Code za pomocą oficjalnego mechanizmu hooków PreToolUse. Naprawia błędy zanim się pojawią, oszczędzając tokeny i eliminując pętle ponawiania.

Bezpłatnie dla użytkowników społeczności.

Problem

Claude Code marnuje znaczną liczbę tokenów na możliwe do uniknięcia błędy:

• Błędy katalogu – Uruchomienie cargo build w katalogu nadrzędnym bez Cargo.toml, a następnie ponowna próba po przeczytaniu błędu.
• Pętle ponawiania – Nieudane polecenie generuje szczegółowe wyjście, Claude je czyta, analizuje i ponawia próbę.
• Szczegółowe wyjście – Polecenia takie jak find lub ls -R generują tysiące linii, które Claude musi przetworzyć.

Cztery filary

Korekta kontekstu (cd-prepend)

Wykrywa, gdy polecenia takie jak cargo build lub npm test są uruchamiane w złym katalogu i dodaje cd /correct/path && przed wykonaniem.

Debugowanie GDB

Wykrywa możliwości podpięcia GDB do głębszego debugowania segfaultów i awarii, dostarczając ustrukturyzowane informacje debugowania.

Eksploracja sesji

Przeszukuje logi sesji Claude Code w poszukiwaniu par awaria-naprawa. Gdy ten sam błąd się powtarza, PRECC już zna poprawkę i stosuje ją automatycznie.

Umiejętności automatyzacji

Biblioteka wbudowanych i wydobytych umiejętności dopasowujących wzorce poleceń i je przepisujących. Umiejętności definiowane są jako pliki TOML lub wiersze SQLite.

Jak to działa (wersja 30-sekundowa)

1. Claude Code zamierza uruchomić polecenie bash.
2. Hook PreToolUse wysyła polecenie do precc-hook jako JSON na stdin.
3. precc-hook przetwarza polecenie przez potok (umiejętności, korekta katalogu, kompresja) w mniej niż 3 milisekundy.
4. Poprawione polecenie jest zwracane jako JSON na stdout.
5. Claude Code wykonuje poprawione polecenie.

Trywialne błędy są łączone; powód przepisania jedzie w odpowiedzi hooka, więc każda korekta jest audytowalna, a nie cicha.

Granica bezpieczeństwa

PRECC przepisuje tylko wtedy, gdy równoważność semantyczna jest bezspornie zachowana lub weryfikowalna przez użytkownika. Destrukcyjne polecenia (rm, git push --force, git reset --hard) nigdy nie są przepisywane, nawet jeśli pasuje umiejętność. Każda mutacja musi być ograniczona — przepisane polecenie musi nadal zawierać główne tokeny oryginału. Nieograniczone przepisania są automatycznie cofane. Każde zastosowane przepisanie jest rejestrowane i wyświetlane, abyś mógł je audytować, wyłączyć lub cofnąć.

Kompresja adaptacyjna

Jeśli polecenie nie powiedzie się po kompresji, PRECC automatycznie pomija kompresję przy ponownej próbie, aby Claude otrzymał pełne nieskompresowane wyjście do debugowania.

Statystyki użycia na żywo

Aktualna wersja –:

Measured Savings (Ground Truth)

Oszczędności wg wersji

Te liczby aktualizują się automatycznie z zanonimizowanej telemetrii.

Linki

• GitHub: https://github.com/peria-ai/precc-cc
• Strona: https://peria.ai
• Dokumentacja: https://precc.cc