Каркас проекта для вайбкодинга: папки и CLAUDE.md, чтобы Claude не путался (2026)

Просишь Claude добавить одну кнопку, а он переписывает половину проекта, путает где что лежит и забывает, о чём вы договаривались два сообщения назад. Причина почти всегда в самом проекте: файлы свалены в кучу, и Claude Code негде взять контекст. Лечится это за пять минут - заводишь понятные папки и один файл-инструкцию CLAUDE.md, который модель читает автоматически. Дальше она перестаёт терять нить.

Ниже разложено по шагам: какие папки завести с самого старта, зачем нужен CLAUDE.md и что в него класть. В конце готовый шаблон, который копируешь к себе. Без программирования, понятно человеку, который открывает это впервые.

Почему Claude путается и переписывает рабочий код

Claude Code читает твой проект как сотрудник, который вышел на работу сегодня. Каждый раз с чистого листа. Он не держит в памяти вчерашний чат. В начале сессии он смотрит на папки и файлы и по ним понимает, что это за проект и как тут принято делать.

Сваленные в кучу файлы для него - пустой стол. Взять контекст неоткуда, и он начинает угадывать. Отсюда и переписанная половина проекта, и путаница где что лежит.

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

Что нужно до старта: поставить Claude Code

Весь каркас работает поверх Claude Code. Это Claude, встроенный в редактор кода VS Code как обычная программа на компьютере. Ты пишешь ему на русском, что сделать, он правит файлы сам.

Если его ещё нет, поставь сначала его. Это примерно 15 минут и без программирования: скачать, оплатить российской картой и запустить за один вечер разбирает отдельный гайд по шагам, со скриншотами - Claude Code с нуля из России. Без него команды ниже вставлять будет некуда.

Уже стоит и открыт в VS Code? Тогда заводим каркас. Весь он собирается за четыре коротких шага.

Как завести папку проекта

Первое правило: всё, что относится к проекту, живёт в одной папке. Не на рабочем столе вперемешку с фотками, а отдельная папка с понятным именем, например moy-sayt или bot-zapisi. Латиницей, без пробелов, чтобы потом не ловить странные ошибки.

Создай папку и открой её в VS Code: верхнее меню File → Open Folder, выбери эту папку. Всё, что Claude будет делать, он делает внутри неё. Это его рабочий стол, и он видит ровно то, что в нём лежит.

Как разложить проект по папкам

Дальше внутри делаем полки. Claude по именам папок понимает, куда что класть и где что искать. Тебе не нужно угадывать, как принято у программистов, нужно, чтобы было понятно человеку. Вот базовый набор, который закрывает почти любой простой проект.

Руками эти папки создавать не обязательно. Можно просто сказать Claude словами, и он соберёт структуру сам.

Заведи в проекте папки src, assets, content и docs.
В src положи код, в assets картинки, в content тексты
страниц, в docs мои заметки и идею. Создай пустой README
в каждой папке, чтобы было понятно, что куда класть.

Что увидишь: Claude создаст папки и покажет дерево проекта. Слева в VS Code появятся новые папки. С этого момента он знает, что код в src, а картинки в assets, и не будет сваливать всё в кучу.

Что такое CLAUDE.md и что в него класть

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

Сюда кладёшь то, что верно всегда, в любой день работы над проектом. Что строим, на чём, как тут принято, чего трогать нельзя. Сиюминутное вроде «сегодня делаем кнопку» сюда не пиши, для этого есть сам чат. В CLAUDE.md только то, что Claude должен помнить постоянно.

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

Готовый шаблон CLAUDE.md, который копируешь к себе

Вот базовый каркас файла. Создай в корне проекта файл с именем CLAUDE.md (именно так, заглавными), вставь это внутрь и поменяй слова в скобках на свои. Дальше Claude будет держать это в голове сам.

# Проект: (название, например "Сайт моей онлайн-школы")

## Что это
(одна строка: что строим и для кого. Пример:
лендинг для онлайн-школы фотографии, цель - заявки на курс)

## Стек
(на чём делаем. Если не знаешь - так и напиши Claude:
"подбери простой стек для новичка". Пример:
обычный сайт на HTML и Tailwind, без сложных фреймворков)

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

## Правила
- Объясняй простыми словами, я не программист
- Перед большой правкой коротко скажи, что собираешься менять
- Не переписывай то, что уже работает, без моего согласия
- Тексты бери из папки content, свои не выдумывай
- Пиши на русском

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

Сохрани файл (Cmd+S или Ctrl+S). Готово, это и есть каркас. Можешь оставить его таким на старте и дополнять по ходу: заметил, что Claude раз за разом делает что-то по-своему - добавь это правило в раздел «Правила».

Разбор каждого блока файла отдельно, с примерами под разные проекты, лежит в гайде как настроить CLAUDE.md. Здесь дан рабочий минимум, там - вглубь.

Как проверить, что Claude видит каркас

Claude подхватывает CLAUDE.md сам, но на старте полезно убедиться, что он его прочитал. Открой чат Claude Code в папке проекта и напиши одну строку.

Прочитай CLAUDE.md и своими словами скажи:
что мы строим, какой стек и какие у нас правила.

Если Claude пересказал твою записку правильно, каркас на месте. Теперь в любом новом чате он стартует, уже зная контекст, и тебе не нужно каждый раз объяснять заново «у нас сайт школы, тексты в content, пишем на русском».

Три ошибки, на которых застревают новички

Каркас простой, но пара мелочей ломает его у тех, кто делает впервые. Пройдись по ним заранее.

Первая - имя файла. Строго CLAUDE.md, заглавными буквами, в корне папки проекта, рядом с папками src и assets. Назовёшь claude.md или положишь в подпапку - Claude Code может не подхватить его автоматически, и вся затея впустую.

Вторая - размер. Соблазн расписать всё на десять экранов велик. Не надо. Чем длиннее файл, тем хуже Claude держит правила в голове. Пять-семь коротких пунктов работают лучше трёх страниц воды.

Третья - устаревший файл. Сменил стек или передумал по структуре - сразу поправь CLAUDE.md.

Зачем это на самом деле

Завести каркас по шагам выше ты сможешь сегодня. И уже на этом многое меняется.

Раньше каждый новый чат начинался с того, что ты заново объясняешь, что за проект, потом полдня правишь за Claude его выдумки и борешься с тем, что он переписал работающее. С каркасом он стартует, уже зная правила, и держит линию.

Это то самое место, на котором новичок обычно выгорает и бросает: вроде ИИ умный, а на деле каждый раз бой и переделки. Чаще всего причина простая - модели не дали каркас. Дал - и работа из борьбы превращается в нормальный диалог с понятливым помощником.

Чек-лист: что у тебя теперь есть

• Одна папка проекта с понятным именем латиницей, открыта в VS Code
• Внутри разложены полки: src, assets, content, docs, каждая под своё
• В корне лежит CLAUDE.md с коротким описанием проекта, стека, структуры и правил
• В файле прописано, чего Claude трогать нельзя
• Ты проверил одной строкой, что Claude читает CLAUDE.md и пересказывает его верно
• Понимаешь три грабли: имя файла, длина, актуальность

Куда двигаться от каркаса

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

Ближайший шаг после каркаса - собрать на нём первую живую страницу. Как поднять сайт нейросетью с нуля, командами на русском, разбирает гайд сайт нейросетью с нуля. Каркас у тебя уже есть, дальше строим из него.