Введение

Что такое PRECC?

PRECC (Предиктивная коррекция ошибок для Claude Code) — это инструмент на Rust, который перехватывает bash-команды Claude Code через официальный механизм хуков PreToolUse. Он исправляет ошибки до их возникновения, экономя токены и устраняя циклы повторов.

Бесплатно для участников сообщества.

Проблема

Claude Code тратит значительное количество токенов на предотвратимые ошибки:

• Ошибки каталога — выполнение cargo build в каталоге без Cargo.toml.
• Циклы повторов — неудачная команда создаёт многословный вывод, Claude анализирует и повторяет.
• Многословный вывод — команды вроде find или ls -R выводят тысячи строк.

Четыре столпа

Исправление контекста (cd-prepend)

Определяет, когда команды вроде cargo build или npm test выполняются в неправильном каталоге, и добавляет cd /правильный/путь && перед выполнением.

Отладка GDB

Обнаруживает возможности подключения GDB для углублённой отладки segfault и сбоев.

Анализ сессий

Анализирует логи сессий Claude Code для поиска пар ошибка-исправление.

Навыки автоматизации

Библиотека навыков, которые сопоставляют шаблоны команд и перезаписывают их.

Как это работает (30-секундная версия)

1. Claude Code собирается выполнить bash-команду.
2. Хук PreToolUse отправляет команду в precc-hook как JSON.
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