Каркас проекта, чтобы Claude не путался и не переделывал одно и то же

Шаг 0: что нужно до старта

Весь каркас работает поверх Claude Code — это Claude, встроенный в редактор кода VS Code как обычная программа. Он читает твои файлы, запускает команды и сам правит проект, пока ты смотришь или занимаешься своим. Ни мощного компьютера, ни знания программирования не нужно. Если его ещё нет:

• Установка с нуля и оплата российской картой, по шагам — Claude Code из России за вечер →
• Если хочется без подписки, на бесплатных моделях — Claude Code бесплатно →

Уже стоит и открыт в VS Code? Тогда заводим каркас.

Одна папка — и откуда запускать Claude

Первое правило простое: всё, что относится к проекту, живёт в одной папке. Не на рабочем столе вперемешку с остальным, а отдельная папка с понятным именем — например moy-sayt или bot-zapisi. Латиницей, без пробелов, чтобы потом не ловить странные ошибки. Создаёшь папку и открываешь её в VS Code через File → Open Folder. Всё, что Claude делает, он делает внутри неё — это его рабочий стол.

И есть деталь, которую новички пропускают, а она важная: где ты запускаешь Claude, тем он и ограничен. Запустишь из корня проекта — он видит весь проект и читает корневой CLAUDE.md. Запустишь из подпапки — видит только её, а из инструкций берёт файл этой папки плюс всех родительских (дока, large codebases). Для простого проекта правило одно: открывай и запускай Claude из корневой папки — тогда он видит всё нужное и ничего лишнего.

CLAUDE.md — постоянная память проекта

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

Сюда кладёшь то, что верно всегда, в любой день работы над проектом. В официальном гайде корневой файл описывают как место для общих правил репозитория: что за проект, на чём он, как устроена структура, какие договорённости по коду и коммитам (там же). А сиюминутное — «сегодня делаем кнопку» — сюда не пишут: для этого есть сам чат.

И ещё одно правило из практики самих инженеров Anthropic: короткий файл работает лучше длинного. Когда корневой CLAUDE.md разрастается и пытается описать вообще всё, он начинает съедать тот самый контекст и теряет пользу — либо раздувается, либо становится слишком общим (дока). Пять-семь чётких пунктов модель удержит. Простыню на три экрана начнёт терять.

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

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

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

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

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

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

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

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

Когда проект растёт: правила по папкам

Пока проект маленький, хватает одного CLAUDE.md в корне. Но как только он разрастается — несколько частей, фронт и бэк, разные стеки — один файл становится либо громоздким, либо слишком общим (дока, large codebases). Тогда инструкции раскладывают по папкам, и это снова про экономию контекста.

Работает так: Claude загружает корневой файл и инструкции всех родительских папок сразу при старте, а CLAUDE.md конкретной подпапки подтягивает в тот момент, когда лезет в её файлы (там же). Корневой файл держит общие правила, в папке фронтенда лежит свой про фронтенд, в папке API — свой. В каждый момент Claude видит общие правила плюс ровно те, что относятся к коду, который сейчас трогает, — и не тащит в контекст лишнее.

my-project/
 ├── CLAUDE.md            ← общие правила всего проекта
 └── packages/
     ├── api/
     │   ├── CLAUDE.md     ← правила только для бэкенда
     │   └── src/
     └── web/
         ├── CLAUDE.md     ← правила только для фронтенда
         └── src/

Эти файлы коммитят в репозиторий, чтобы вся команда наследовала одни правила (дока). Для соло-проекта это просто значит: каркас переживает и перезапуск, и новый чат, и тебя через месяц.

Правило «сначала план, потом код»

Главная ошибка новичка — сразу писать «напиши код». Claude бросается реализовывать и нередко решает не ту задачу. В официальном гайде это прямо вынесено в рекомендуемый рабочий цикл из четырёх фаз: исследовать → план → код → коммит (Best practices).

Для этого в Claude Code есть режим плана (plan mode): в нём он читает файлы и отвечает на вопросы, но ничего не меняет, пока ты не одобришь подход. План можно открыть прямо в редакторе и поправить (Ctrl+G), а уже потом дать команду реализовать (там же).

У плана есть и обратная сторона — это лишний шаг. Если правка крошечная и её можно описать одной фразой (переименовать переменную, добавить строчку лога), официальный совет прямой: пропусти план и проси сделать сразу. План нужен там, где ты не уверен в подходе или правка задевает несколько файлов (там же).

Закрепи это правило в каркасе — и Claude будет приходить с планом сам:

- Перед задачей в несколько файлов сначала короткий план
  и пауза на моё «ок». Мелкие правки делай сразу, без плана.

Дай Claude способ проверить себя

Есть приём, который превращает сессию «надо стоять над душой» в сессию, от которой можно отойти. Дай Claude то, чем он сам проверит свою работу: тесты, сборку, скриншот для сравнения (Best practices).

Логика простая. Claude останавливается, когда работа «выглядит сделанной». Без проверки «выглядит» — единственный сигнал, и роль контролёра достаётся тебе: каждую ошибку приходится замечать вручную. Дай ему то, что выдаёт «прошло / не прошло» — и петля замыкается сама: он делает, запускает проверку, читает результат и доводит, пока не сойдётся (там же).

Для контентного или простого проекта это не обязательно тесты. Это может быть «открой страницу и сравни со скриншотом макета, перечисли отличия и исправь» или «собери проект и покажи, что собралось без ошибок». Главное — чтобы у Claude был объективный сигнал, а не только твоё «вроде норм».

Что ты увидишь

Это не теория. Вот один и тот же запрос на голом проекте и на проекте с каркасом. Claude один и тот же — разница только в том, что он читает на входе.

Чтобы не споткнуться

Три вещи, на которых застревают новички — и как пройти их сразу.

А если…

Четыре сомнения, которые ловят на входе. Отвечаю прямо.

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

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

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

А дальше

Каркас закрывает фундамент: проект, который Claude понимает и собирает сам. Но это ещё не вся машина.

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

Источники

Факты в этом гайде — из официальной документации Claude Code: