Introdução

O que é PRECC?

PRECC (Correção preditiva de erros para o Claude Code) é uma ferramenta Rust que intercepta comandos bash do Claude Code através do mecanismo oficial PreToolUse hook. Corrige erros antes que aconteçam, economizando tokens e eliminando ciclos de retentativa.

Gratuito para usuários da comunidade.

O problema

O Claude Code desperdiça tokens significativos em erros evitáveis:

• Erros de diretório errado – Executar cargo build em um diretório pai sem Cargo.toml, e tentar novamente após ler o erro.
• Ciclos de retentativa – Um comando falho produz saída verbosa, o Claude a lê, raciocina e tenta novamente. Cada ciclo consome centenas de tokens.
• Saída verbosa – Comandos como find ou ls -R produzem milhares de linhas que o Claude precisa processar.

Os quatro pilares

Correção de contexto (cd-prepend)

Detecta quando comandos como cargo build ou npm test são executados no diretório errado e adiciona cd /caminho/correto && antes da execução.

Depuração GDB

Detecta oportunidades de anexar GDB para depuração mais profunda de segfaults e travamentos, fornecendo informações de depuração estruturadas em vez de core dumps brutos.

Mineração de sessões

Minera logs de sessões do Claude Code em busca de pares falha-correção. Quando o mesmo erro reaparece, o PRECC já conhece a correção e a aplica automaticamente.

Habilidades de automação

Uma biblioteca de habilidades integradas e mineradas que correspondem a padrões de comando e os reescrevem. As habilidades são definidas como arquivos TOML ou linhas SQLite, facilitando a inspeção, edição e compartilhamento.

Como funciona (versão de 30 segundos)

1. O Claude Code está prestes a executar um comando bash.
2. O hook PreToolUse envia o comando para precc-hook como JSON via stdin.
3. precc-hook processa o comando pelo pipeline (habilidades, correção de diretório, compressão) em menos de 3 milissegundos.
4. O comando corrigido é retornado como JSON via stdout.
5. O Claude Code executa o comando corrigido em vez do original.

Erros triviais são agrupados; o motivo da reescrita viaja na resposta do hook, então cada correção é auditável, não silenciosa.

Limite de segurança

PRECC só reescreve quando a equivalência semântica é provavelmente preservada ou verificável pelo usuário. Comandos destrutivos (rm, git push --force, git reset --hard) nunca são reescritos, mesmo se uma habilidade corresponder. Toda mutação deve ser limitada — o comando reescrito deve conter os tokens essenciais do original. Reescritas ilimitadas são automaticamente revertidas. Cada reescrita aplicada é registrada e exibida para que você possa auditá-la, desativá-la ou desfazê-la.

Compressão adaptativa

Se um comando falhar após compressão, PRECC automaticamente pula a compressão na próxima tentativa para que Claude obtenha a saída completa não comprimida para debug.

Estatísticas de uso ao vivo

Versão atual –:

Economia medida (dados reais)

Economia por versão

Esses números são atualizados automaticamente a partir de telemetria anonimizada.

Links

• GitHub: https://github.com/peria-ai/precc-cc
• Site: https://peria.ai
• Documentação: https://precc.cc