Introducción

¿Qué es PRECC?

PRECC (Corrección predictiva de errores para Claude Code) es una herramienta Rust que intercepta los comandos bash de Claude Code a través del mecanismo oficial de hooks PreToolUse. Corrige errores antes de que ocurran, ahorrando tokens y eliminando bucles de reintento.

Gratuito para usuarios de la comunidad.

El problema

Claude Code desperdicia tokens significativos en errores prevenibles:

• Errores de directorio – Ejecutar cargo build en un directorio padre sin Cargo.toml, y reintentar después de leer el error.
• Bucles de reintento – Un comando fallido produce salida verbose, Claude la lee, razona y reintenta. Cada ciclo quema cientos de tokens.
• Salida verbose – Comandos como find o ls -R generan miles de líneas que Claude debe procesar.

Los cuatro pilares

Corrección de contexto (cd-prepend)

Detecta cuando comandos como cargo build o npm test se ejecutan en el directorio incorrecto y antepone cd /ruta/correcta && antes de la ejecución.

Depuración GDB

Detecta oportunidades para adjuntar GDB para una depuración más profunda de segfaults y crashes, proporcionando información de depuración estructurada.

Minería de sesiones

Mina los registros de sesión de Claude Code en busca de pares fallo-corrección. Cuando el mismo error recurre, PRECC ya conoce la corrección y la aplica automáticamente.

Habilidades de automatización

Una biblioteca de habilidades integradas y minadas que coinciden con patrones de comandos y los reescriben. Las habilidades se definen como archivos TOML o filas SQLite.

Cómo funciona (versión de 30 segundos)

1. Claude Code está a punto de ejecutar un comando bash.
2. El hook PreToolUse envía el comando a precc-hook como JSON por stdin.
3. precc-hook ejecuta el comando a través del pipeline (habilidades, corrección de directorio, compresión) en menos de 3 milisegundos.
4. El comando corregido se devuelve como JSON por stdout.
5. Claude Code ejecuta el comando corregido.

Los errores triviales se colapsan; la razón de la reescritura viaja en la respuesta del hook, así cada corrección es auditable, no silenciosa.

Límite de seguridad

PRECC solo reescribe cuando la equivalencia semántica se preserva de forma demostrable o es verificable por el usuario. Los comandos destructivos (rm, git push --force, git reset --hard) nunca se reescriben, incluso si coincide alguna habilidad. Toda mutación debe ser acotada — el comando reescrito debe contener los tokens esenciales del comando original. Las reescrituras no acotadas se revierten automáticamente. Cada reescritura aplicada se registra y se muestra para que puedas auditarla, desactivarla o revertirla.

Compresión adaptativa

Si un comando falla después de la compresión, PRECC omite automáticamente la compresión en el reintento para que Claude obtenga la salida completa sin comprimir para depurar.

Estadísticas de uso en vivo

Versión actual –:

Ahorro medido (datos reales)

Ahorro por versión

Estos números se actualizan automáticamente desde telemetría anonimizada.

Enlaces

• GitHub: https://github.com/peria-ai/precc-cc
• Sitio web: https://peria.ai
• Documentación: https://precc.cc