Внедрение Karpathy-рекомендаций для Claude Code

Внедрите Karpathy-рекомендации для оптимизации CLAUDE.md и минимизации ошибок LLM при генерации кода. Пошаговое руководство для разработчиков.

Средний

Алексей Кузнецов

Системный администратор20 июля 2026 г.3 мин чтения

touch CLAUDE.md

# Допущения и уточнения

Перед реализацией:
- Формулируйте все допущения явно
- При неоднозначности останавливайтесь и спрашивайте
- Представляйте альтернативы, а не выбираете единственный путь

# Минимализм в коде

- Реализуйте только то, что прямо запрошено
- Не создавайте абстракций для одноразового использования
- Исключите обработку невозможных сценариев
- При наличии альтернативы выбирайте более простую реализацию

# Критерии успеха

Преобразуйте задачи:
- «Добавить валидацию» → «Написать тесты для невалидных входов, затем реализовать валидацию»
- «Оптимизировать запрос» → «Измерить время выполнения до/после, убедиться в улучшении»
- «Рефакторинг X» → «Убедиться, что тесты проходят до и после изменений»

# Хирургические изменения

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

# Проектные ограничения

## Технологический стек
- Python 3.11+, Django 4.x
- PostgreSQL 15, Redis 7

## Стандарты
- PEP 8 для Python-кода
- Тесты обязательны для бизнес-логики

## Запреты
- Никаких глобальных переменных
- Безопасность: только parameterized queries

# Метрики эффективности

Отслеживайте:
- Количество правок после code review
- Частоту уточняющих вопросов до начала работы
- Размер патчей (меньше — лучше)
- Время на исправление правок

Внедрение рекомендаций Karpathy для повышения качества работы Claude Code

Пошаговое руководство по созданию и настройке CLAUDE.md для минимизации типичных ошибок LLM при генерации кода

Предварительные требования

• Базовые навыки работы с Git
• Понимание структуры проекта
• Доступ к репозиторию проекта

Шаг 1: Создание базового файла CLAUDE.md

Создайте файл CLAUDE.md в корне проекта. Это специальный файл, который Claude Code использует для понимания поведенческих ожиданий. Разместите в нём рекомендации из репозитория Karpathy, адаптировав под специфику вашего проекта.

touch CLAUDE.md

Шаг 2: Интеграция принципа «Думай перед кодом»

Добавьте в CLAUDE.md секцию с чётким правилом: перед любой реализацией необходимо формулировать допущения. Это предотвращает распространённую ошибку LLM — навязывание собственных предположений вместо уточнения требований. Укажите, что при неоднозначных задачах нужно останавливаться и задавать уточняющие вопросы.

# Допущения и уточнения

Перед реализацией:
- Формулируйте все допущения явно
- При неоднозначности останавливайтесь и спрашивайте
- Представляйте альтернативы, а не выбираете единственный путь

Шаг 3: Принцип простоты как основа архитектуры

Укажите в CLAUDE.md, что каждый новый код должен быть минимальным решением задачи. Запретите добавлять абстракции, гибкость и обработку гипотетических сценариев. Это снижает риск появления ненужного кода, который потом придётся поддерживать.

# Минимализм в коде

- Реализуйте только то, что прямо запрошено
- Не создавайте абстракций для одноразового использования
- Исключите обработку невозможных сценариев
- При наличии альтернативы выбирайте более простую реализацию

Шаг 4: Чёткие критерии успеха для задач

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

# Критерии успеха

Преобразуйте задачи:
- «Добавить валидацию» → «Написать тесты для невалидных входов, затем реализовать валидацию»
- «Оптимизировать запрос» → «Измерить время выполнения до/после, убедиться в улучшении»
- «Рефакторинг X» → «Убедиться, что тесты проходят до и после изменений»

Шаг 5: Настройка верификации изменений

Установите правило: каждая изменённая строка должна иметь прямую связь с запросом пользователя. Запретите рефакторинг соседнего кода, исправление форматирования и удаление чужого мёртвого кода без прямой необходимости.

# Хирургические изменения

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

Шаг 6: Добавление проекта-специфичных правил

Разделите CLAUDE.md на две части: общие рекомендации Karpathy и специфику вашего проекта. В проектную секцию включите: используемые технологии, стандарты кода, список запрещённых паттернов, ссылки на внутреннюю документацию.

# Проектные ограничения

## Технологический стек
- Python 3.11+, Django 4.x
- PostgreSQL 15, Redis 7

## Стандарты
- PEP 8 для Python-кода
- Тесты обязательны для бизнес-логики

## Запреты
- Никаких глобальных переменных
- Безопасность: только parameterized queries

Шаг 7: Проверка эффективности рекомендаций

Через месяц использования CLAUDE.md проанализируйте: уменьшились ли случаи переписывания кода из-за переусложнения, стали ли уточняющие вопросы задаваться до начала реализации, исчезли ли правки, не связанные с задачей. Метрика успеха — снижение количества правок после review.

# Метрики эффективности

Отслеживайте:
- Количество правок после code review
- Частоту уточняющих вопросов до начала работы
- Размер патчей (меньше — лучше)
- Время на исправление правок