Система автоматического исправления использует Claude Code Headless для обнаружения и устранения ошибок в продакшене.

Как работает система автоматического исправления

Разработчик создал автоматизированную систему, которая обнаруживает и исправляет ошибки в продакшене с использованием Claude Code CLI в headless-режиме. Система работает уже несколько недель и описывается как бесплатная и с открытым исходным кодом, требующая только подписку на Claude.

Архитектура системы

Рабочий процесс следует такой последовательности:

• Мониторинг логов продакшена
• Наблюдатель идентифицирует ошибки, группирует дубликаты и классифицирует серьезность
• 30-секундное окно стабилизации
• Обнаружение критических/высокоприоритетных ошибок запускает систему
• Создается git worktree (изолированная ветка, которая никогда не затрагивает основную)
• Claude Code запускается в headless-режиме, ограниченный конкретной ошибкой
• Уведомление в Telegram: "Новая ошибка — Одобрить исправление?" с вариантами Одобрить/Пропустить
• PR создается автоматически при одобрении

Ключевые детали реализации

Разработчик определил git worktree как критически важный компонент — каждая ошибка получает свою изолированную копию репозитория. Claude может читать, редактировать, запускать тесты и выполнять другие операции в этой изолированной среде. Если исправление неудовлетворительно, worktree можно удалить, не затрагивая основную ветку.

Сессии Claude получают сфокусированные промпты, содержащие:

• Сообщение об ошибке
• Трассировку стека
• Затронутый путь
• Уровень серьезности

Headless-сессия запускается с ограниченными инструментами: Read, Write, Edit, Glob, Grep и Bash. Пример предоставленного промпта: "Исправь эту ошибку в продакшене в кодовой базе LevProductAdvisor. Ошибка: MongoServerError: connection pool closed. Стек: at MongoClient.connect (mongo-client.ts:88). Путь: POST /api/products/list. Серьезность: КРИТИЧЕСКАЯ."

Результаты и производительность

По словам разработчика:

• Критические ошибки инфраструктуры (подключение к базе данных, аутентификация): Claude исправляет 70-80% корректно
• Логические баги с четкой трассировкой стека: Стабильная производительность
• Расплывчатые ошибки без хорошей трассировки стека: Результат непредсказуем, обычно пропускаются

Система эффективно справляется с простыми проблемами, такими как отсутствие проверок на null или некорректная логика запросов, часто решая их с первой попытки.

Дополнительные возможности

Разработчик создал интерактивную панель управления в Telegram для мониторинга:

• Статус очереди
• Последние ошибки
• Статус системы
• Возможность обновления

Представление /errors получает данные из MongoDB и отображает статусную информацию, такую как "исправляется • 5 минут назад", "обнаружено • 12 минут назад" или "исправлено • 2 часа назад".

Технологический стек

Система использует TypeScript, Express, MongoDB, node-telegram-bot-api и Claude Code CLI. Разработчик отмечает, что использование headless CLI позволяет избежать затрат на API, требуя только локально запущенную подписку на Claude. Каждая сессия ограничена и изолирована в worktree, минимизируя риски.

Разработчик планирует опубликовать репозиторий на GitHub, описывая его как универсальный — пользователи направляют наблюдатель на свои файлы логов и настраивают шаблоны серьезности.