Один CLAUDE.md, который чинит поведение Клода

Один файл на GitHub меняет поведение Claude сильнее, чем десяток твоих уточнений в чате. Называется CLAUDE.md. Ты кидаешь его в проект, и Claude перестаёт делать четыре вещи, которые бесят: переусложнять простые задачи, пропускать твои инструкции, отдавать работу как готовую когда она не доделана, и выдумывать функции и методы, которых не существует. Файл собрал Andrej Karpathy на основе типичных ошибок нейросетей в коде. У репозитория 194 тысячи звёзд, это один из самых популярных наборов правил в мире. Ниже прямая ссылка, что именно внутри, и полная установка по шагам за пять минут.

5 минут, копируешь один файл в проект. Кода писать не нужно. Работает и для отдельного проекта, и глобально для всех.

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

Что это за файл и откуда он

CLAUDE.md, это обычный текстовый файл с правилами поведения, которые Claude Code читает автоматически при старте и держит в голове всю сессию. Ты не повторяешь одно и то же в каждом чате, правила уже зашиты.

Прямая ссылка на репозиторий: https://github.com/multica-ai/andrej-karpathy-skills . Внутри лежит сам CLAUDE.md, файл под Cursor, примеры и плагин. Основа собрана из наблюдений Andrej Karpathy: нейросети делают неверные предположения и бегут с ними дальше, не проверив, и склонны переусложнять код и придумывать несуществующие интерфейсы. Файл гасит ровно это.

Дальше без пересказа воды: разберём четыре правила из файла и то, какую твою боль каждое закрывает.

Как файл лечит четыре проблемы

В файле ровно четыре блока правил. Каждый бьёт по одной из твоих болей. Это реальное содержание файла, не мой пересказ по мотивам.

1. Думай до кода (лечит выдуманные API)

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

2. Сначала простота (лечит переусложнение)

Правило: минимум кода, который решает задачу, ничего лишнего. Никаких абстракций под разовый код, никакой заготовленной гибкости, которую ты не просил, никакой обработки невозможных случаев. Дословно из файла: если написал 200 строк, а можно 50, перепиши. И контрольный вопрос: сказал бы сеньор, что это переусложнено? Если да, упрощай.

3. Точечные правки (лечит самодеятельность)

Правило: трогай только то, что нужно, убирай только свой мусор. Не улучшай соседний код и форматирование, не рефактори то, что не сломано, держи стиль проекта. Каждая изменённая строка обязана вести прямо к твоей задаче. Claude перестаёт переписывать половину файла, когда ты просил починить одну строку, и перестаёт игнорировать твои рамки.

4. Работа под цель (лечит фальшивое готово)

Правило: сначала критерий успеха, потом цикл до его проверки. Задача переводится в проверяемую цель: не «добавь валидацию», а «напиши тесты на плохой ввод и сделай, чтобы они прошли». Claude крутит работу, пока цель реально не выполнена, а не пишет «готово» на середине. Это и закрывает боль недоделанной работы, выданной за законченную.

Вариант А. Поставить на один проект

Так правила действуют только внутри этого проекта. Удобно, когда у разных проектов свои требования. Файл кладётся в корневую папку проекта.

  1. Открой репозиторий по ссылке и скачай файл CLAUDE.md. Быстрый способ без захода на сайт, команда ниже: она скачивает свежий файл прямо в текущую папку проекта.
  2. Положи CLAUDE.md в корень проекта, туда же, где лежит твой код (рядом с package.json или .git, если они есть).
  3. Запусти в этой папке команду claude. При старте Claude Code сам подхватит CLAUDE.md из корня, ничего включать не надо.
  4. При желании открой файл в любом редакторе и допиши свои правила проекта внизу. Файл для того и создан, чтобы его дополнять.
Промпт
curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md -o CLAUDE.md
Команду запускай, находясь в папке своего проекта. Она просто кладёт файл рядом с кодом. Ничего не устанавливает и не ломает.

Вариант Б. Поставить глобально для всех проектов

Так правила действуют сразу во всех твоих проектах, отдельно копировать в каждый не нужно. Файл кладётся в домашнюю папку Claude по адресу ~/.claude/CLAUDE.md .

  1. Выполни команду ниже одной строкой. Она создаёт папку ~/.claude, если её ещё нет, и скачивает туда файл под именем CLAUDE.md.
  2. Всё. Теперь эти правила Claude читает в любом проекте на этой машине или сервере.
  3. Если в конкретном проекте нужны ещё и свои правила, положи туда локальный CLAUDE.md по варианту А. Claude объединит глобальный и проектный файлы, проектный уточняет глобальный.
Промпт
mkdir -p ~/.claude && curl -fsSL https://raw.githubusercontent.com/multica-ai/andrej-karpathy-skills/main/CLAUDE.md -o ~/.claude/CLAUDE.md
Тильда ~ это твоя домашняя папка, Claude ищет глобальные правила именно там. Команда безопасна: создаёт папку и кладёт один текстовый файл.

Проверь, что файл подхватился

Занимает десять секунд. Нужно убедиться, что Claude реально прочитал правила, а не проигнорировал файл.

  1. Запусти claude в папке проекта и первым сообщением задай вопрос из блока ниже.
  2. Если Claude в ответ перечислит четыре принципа (думай до кода, простота, точечные правки, работа под цель), файл подхвачен и работает.
  3. Если Claude отвечает, что никаких особых правил не видит, проверь имя и место файла: для проекта это CLAUDE.md строго в корне, для глобали это ~/.claude/CLAUDE.md . Имя пишется заглавными, регистр важен.
Промпт
Прочитай свой файл CLAUDE.md и кратко перечисли правила, которым ты сейчас следуешь.

Честно о том, чего ждать

Чтобы не было завышенных ожиданий.

Это набор правил-подсказок, а не гарантия. Он заметно снижает четыре типичные ошибки, но не отменяет проверку работы человеком. Сам автор честно пишет: правила смещают Claude в сторону аккуратности за счёт скорости, и для совсем простых задач стоит включать здравый смысл. Файл создан, чтобы его дополнять под себя: смело дописывай свои правила по стилю, стеку и процессу вниз файла, тогда он станет по-настоящему твоим.
Следующий шаг
Хочешь так же, но под свой блог и продукт?

Я собрал систему, по которой обычный человек запускает блог с нуля и набирает аудиторию без съёмок, монтажа и команды. Внутри разбор, с которого стартовал сам.

Открыть разбор: с чего начать