소개
PRECC란 무엇인가요?
PRECC (Claude Code를 위한 예측 오류 수정) 는 공식 PreToolUse 후크 메커니즘을 통해 Claude Code의 bash 명령을 가로채는 Rust 도구입니다. 오류를 발생하기 전에 수정하여 토큰을 절약하고 재시도 루프를 제거합니다.
커뮤니티 사용자에게 무료.
문제
Claude Code는 예방 가능한 실수에 상당한 토큰을 낭비합니다:
- 잘못된 디렉토리 오류 –
Cargo.toml이 없는 상위 디렉토리에서cargo build를 실행한 후 오류를 읽고 재시도합니다. - 재시도 루프 – 실패한 명령은 장황한 출력을 생성하고, Claude가 이를 읽고 추론하고 재시도합니다. 각 사이클마다 수백 개의 토큰을 소비합니다.
- 장황한 출력 –
find나ls -R같은 명령은 수천 줄을 출력하여 Claude가 처리해야 합니다.
네 가지 기둥
컨텍스트 수정 (cd-prepend)
cargo build나 npm test 같은 명령이 잘못된 디렉토리에서 실행될 때를 감지하고 실행 전에 cd /올바른/경로 &&를 추가합니다.
GDB 디버깅
세그폴트와 충돌의 심층 디버깅을 위해 GDB를 연결할 기회를 감지하고, 원시 코어 덤프 대신 구조화된 디버그 정보를 제공합니다.
세션 마이닝
Claude Code 세션 로그에서 실패-수정 쌍을 채굴합니다. 동일한 실수가 재발하면 PRECC는 이미 수정을 알고 자동으로 적용합니다.
자동화 스킬
명령 패턴에 일치하고 다시 작성하는 내장 및 채굴된 스킬 라이브러리. 스킬은 TOML 파일 또는 SQLite 행으로 정의되어 검사, 편집, 공유가 쉽습니다.
작동 방식 (30초 버전)
- Claude Code가 bash 명령을 실행하려고 합니다.
- PreToolUse 후크가 명령을 JSON 형식으로 stdin을 통해
precc-hook에 보냅니다. precc-hook은 3밀리초 미만으로 파이프라인(스킬, 디렉토리 수정, 압축)을 통해 명령을 처리합니다.- 수정된 명령이 JSON 형식으로 stdout을 통해 반환됩니다.
- Claude Code는 원본 대신 수정된 명령을 실행합니다.
사소한 오류는 통합됩니다. 재작성 이유는 후크 응답에 포함되어 있어 모든 수정은 감사 가능하며 묵시적이지 않습니다.
안전 경계
PRECC는 의미적 동등성이 증명 가능하게 보존되거나 사용자가 검증할 수 있는 경우에만 재작성합니다. 파괴적 명령(rm, git push --force, git reset --hard)은 스킬이 일치하더라도 절대 재작성되지 않습니다. 모든 변환은 유계여야 합니다 — 재작성된 명령은 원본 명령의 핵심 토큰을 포함해야 합니다. 무계 재작성은 자동으로 되돌려집니다. 적용된 모든 재작성은 기록되고 표시되어 감사, 비활성화 또는 취소할 수 있습니다.
적응형 압축
명령이 압축 후 실패하면 PRECC가 다음 재시도에서 자동으로 압축을 건너뛰어 Claude가 디버깅을 위한 전체 비압축 출력을 받습니다.
실시간 사용 통계
현재 버전 –:
| 지표 | 값 |
|---|---|
| 후크 호출 수 | – |
| 절약된 토큰 | – |
| 절약 비율 | –% |
| RTK 재작성 | – |
| CD 수정 | – |
| 후크 지연 시간 | – ms (p50) |
| 고유 사용자 | – |
실측 절약 (실제 데이터)
릴리스별 절약
이 수치는 익명화된 텔레메트리에서 자동으로 업데이트됩니다.
링크
- GitHub: https://github.com/peria-ai/precc-cc
- 웹사이트: https://peria.ai
- 문서: https://precc.cc