Все про CLAUDE.md

Начало

Подмешивается в каждый ваш промпт в Claude Code, чтобы предоставить "память" о вашем проекте. Это не конфигурация и не жёсткая политика: Claude может проигнорировать любое правило записанное в этот текстовый файл. Особенно этим славились устаревшие модели типа Opus 4 \ Sonnet 4 они рандомно игнорили почти все, что вы в эти файлы записывали (т.е. это ну как повезет).

Есть три уровня организации:
• уровень всех проектов в домашней директории ~/
• уровень проекта — в корне проекта
• уровень подпапки проекта

Файлы эти стакаются, т.е. размещая новый CLAUDE.md в подкаталоге, КК будет читать этот файл при работе именно с этим каталогом (что экономит токены). Но если вы делаете в файле ссылку на другой CLAUDE.md через @/путь/к/файлу то файл будет загружен сразу и полностью и никакой экономии контекста не будет.

Обычно создается командой /init которая начнет файл строкой

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

(которую можно было бы и удалить)

Дальше создается одинаковый скелет разделов. Практически везде повторяется структура: Что это → Команды → Архитектура. Иногда добавляется «Конфигурация/Окружение» и «Тесты».

Если Claude Code уже совершал какие-то ошибки, он будет их записывать в CLAUDE.md. Философия «объясняй неочевидное». Почти в каждом файле есть явная фраза вроде «неочевидно из кода одного файла» и запреты-инструкции для будущего Claude: «не сливай два шага обратно», «не консолидируй», «не ужесточай парсинг» CLAUDE.md пишется как защиту от регрессий, а не как README.

Некоторые CLAUDE.md могут быть короткие на 30 строк, некоторым на 730 строк уже нужна оптимизация. Сам Антропик рекомендует держать файл не длиннее 200 строк. Но из практики - чем он короче и компактнее, тем лучше.

В некоторые файлы СС тупо пишет changelog 0.3.0 → 0.4.3 (~350 строк) и прочий мусор — потому что, старым версиям Opus 4 им вообще все равно, что и куда писать (код или текст).

Каждый раз, когда я начинаю читать CLAUDE.md у меня течет кровь из глаз.

Хороший CLAUDE.md содержит только то, что Claude должен знать почти в каждой задаче.

Claude Code по-прежнему нативно читает CLAUDE.md, а не AGENTS.md.

Для совместимости с Codex и другими агентами:

ln -s AGENTS.md CLAUDE.md

Официальный плагин:

/plugin install claude-md-management@claude-plugins-official

он создаст слэш команду:

/claude-md-management:revise-claude-md - эта команда обогощает файл знаниями из текущей сессии
 /claude-md-improver - эта команда сканирует и исправляет все CLAUDE.md которые найдет

При запуске второй команды, будет показан "отчет качества" и дан выбор:
• Да, все правки
• Да, но без изменения дерева каталогов
• Нет, только показать отчёт

- Коммитов за всю историю — ровно 1, так что это 💩 особо не сделает ваш файл короче и нужно что-то помощнее:

claude plugin marketplace add getsentry/skills
claude plugin install sentry-skills@sentry-skills

И он установит столько всякого говнища (+100 доп. скиллов, устанете чистить)

Запускайте /agents-md - туда уже было хотя бы 2 коммита.

Он ужмет ваш C.md до <100 строк (чтобы явно с запасом можно было добавлять туда больше всякого говнища).

Ну и затем сразу:

claude plugin uninstall sentry-skills@sentry-skills

Чтобы даже не разбираться, что за +100 скиллов он там ставит.

https://code.claude.com/docs/en/memory - офф. документация.