Claude не помнит - он смотрит

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

Базовый набор папок

src/
Сам код и страницы - основное содержимое проекта.
assets/
Картинки, логотип, шрифты - всё визуальное сырьё.
content/
Тексты - что и где написано на страницах.
docs/
Заметки, идея проекта, референсы - всё, что не код и не финальный текст.

Не обязательно создавать эти папки руками - можно просто попросить Claude Code собрать структуру словами, объяснив, что куда класть.

CLAUDE.md - сердце каркаса

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

# Проект: (название)

## Что это
(одна строка: что строим и для кого)

## Стек
(на чём делаем - если не знаете, попросите Claude подобрать простой стек)

## Структура папок
- src/ - код и страницы
- assets/ - картинки, логотип, шрифты
- content/ - тексты страниц
- docs/ - идея, заметки, референсы

## Правила
(чего не трогать, как принято называть файлы, любые постоянные договорённости)

Что класть в файл, а что нет

Таблица прокручивается вбок на телефоне →

Класть в CLAUDE.mdНе класть
Что за проект и для когоЗадачу на сегодня
Стек и структура папокРазовые просьбы
Постоянные правила («не трогать эту папку»)Длинные объяснения, которые Claude поймёт сам из кода
Что нельзя менять без согласованияВсё, что верно только сегодня, а завтра уже нет

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

Признак, что каркас пора завести

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

Чек-лист перед стартом проекта

Сохраните себе
  1. Заведите одну папку под весь проект - латиницей, без пробелов в имени.
  2. Разложите по подпапкам с понятными названиями - Claude Code ориентируется по именам.
  3. Создайте CLAUDE.md в корне и опишите проект, стек и структуру в 5-7 пунктах.
  4. Не кладите в CLAUDE.md разовые задачи - для них есть обычный чат.
  5. Пересматривайте файл раз в несколько недель - устаревшие пункты путают агента не меньше, чем их отсутствие.
Обязательно ли заводить CLAUDE.md для маленького проекта?
Необязательно для одноразового скрипта. Для проекта, над которым работаете несколько дней, файл экономит время на повторных объяснениях.
Что делать, если файл CLAUDE.md разросся на несколько экранов?
Сократите его - длинный файл агент начинает путать так же, как отсутствие файла вообще.
Можно ли попросить Claude Code самого собрать структуру папок проекта?
Да, достаточно описать словами, что за проект и что куда класть - агент создаст структуру сам.
← Все статьи блога