Как настроить CLAUDE.md по правилам Карпати: 4 принципа против раздувания кода и лишних правок
Шаблон инструкций для Claude Code набрал 227 тысяч звёзд на GitHub и устраняет привычку нейросетей переписывать рабочий код.
В начале 2025 года бывший директор по ИИ в Tesla и сооснователь OpenAI Андрей Карпати описал на платформе X ключевые проблемы при написании кода языковыми моделями. По его наблюдениям, нейросети склонны додумывать требования за человека, усложнять архитектуру и добавлять сотни строк абстракций там, где достаточно нескольких десятков.
Вторая частая проблема — неконтролируемые побочные правки: модели часто переписывают соседние комментарии, меняют стиль кавычек или удаляют чужой код, не относящийся к текущей задаче. Разработчик платформы Multica Цзяюань Чанг оформил наблюдения Карпати в виде готового набора правил для файла CLAUDE.md. К 31 октября 2026 года открытый репозиторий проекта multica-ai/andrej-karpathy-skills собрал свыше 227 тысяч звёзд на GitHub.
Как подключить правила к Claude Code
Разработчики предусмотрели два варианта установки: через официальную систему плагинов Claude Code либо прямым скачиванием файла CLAUDE.md в корень проекта. При установке плагином правила подключаются один раз и начинают действовать во всех рабочих директориях терминала.
Если требуется ограничить область действия одним репозиторием, достаточно загрузить файл CLAUDE.md через утилиту curl в корень целевой папки:
Для проектов, где уже ведётся собственный файл инструкций, правила можно дописать в конец документа через стандартное перенаправление вывода терминала:
1. Сначала думать: проверка предположений до генерации кода
Принцип «Think Before Coding» устраняет распространённую ошибку, когда агент молча выбирает одну из возможных интерпретаций расплывчатого запроса и начинает писать сотни строк не в ту сторону. Правило предписывает модели явно озвучивать все допущения перед началом редактирования файлов.
- Явно фиксировать предположения: если формулировка задачи допускает двоякое толкование, агент обязан задать уточняющий вопрос до внесения изменений в код.
- Показывать альтернативные пути: при наличии нескольких вариантов реализации модель обязана перечислить их и показать компромиссы, а не выбирать один путь втайне от человека.
- Отказываться от усложнений: если существует более простое решение задачи, агент должен прямо предложить его вместо реализации громоздкой конструкции.
- Останавливаться при нехватке данных: при обнаружении противоречий в кодовой базе модель прекращает выполнение и описывает возникшую неясность.
2. Простота превыше всего: запрет на упреждающие абстракции
Принцип «Simplicity First» направлен против раздувания архитектуры. По наблюдениям Карпати, языковые модели любят внедрять паттерны проектирования, интерфейсы и фабрики для однократных операций, а также писать обработку ошибок для сценариев, которые физически не могут возникнуть в программе.
- Никаких лишних функций: запрещено добавлять возможности, параметры конфигурации и флаги гибкости, о которых прямо не просили в исходном запросе.
- Запрет абстракций для однократного использования: если код вызывается только в одном месте, отдельный интерфейс или вспомогательный класс считается избыточным.
- Отказ от гипотетической обработки ошибок: не писать проверки и перехваты исключений для невозможных внутренних состояний системы.
- Правило сжатия: если написанный фрагмент из 200 строк можно сократить до 50 без потери функциональности, модель обязана переписать его в компактном виде.
3. Точечные правки: запрет на несанкционированный рефакторинг
Принцип «Surgical Changes» защищает проект от так называемого попутного рефакторинга. При исправлении ошибки в одной строке агент часто попутно меняет форматирование, добавляет подсказки типов в соседние функции или переписывает комментарии других авторов. В результате diff в pull request раздувается до десятков изменённых файлов.
- Не трогать соседний код: запрещено переформатировать чужие блоки, переписывать docstring-документацию или менять стиль кавычек ради личных предпочтений модели.
- Соответствовать стилю окружения: новый код обязан в точности повторять уже принятые в файле соглашения, даже если они отличаются от общих рекомендаций языка.
- Не трогать старый мёртвый код: если агент замечает неиспользуемые функции, созданные до его запуска, он сообщает о них в чате, но не удаляет самостоятельно.
- Убирать только собственный мусор: модель обязана подчищать за собой удалённые импорты, неиспользуемые переменные и промежуточные структуры, возникшие в ходе текущей правки.
4. Целевое исполнение: переход от приказов к циклам верификации
Принцип «Goal-Driven Execution» опирается на сильную сторону языковых моделей — способность циклически выполнять действия до достижения измеримого критерия успеха. Карпати отмечал, что вместо расплывчатых команд эффективнее формулировать проверяемые условия остановки.
Правило трансформирует типовые инструкции в последовательности с проверкой:
- Вместо команды «добавь валидацию» — «напиши тесты на некорректные входные данные, затем добейся успешного прохождения проверки».
- Вместо указания «исправь ошибку» — «напиши воспроизводящий тест, затем внеси минимальные правки до зелёного статуса».
- Вместо общего «сделай рефакторинг модуля» — «убедись, что существующий набор тестов завершается успешно до правок и после их завершения».
Для составных задач модель обязана сначала зафиксировать пошаговый план, где у каждого этапа указан конкретный способ верификации:
Плата за строгость и признаки работающих правил
В документации репозитория авторы прямо предупреждают о компромиссе: правила отдают приоритет осторожности перед скоростью. Для тривиальных действий вроде исправления опечатки в тексте или замены названия переменной избыточная строгость замедляет процесс, поэтому для мелких правок допустимо отступать от полного цикла согласований.
Признаки того, что инструкции дают практический эффект в проекте:
- В diff попадают исключительно запрошенные строки без посторонних правок в соседних модулях.
- Уточняющие вопросы по архитектуре и спорным моментам поступают до генерации кода, а не после обнаружения испорченных зависимостей.
- Кодовая база сохраняет единый стиль оформления, а размер pull request остаётся компактным.
- Модель самостоятельно перезапускает тесты при ошибках и возвращает управление человеку только после подтверждения работоспособности решения.
Всё самое интересное — в нашем Telegram-канале «Claude без воды».