Коротко
Что внутри CLAUDE.md «от Карпаты»?
Файл лежит в открытом репозитории andrej-karpathy-skills на GitHub. На 31 октября 2026 года у репозитория 227 268 звёзд. Внутри четыре раздела, каждый - заголовок, короткий девиз и список правил:
| Раздел | О чём | Пример правила из файла |
|---|---|---|
| Think Before Coding | не угадывать молча | назови допущения; если неясно - остановись и спроси |
| Simplicity First | минимум кода под задачу | никаких функций сверх запроса и «гибкости», о которой не просили |
| Surgical Changes | точечные правки | не «улучшай» соседний код; убирай только то, что осиротело от твоих правок |
| Goal-Driven Execution | цель, которую можно проверить | «почини баг» превращается в «напиши тест, который его ловит, и добейся, чтобы он прошёл» |
В шапке файла есть важная оговорка: правила смещают агента к осторожности в ущерб скорости, и для простых задач автор советует действовать по ситуации. Там же сказано, что файл надо объединять с правилами своего проекта.
Подробнее о том, что писать в CLAUDE.md своего проекта, - в статье что писать в CLAUDE.md. Здесь вопрос другой: что делать с чужим готовым файлом.
Кто написал файл и при чём тут Карпаты?
История в репозитории короткая. Пост Карпаты вышел 26 января 2026 года. Файл CLAUDE.md добавлен одним коммитом в ночь на 27 января по UTC, автор коммита - Jiayuan Zhang, в описании плагина указан ник forrestchang. С тех пор файл не менялся. Сам README называется «Karpathy-Inspired Claude Code Guidelines» и ссылается на пост Карпаты в X, из которого взяты три претензии к моделям: делают неверные допущения и не проверяют их, переусложняют код, меняют то, чего не просили.
Позже репозиторий переехал в организацию multica-ai, старый адрес перенаправляет на новый. В пересказах файл часто называют «CLAUDE.md Карпаты», и это неточно. Правильно - файл по мотивам его наблюдений.
Почему это важно на практике. Имя автора добавляет файлу веса, но правило работает или не работает независимо от того, кто его сформулировал. Проверять его приходится так же, как любое своё.
Прогон: две задачи с файлом и без него
Прогон сделан 31 октября 2026 года в Claude Code версии 2.1.186, неинтерактивным запуском claude -p. Каждая попытка шла в своей чистой папке с исходным файлом задачи, а результат сравнивался по списку изменений в файлах и по итоговому ответу агента.
Две задачи, обе маленькие и на Python:
- Точечная правка. Файл с ошибкой в расчёте скидки, рядом «грязный, но рабочий» код: неиспользуемые импорты, функция в другом стиле, закомментированный старый вариант. Запрос: «В prices.py скидка считается неправильно, почини.» Проверка правила 3: тронет ли агент соседний код.
- Задача с пробелом. Скрипт печатает отчёт по продажам. Запрос: «Добавь экспорт отчёта.» Формат нарочно не указан. Проверка правил 1 и 2: скажет ли агент, какой формат выбрал, и не добавит ли лишнего.
Каждая задача - с файлом и без, по два повтора, в двух сериях. Первая - в моём окружении, где агент читает мой личный CLAUDE.md. Вторая - в чистом, без личного файла, как у человека, который только поставил Claude Code.
| Что смотрели | Без файла | С файлом |
|---|---|---|
| Точечная правка: тронут соседний код | 0 из 4 | 0 из 4 |
| Задача с пробелом: назвал формат в итоговом ответе | 4 из 4 | 4 из 4 |
| Задача с пробелом: объяснил, почему выбрал этот формат | 0 из 4 | 3 из 4 |
| Задача с пробелом: предложил другой формат | 0 из 4 | 4 из 4 |
| Задача с пробелом: добавил второй формат | 1 из 4 | 0 из 4 |
| Задача с пробелом: добавил разбор аргументов командной строки | 2 из 4 | 2 из 4 |
| Задал вопрос до начала работы | 0 из 4 | 0 из 4 |
Что это значит на практике. На простой правке современная модель и без файла работала точечно: все восемь прогонов исправили одну строку и не тронули остальное. Видимая разница - в задаче с пробелом. Формат CSV выбрали все восемь прогонов и все назвали его в ответе. Разница в том, что агент делал с этим выбором. С файлом он чаще объяснял его и оставлял развилку, например: «Выбрал CSV, потому что это табличные данные по продажам», а дальше предлагал Excel или JSON, если нужно. Без файла CSV подавался как данность, и другой формат не предлагался ни разу. С лишним сложнее: второй формат без запроса добавил один прогон без файла, а разбор аргументов командной строки, о котором тоже никто не просил, появился в двух прогонах с файлом и в двух без него. Здесь файл разницы не дал.
Две маленькие задачи, по два повтора, одна модель и запуск без живого диалога. В пересказах файла ходят цифры о падении ошибок в разы, но методику по ним не проверить. Твой результат зависит от твоих задач, поэтому прогони одну свою задачу так же: с файлом и без.
Чего в этом файле нет
В основной статье про CLAUDE.md рабочий файл собирается из семи блоков: проект, стек и команды, структура, правила работы, красные линии, навигация, выученные ошибки. Файл по мотивам Карпаты закрывает один из семи - правила работы, и то только про код. Агент с ним станет аккуратнее, но не узнает, каким менеджером пакетов ставить зависимости, какую папку не трогать и что нельзя выкладывать без команды.
По сути CLAUDE.md - это контекст-инжиниринг в самой дешёвой форме: агент получает знание о проекте до того, как возьмётся за задачу. Чужой файл такого знания дать не может, он писался без твоего проекта.
Вторая вещь, которой нет, - твои ошибки. Самые полезные строки в своём файле появляются после конкретных промахов агента в твоём проекте. Чужой файл собран из чужих промахов, общих для всех.
Как сверить чужой файл со своим?
Сверка с моими файлами правил, личным и рабочей папки, дала вот что:
| Правило файла | Что уже записано у меня |
|---|---|
| Возражай, если есть вариант проще | в личном файле: «Оспаривай мои решения. Если идея слабая или есть вариант лучше - говори прямо» |
| Минимум кода, ничего сверх запроса | в личном файле: «Если для задачи проще обойтись без фреймворка - предложи минимальный вариант» |
| Убирай за собой только своё | в правилах рабочей папки: удалять одноразовый код в том же коммите, где он отработал |
| Цель, которую можно проверить | в правилах рабочей папки: после фичи цикл самопроверки, перед публикацией полная сборка |
| Назови допущения вслух | такого правила не было |
Три из четырёх принципов у меня частично покрыты своими правилами, хотя и не теми словами: проверка у меня идёт после работы, а файл просит задать критерий до неё. Не хватало ровно той строки, которая и дала разницу в прогоне: проговаривать допущения. Её и стоит брать.
Целиком дописывать файл в конец своего, как предлагает README, я бы не стал. Мой личный CLAUDE.md - 153 строки, плюс 65 строк чужого файла дают 218. Документация Claude Code советует держать каждый CLAUDE.md до 200 строк: длинный файл съедает контекст и хуже соблюдается.
Прочитай чужой файл целиком
65 строк читаются за пять минут. Отметь правила, которые понимаешь и с которыми согласен.Сверь со своим
По каждому правилу: уже есть, нужно, не нужно. Повторы своими словами не дублируй.Перенеси строку, а не раздел
Одно правило - одна строка в блоке правил работы. Своими словами и на языке твоего файла.Проверь в новой сессии
Дай агенту задачу с намеренным пробелом и посмотри, объяснит ли он свой выбор и предложит ли другой вариант. Не сделал - правило сформулировано слабо.
Если агент вообще редко переспрашивает, есть приём сильнее одной строки в файле: попросить его задать вопросы до начала работы. Он разобран в статье пусть агент задаёт вопросы тебе.
Свои правила работы агента у меня собраны не из вирусных файлов, а из промахов в проектах. Так же их собирают на обучении работе с ИИ-агентами: рядом с папкой о твоём деле лежат правила, по которым ты агентом управляешь, и каждое появляется после конкретной задачи.
Плагин или файл: в чём разница при установке
Первый способ - скопировать CLAUDE.md в проект или дописать в конец своего. Тогда правила в контексте всегда, в любой задаче. Второй, рекомендованный в README, - поставить плагин из репозитория. Внутри него скилл с тем же текстом и описанием «используй, когда пишешь, проверяешь или переделываешь код». Агент подтянет его, когда решит, что задача про код.
Для правил поведения, которые должны работать всегда, надёжнее строка в своём файле. Чем скилл отличается от других способов дать агенту знание, разобрано в статье скилл и MCP-сервер. Проверка чужого скилла перед установкой - отдельная тема, в этой статье её не разбираю.
Частые вопросы
Частые вопросы
Главный вывод
Если коротко, суть такая. Файл по мотивам Карпаты описывает четыре привычки аккуратного разработчика, и большинство из них у внимательного пользователя уже записаны своими словами. На маленьких задачах модель и без него правит точечно. Заметная прибавка в прогоне одна: агент чаще объясняет, почему выбрал именно так, и предлагает другой вариант. От лишних функций в моих задачах файл не уберёг.
Поэтому вместо своего файла его ставить не надо, а целиком поверх своего - тоже. Возьми строку, которой у тебя нет, и проверь её так же, как проверял бы своё правило.
А у тебя в CLAUDE.md уже есть правило, которое заставляет агента объяснять свой выбор, или он пока просто сообщает, что сделал?
