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

Здесь всё, чтобы поставить файл и работать по нему с первого запроса: что это за файл, что понадобится, три способа установки в 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.
- **Агент всё равно пропускает шаги** - назови правило прямо в запросе: «сначала перечисли допущения» или «напиши тест до правки».
- **На мелочах правила тормозят** - так задумано: они ставят осторожность выше скорости. Для опечаток и однострочных правок прямо скажи агенту, что план и вопросы не нужны.

---

Источник: https://localhost:3000/m/odin-fayl-s-kotorym-claude-code-umnee-4-principa-po-zametkam-karpatogo