Как настроить CLAUDE.md по правилам Карпати: 4 принципа против раздувания кода и лишних правок

Как настроить CLAUDE.md по правилам Карпати: 4 принципа против раздувания кода и лишних правок

Шаблон инструкций для Claude Code набрал 227 тысяч звёзд на GitHub и устраняет привычку нейросетей переписывать рабочий код.

В начале 2025 года бывший директор по ИИ в Tesla и сооснователь OpenAI Андрей Карпати описал на платформе X ключевые проблемы при написании кода языковыми моделями. По его наблюдениям, нейросети склонны додумывать требования за человека, усложнять архитектуру и добавлять сотни строк абстракций там, где достаточно нескольких десятков.

Вторая частая проблема — неконтролируемые побочные правки: модели часто переписывают соседние комментарии, меняют стиль кавычек или удаляют чужой код, не относящийся к текущей задаче. Разработчик платформы Multica Цзяюань Чанг оформил наблюдения Карпати в виде готового набора правил для файла CLAUDE.md. К 31 октября 2026 года открытый репозиторий проекта multica-ai/andrej-karpathy-skills собрал свыше 227 тысяч звёзд на GitHub.

Репозиторий multica-ai/andrej-karpathy-skills на GitHub. Источник: GitHub
Репозиторий multica-ai/andrej-karpathy-skills на GitHub. Источник: GitHub

Как подключить правила к Claude Code

Разработчики предусмотрели два варианта установки: через официальную систему плагинов Claude Code либо прямым скачиванием файла CLAUDE.md в корень проекта. При установке плагином правила подключаются один раз и начинают действовать во всех рабочих директориях терминала.

/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skills@karpathy-skills

Если требуется ограничить область действия одним репозиторием, достаточно загрузить файл CLAUDE.md через утилиту curl в корень целевой папки:

curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md

Для проектов, где уже ведётся собственный файл инструкций, правила можно дописать в конец документа через стандартное перенаправление вывода терминала:

echo " " >> CLAUDE.md curl https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md

1. Сначала думать: проверка предположений до генерации кода

Принцип «Think Before Coding» устраняет распространённую ошибку, когда агент молча выбирает одну из возможных интерпретаций расплывчатого запроса и начинает писать сотни строк не в ту сторону. Правило предписывает модели явно озвучивать все допущения перед началом редактирования файлов.

  • Явно фиксировать предположения: если формулировка задачи допускает двоякое толкование, агент обязан задать уточняющий вопрос до внесения изменений в код.
  • Показывать альтернативные пути: при наличии нескольких вариантов реализации модель обязана перечислить их и показать компромиссы, а не выбирать один путь втайне от человека.
  • Отказываться от усложнений: если существует более простое решение задачи, агент должен прямо предложить его вместо реализации громоздкой конструкции.
  • Останавливаться при нехватке данных: при обнаружении противоречий в кодовой базе модель прекращает выполнение и описывает возникшую неясность.

2. Простота превыше всего: запрет на упреждающие абстракции

Принцип «Simplicity First» направлен против раздувания архитектуры. По наблюдениям Карпати, языковые модели любят внедрять паттерны проектирования, интерфейсы и фабрики для однократных операций, а также писать обработку ошибок для сценариев, которые физически не могут возникнуть в программе.

  • Никаких лишних функций: запрещено добавлять возможности, параметры конфигурации и флаги гибкости, о которых прямо не просили в исходном запросе.
  • Запрет абстракций для однократного использования: если код вызывается только в одном месте, отдельный интерфейс или вспомогательный класс считается избыточным.
  • Отказ от гипотетической обработки ошибок: не писать проверки и перехваты исключений для невозможных внутренних состояний системы.
  • Правило сжатия: если написанный фрагмент из 200 строк можно сократить до 50 без потери функциональности, модель обязана переписать его в компактном виде.

3. Точечные правки: запрет на несанкционированный рефакторинг

Принцип «Surgical Changes» защищает проект от так называемого попутного рефакторинга. При исправлении ошибки в одной строке агент часто попутно меняет форматирование, добавляет подсказки типов в соседние функции или переписывает комментарии других авторов. В результате diff в pull request раздувается до десятков изменённых файлов.

  • Не трогать соседний код: запрещено переформатировать чужие блоки, переписывать docstring-документацию или менять стиль кавычек ради личных предпочтений модели.
  • Соответствовать стилю окружения: новый код обязан в точности повторять уже принятые в файле соглашения, даже если они отличаются от общих рекомендаций языка.
  • Не трогать старый мёртвый код: если агент замечает неиспользуемые функции, созданные до его запуска, он сообщает о них в чате, но не удаляет самостоятельно.
  • Убирать только собственный мусор: модель обязана подчищать за собой удалённые импорты, неиспользуемые переменные и промежуточные структуры, возникшие в ходе текущей правки.

4. Целевое исполнение: переход от приказов к циклам верификации

Принцип «Goal-Driven Execution» опирается на сильную сторону языковых моделей — способность циклически выполнять действия до достижения измеримого критерия успеха. Карпати отмечал, что вместо расплывчатых команд эффективнее формулировать проверяемые условия остановки.

Правило трансформирует типовые инструкции в последовательности с проверкой:

  • Вместо команды «добавь валидацию» — «напиши тесты на некорректные входные данные, затем добейся успешного прохождения проверки».
  • Вместо указания «исправь ошибку» — «напиши воспроизводящий тест, затем внеси минимальные правки до зелёного статуса».
  • Вместо общего «сделай рефакторинг модуля» — «убедись, что существующий набор тестов завершается успешно до правок и после их завершения».

Для составных задач модель обязана сначала зафиксировать пошаговый план, где у каждого этапа указан конкретный способ верификации:

1. [Шаг задачи] → проверка: [конкретная команда или тест] 2. [Шаг задачи] → проверка: [конкретная команда или тест] 3. [Шаг задачи] → проверка: [конкретная команда или тест]

Плата за строгость и признаки работающих правил

В документации репозитория авторы прямо предупреждают о компромиссе: правила отдают приоритет осторожности перед скоростью. Для тривиальных действий вроде исправления опечатки в тексте или замены названия переменной избыточная строгость замедляет процесс, поэтому для мелких правок допустимо отступать от полного цикла согласований.

Признаки того, что инструкции дают практический эффект в проекте:

  • В diff попадают исключительно запрошенные строки без посторонних правок в соседних модулях.
  • Уточняющие вопросы по архитектуре и спорным моментам поступают до генерации кода, а не после обнаружения испорченных зависимостей.
  • Кодовая база сохраняет единый стиль оформления, а размер pull request остаётся компактным.
  • Модель самостоятельно перезапускает тесты при ошибках и возвращает управление человеку только после подтверждения работоспособности решения.

Всё самое интересное — в нашем Telegram-канале «Claude без воды».

22