CLAUDE.md Karpathy: 210K звёзд и 4 правила простыми словами

Кто на самом деле написал этот файл

Короткий честный ответ: не Karpathy. Файл собрал разработчик по имени Форрест Чанг (Forrest Chang) и выложил на GitHub - это сайт, где программисты хранят свои проекты открыто, а любой желающий может зайти, посмотреть код и забрать себе копию. В описании страницы прямо написано - файл «derived from Andrej Karpathy's observations», то есть выведен из наблюдений Karpathy, а не написан им лично. Сам Karpathy в одном из постов описал типичные провалы ИИ-агентов при написании кода: агенты молча додумывают за пользователя, не признаются, что запутались, любят раздувать простой код в сложную конструкцию и иногда трогают чужие строки, которые их не просили трогать

Чанг взял эти наблюдения и превратил их в 4 конкретных правила одним файлом. Получилось настолько метко, что страница разлетелась по GitHub с невероятной скоростью - отсюда и число 210 150 звёзд (это как лайки, только для кода: чем больше людей нажали на звёздочку, тем ценнее находка). Название страницы «andrej-karpathy-skills» и держит имя Karpathy в заголовке, поэтому путаница «это же Karpathy написал» разошлась почти везде, где обсуждали файл

Зачем вообще нужен файл правил для Claude Code

CLAUDE.md - это обычный текстовый файл, который ты кладёшь в корень своего проекта. Claude Code читает его в начале каждого разговора и старается следовать написанному. Жёстко заставить его это не может: по официальной справке Anthropic, «Claude reads it and tries to follow it, but there's no guarantee of strict compliance» - файл не команда, а скорее записка коллеге. Именно поэтому короткий и чёткий файл работает лучше длинного: справка Anthropic советует держать его меньше 200 строк, а файл Karpathy укладывается в 70 с большим запасом

Без такого файла Claude Code по умолчанию ведёт себя как способный, но самоуверенный помощник. Если задача описана нечётко, он выбирает интерпретацию сам и сразу пишет код, вместо того чтобы спросить, что именно ты имел в виду. Дальше 4 правила разбирают, как именно это лечится. Если у тебя ещё нет Claude Code вообще - установка с нуля разобрана в гайде Claude Code из России: скачать, оплатить и запустить за один вечер. А первые самостоятельные шаги в нём - в гайде Claude Code с нуля: от «у меня ничего нет» до первого готового результата

Все 4 правила коротко в одной таблице, детали - в разделах ниже:

Правило 1. Подумай, прежде чем писать код

Смысл в двух словах: не додумывай за пользователя молча. Если задача допускает два разных прочтения - Claude обязан назвать оба варианта и спросить, какой нужен, а не выбрать один по своему усмотрению и сразу выдать готовый код

Я проверил это своим прогоном (подробности и логи - в разделе «Проверил сам» ниже): без этого правила Claude Code показывает готовое решение и только в конце спрашивает, устраивает ли оно. С правилом - Claude сначала называет обе развилки словами, объясняет разницу и ждёт ответа, и только потом пишет код

Правило 2. Простота прежде всего

Смысл: минимум кода под задачу, без запасных возможностей, которые никто не просил. Karpathy в своём наблюдении отмечал, что ИИ-агенты «really like to overcomplicate code and APIs, bloat abstractions... implement a bloated construction over 1000 lines when 100 would do» - любят раздувать простую задачу в сложную конструкцию на тысячу строк там, где хватило бы сотни

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

Правило 3. Точечные правки без самодеятельности

Смысл: трогай только то, что просили, и ничего вокруг. Не «улучшай» соседний код по пути, не переписывай форматирование чужой функции, если тебя просили поправить одну строку. Заметил рядом мёртвый код - скажи об этом, но не удаляй сам, если не просили

Проверка из самого правила простая: каждая изменённая строка обязана иметь прямую связь с тем, что попросил пользователь. Если строка изменилась, а связи с задачей нет - это чужая правка, и она не нужна. Чем ещё Claude Code отличается от других похожих инструментов по дисциплине правок - смотри сравнение в гайде Cursor или Claude Code в 2026 году: разница в 6 раз на тесте и в гайде Goose или Claude Code: 2 способа получить ИИ-агента в 2026

Правило 4. Цель важнее инструкции

Смысл: вместо расплывчатой команды формулируй проверяемый результат. «Почини баг» превращается в «напиши тест, который воспроизводит баг, потом сделай так, чтобы тест прошёл». «Добавь проверку» превращается в «напиши тесты на неправильные данные, потом сделай так, чтобы они проходили»

Karpathy в своём наблюдении отдельно отмечал сильную сторону ИИ-агентов - способность крутиться в цикле, пока не достигнет чёткой цели: «LLMs are exceptionally good at looping until they meet specific goals... Don't tell it what to do, give it success criteria and watch it go» - не говори что делать, дай критерий успеха и дай агенту работать самостоятельно. Похожая идея про заранее заданный порядок действий разобрана в гайде Ultracode в Claude Code: 2 способа включить режим workflow

Проверил сам: одна задача, два поведения

Чтобы не пересказывать чужие слова, я собрал две одинаковые тестовые папки с файлом app.py (простая функция сложения двух чисел), версия Claude Code 2.1.251. В одной папке лежит только код. В другой - тот же код плюс файл CLAUDE.md с этими же 4 правилами. В обеих папках я попросил одну и ту же задачу: «Добавь в app.py валидацию входных данных для функции add»

Без файла CLAUDE.md Claude Code сам выбрал вариант («принимать только числа, отдельно отсекать bool»), сразу написал готовый код и лишь одной строкой в конце спросил, устраивает ли такая логика. Решение было принято раньше вопроса

С файлом CLAUDE.md Claude Code сначала назвал два разных варианта решения списком («A - только числа» и «B - любые складываемые типы»), объяснил разницу между ними человеческим языком и попросил выбрать один из двух, прежде чем написать хоть строку кода. Вопрос был задан раньше решения

Разница воспроизвелась дважды на каждой версии папки - поведение не было случайностью одного запуска. Это ровно та развилка, которую описывает правило 1: «If multiple interpretations exist, present them - don't pick silently» - если есть несколько прочтений, покажи их все, а не выбирай молча

Этот кусок вынесен в отдельный гайд Бесплатный ИИ-агент для VS Code: 3 пути без оплаты

Коротко, что изменилось в самом прогоне:

Шаг 1. Открой страницу проекта и посмотри файл

Ссылка github.com/multica-ai/andrej-karpathy-skills ведёт на главную страницу проекта. Наверху GitHub всегда показывает число звёзд прямо на экране - рядом со значком звезды в правом верхнем углу карточки проекта. Открой файл CLAUDE.md в списке файлов - он один-единственный, никаких вложенных папок с кодом искать не нужно

Что увидишь: короткий текст меньше 70 строк, разбитый на 4 пронумерованных раздела, каждый с жирным заголовком-смыслом и коротким списком правил внутри. Это тебе даёт возможность своими глазами убедиться, что файл действительно такой короткий, каким его описывают, и увидеть актуальное число звёзд на момент своего визита - оно наверняка успело подрасти ещё сильнее с 4 сентября 2026

Шаг 2. Скачай файл в свой проект

В Claude Code окно с командами уже под рукой, если ты им пользуешься. Открой окно с командами в папке своего проекта и выполни:

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

Что увидишь: на экране появится короткий отчёт о загрузке файла, а в папке проекта появится новый файл CLAUDE.md. Если у тебя в проекте уже есть свой файл CLAUDE.md с другими правилами - не перезаписывай его этой командой, а допиши правила Karpathy в конец существующего файла:

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

Дальше Claude Code в следующем же разговоре в этой папке прочитает файл и начнёт вести себя по его 4 правилам

Шаг 3. Проверь правило на реальной задаче

Попроси Claude Code сделать что-то, что можно понять хотя бы двумя разными способами - например, «добавь проверку данных» или «сократи эту функцию». Обрати внимание на порядок: сначала называет ли Claude Code развилку вариантов, или сразу показывает готовый код

Что увидишь: если файл сработал, ответ начнётся с вопроса или списка вариантов, а не с готового кода. Это живое подтверждение, что правила действительно меняют поведение, а не просто лежат мёртвым текстом в папке проекта

Шаг 4. Подстрой файл под свой проект

Автор той же страницы советует не переписывать готовые 4 правила, а дописывать к ним свои поверх, если у твоего проекта есть особые требования - например, свой стиль кода или обязательные проверки перед сохранением изменений

Что увидишь: файл CLAUDE.md растёт вниз новыми разделами, а исходные 4 правила Karpathy остаются нетронутыми сверху. Правила становятся личными под твой проект, а фундамент - все 4 базовых правила - остаётся тем же, что разлетелось по 210 тысячам чужих проектов на GitHub

Что файл не решает

Файл CLAUDE.md - это не жёсткая настройка, а инструкция, которой Claude Code старается следовать, но не обязан выполнять беспрекословно. Официальная справка Anthropic прямо это признаёт: «Claude reads it and tries to follow it, but there's no guarantee of strict compliance». Нужно ЗАБЛОКИРОВАТЬ какое-то действие железно, а не просто попросить его не делать? В Claude Code для этого есть отдельный механизм под названием хуки. Он разобран в гайде CLAUDE.md: памятка для ИИ, 4 прогона и замок на важное в разделе про замок вместо просьбы и в короткой справке Хуки (hooks) в Claude Code

Файл Karpathy также не заменяет твои собственные правила проекта - он задаёт общий стиль поведения (осторожность, простота, точечные правки, проверяемый результат), а конкретику своих инструментов, своих тестов и своих команд запуска всё равно приходится дописывать самому

Как настройки Claude Code усиливают эти же 4 правила

4 правила Karpathy работают на уровне текста-инструкции, а есть ещё уровень настроек, который работает жёстче - через параметры, а не через просьбу. Хочется не просто попросить Claude Code быть осторожнее, а закрепить это настройкой? Разбор рычагов настройки собран в гайде Усилить Claude настройкой, а не промптами - там 4 других рычага, ни один из них не завязан конкретно на файл Karpathy, но вместе они дополняют друг друга. Полностью бесплатный запуск Claude Code без единого рубля разобран в гайде Запусти Claude Code полностью бесплатно

Ещё один способ расширить возможности Claude Code - не файл-инструкция, а отдельный навык, который можно вызывать снова и снова. Разница и практика собраны в гайдах Как сделать свой Skill в Claude за 5 шагов: живой прогон 2026 и 7 скиллов Claude, что ведут весь мой контент: полная установка с нуля. А если хочется подключить Claude Code к внешнему сервису - почте, календарю, чужой базе данных - за это отвечает уже не файл и не навык, а протокол подключения. Коротко об этом в гайдах Claude MCP: как подключить свой первый сервис за 10 минут и MCP сервер простыми словами: 12 готовых серверов на выбор

Четыре разных способа влиять на поведение Claude Code сводятся в одну таблицу:

Что ещё почитать про CLAUDE.md и Claude Code

• CLAUDE.md: памятка для ИИ, 4 прогона и замок на важное - как завести свой файл памятки с нуля и чем хуки отличаются от простой просьбы
• Усилить Claude настройкой, а не промптами - другие рычаги настройки Claude Code, жёстче обычного текстового файла
• Память Claude в 2026: как посмотреть и стереть за 4 шага - память приложения Claude, другой продукт и другой механизм
• Claude Code из России: скачать, оплатить и запустить за один вечер - установка с нуля, если инструмента ещё нет
• Claude Code с нуля: от «у меня ничего нет» до первого готового результата - первые шаги после установки
• Запусти Claude Code полностью бесплатно - бесплатный вариант запуска без подписки
• Как сделать свой Skill в Claude за 5 шагов: живой прогон 2026 - навык, который можно вызывать снова и снова, вместо файла-инструкции
• 7 скиллов Claude, что ведут весь мой контент: полная установка с нуля - готовый набор навыков на практике
• Claude MCP: как подключить свой первый сервис за 10 минут - подключение к внешним сервисам
• MCP сервер простыми словами: 12 готовых серверов на выбор - готовые варианты подключения
• Хуки (hooks) в Claude Code - короткая справка про жёсткую блокировку действий
• Cursor или Claude Code в 2026 году: разница в 6 раз на тесте - сравнение с похожим инструментом
• Goose или Claude Code: 2 способа получить ИИ-агента в 2026 - ещё одно сравнение подходов
• Ultracode в Claude Code: 2 способа включить режим workflow - заранее заданный порядок действий вместо разовой просьбы

Источники

• GitHub: multica-ai/andrej-karpathy-skills - страница проекта с файлом CLAUDE.md, живое число звёзд
• Сырой файл CLAUDE.md - полный текст всех 4 правил
• Описание проекта на GitHub - происхождение файла, цитаты наблюдений Karpathy, таблица «проблема → принцип»
• Пост Andrej Karpathy на X - первоисточник наблюдений, на который ссылается описание проекта
• Официальная справка Claude Code: Memory - как CLAUDE.md загружается и почему это не жёсткая настройка
• Живой счётчик звёзд GitHub - прямой ответ сервиса со свежим числом звёзд

Памятка: 4 правила Karpathy за 2 минуты

Семь строк, которые закрывают путь от «кто это вообще написал» до готового файла в своём проекте

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