- Где лежит CLAUDE.md
- Как создать
- Что писать
- Как писать, чтобы Claude слушался
- CLAUDE.md и авто-память
- Нужна ли подписка
- Вопросы
CLAUDE.md — файл с инструкциями для Claude Code. Claude читает его в начале каждой сессии: команды сборки, правила кода, устройство проекта. Без него каждая сессия начинается с чистого листа, и одно и то же приходится объяснять заново. Создать файл проще всего командой /init.
Где лежит CLAUDE.md
| Где | Для чего | Кто видит |
|---|---|---|
~/.claude/CLAUDE.md | твои привычки во всех проектах | только ты |
./CLAUDE.md или ./.claude/CLAUDE.md | правила проекта | все, кто работает с репозиторием |
./CLAUDE.local.md | личные настройки проекта, добавь в .gitignore | только ты |
| системная папка компании | правила организации от админа | все в организации |
Файлы из папок выше рабочей загружаются при запуске, из вложенных — когда Claude в них работает. Если в репозитории уже есть AGENTS.md, Claude Code может читать его вместо CLAUDE.md.
Как создать
- Открой проект и запусти
claude. - Введи
/init. Claude изучит код и напишет черновик: команды сборки и тестов, найденные правила. - Допиши то, чего Claude сам не найдёт, через
/memoryили в редакторе. - Проверь, что файл подхватился:
/contextпокажет его в списке Memory files.
Если CLAUDE.md уже есть, /init не перезапишет его, а предложит правки.
Что писать
Пиши то, что иначе объяснял бы каждый раз:
- команды: сборка, тесты, запуск;
- правила кода, которые не видны из самого кода;
- где что лежит в проекте;
- правила вида «всегда делай X перед Y».
Добавляй строку, когда Claude повторил ошибку или ты второй раз пишешь ту же поправку.
Как писать, чтобы Claude слушался
- Конкретно. «Отступ 2 пробела», а не «форматируй красиво». «Запускай
npm testперед коммитом», а не «проверяй изменения». - Коротко. Anthropic советует держать файл до 200 строк: длинный тратит контекст, и правила соблюдаются хуже.
- Без противоречий. Из двух спорящих правил Claude может выбрать любое. Найти устаревшее и противоречивое поможет
/doctor prompt-audit. - По разделам. Заголовки и списки Claude читает лучше, чем сплошной текст.
Правила для части проекта вынеси в .claude/rules/, длинные процедуры — в skills.
CLAUDE.md — это подсказка, а не запрет. Чтобы Claude точно не сделал какое-то действие, нужен хук PreToolUse, а не строка в файле.
CLAUDE.md и авто-память
| CLAUDE.md | Авто-память | |
|---|---|---|
| Кто пишет | ты | Claude |
| Что внутри | правила и инструкции | твои поправки, предпочтения, контекст |
| Сколько загружается | весь файл | первые 200 строк или 25 КБ |
Авто-память включена по умолчанию, переключатель — в /memory. Claude не записывает туда то, что видно из кода или уже есть в CLAUDE.md.
Нужна ли подписка
CLAUDE.md работает в Claude Code, а тот входит в платные тарифы: от Pro. Claude Pro в Чердаке — 2 490 ₽ в месяц, оплата по СБП, подписка на твой аккаунт. Как поставить Claude Code — в гайде как установить Claude Code, остальные команды — в гайде команды Claude Code.
Вопросы
Что такое CLAUDE.md? Файл с инструкциями, который Claude Code читает в начале каждой сессии.
Где должен лежать CLAUDE.md? В корне проекта или в .claude/. Общие правила для всех проектов — в ~/.claude/CLAUDE.md.
Как создать CLAUDE.md? Командой /init в Claude Code, потом допиши руками.
Почему Claude не выполняет правила из CLAUDE.md? Файл слишком длинный, правило размытое или противоречит другому. Сократи файл и проверь его через /doctor prompt-audit.
Можно ли использовать AGENTS.md? Да, Claude Code может читать его вместо CLAUDE.md.