CLAUDE.md в Claude Code: что писать, а что нет
CLAUDE.md это файл памяти проекта. Его содержимое летит в каждый запрос к модели, поэтому он должен быть коротким и плотным по смыслу. Пишите туда стек, команды запуска, строгие правила и границы. Не пишите туда документацию, длинные описания и рассуждения: за них вы платите токенами каждый ход.
Зачем нужен CLAUDE.md
Без него агент каждый раз угадывает стек, команды и договорённости проекта. С ним он сразу знает: какой фреймворк, как запустить, чего не трогать. Это и точность выше, и расход ниже, потому что не приходится переспрашивать.
Структура правильного файла
# Проект: <название, одна строка> ## Стек Next.js 14, TypeScript, Tailwind, Postgres + Prisma ## Команды - dev: npm run dev - test: npm test - lint: npm run lint - migrate: npm run db:migrate ## Правила - Типы строгие, без any - Компоненты функциональные - /migrations не трогать без подтверждения - Коммиты на русском, без эмодзи
Хороший и плохой пример
| Плохо (10 000+ токенов) | Хорошо (~1 500 токенов) |
|---|---|
| История проекта на три абзаца | Одна строка с названием |
| Описание архитектуры простынёй | Стек списком |
| Все возможные команды с флагами | 4 ключевые команды |
| Рассуждения о кодстайле | Чёткие правила списком |
| Скопированная документация библиотек | Ничего из чужой доки |
Уровни файлов
Claude Code читает CLAUDE.md на нескольких уровнях: глобальный в домашней директории, в корне проекта и в подпапках. Глобальный для личных предпочтений во всех проектах, проектный для стека и правил конкретного репозитория, в подпапках для локальных нюансов вроде «тут легаси, не трогать».
Что не писать
- Длинные описания зачем проект нужен: агенту это не помогает кодить.
- Документацию сторонних библиотек: модель её уже знает.
- Чейнджлоги и историю коммитов: для этого есть git.
- Эмоции и заметки: они только раздули бы контекст.
Короткий CLAUDE.md это половина экономии. Вторая половина в доступе к модели по честной цене: CLOD подключает Opus 4.8 и Sonnet 4.6 с оплатой рублём за токены.
Частые вопросы
CLAUDE.md обязан быть в каждом проекте?
Нет, но без него агент чаще ошибается со стеком и командами. На маленьком проекте можно обойтись, на среднем и крупном файл окупает себя сразу.
Где должен лежать CLAUDE.md?
В корне проекта. Глобальные предпочтения можно положить в домашнюю директорию, тогда они применятся ко всем проектам.
Насколько длинным может быть файл?
Идеально до 2 000 токенов. Больше 8 000 уже раздувает контекст и стоит на каждом ходу. Лучше короче.
Агент сам обновляет CLAUDE.md?
Может, если попросить. Но контролируйте правки: иногда он добавляет лишнее. Периодически ревьюйте файл и подрезайте.