Один CLAUDE.md, который чинит поведение Клода
Один файл на GitHub меняет поведение Claude сильнее, чем десяток твоих уточнений в чате. Называется CLAUDE.md. Ты кидаешь его в проект, и Claude перестаёт делать четыре вещи, которые бесят: переусложнять простые задачи, пропускать твои инструкции, отдавать работу как готовую когда она не доделана, и выдумывать функции и методы, которых не существует. Файл собрал Andrej Karpathy на основе типичных ошибок нейросетей в коде. У репозитория 194 тысячи звёзд, это один из самых популярных наборов правил в мире. Ниже прямая ссылка, что именно внутри, и полная установка по шагам за пять минут.
Что это за файл и откуда он
CLAUDE.md, это обычный текстовый файл с правилами поведения, которые Claude Code читает автоматически при старте и держит в голове всю сессию. Ты не повторяешь одно и то же в каждом чате, правила уже зашиты.
Дальше без пересказа воды: разберём четыре правила из файла и то, какую твою боль каждое закрывает.
Как файл лечит четыре проблемы
В файле ровно четыре блока правил. Каждый бьёт по одной из твоих болей. Это реальное содержание файла, не мой пересказ по мотивам.
1. Думай до кода (лечит выдуманные API)
Правило: не предполагай, не прячь сомнения, называй развилки. Если что-то неясно, остановись и спроси. Если возможны несколько трактовок, покажи их, а не выбирай молча. Именно неозвученное предположение и рождает несуществующий метод: Claude додумал, что функция есть, и вызвал её. Правило заставляет сначала свериться, а не выдумывать.
2. Сначала простота (лечит переусложнение)
Правило: минимум кода, который решает задачу, ничего лишнего. Никаких абстракций под разовый код, никакой заготовленной гибкости, которую ты не просил, никакой обработки невозможных случаев. Дословно из файла: если написал 200 строк, а можно 50, перепиши. И контрольный вопрос: сказал бы сеньор, что это переусложнено? Если да, упрощай.
3. Точечные правки (лечит самодеятельность)
Правило: трогай только то, что нужно, убирай только свой мусор. Не улучшай соседний код и форматирование, не рефактори то, что не сломано, держи стиль проекта. Каждая изменённая строка обязана вести прямо к твоей задаче. Claude перестаёт переписывать половину файла, когда ты просил починить одну строку, и перестаёт игнорировать твои рамки.
4. Работа под цель (лечит фальшивое готово)
Правило: сначала критерий успеха, потом цикл до его проверки. Задача переводится в проверяемую цель: не «добавь валидацию», а «напиши тесты на плохой ввод и сделай, чтобы они прошли». Claude крутит работу, пока цель реально не выполнена, а не пишет «готово» на середине. Это и закрывает боль недоделанной работы, выданной за законченную.
Вариант А. Поставить на один проект
Так правила действуют только внутри этого проекта. Удобно, когда у разных проектов свои требования. Файл кладётся в корневую папку проекта.
- Открой репозиторий по ссылке и скачай файл CLAUDE.md. Быстрый способ без захода на сайт, команда ниже: она скачивает свежий файл прямо в текущую папку проекта.
- Положи CLAUDE.md в корень проекта, туда же, где лежит твой код (рядом с package.json или .git, если они есть).
- Запусти в этой папке команду claude. При старте Claude Code сам подхватит CLAUDE.md из корня, ничего включать не надо.
- При желании открой файл в любом редакторе и допиши свои правила проекта внизу. Файл для того и создан, чтобы его дополнять.
Вариант Б. Поставить глобально для всех проектов
Так правила действуют сразу во всех твоих проектах, отдельно копировать в каждый не нужно. Файл кладётся в домашнюю папку Claude по адресу ~/.claude/CLAUDE.md .
- Выполни команду ниже одной строкой. Она создаёт папку ~/.claude, если её ещё нет, и скачивает туда файл под именем CLAUDE.md.
- Всё. Теперь эти правила Claude читает в любом проекте на этой машине или сервере.
- Если в конкретном проекте нужны ещё и свои правила, положи туда локальный CLAUDE.md по варианту А. Claude объединит глобальный и проектный файлы, проектный уточняет глобальный.
Проверь, что файл подхватился
Занимает десять секунд. Нужно убедиться, что Claude реально прочитал правила, а не проигнорировал файл.
- Запусти claude в папке проекта и первым сообщением задай вопрос из блока ниже.
- Если Claude в ответ перечислит четыре принципа (думай до кода, простота, точечные правки, работа под цель), файл подхвачен и работает.
- Если Claude отвечает, что никаких особых правил не видит, проверь имя и место файла: для проекта это CLAUDE.md строго в корне, для глобали это ~/.claude/CLAUDE.md . Имя пишется заглавными, регистр важен.
Честно о том, чего ждать
Чтобы не было завышенных ожиданий.
Я собрал систему, по которой обычный человек запускает блог с нуля и набирает аудиторию без съёмок, монтажа и команды. Внутри разбор, с которого стартовал сам.
Открыть разбор: с чего начать→