CLAUDE.md Карпати вышел на первое место в GitHub с 82 000 звёзд. Большинство разработчиков до сих пор его не читали

Источник: X / Dep.

Файл под названием CLAUDE.md вышел на первое место в GitHub Trending

82 000 звёзд. 7 800 форков.

Всё началось с Андрея Карпати. Бывший директор по AI в Tesla. Один из основателей OpenAI. Он выделил 4 поведения, из-за которых Claude Code ошибается, и записал их в один файл.

Один разработчик взял эти 4 правила, расширил их и опубликовал файл. Он завирусился.

Причина: точность кодинга выросла с 65% до 94%.

Большинство разработчиков, которые ежедневно используют Claude Code, до сих пор это не настроили. Они начинают с нуля в каждой сессии. Заново объясняют один и тот же контекст. Чистят нежелательные изменения области задачи. Откатывают рефакторинги, о которых никто не просил.

Вот полный файл.

Настройка, которую большинство разработчиков пропустили

Каждый раз, когда вы открываете Claude Code, он стартует с пустого места.

Он не знает ваш стек. Ваши стандарты. Контекст проекта. Что вы уже пробовали. От чего вы явно отказались три сессии назад.

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

CLAUDE.md — это обычный текстовый файл, который вы кладёте в корень проекта. Claude Code автоматически читает его в начале каждой сессии.

Одна настройка. Ноль повторных объяснений. Три категории дорогих ошибок исправлены.

1 / 3 | DEFAULTS: $375 в неделю, которые вы тратите на повторение самого себя

Средний разработчик тратит 30 минут в день на повторное объяснение контекста Claude.

Стек. Стандарты кодинга. Бэкграунд проекта. Что уже пробовали. Ничего из этого не сохраняется между сессиями, если вы один раз не запишете это и не дадите Claude читать каждый раз.

30 минут в день при ставке разработчика $150/час: $375 в неделю. На одного разработчика.

Для команды из 5 человек: $1 875 в неделю исчезают.

Эти 7 правил идут в начало вашего файла CLAUDE.md.

• → Убейте филлер:
• → Подбирайте длину под задачу:
• → Показывайте варианты перед действием:
• → Признавайте неопределённость до того, как она станет стоить мне денег:
• → Кто я и что я знаю:
• → Текущий контекст проекта:
• → Зафиксируйте голос:

Время, потраченное на повторное объяснение контекста в день: 30 минут.
При ставке разработчика $150/час: $75 в день.
В неделю: $375 в неделю на разработчика.
Команда из 5 человек: $1 875 в неделю.
Настройка CLAUDE.md для этого раздела: всего 45 минут.

Ошибка, которой нужно избежать: не пишите CLAUDE.md с нуля. Сначала используйте этот промпт, затем отредактируйте результат.

2 / 3 | BEHAVIOR: изменения по $150/час, которые вы не разрешали

Вы просите Claude исправить одну функцию.

Он рефакторит три файла, переименовывает переменные, реорганизует импорты и переписывает комментарии, над которыми вы работали.

И всё это без спроса.

1 час на ревью и откат нежелательных изменений: $150. Три раза в неделю: $450 в неделю. На одного разработчика.

Для команды из 5 человек: $2 250 в неделю на уборку изменений, которые никто не разрешал.

Эти 7 правил идут в раздел behavior вашего CLAUDE.md.

• → Оставайтесь в рамках задачи:
• → Спрашивайте перед большими изменениями:
• → Подтверждайте перед любым destructive-действием:
• → Жёсткие стопы для production:
• → Всегда показывайте, что изменилось:
• → Никогда не действуйте без явного подтверждения:
• → Думайте перед тем, как писать код:

1 час в неделю на откат нежелательных изменений области задачи: $150 в неделю.
30 минут в неделю на ручные diff-проверки после каждой задачи: $75 в неделю.
Итого поведенческие потери на разработчика: $225 в неделю.
Команда из 5 человек: $1 125 в неделю.
Настройка behavior-раздела CLAUDE.md: 30 минут.

3 / 3 | MEMORY + STACK: настройка, которая делает Claude Code действительно надёжным

Claude забывает всё между сессиями.

Каждое принятое решение. Каждый подход, который не сработал. Причину, по которой вы выбрали Prisma вместо Drizzle шесть месяцев назад. Ограничение, которое существует из-за конкретного требования клиента.

Он забывает. Затем предлагает ровно то, что вы уже исключили.

Этот раздел даёт Claude самое близкое к настоящей памяти, что сейчас существует. И фиксирует ваш tech stack, чтобы он перестал предлагать инструменты, которые ломают существующую архитектуру.

• → MEMORY.md decision log:
• → Session end summary:
• → ERRORS.md failure log:
• → Permanent facts list:
• → Зафиксируйте tech stack:
• → Extended Thinking для сложных решений:
• → 4 правила, которые завирусились:

Карпати выделил 4 поведения, из-за которых Claude Code ошибается. Один разработчик свёл их в эти 4 строки. Точность кодинга выросла с 65% до 94%.

2 часа в неделю на восстановление после забытых решений и неверных предложений: $300 в неделю на разработчика.
Неверные рекомендации по стеку и несовместимые инструменты: $75 в неделю.
Итого потери, связанные с памятью, на разработчика: $375 в неделю.
Команда из 5 человек: $1 875 в неделю.
Настройка MEMORY.md + ERRORS.md + stack: 20 минут.

Вывод

Вот вся математика.

$375 в неделю — повторное объяснение контекста в каждой сессии.
$225 в неделю — откат несанкционированных изменений.
$375 в неделю — восстановление после забытых решений.
Итого потери на разработчика: $975 в неделю.

Команда из 5 разработчиков: $4 875 в неделю.
В год: $253 500.

Настройка CLAUDE.md: всего 2 часа.
Только 4 правила Карпати: точность кодинга с 65% до 94%.

Один обычный текстовый файл. 21 правило. Два часа работы.

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

Те, кто этого не сделал, тратят $975 в неделю на повторение самих себя.

P.S. Начните с 4 правил Карпати. Только с этих четырёх. Вставьте их в новый файл CLAUDE.md в корне проекта прямо сейчас. Это занимает 2 минуты. Добавляйте остальное по одному блоку в неделю, когда замечаете, чего не хватает.

Сохраните это, пока не потерялось. Если было полезно — поделитесь с одним человеком, которому это нужно.