CLAUDE.md: что это за файл и как его написать в 2026

CLAUDE.md это обычный текстовый файл в корне проекта, куда вы записываете правила и договорённости для Claude Code. Ассистент читает его в начале каждой сессии, поэтому вам не приходится по десятому разу объяснять, какой командой запускается проект и что в нём нельзя трогать. Ниже разберём, как этот файл устроен, где он должен лежать, что в него писать, как создать его командой /init и из-за чего он чаще всего перестаёт работать.

Почему ассистент забывает договорённости

У любой нейросети есть контекст: рабочая память одного диалога, куда помещается всё, что вы написали, все прочитанные файлы и вывод всех команд. Память эта не бесконечная и, что важнее, не переезжает в следующий разговор. По документации Anthropic, каждая сессия Claude Code начинается с чистого контекстного окна. Вчера вы полчаса объясняли, что тексты на сайте пишутся на «вы», а сегодня ассистент об этом не знает: не потому что не послушал, а потому что не помнит. Как устроено само окно и сколько в него влезает, мы разбирали в материале про контекстное окно и токены Claude.

Отсюда и файл памяти. Файл CLAUDE.md из корня проекта подгружается автоматически до вашего первого сообщения, в каждой сессии, а файлы во вложенных папках подключаются, когда ассистент берётся за код из этих папок. Это не настройка программы и не жёсткий запрет, а текст, который ассистент читает и старается соблюдать.

Где лежит файл и какие бывают уровни

Файлов памяти может быть несколько, у каждого своя зона ответственности:

• Проектный: ./CLAUDE.md или ./.claude/CLAUDE.md в корне проекта. Правила, общие для всех, кто над проектом работает. Его кладут в репозиторий вместе с кодом.
• Личный: ~/.claude/CLAUDE.md в домашней папке. Ваши собственные привычки, действуют во всех проектах на этом компьютере.
• Локальный: ./CLAUDE.local.md рядом с проектным. Личные заметки по конкретному проекту, его добавляют в .gitignore, чтобы он не уехал в общий репозиторий.
• Корпоративный: файл политики, который администраторы раскладывают на все машины компании.

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

По теме: Расширение Claude в 2026: для Chrome, VS Code и JetBrains

Как создать файл: команда /init

Писать с нуля не нужно, черновик ассистент соберёт сам.

1. Откройте проект в Claude Code. Проще всего начать с десктопного приложения для Windows и macOS: чат и Claude Code живут в одной программе, отдельно ставить терминальную версию не нужно, скачать можно на официальной странице загрузки. Терминальная версия и расширения для редакторов тоже подойдут, файл памяти работает одинаково везде.
2. Наберите команду /init и отправьте. Ассистент пройдётся по проекту, найдёт команды сборки и тестов, принятые в коде соглашения и соберёт из этого черновик CLAUDE.md.
3. Прочитайте черновик глазами и вычеркните всё, что и так видно в коде: список папок, перечень зависимостей, пересказ структуры.
4. Допишите то, чего ассистент узнать не мог: договорённости команды, подводные камни, что в проекте трогать нельзя и почему.
5. Проверьте, что файл подхватился. Команда /context показывает список загруженных файлов памяти, а /memory открывает их на редактирование.

Если CLAUDE.md в проекте уже есть, /init не затрёт его, а предложит улучшения к тому, что написано. Дальше файл живёт как код: его правят, сокращают и пересматривают, когда проект меняется.

Что писать в CLAUDE.md, а что не надо

Главный критерий простой: сюда идёт то, что вы иначе объясняли бы заново в каждом разговоре. Стоит записать:

• команды, которые невозможно угадать по коду (чем запускать, чем собирать, чем прогонять тесты);
• правила оформления, отличающиеся от общепринятых;
• договорённости репозитория: как называются ветки, как оформляются коммиты;
• архитектурные решения, специфичные для вашего проекта;
• особенности окружения: нужные переменные, версия языка, чем поднимается база;
• неочевидные грабли, на которые вы уже наступали.

А вот чего в файле лучше не держать:

• пересказ структуры папок и списка библиотек: это ассистент прочитает сам;
• документацию чужих сервисов и библиотек, вместо копии достаточно ссылки;
• общие лозунги вроде «пиши качественный код»;
• то, что и без инструкции делается правильно;
• сведения, которые часто меняются: они быстро устаревают.

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

Пример: файл для сайта и файл для бота

Вот как это выглядит на практике. Небольшой сайт-лендинг:

# Проект: лендинг студии керамики
Статический сайт: HTML, CSS, немного JavaScript. Сборщика нет.

## Команды
- Локальный просмотр: `python3 -m http.server 8000`
- Публикация: `git push`, дальше хостинг собирает сам

## Правила
- Правим только файлы в `src/`, папка `dist/` собирается автоматически
- Тексты на русском, обращение к посетителю на «вы»
- Новые секции добавляем в `index.html`, отдельные страницы не плодим
- IMPORTANT: без внешних библиотек, страница должна открываться офлайн

Телеграм-бот, тот же принцип, другое содержание:

# Проект: бот записи на стрижку
Python 3.12, библиотека aiogram, база SQLite в файле `data/bot.db`.

## Команды
- Запуск: `python bot.py`
- Тесты: `pytest -q`

## Правила
- Токен бота только в `.env`, в коде и в git его быть не должно
- Каждый новый обработчик кладём в `handlers/` отдельным файлом
- Сообщения пользователю на «вы», без эмодзи
- YOU MUST прогонять `pytest -q` перед коммитом

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

Проверяйте файл делом. Если ассистент второй раз подряд делает то, что вы уже запрещали, причин обычно две: правило сформулировано размыто или файл разросся и правило в нём потерялось. Сократите вдвое и посмотрите, изменится ли поведение.

По теме: Claude в Cursor: как включить модели, лимиты и отличие от Claude Code

Частые ошибки

• Файл на несколько экранов: чем длиннее инструкция, тем больше правил ассистент пропускает.
• Дублирование кода словами. Описания папок устаревают на первой же перестройке проекта, а пользы не дают.
• Противоречия между файлами. Если личный и проектный требуют разного, ассистент выберет одно из двух, и не обязательно то, которое вы имели в виду.
• Попытка запретить текстом то, что надо запрещать технически. CLAUDE.md это контекст, а не защита.
• Написали один раз и забыли. Хорошее правило добавляется ровно тогда, когда вы во второй раз исправляете одну и ту же ошибку.

Что есть рядом: импорты, правила и автопамять

Когда одного файла становится мало, рядом есть три механизма. Импорты: строка вида @docs/git-instructions.md подтягивает другой файл внутрь основного, вложенность до четырёх шагов. Это про порядок, а не про экономию, импортированное всё равно грузится при старте.

Каталог .claude/rules/: инструкции раскладываются по темам отдельными файлами, и правилу можно указать, к каким путям оно относится. Тогда оно подгрузится, только когда ассистент откроет подходящие файлы.

Автопамять: заметки, которые Claude Code ведёт себе сам, отдельно от вашего файла. Она включена по умолчанию, хранится на вашем компьютере и загружается в сессию не целиком, а первыми 200 строками или 25 килобайтами файла-указателя MEMORY.md. Посмотреть и почистить их можно через /memory. А если знание нужно не всегда, а под конкретную задачу, ему место в навыке, как это работает, мы показывали в разборе Claude Skills.

Отдельная деталь для тех, кто пользуется несколькими ассистентами. Claude Code читает CLAUDE.md и не читает AGENTS.md, который понимают другие инструменты. Если такой файл уже есть, не копируйте текст: сделайте CLAUDE.md из одной строки @AGENTS.md.

Частые вопросы

Нужен ли CLAUDE.md, если проект совсем маленький?

Для разовой странички нет. Файл окупается, когда вы возвращаетесь к проекту во второй и третий раз: именно тогда начинается «я же вчера просил». Хватит пяти строк про запуск и трёх правил, дальше дописывайте по поводам.

Файл читается целиком или обрезается?

CLAUDE.md загружается полностью, независимо от длины: рекомендация про 200 строк касается качества, а не технического лимита. Ограничение в 200 строк или 25 килобайт относится к другому файлу, MEMORY.md из автопамяти.

Правила пропадают после сжатия контекста?

Проектный CLAUDE.md из корня после /compact перечитывается с диска и возвращается в сессию. А вот договорённость, сказанная только голосом в чате, при сжатии может потеряться, это лишний довод записывать важное в файл.

Чем это отличается от обычного промпта?

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

Как сделать правило по-настоящему обязательным?

Текстом никак: инструкции влияют на поведение, но не гарантируют его. Для действий, которые должны происходить всегда (прогнать тесты перед коммитом, не пускать правки в определённую папку), есть хуки и настройки прав, они срабатывают независимо от решения ассистента.