Giriş

PRECC nedir?

PRECC (Claude Code için Tahminsel Hata Düzeltme) , resmi PreToolUse hook mekanizması aracılığıyla Claude Code bash komutlarını yakalayan bir Rust aracıdır. Hataları gerçekleşmeden önce düzeltir, token tasarrufu sağlar ve yeniden deneme döngülerini ortadan kaldırır.

Topluluk kullanıcıları için ücretsiz.

Sorun

Claude Code, önlenebilir hatalarda önemli miktarda token harcar:

• Yanlış dizin hataları – Cargo.toml olmayan üst dizinde cargo build çalıştırmak ve hatayı okuduktan sonra yeniden denemek.
• Yeniden deneme döngüleri – Başarısız bir komut ayrıntılı çıktı üretir, Claude bunu okur, üzerinde düşünür ve yeniden dener. Her döngü yüzlerce token tüketir.
• Ayrıntılı çıktı – find veya ls -R gibi komutlar, Claude’un işlemesi gereken binlerce satır üretir.

Dört sütun

Bağlam Düzeltme (cd-prepend)

cargo build veya npm test gibi komutların yanlış dizinde çalıştığını algılar ve yürütmeden önce cd /doğru/yol && ekler.

GDB hata ayıklama

Segfault’lar ve çökmelerin daha derin hata ayıklaması için GDB iliştirme fırsatlarını algılar ve ham core dump’lar yerine yapılandırılmış hata ayıklama bilgisi sağlar.

Oturum madenciliği

Claude Code oturum kayıtlarından hata-düzeltme çiftlerini madenciliğe alır. Aynı hata tekrar ettiğinde PRECC düzeltmeyi zaten bilir ve otomatik olarak uygular.

Otomasyon yetenekleri

Komut desenleriyle eşleşen ve onları yeniden yazan yerleşik ve madeni yeteneklerden oluşan bir kütüphane. Yetenekler TOML dosyaları veya SQLite satırları olarak tanımlanır, bu da onları incelemeyi, düzenlemeyi ve paylaşmayı kolaylaştırır.

Nasıl çalışır (30 saniyelik versiyon)

1. Claude Code bir bash komutu çalıştırmak üzere.
2. PreToolUse hook komutu JSON olarak stdin üzerinden precc-hook’a gönderir.
3. precc-hook komutu pipeline’dan (yetenekler, dizin düzeltmesi, sıkıştırma) 3 milisaniyenin altında geçirir.
4. Düzeltilmiş komut JSON olarak stdout üzerinden geri döner.
5. Claude Code orijinali yerine düzeltilmiş komutu çalıştırır.

Önemsiz hatalar birleştirilir; yeniden yazma nedeni hook yanıtında taşınır, böylece her düzeltme denetlenebilir — sessiz değil.

Güvenlik sınırı

PRECC yalnızca anlamsal eşdeğerlik kanıtlanabilir şekilde korunduğunda veya kullanıcı tarafından doğrulanabilir olduğunda yeniden yazar. Yıkıcı komutlar (rm, git push --force, git reset --hard) bir yetenek eşleşse bile asla yeniden yazılmaz. Her mutasyon sınırlı olmalıdır — yeniden yazılan komut, orijinalin temel tokenlerini içermelidir. Sınırsız yeniden yazmalar otomatik olarak geri alınır. Uygulanan her yeniden yazma günlüğe kaydedilir ve gösterilir; böylece denetleyebilir, devre dışı bırakabilir veya geri alabilirsiniz.

Uyarlanabilir sıkıştırma

Bir komut sıkıştırmadan sonra başarısız olursa, PRECC bir sonraki denemede sıkıştırmayı otomatik olarak atlar ve Claude hata ayıklama için tam sıkıştırılmamış çıktıyı alır.

Canlı kullanım istatistikleri

Güncel sürüm –:

Ölçülen Tasarruf (Gerçek Veri)

Sürüme göre tasarruf

Bu sayılar anonim telemetri verilerinden otomatik olarak güncellenir.

Bağlantılar

• GitHub: https://github.com/peria-ai/precc-cc
• Web sitesi: https://peria.ai
• Belgeler: https://precc.cc