Гайды / Вайбкодинг
Вайбкодинг · каркас проекта · по шагам
Каркас проекта, чтобы Claude не путался и не переделывал одно и то же
Знаешь это чувство: просишь Claude добавить кнопку, а он переписывает половину проекта, путает где что лежит и забывает, о чём вы договаривались два сообщения назад. Дело почти всегда не в Claude, а в том, что проект свален в кучу и ему негде взять контекст. Ниже разложил по шагам: какие папки завести с самого старта, зачем нужен один файл-инструкция CLAUDE.md и что в него класть. В конце готовый каркас, который копируешь к себе за пять минут. Без программирования, понятно человеку, который открывает это впервые
В чём фокус
Claude собирает не по памяти, а по тому, что видит в папке
Claude Code читает твой проект как новый сотрудник, который вышел сегодня. Каждый раз заново. Он не помнит вчерашний разговор, он смотрит на папки и файлы и по ним понимает, что это за проект и как тут принято делать. Сваленные в кучу файлы для него это пустой стол, и он начинает гадать
Каркас это две простые вещи. Первое: понятная структура папок, по которой сразу видно, что где лежит. Второе: один файл CLAUDE.md в корне проекта, который Claude читает автоматически в начале каждой сессии. Это короткая записка вроде «вот что мы строим, вот стек, вот правила, не трогай вот это». Заводишь их один раз, и дальше Claude перестаёт терять нить
Шаг 0 · что нужно до старта
Сначала на компьютере должен стоять Claude Code
Весь каркас работает поверх Claude Code (это Claude, встроенный в редактор кода VS Code, как обычная программа на компьютере). Если его ещё нет, поставь сначала его, это 15 минут и без программирования
Если Claude Code ещё не стоит
У меня есть отдельный гайд: скачать, оплатить российской картой и запустить за один вечер, всё по скриншотам
Установить Claude Code с нуляУже стоит и открыт в VS Code? Тогда заводим каркас
Шаг 1 · заведи папку проекта
Один проект - одна папка, всё внутри неё
Первое правило: всё, что относится к проекту, живёт в одной папке. Не на рабочем столе вперемешку с фотками, а отдельная папка с понятным именем, например moy-sayt или bot-zapisi. Латиницей, без пробелов, чтобы потом не ловить странные ошибки
Создай папку, открой её в VS Code (верхнее меню File → Open Folder и выбери эту папку). Всё, что Claude будет делать, он делает внутри неё. Это его рабочий стол, и он видит ровно то, что в нём лежит
Шаг 2 · разложи по полкам
Заведи несколько папок с понятными именами
Дальше внутри делаем полки. Claude по именам папок понимает, куда что класть и где что искать. Тебе не нужно угадывать «как у программистов», нужно, чтобы было понятно человеку. Вот базовый набор, который закрывает почти любой простой проект:
Не нужно создавать все папки руками. Можно просто сказать Claude словами, и он соберёт структуру сам:
› Заведи в проекте папки src, assets, content и
docs. В src положи код, в assets картинки, в
content тексты страниц, в docs мои заметки и
идею. Создай пустой README в каждой папке,
чтобы было понятно, что куда класть
Что увидишь
Claude создаст папки и покажет тебе дерево проекта. Слева в VS Code появятся новые папки. С этого момента он знает, что код в src, а картинки в assets, и не будет сваливать всё в кучу
Шаг 3 · сердце каркаса
Заведи файл CLAUDE.md - постоянную память проекта
Это главный файл. CLAUDE.md лежит в корне папки, и Claude Code читает его сам в начале каждой новой сессии, до того как ты вообще что-то напишешь. То есть это его постоянная память: один раз записал правила, и в каждом новом чате он уже их знает
Сюда кладёшь то, что верно всегда, в любой день работы над проектом. Что мы строим, на чём, как тут принято, чего трогать нельзя. Не пиши сюда сиюминутное вроде «сегодня делаем кнопку», для этого есть сам чат. Сюда только то, что Claude должен помнить постоянно. Короткий файл работает лучше длинного: пять-семь чётких пунктов он держит в голове, простыню на три экрана начинает терять
класть в CLAUDE.md
что за проект, стек, структура папок, постоянные правила, чего не трогать
не класть
задачу на сегодня, разовые просьбы, длинные объяснения, то что Claude поймёт сам из кода
Шаг 4 · готовый шаблон
Скопируй этот базовый CLAUDE.md и поправь под себя
Вот готовый каркас файла. Создай в корне проекта файл с именем CLAUDE.md (именно так, заглавными), вставь это внутрь и поменяй слова в скобках на свои. Дальше Claude будет держать это в голове сам
# Проект: (название, например "Сайт моей онлайн-школы") ## Что это (одна строка: что строим и для кого. Пример: лендинг для онлайн-школы фотографии, цель - заявки на курс) ## Стек (на чём делаем. Если не знаешь - так и напиши Claude "подбери простой стек для новичка". Пример: обычный сайт на HTML и Tailwind, без сложных фреймворков) ## Структура папок - src/ - код и страницы - assets/ - картинки, логотип, шрифты - content/ - тексты страниц - docs/ - идея, заметки, референсы ## Правила - Объясняй простыми словами, я не программист - Перед большой правкой коротко скажи, что собираешься менять - Не переписывай то, что уже работает, без моего согласия - Тексты бери из папки content, не выдумывай свои - Пиши на русском ## Не трогать - (сюда то, что нельзя менять. Пример: файл с настройками, готовый блок оплаты)
Что увидишь
Сохрани файл (Cmd+S или Ctrl+S). Готово. Это и есть каркас. Можешь оставить его таким на старте и дополнять по ходу, когда заметишь, что Claude раз за разом делает что-то не так, добавь это правило в раздел «Правила»
Шаг 5 · проверь, что Claude это видит
Скажи одну строку и убедись, что каркас работает
Claude подхватывает CLAUDE.md сам, но на старте полезно проверить, что он его прочитал. Открой чат Claude Code в папке проекта и напиши:
› Прочитай CLAUDE.md и своими словами скажи:
что мы строим, какой стек и какие у нас правила
Если Claude пересказал твою записку правильно, каркас на месте. Теперь в любом новом чате он стартует уже зная контекст, и тебе не нужно каждый раз объяснять заново «у нас сайт школы, тексты в content, на русском»
Чтобы не споткнуться
Почему Claude не видит каркас: имя файла и его размер
- 01
Имя файла строго CLAUDE.md
Заглавными буквами, в корне папки проекта. Если назвать claude.md или положить в подпапку, Claude может не подхватить его автоматически. Лежит рядом с твоими папками src и assets
- 02
Не превращай в простыню
Соблазн расписать всё на десять экранов. Не надо. Чем длиннее файл, тем хуже Claude держит правила в голове. Пять-семь коротких пунктов работают лучше, чем три страницы воды
- 03
Обновляй, когда поменялось
Сменил стек или передумал по структуре - поправь CLAUDE.md. Устаревший файл хуже пустого: он уводит Claude не туда. Заметил, что Claude повторяет одну и ту же ошибку - добавь про это строчку в «Правила»
Зачем тебе это на самом деле
Каркас превращает Claude из новичка в сотрудника, который тебя помнит
Завести каркас по шагам выше ты сможешь сегодня. И уже на этом многое меняется. Раньше каждый новый чат начинался с того, что ты заново объясняешь, что за проект, потом полдня правишь за Claude его выдумки и борешься с тем, что он переписал работающее. С каркасом он стартует, уже зная правила, и держит линию
Это то самое, на чём новичок обычно выгорает и бросает: вроде ИИ умный, а на деле каждый раз бой и переделки. Чаще всего проблема не в ИИ, а в том, что ему не дали каркас. Дал - и работа из борьбы превращается в нормальный диалог с понятливым помощником
А дальше
«Каркас завёл. А как из этого собрать что-то, что приносит деньги?»
Каркас это фундамент, чтобы Claude тебя слушался. Дальше идёт то, что в один файл не положишь: как выбрать, что вообще строить, чтобы это покупали, как собрать продукт или сайт целиком, как привести на него людей и превратить их в заявки. Это уже не один файл-инструкция, это система от идеи до первых клиентов
Я разложил её по шагам на ИИ-Лагере: как с нуля собрать продукт в нейросетях, упаковать его и запустить трафик, руками вместе со мной. Вход бесплатный
Живое мероприятие · ИИ-Лагерь
Хочешь не просто настроить Claude, а собрать с ним продукт и первые продажи?
На ИИ-Лагере весь путь от и до: выбираем что строить, собираем в нейросетях, запускаем трафик, от пустой папки до первых заявок, вместе со мной. Участие бесплатное
Забрать бесплатную путёвкуКаркас завёл, дальше строим из него деньги ))