Агент каждый раз начинает с нуля. Вот зачем нужен этот файл
Каждая новая сессия Claude Code, когда ты открываешь терминал и запускаешь claude, начинается для него как чистый лист. Он не помнит вчерашний разговор, не знает, что ты уже рассказывал про свой проект вчера, и не в курсе, какие у тебя правила.
Чтобы не объяснять одно и то же заново в каждой сессии, Claude Code умеет читать специальный файл по имени CLAUDE.md. Он лежит в корне проекта, и в начале каждой сессии агент подхватывает его автоматически, тебе не нужно ничего вставлять в чат руками.
Это обычный текстовый файл в формате Markdown, в котором своими словами описано: что это за проект, из чего он состоит, какими командами его запускать и проверять, и каких правил агенту стоит держаться. Чем лучше этот файл, тем меньше агент гадает и тем реже делает не то, что ты имел в виду.
Как создать файл за одну команду
Руками писать CLAUDE.md с нуля не обязательно. Проще всего попросить сам Claude Code составить черновик, а потом поправить его под себя.
- Зайди в папку своего проекта в терминале и запусти
claude. - Введи команду
/init. - Claude Code сам пройдётся по файлам проекта, посмотрит, на чём он написан, и предложит черновик CLAUDE.md.
- Прочитай черновик и убери то, что звучит странно или неточно, ты знаешь свой проект лучше.
Если проект совсем новый и файлов в нём ещё почти нет, черновик получится коротким, это нормально. Можно дописать файл вручную прямо сейчас или вернуться к этому через пару дней, когда появится, что в нём зафиксировать.
Что обязательно положить внутрь
Файл не обязан быть длинным и подробным. Важнее, чтобы в нём была база, без которой агент точно будет ошибаться.
| Раздел | Зачем |
|---|---|
| Что это за проект | Одно-два предложения: Telegram-бот для записи клиентов, сайт-визитка, личный трекер привычек. |
| На чём написан | Язык и основные библиотеки, чтобы агент не предлагал что-то несовместимое со стеком. |
| Команды запуска и проверки | Как запустить проект локально, как прогнать тесты, если они есть. Агент сам выполнит эти команды. |
| Структура папок | Где лежит код, где конфиги, где секреты, чтобы агент не лез куда не надо. |
| Жёсткие правила | Например: «не трогай файл .env», «не удаляй папку data/», «перед изменением базы спроси меня». |
Секреты, пароли и ключи API в CLAUDE.md писать нельзя: этот файл обычно попадает в Git и может уйти в публичный репозиторий. Про это подробно в гайде как не слить ключи и пароли.
Частые ошибки новичков с этим файлом
Мини-шаблон, который можно взять за основу
Вот пример короткого CLAUDE.md для типичного первого проекта новичка, Telegram-бота. Скопируй и замени под свой случай.
Такого шаблона достаточно, чтобы агент перестал задавать одни и те же вопросы в начале каждой сессии. Остальное можно дописывать по мере того, как проект растёт и ты замечаешь, что агент снова и снова наступает на одни и те же грабли.