Файл CLAUDE.md: зачем нужен и что это такое
Что такое файл CLAUDE.md и зачем он нужен: обычная текстовая записка, которую Claude Code читает в начале каждой сессии, — правила переживают любой чат.
Евгений Арсентьев · MD, PhDПроверено на точность — Евгений Арсентьев, MD, PhD · 2026-06-12
Вот раздражение, в которое упирается каждый через пару недель стройки с Claude Code: каждая сессия начинается с нуля. Вчера ты сказал ему хранить данные в одном файле, отвечать по-русски и не трогать папку с фотографиями — а сегодня печатаешь всё это заново. Если ты проходил мой курс, то знаешь почему: рабочий стол ИИ протирается между разговорами. Чего в курсе не было — так это лекарства. А оно до неприличия простое.
Зачем нужен файл CLAUDE.md?
В папке твоего проекта может жить файл с именем CLAUDE.md. Это не код — это обычная текстовая записка. Claude Code читает её в начале КАЖДОЙ сессии, автоматически, ещё до того, как ты что-то написал. Какие правила там лежат — с теми Claude и начинает день. Весь механизм: записка на холодильнике, только холодильник — твой проект, а читатель никогда её не пропускает.
А он мне точно нужен?
Если ты задаёшь Claude только разовые вопросы — нет. Но как только заметил, что печатаешь одну и ту же инструкцию по второму разу, — это и есть сигнал, что записка нужна. Файл окупается в первое же утро, когда ты открываешь проект, а Claude уже знает твой язык, твой файл с данными и запретные папки — без единого напоминания.
Что писать в файл CLAUDE.md?
Что туда писать (тест: «я это объясняю по второму разу»)
- 1Правила, которые повторяешь: «отвечай по-русски», «все данные храни в data.json», «везде тёмная тема».
- 2Как запускать твой инструмент: «для проверки открывай index.html» — чтобы Claude сам правильно проверял свою работу.
- 3Границы: «папку с фотографиями не трогать», «дизайн без моей просьбы не менять».
- 4Всё, что ты поправил дважды. Дважды — значит, место этому в файле.
Как создать файл CLAUDE.md?
Создавать его руками не нужно. Просто скажи Claude: «добавь в CLAUDE.md: все данные храни в data.json». Он сам создаст файл и запишет правило. Есть и команда, которая собирает стартовую записку за тебя: набери /init в сессии — Claude изучит проект и напишет её сам.
you ▸ добавь в CLAUDE.md: отвечай по-русски, данные храни в data.json,
папку с фото не изменяй
claude ▸ Добавил в CLAUDE.md ✓ — буду следовать этому в каждой сессии.Как CLAUDE.md работает вместе с авто-памятью?
В свежих версиях Claude Code появилась авто-память — и она включена по умолчанию. Пока вы работаете, Claude тихо записывает заметки для себя: как запускается твой проект, какие ошибки не повторять, что ты ему поправлял. Иногда увидишь мелькнувшее «Writing memory» — это он учится. Разделение труда такое: в CLAUDE.md — ТВОИ правила, в авто-памяти — то, до чего Claude дошёл сам. И то и другое загружается в начале каждой сессии.
Как посмотреть, что Claude запомнил?
Хочешь посмотреть, что он запомнил? Набери /memory в сессии — там список всех файлов-заметок, любую можно открыть, поправить или удалить. Всё это обычный текст. Запомнил что-то не то — сотри строку; хочешь, чтобы держал правило вечно — скажи «запомни это», и оно ляжет в его заметки.
Где находится файл CLAUDE.md?
Мест два, и вся хитрость — в разнице между ними. Проектный файл лежит в папке проекта и действует только на этот проект. Второй, личный, лежит по адресу ~/.claude/CLAUDE.md и действует на ВСЁ, что ты строишь на этом компьютере. Руками искать ни тот, ни другой почти никогда не нужно — ты говоришь Claude, какой из них имеешь в виду, и он правит нужный файл.
CLAUDE.md в папке проекта действует на этот проект. Но есть и личная записка — по адресу ~/.claude/CLAUDE.md — она действует на ВСЁ, что ты строишь на этом компьютере. Положи туда один раз язык и общий вкус («отвечай по-русски; объясняй как непрограммисту») — и каждый будущий проект начнётся уже надрессированным. Скажи Claude: «добавь в мой личный CLAUDE.md: …» — он знает, где тот живёт.
Какой размер CLAUDE.md уже слишком большой?
Первая: держи файл коротким — примерно до 200 строк. Раздутую записку выполняют хуже, а не лучше (как и у людей). Вторая: это инструкции, а не железный закон — конкретные правила («данные храни в data.json») Claude соблюдает заметно надёжнее размытых («делай всё хорошо»). Кажется, что правило игнорируется — набери /memory и проверь, что твой файл вообще в списке загруженных.
Пять минут — апгрейд навсегда
0/5Это самый дешёвый апгрейд во всём вайб-кодинге: один текстовый файл, написанный однажды, — и ассистент, который каждое утро тебя забывал, начинает ощущаться коллегой, который сидит на проекте месяцами.
Бесплатный курс
Хватит читать про ИИ — начни строить с ним
Бесплатный курс Claude Code: свой первый сайт, инструмент или игра — без программирования. Без апсейлов и кросс-сейлов — здесь нечего купить.
Начать →Источники и исследования
Подборка рецензируемых работ и препринтов по научной основе этой темы.
- [1]Wang et al. (2023). Augmenting Language Models with Long-Term Memory. arXiv:2306.07174
- [2]Zhong et al. (2023). MemoryBank: Enhancing Large Language Models with Long-Term Memory. arXiv:2305.10250
- [3]Gutiérrez et al. (2024). HippoRAG: Neurobiologically Inspired Long-Term Memory for Large Language Models. arXiv:2405.14831
- [4]Wan et al. (2025). StoryBench: A Dynamic Benchmark for Evaluating Long-Term Memory with Multi Turns. arXiv:2506.13356
- [5]Shen et al. (2025). TALM: Dynamic Tree-Structured Multi-Agent Framework with Long-Term Memory for Scalable Code Generation. arXiv:2510.23010
- [6]Jonelagadda et al. (2025). Mnemosyne: An Unsupervised, Human-Inspired Long-Term Memory Architecture for Edge-Based LLMs. arXiv:2510.08601
- [7]Shen et al. (2026). Mem2ActBench: A Benchmark for Evaluating Long-Term Memory Utilization in Task-Oriented Autonomous Agents. arXiv:2601.19935
Автор
Евгений Арсентьев
MD, PhD · Руководитель ИИ-трансформации
Чтение — это синяя пилюля
Хочешь реально это построить?
Гайды объясняют. Бесплатный курс превращает — персонально, с геймификацией и заточенный на быстрый запуск.
Начать бесплатный курс →