Дмитрий Анашкин

CLAUDE.md по мотивам Карпаты: что внутри и стоит ли копировать себе

Опубликовано 8 нояб. 2026 г.Обновлено 15 нояб. 2026 г.10 мин чтенияСредний
Два листа с галочками, линейка и карандаш на папке
Плейбук
CLAUDE.md по мотивам Карпаты
Дмитрий Анашкин · 10 мин
Чему вы научитесь
  • Кто на самом деле написал файл и что в его четырёх разделах
  • Что изменилось в работе агента в прогоне двух задач с файлом и без
  • Как сверить чужой CLAUDE.md со своим и перенести только недостающие строки
Средний
1просмотров

Коротко

Что внутри 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:

  1. Точечная правка. Файл с ошибкой в расчёте скидки, рядом «грязный, но рабочий» код: неиспользуемые импорты, функция в другом стиле, закомментированный старый вариант. Запрос: «В prices.py скидка считается неправильно, почини.» Проверка правила 3: тронет ли агент соседний код.
  2. Задача с пробелом. Скрипт печатает отчёт по продажам. Запрос: «Добавь экспорт отчёта.» Формат нарочно не указан. Проверка правил 1 и 2: скажет ли агент, какой формат выбрал, и не добавит ли лишнего.

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

Что смотрелиБез файлаС файлом
Точечная правка: тронут соседний код0 из 40 из 4
Задача с пробелом: назвал формат в итоговом ответе4 из 44 из 4
Задача с пробелом: объяснил, почему выбрал этот формат0 из 43 из 4
Задача с пробелом: предложил другой формат0 из 44 из 4
Задача с пробелом: добавил второй формат1 из 40 из 4
Задача с пробелом: добавил разбор аргументов командной строки2 из 42 из 4
Задал вопрос до начала работы0 из 40 из 4

Что это значит на практике. На простой правке современная модель и без файла работала точечно: все восемь прогонов исправили одну строку и не тронули остальное. Видимая разница - в задаче с пробелом. Формат CSV выбрали все восемь прогонов и все назвали его в ответе. Разница в том, что агент делал с этим выбором. С файлом он чаще объяснял его и оставлял развилку, например: «Выбрал CSV, потому что это табличные данные по продажам», а дальше предлагал Excel или JSON, если нужно. Без файла CSV подавался как данность, и другой формат не предлагался ни разу. С лишним сложнее: второй формат без запроса добавил один прогон без файла, а разбор аргументов командной строки, о котором тоже никто не просил, появился в двух прогонах с файлом и в двух без него. Здесь файл разницы не дал.

Чего в этом файле нет

В основной статье про CLAUDE.md рабочий файл собирается из семи блоков: проект, стек и команды, структура, правила работы, красные линии, навигация, выученные ошибки. Файл по мотивам Карпаты закрывает один из семи - правила работы, и то только про код. Агент с ним станет аккуратнее, но не узнает, каким менеджером пакетов ставить зависимости, какую папку не трогать и что нельзя выкладывать без команды.

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

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

Как сверить чужой файл со своим?

Сверка с моими файлами правил, личным и рабочей папки, дала вот что:

Правило файлаЧто уже записано у меня
Возражай, если есть вариант прощев личном файле: «Оспаривай мои решения. Если идея слабая или есть вариант лучше - говори прямо»
Минимум кода, ничего сверх запросав личном файле: «Если для задачи проще обойтись без фреймворка - предложи минимальный вариант»
Убирай за собой только своёв правилах рабочей папки: удалять одноразовый код в том же коммите, где он отработал
Цель, которую можно проверитьв правилах рабочей папки: после фичи цикл самопроверки, перед публикацией полная сборка
Назови допущения вслухтакого правила не было

Три из четырёх принципов у меня частично покрыты своими правилами, хотя и не теми словами: проверка у меня идёт после работы, а файл просит задать критерий до неё. Не хватало ровно той строки, которая и дала разницу в прогоне: проговаривать допущения. Её и стоит брать.

Целиком дописывать файл в конец своего, как предлагает README, я бы не стал. Мой личный CLAUDE.md - 153 строки, плюс 65 строк чужого файла дают 218. Документация Claude Code советует держать каждый CLAUDE.md до 200 строк: длинный файл съедает контекст и хуже соблюдается.

  1. Прочитай чужой файл целиком

    65 строк читаются за пять минут. Отметь правила, которые понимаешь и с которыми согласен.
  2. Сверь со своим

    По каждому правилу: уже есть, нужно, не нужно. Повторы своими словами не дублируй.
  3. Перенеси строку, а не раздел

    Одно правило - одна строка в блоке правил работы. Своими словами и на языке твоего файла.
  4. Проверь в новой сессии

    Дай агенту задачу с намеренным пробелом и посмотри, объяснит ли он свой выбор и предложит ли другой вариант. Не сделал - правило сформулировано слабо.

Если агент вообще редко переспрашивает, есть приём сильнее одной строки в файле: попросить его задать вопросы до начала работы. Он разобран в статье пусть агент задаёт вопросы тебе.

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

Плагин или файл: в чём разница при установке

Первый способ - скопировать CLAUDE.md в проект или дописать в конец своего. Тогда правила в контексте всегда, в любой задаче. Второй, рекомендованный в README, - поставить плагин из репозитория. Внутри него скилл с тем же текстом и описанием «используй, когда пишешь, проверяешь или переделываешь код». Агент подтянет его, когда решит, что задача про код.

Для правил поведения, которые должны работать всегда, надёжнее строка в своём файле. Чем скилл отличается от других способов дать агенту знание, разобрано в статье скилл и MCP-сервер. Проверка чужого скилла перед установкой - отдельная тема, в этой статье её не разбираю.

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

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

Главный вывод

Если коротко, суть такая. Файл по мотивам Карпаты описывает четыре привычки аккуратного разработчика, и большинство из них у внимательного пользователя уже записаны своими словами. На маленьких задачах модель и без него правит точечно. Заметная прибавка в прогоне одна: агент чаще объясняет, почему выбрал именно так, и предлагает другой вариант. От лишних функций в моих задачах файл не уберёг.

Поэтому вместо своего файла его ставить не надо, а целиком поверх своего - тоже. Возьми строку, которой у тебя нет, и проверь её так же, как проверял бы своё правило.

А у тебя в CLAUDE.md уже есть правило, которое заставляет агента объяснять свой выбор, или он пока просто сообщает, что сделал?

Источники

Отправь другу или себе в избранное в Telegram, чтобы не потерять.

Поделиться в Telegram
Было полезно?
Автор
Дмитрий Анашкин
Практик-интегратор ИИ в бизнес

Основатель NeuroDA и SMAIPL. Корпоративные воркшопы по ИИ, внедрение AI в бизнес-процессы.

Похожие гайды

Альтернативы Claude Code в 2026: OpenCode, Qwen Code и GigaCode - в чём уступают и когда хватает

С 12 ноября 2026 года Anthropic отдельно прописал правило для компаний из неподдерживаемых регионов и их сотрудников. Сравниваю три альтернативы Claude Code: модель, куда уходят данные, лицензия, что проверить. Показываю, когда замены хватает и как проверить её за вечер на своей задаче.

12 мин

Мультиагентные системы: как несколько ИИ работают над одной задачей

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

12 мин

Замена ИИ-модели: как проверить её на своих задачах до перехода

Новая модель быстрее сортирует письма на демонстрации. В рабочей очереди она может направить обращение не в тот отдел. Показываю, как собрать набор проверок, зафиксировать условия перехода и посчитать стоимость подтверждённого маршрута.

9 мин

Мониторинг задач по расписанию: как поймать сбой, если скрипт молчит

Скрипт должен обновлять отчёт каждое утро. Сообщений об ошибке нет, а на диске вчерашняя версия. Показываю, как разобрать пропуск запуска или зависание и как настроить сигнал, который подтверждает результат работы.

8 мин

Связанные понятия