Karpathy skills для Claude Code: 4 правила против мусора
CLAUDE.md с четырьмя правилами Карпатого собрал 230 тысяч звёзд. Разбираю файл, способы установки и прогон Claude Code на одной задаче с правилами и без.
230 тысяч звёзд на GitHub собрал файл длиной 65 строк. Karpathy skills для Claude Code — это CLAUDE.md с четырьмя правилами поведения: думать до кода, писать минимум, править хирургически и работать от проверяемой цели. Собрал его Forrest Chang по заметке Андрея Карпатого о том, где ИИ-агенты ошибаются в коде. Ставится плагином или одной командой curl.
В апреле я разбирал этот файл, когда у репозитория было 48 тысяч звёзд. За полгода он вырос почти в пять раз и переехал в организацию Multica, а текст правил не поменялся. Поэтому в этот раз я не стал пересказывать README, а прогнал Claude Code на одной задаче четыре раза: дважды с правилами Карпатого и дважды без них.
В статье разберём:
- что написано в CLAUDE.md от Karpathy skills;
- откуда у репозитория 230 тысяч звёзд;
- как я проверял правила на демо-проекте;
- что изменилось в ответах Claude Code;
- сколько кода и денег стоят правила;
- как поставить Karpathy skills в Claude Code и Cursor;
- когда правила мешают.
Что написано в CLAUDE.md от Karpathy skills
Файл отвечает на пост Карпатого от 26 января 2026 года. Там он перечислил, что раздражает в агентах для кода. Модели молча выбирают одну трактовку задачи и не переспрашивают. Раздувают абстракции и пишут тысячу строк там, где хватит сотни. Заодно меняют код и комментарии, которые не поняли, хотя к задаче они не относятся.
Forrest Chang превратил эти жалобы в четыре раздела инструкции. Каждый открывается жирным девизом, под ним 4–6 строк правил.

Пройдусь по разделам и переведу каждый на язык поведения агента.
Think Before Coding: думать до кода. Строка «State your assumptions explicitly. If uncertain, ask» требует назвать допущения вслух и спросить, если не уверен. Следующая запрещает молча выбирать одну трактовку из нескольких. Ещё две разрешают спорить, если есть путь проще, и велят остановиться, если что-то непонятно.
Simplicity First: сначала простота. Никаких функций сверх запроса, абстракций для одноразового кода и настроек, о которых не просили. Ошибки обрабатываются только для тех сценариев, которые реально случатся. Проверка простая: сказал бы старший инженер, что это переусложнено? Если 200 строк можно ужать до 50, их переписывают.
Surgical Changes: хирургические правки. Соседний код, комментарии и форматирование не трогать, даже если хочется. Стиль файла сохранять, даже если сам писал бы иначе. Чужой мёртвый код упомянуть, но не удалять. Убирать можно только то, что осиротело из-за твоей же правки: импорт, переменную, функцию. Каждая изменённая строка должна вести к запросу пользователя.
Goal-Driven Execution: работа от цели. Императивная просьба превращается в цель с проверкой. Вместо «добавь валидацию» агент пишет тесты на плохие входные данные и добивается, чтобы они прошли. Вместо «почини баг» сначала пишет тест, который баг воспроизводит. Для задач из нескольких шагов файл просит короткий план, где у каждого шага есть проверка:
1. [Шаг] → проверка: [что проверить]
2. [Шаг] → проверка: [что проверить]
3. [Шаг] → проверка: [что проверить]
Четвёртый принцип опирается на мысль Карпатого: модели отлично крутятся в цикле, пока не достигнут конкретной цели, поэтому им нужен критерий успеха, а не пошаговые указания. Похожую идею Anthropic позже встроила в сам Claude Code командой /goal.
Рядом с CLAUDE.md в репозитории лежит EXAMPLES.md на 522 строки. В нём каждое правило показано парой: что обычно делает модель и как правильно.

Если свой CLAUDE.md ты ещё не писал, начни с гайда по инструкциям для Claude Code: правила Карпатого ложатся поверх проектных и их не заменяют.
Откуда у репозитория 230 тысяч звёзд
На 6 ноября 2026 года у репозитория 230 тысяч звёзд и 22,9 тысячи форков. По рейтингу star-history.com это 23-е место среди всех репозиториев GitHub. Для сравнения: 17 апреля, когда вышел мой первый разбор, звёзд было 48 тысяч.

Цифру стоит читать аккуратно. Звёзды копились, пока сам файл стоял на месте. Текст правил последний раз меняли 27 января, в день создания репозитория. Апрельские коммиты добавили правило для Cursor и перевод README на китайский, а после 20 апреля в репозитории не было ни одного коммита. Открытыми висят 138 задач и запросов на слияние, среди них переводы на корейский и японский и метаданные для Codex.
Ещё одна перемена касается адреса. Репозиторий переехал из личного аккаунта forrestchang в организацию multica-ai. Автор теперь делает Multica, открытую платформу для команд из людей и ИИ-агентов, и ссылка на неё висит первой строкой README. Старый адрес GitHub перенаправляет на новый, я проверил это командой git ls-remote: оба адреса отдают один и тот же коммит.
Звёзды говорят о том, что проблема знакома многим. Работают ли правила, по ним не понять. Это я и проверил.
Как я проверял правила на демо-проекте
Задачу я выбрал так, чтобы она провоцировала все три болячки из поста Карпатого. В демо-проекте лежит модуль расчёта счёта для интернет-магазина на 39 строк. В нём есть всё, на что агенту хочется отвлечься: функция loadItems в верблюжьем стиле среди змеиного, мёртвая функция old_total_v1 с комментарием «вроде больше не используется» и неиспользуемый импорт Decimal. Рядом два теста и CLI.
Промпт специально неоднозначный: «Добавь в расчёт счёта поддержку промокода со скидкой.» Непонятно, скидка в процентах или в рублях, считается она до НДС или после, где хранятся коды и что делать с неизвестным.
Условия прогона:
- Claude Code 2.1.319, модель Opus 5.5, запуск без интерфейса через
claude -p; - мои настройки, хуки и плагины отключены флагом
--setting-sources project,local, все скиллы флагом--disable-slash-commands; - в двух прогонах в корне проекта лежит CLAUDE.md из репозитория Карпатого, в двух других его нет;
- агенту разрешено править файлы и запускать тесты.
Скиллы я выключил потому, что у меня самого karpathy-guidelines стоит в общих скиллах с мая и мог бы сработать в прогоне «без правил». Мой глобальный ~/.claude/CLAUDE.md загружался во всех четырёх прогонах, это я проверил отдельным запросом. Но в нём только правила про терминал, GitHub и память, про стиль кода там ничего нет.
Что изменилось в ответах Claude Code
Разница видна с первого ответа. Без правил Claude Code оба раза сразу написал код. С правилами он оба раза остановился и задал вопросы.


Без правил Claude сам выбрал трактовку и спросил про неё уже после кода. С правилами он задал пять вопросов до первой правки и к каждому предложил вариант. Скриншот: терминал / matveev.tech
Без правил Claude придумал коды SALE10 и SALE20, решил считать скидку от суммы до НДС и написал четыре теста. Тесты он не запустил: в одном прогоне сам написал, что «код не проверен», в другом проверил только CLI вручную. Вопросы о том, какие коды нужны и до или после НДС считать скидку, пришли в конце, когда код уже был готов.
С правилами ответ начинается со слов «Прежде чем писать код, нужно решить несколько вопросов». Дальше идут пять пунктов, и к каждому Claude предлагает вариант по умолчанию. Например, по НДС: «(100 − 10) × 1,2 = 108». Ответить на такое можно одним словом. Я ответил «да» в той же сессии, и Claude сделал ровно предложенное, а потом прогнал тесты.
Одна деталь меня удивила. Чужой код без правил тоже никто не тронул. Во всех четырёх прогонах loadItems, old_total_v1 и лишний импорт остались на месте. Болячку из апрельской статьи про рефакторинг соседнего модуля «заодно» Opus 5.5 в этой задаче не показал. Третий принцип у современной модели, похоже, уже работает и без подсказки.

Сколько кода и денег стоят правила
Объём правок я посчитал командой git diff --numstat по Python-файлам каждого прогона.

| Прогон | Добавлено строк | Тестов добавлено | Тесты запущены агентом | Время | Стоимость по оценке Claude Code |
|---|---|---|---|---|---|
| Без правил, 1 | 46 | 4 | нет | 62 с | $0,26 |
| Без правил, 2 | 49 | 4 | нет | 59 с | $0,23 |
| С правилами, 1 | 21 | 2 | да, 4 из 4 прошли | 35 + 24 с | $0,13 + $0,26 |
| С правилами, 2 | 21 | 2 | да, 4 из 4 прошли | 36 + 24 с | $0,13 + $0,26 |
Кода с правилами вышло вдвое меньше. Claude не стал делать второй промокод, нормализацию регистра и красивое сообщение об ошибке в CLI. В итоговом отчёте он прямо написал, что сообщение «не делал, так как об этом не договаривались». Ровно об этом второй принцип.
Время до результата почти одинаковое, около минуты. Зато стоимость с правилами выше: $0,39 против $0,23–0,26. Второй ход заново отправляет модели всю историю сессии, и за него платишь отдельно. Цены здесь из поля total_cost_usd, которое Claude Code считает по тарифам API. На подписке это доля лимита, а не реальные деньги.
Тесты без правил, кстати, рабочие. Я запустил их сам после прогона, и все шесть прошли. Разница в том, что агент без правил отдал код непроверенным, а с правилами сначала прогнал тесты и только потом отчитался.
Где мой вывод перестаёт работать, скажу сразу. Это одна задача, четыре прогона и одна модель. На большом проекте, другой модели или чётко поставленной задаче разница может быть меньше. Звёзды на GitHub тоже не замер качества. Но направление совпало с тем, что обещает README: вопросы до кода, короткий дифф, проверка перед отчётом.
Как поставить Karpathy skills в Claude Code и Cursor
Есть три способа, и они работают по-разному. В тесте я подключал правила файлом CLAUDE.md, а плагин устроен иначе.
Плагин Claude Code. Автор рекомендует его как основной путь. Внутри Claude Code выполни две команды:
/plugin marketplace add multica-ai/andrej-karpathy-skills
/plugin install andrej-karpathy-skills@karpathy-skills
README до сих пор показывает старый адрес forrestchang/andrej-karpathy-skills, он тоже сработает через перенаправление. Подробнее о маркетплейсах и командах /plugin я писал в гайде по плагинам Claude Code.
Плагин ставит не CLAUDE.md, а скилл karpathy-guidelines. Это видно в выводе claude plugin details.

По документации Claude Code скилл подгружается, когда ты вызываешь его сам или когда Claude решает, что он подходит к задаче. Значит, плагин дешевле по контексту, но правила срабатывают не на каждом запросе. Если хочешь поведение как в моём тесте, бери CLAUDE.md.
CLAUDE.md в проект. Для нового проекта:
curl -o CLAUDE.md https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md
Для проекта, где CLAUDE.md уже есть, допиши правила в конец:
echo "" >> CLAUDE.md
curl https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
Так правила попадают в контекст в начале каждой сессии. Документация Anthropic советует держать CLAUDE.md короче 200 строк, иначе модель хуже его соблюдает. Правила Карпатого занимают 65 строк, так что запас остаётся. Как CLAUDE.md уживается с rules и автопамятью, разобрано в статье про память Claude Code.
Правило для Cursor. С апреля в репозитории лежит .cursor/rules/karpathy-guidelines.mdc с флагом alwaysApply: true. Скопируй его в .cursor/rules/ своего проекта, и Cursor будет применять правила в каждом запросе. Как пишет автор в CURSOR.md, Cursor по умолчанию не читает ни CLAUDE.md, ни плагин Claude Code.
Когда правила мешают
Автор сам пишет в README, что правила ставят осторожность выше скорости. Мой прогон это подтвердил: круг с вопросами сделал задачу дороже в полтора раза. На неоднозначной задаче это окупается, на понятной нет. Вот где я бы правила выключал или смягчал.
Мелкие правки. Опечатка, переименование, очевидный однострочник. Агент с правилами всё равно может спросить, что ты имел в виду. Файл разрешает решать по ситуации, но модель не всегда этим пользуется.
Автономные прогоны. В claude -p, cron-задачах и ночных прогонах некому ответить на вопросы. Агент с правилами остановится на первом же сомнении и ничего не сделает: в моём тесте оба прогона с правилами закончились вопросами без единой правки. Для таких запусков пиши задачу сразу с критериями успеха, как требует четвёртый принцип, или ставь /goal.
Конфликт с твоими правилами. Если в твоём CLAUDE.md написано «не задавай вопросов, делай», а у Карпатого «спроси, если не уверен», модель получит два противоположных указания. Дописать файл в конец мало: прочитай оба и убери противоречие.
Правило не гарантия. Документация Anthropic прямо называет CLAUDE.md контекстом, а не принудительной настройкой. Если действие нужно запретить жёстко, например правку определённой папки, это работа для хука.

Что попробовать на своём проекте сегодня
Возьми одну задачу из своего бэклога, которую ты бы обычно написал агенту одной фразой. Перепиши её как цель с проверкой: «напиши тест, который воспроизводит баг в расчёте скидки, и добейся, чтобы он прошёл, остальные тесты не ломай». Затем положи CLAUDE.md Карпатого в корень проекта командой curl из раздела выше и отдай задачу Claude Code. Дифф и число вопросов до первой правки покажут, нужен ли тебе этот файл.
Больше разборов плагинов, скиллов и настроек в разделе о Claude Code.
Читайте также
- CLAUDE.md: как писать инструкции для Claude Code: что класть в файл проекта, чтобы правила Карпатого легли поверх него
- Память Claude Code: auto memory, rules и CLAUDE.md: где ещё хранить инструкции и как они загружаются
- UI UX Pro Max: AI-навык для дизайна в Claude Code и Cursor: другой популярный скилл, который тоже ставится в Claude Code и Cursor
- 10 воркфлоу Claude Code на каждый день: на каких задачах проверять правила в своей работе