Один файл, с которым Claude Code умнее: 4 принципа по заметкам Карпатого

Что это

andrej-karpathy-skills на GitHub - https://github.com/multica-ai/andrej-karpathy-skills

Это один файл CLAUDE.md с правилами поведения для Claude Code. Его собрали по заметкам Андрея Карпатого о том, где агенты для кода ошибаются чаще всего: додумывают за тебя и не проверяют, переусложняют код и правят то, что не до конца понимают. Оригинал заметок - Заметки Андрея Карпатого - https://x.com/karpathy/status/2015883857489522876 (пост от 26 января 2026 года). Об авторе заметок - Кто такой Андрей Карпатый - https://karpathy.ai/ (один из основателей OpenAI, потом директор по ИИ в Tesla).

В репозитории одни и те же правила лежат в трёх видах: файл CLAUDE.md, плагин для Claude Code со скиллом karpathy-guidelines и правило для Cursor. В README и в манифесте плагина указана лицензия MIT, всё бесплатно. Раньше репозиторий жил по адресу forrestchang/andrej-karpathy-skills - команды с этим адресом из README продолжают работать, GitHub сам перенаправляет на новый.

Что понадобится

• Claude Code - https://code.claude.com/docs/en/setup. Установка на macOS, Linux и WSL одной командой в терминале: curl -fsSL https://claude.ai/install.sh | bash, потом запусти claude и войди в аккаунт.
• Подходящий тариф. Claude Code работает на тарифах Pro, Max, Team, Enterprise или с аккаунтом Console, на бесплатном плане его нет. Pro стоит 20 долларов в месяц при помесячной оплате: https://claude.com/pricing
• Страна из списка Anthropic. Claude Code доступен только в поддерживаемых странах, список: https://www.anthropic.com/supported-countries - заранее проверь, что твой аккаунт и способ оплаты подходят.
• Git - нужен для установки плагина из репозитория.

Способ 1. Плагин для Claude Code - сразу для всех проектов

1. Открой Claude Code и выполни команду: /plugin marketplace add forrestchang/andrej-karpathy-skills
2. Затем поставь плагин: /plugin install andrej-karpathy-skills@karpathy-skills
3. Если в итоге установки написано «Run /reload-plugins to activate», Claude Code сам перезагрузит плагины. Если он предупредит, что следующее сообщение перечитает весь разговор, выполни /reload-plugins --force.
4. Проверка: набери / и найди скилл karpathy-guidelines. Скиллы плагина идут с его именем впереди, поэтому в списке он может выглядеть как andrej-karpathy-skills:karpathy-guidelines.

Скилл описан так: «Use when writing, reviewing, or refactoring code» - то есть Claude подключает его, когда пишет, проверяет или переделывает код. Чтобы включить правила явно, вызови скилл через / или начни запрос со слов «работай по karpathy-guidelines».

Если короткий адрес не сработал, дай полный адрес репозитория: /plugin marketplace add https://github.com/multica-ai/andrej-karpathy-skills.git

Способ 2. Файл CLAUDE.md - правила работают в каждой сессии

Claude Code читает файлы CLAUDE.md в начале каждого разговора, поэтому правила действуют всегда, а не только когда включился скилл. Официально про эти файлы: Файлы CLAUDE.md в Claude Code - https://code.claude.com/docs/en/memory

Новый проект без своего CLAUDE.md. В терминале, в папке проекта:

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

В проекте уже есть CLAUDE.md. Не затирай его, а допиши правила в конец двумя командами по очереди:

1. echo | tee -a CLAUDE.md
2. curl -s https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md | tee -a CLAUDE.md

Или попроси сам Claude Code: Скачай https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md и допиши его текст в конец CLAUDE.md этого проекта отдельным разделом. Ничего из того, что уже есть в файле, не удаляй и не меняй.

Сразу для всех проектов. Личные правила Claude Code лежат в файле ~/.claude/CLAUDE.md. Выполни по очереди:

1. mkdir -p ~/.claude
2. echo | tee -a ~/.claude/CLAUDE.md
3. curl -s https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md | tee -a ~/.claude/CLAUDE.md

Проверка. Открой новую сессию Claude Code, выполни /context и найди свой CLAUDE.md в списке Memory files.

Способ 3. Скилл из каталога skills.sh и правило для Cursor

• Каталог skills.sh - https://skills.sh/multica-ai/andrej-karpathy-skills. Там скилл karpathy-guidelines ставится одной командой, нужен Node.js: npx skills add multica-ai/andrej-karpathy-skills
• Cursor. Скопируй файл .cursor/rules/karpathy-guidelines.mdc из репозитория в папку .cursor/rules/ своего проекта (создай папки, если их нет). Проверить можно в Cursor: Settings, раздел Rules, там появится karpathy-guidelines.

4 принципа на русском целиком

Это перевод файла CLAUDE.md. Его можно вставить в свой CLAUDE.md вместо английского текста.

Правила поведения, чтобы агент реже ошибался в коде. Совмещай их с инструкциями своего проекта.

Компромисс: правила ставят осторожность выше скорости. На мелких задачах решай по ситуации.

1. Думай перед кодом

Не додумывай. Не скрывай, что запутался. Показывай компромиссы.

Перед тем как писать код:

• Явно называй свои допущения. Если не уверен - спроси.
• Если задачу можно понять по-разному - покажи варианты, а не выбирай молча.
• Если есть способ проще - скажи об этом. Возражай, когда это оправдано.
• Если что-то непонятно - остановись. Назови, что именно непонятно, и спроси.

2. Сначала простота

Минимум кода, который решает задачу. Ничего на всякий случай.

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

Спроси себя: «Сказал бы опытный инженер, что это переусложнено?» Если да - упрости.

3. Хирургические правки

Трогай только то, что нужно. Убирай только за собой.

Когда правишь существующий код:

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

Когда после твоих правок что-то осталось без дела:

• Удаляй импорты, переменные и функции, которые стали не нужны из-за ТВОИХ изменений.
• Не удаляй мёртвый код, который был до тебя, если об этом не просили.

Проверка: каждая изменённая строка должна напрямую следовать из запроса пользователя.

4. Работа от цели

Задай критерии успеха. Повторяй, пока не проверено.

Превращай задачи в проверяемые цели:

• «Добавь валидацию» → «Напиши тесты на неверный ввод, потом добейся, чтобы они проходили».
• «Почини баг» → «Напиши тест, который воспроизводит баг, потом добейся, чтобы он проходил».
• «Отрефактори модуль» → «Убедись, что тесты проходят и до, и после».

Для многошаговых задач коротко распиши план:

1. Шаг → проверка: чем проверяем.
2. Шаг → проверка: чем проверяем.
3. Шаг → проверка: чем проверяем.

Чёткие критерии успеха позволяют работать в цикле самостоятельно. Слабые критерии вроде «сделай, чтобы работало» требуют постоянных уточнений.

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

Разборы каждого принципа на примерах кода (как агент ошибается и как правильно) - Примеры к принципам - https://github.com/multica-ai/andrej-karpathy-skills/blob/main/EXAMPLES.md

Готовые промпты

Вставляй в Claude Code и заменяй слова в скобках на своё.

Старт задачи по принципам

Работай по karpathy-guidelines. Задача: (опиши задачу). Прежде чем писать код, перечисли свои допущения и вопросы ко мне, предложи самый простой вариант решения и план из шагов, где у каждого шага есть проверка. Код не пиши, пока я не отвечу на вопросы и не подтвержу план.

Баг через тест

Баг: (что происходит и как его повторить). Сначала напиши тест, который воспроизводит баг и падает. Потом почини минимальной правкой, не трогая соседний код, и прогони весь набор тестов. В конце покажи, какие строки изменились и зачем каждая.

Проверка изменений перед коммитом

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

Если агент уже наворотил лишнего

Оставь только те изменения, которые напрямую нужны для задачи: (опиши задачу). Соседний код, комментарии и форматирование верни как было. Потом напиши тест, который доказывает, что задача решена, прогони его и покажи результат.

Если что-то не работает

• Команда /plugin не распознаётся - проверь версию командой claude --version, обнови Claude Code (для нативной установки заново запусти команду установки из раздела «Что понадобится») и перезапусти терминал.
• Скилл плагина не появился - выполни /reload-plugins или перезапусти Claude Code.
• Правила из CLAUDE.md не подхватились - открой новую сессию и проверь через /context, что файл есть в Memory files.
• Агент всё равно пропускает шаги - назови правило прямо в запросе: «сначала перечисли допущения» или «напиши тест до правки».
• На мелочах правила тормозят - так задумано: они ставят осторожность выше скорости. Для опечаток и однострочных правок прямо скажи агенту, что план и вопросы не нужны.