บทนำ

PRECC คืออะไร?

PRECC (การแก้ไขข้อผิดพลาดเชิงคาดการณ์สำหรับ Claude Code) เป็นเครื่องมือ Rust ที่ดักจับคำสั่ง bash ของ Claude Code ผ่านกลไก hook PreToolUse อย่างเป็นทางการ แก้ไขข้อผิดพลาดก่อนที่จะเกิดขึ้น ประหยัดโทเค็นและกำจัดลูปการลองใหม่

ฟรีสำหรับผู้ใช้ชุมชน

ปัญหา

Claude Code สูญเสียโทเค็นจำนวนมากกับข้อผิดพลาดที่ป้องกันได้:

• ข้อผิดพลาดไดเรกทอรี – รัน cargo build ในไดเรกทอรีที่ไม่มี Cargo.toml
• ลูปการลองใหม่ – คำสั่งที่ล้มเหลวสร้างเอาต์พุตยาว
• เอาต์พุตยาว – คำสั่งเช่น find หรือ ls -R สร้างหลายพันบรรทัด

สี่เสาหลัก

แก้ไขบริบท (cd-prepend)

ตรวจจับเมื่อคำสั่งเช่น cargo build หรือ npm test ทำงานในไดเรกทอรีผิดและเพิ่ม cd /path/ที่ถูก && ก่อนการทำงาน

การดีบัก GDB

ตรวจจับโอกาสในการแนบ GDB เพื่อดีบัก segfault และ crash

การขุดเซสชัน

วิเคราะห์ล็อกเซสชัน Claude Code เพื่อหาคู่ความล้มเหลว-การแก้ไข

ทักษะอัตโนมัติ

ไลบรารีของทักษะที่จับคู่รูปแบบคำสั่งและเขียนใหม่

วิธีการทำงาน (เวอร์ชัน 30 วินาที)

1. Claude Code กำลังจะรันคำสั่ง bash
2. Hook PreToolUse ส่งคำสั่งเป็น JSON ไปยัง precc-hook
3. precc-hook ประมวลผลคำสั่งในเวลาน้อยกว่า 3 มิลลิวินาที
4. คำสั่งที่แก้ไขแล้วถูกส่งกลับเป็น JSON
5. Claude Code รันคำสั่งที่แก้ไขแล้ว

Claude ไม่เคยเห็นข้อผิดพลาด

การบีบอัดแบบปรับตัว

หากคำสั่งล้มเหลวหลังจากการบีบอัด PRECC จะข้ามการบีบอัดในการลองใหม่โดยอัตโนมัติ เพื่อให้ Claude ได้เอาต์พุตเต็มสำหรับการดีบัก

สถิติการใช้งานสด

ตัวเลขเป็นการประมาณ ทุกความล้มเหลวที่ป้องกันได้หลีกเลี่ยงรอบการลองใหม่ทั้งหมด ตัวเลขเหล่านี้อัปเดตอัตโนมัติจากการวัดระยะไกลที่ไม่ระบุตัวตน

ลิงก์

• GitHub: https://github.com/peria-ai/precc-cc
• เว็บไซต์: https://peria.ai
• เอกสาร: https://precc.cc