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.

Claude nigdy nie widzi błędu. Żadne tokeny nie są marnowane.

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

Wartości są szacunkowe. Każdy zapobieżony błąd unika pełnego cyklu ponawiania: wyjście błędu, rozumowanie modelu i polecenie ponowienia. 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