Claude CodeОбзор

Karpathy skills для Claude Code: 4 правила против мусора

CLAUDE.md с четырьмя правилами Карпатого собрал 230 тысяч звёзд. Разбираю файл, способы установки и прогон Claude Code на одной задаче с правилами и без.

Karpathy skills для Claude Code: 4 правила против мусора

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 строк правил.

Файл CLAUDE.md в репозитории andrej-karpathy-skills на GitHub: заголовок, строка Tradeoff и первый принцип Think Before Coding
Весь файл занимает 65 строк и 2,3 КБ, первой строкой автор предупреждает, что правила ставят осторожность выше скорости. Скриншот: GitHub / matveev.tech

Пройдусь по разделам и переведу каждый на язык поведения агента.

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 строки. В нём каждое правило показано парой: что обычно делает модель и как правильно.

Файл EXAMPLES.md на GitHub: пример Hidden Assumptions с запросом «Add a feature to export user data» и кодом функции export_users
На запрос «добавь экспорт данных» модель сама решает, какие поля и в каком формате выгружать. Скриншот: GitHub / matveev.tech

Если свой CLAUDE.md ты ещё не писал, начни с гайда по инструкциям для Claude Code: правила Карпатого ложатся поверх проектных и их не заменяют.

Откуда у репозитория 230 тысяч звёзд

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

График звёзд репозитория multica-ai/andrej-karpathy-skills с января по ноябрь 2026: почти ровная линия до апреля, резкий рост до 170 тысяч к июню и плавный подъём до 230 тысяч
До апреля у репозитория было меньше 10 тысяч звёзд, основной рост пришёлся на апрель и май. Скриншот: star-history.com / matveev.tech

Цифру стоит читать аккуратно. Звёзды копились, пока сам файл стоял на месте. Текст правил последний раз меняли 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 придумал коды SALE10 и SALE20, решил считать скидку от суммы до НДС и написал четыре теста. Тесты он не запустил: в одном прогоне сам написал, что «код не проверен», в другом проверил только CLI вручную. Вопросы о том, какие коды нужны и до или после НДС считать скидку, пришли в конце, когда код уже был готов.

С правилами ответ начинается со слов «Прежде чем писать код, нужно решить несколько вопросов». Дальше идут пять пунктов, и к каждому Claude предлагает вариант по умолчанию. Например, по НДС: «(100 − 10) × 1,2 = 108». Ответить на такое можно одним словом. Я ответил «да» в той же сессии, и Claude сделал ровно предложенное, а потом прогнал тесты.

Одна деталь меня удивила. Чужой код без правил тоже никто не тронул. Во всех четырёх прогонах loadItems, old_total_v1 и лишний импорт остались на месте. Болячку из апрельской статьи про рефакторинг соседнего модуля «заодно» Opus 5.5 в этой задаче не показал. Третий принцип у современной модели, похоже, уже работает и без подсказки.

Superpowers: плагин для Claude Code с TDD и планом
Тот же подход «сначала вопросы, потом код», но в 15 навыках: мой прогон одной задачи с плагином и без.

Сколько кода и денег стоят правила

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

Вывод git diff --numstat по четырём прогонам: без правил 46 и 49 добавленных строк в трёх файлах, с правилами по 21 строке
С правилами Claude добавил по 21 строке в обоих прогонах, без правил 46 и 49. Разница почти вся в тестах и обработке ошибок в CLI. Скриншот: терминал / matveev.tech
Прогон Добавлено строк Тестов добавлено Тесты запущены агентом Время Стоимость по оценке 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 plugin details для andrej-karpathy-skills: один скилл karpathy-guidelines, ни хуков, ни агентов, около 105 токенов в каждой сессии и около 850 при вызове
В каждой сессии плагин занимает около 105 токенов на описание скилла, полный текст правил стоит около 850 токенов и подгружается только при вызове. Скриншот: терминал / matveev.tech

По документации 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 Code Hooks: автоматизация рабочего процесса
Как жёстко запретить агенту действие или проверять каждую правку хуком, а не текстом в CLAUDE.md.

Что попробовать на своём проекте сегодня

Возьми одну задачу из своего бэклога, которую ты бы обычно написал агенту одной фразой. Перепиши её как цель с проверкой: «напиши тест, который воспроизводит баг в расчёте скидки, и добейся, чтобы он прошёл, остальные тесты не ломай». Затем положи CLAUDE.md Карпатого в корень проекта командой curl из раздела выше и отдай задачу Claude Code. Дифф и число вопросов до первой правки покажут, нужен ли тебе этот файл.

Больше разборов плагинов, скиллов и настроек в разделе о Claude Code.

Читайте также

CTO говорит

Разбираю релизы моделей и инструментов: что вышло и стоит ли переходить.

Читать в Telegram

Ещё в разделе Claude Code

Весь раздел