Журнал стройки
Что за код написал ИИ, что такое файлы, фреймворк и git — без единой страшной аббревиатуры
Цели урока
К концу этого урока вы:
- Откроете папку проекта и поймёте, что за файлы там лежат — без страха.
- Узнаете, что такое фреймворк (Next.js) — в одно дыхание, не глубже нужного.
- Поймёте git как машину сохранёнок: коммит, ветка — своими словами.
- Сделаете первый коммит своего проекта — руками Claude Code по вашей просьбе.

О, ты здесь! Отлично — у меня для тебя кое-что есть.
Журнал стройки
Код — это магия. Так думает большинство людей до того, как открывают папку с проектом первый раз. После — удивляются: внутри просто текстовые файлы. Обычный текст, который можно открыть блокнотом. Никакой магии — только слова, знаки препинания и чёткая логика, которую не вы писали.
Страница из урока 4 уже существует на вашем компьютере в виде таких файлов. Сегодня мы посмотрим, что там внутри, и поймём главное: не для того, чтобы учиться это писать, а чтобы не бояться и говорить с прорабом увереннее. Хозяин дома не обязан знать, как паяют провода, — но он должен понимать, где щиток, что такое автомат и почему «просто выдернуть провод» — плохая идея [1].
И ещё один инструмент: git — машина сохранёнок. В уроке 4 мы поняли, что «надо бы сохраниться» — сейчас объясним, как именно, и сделаем первый коммит. Коммит в конце урока будет настоящий — на вашем проекте.
Быстрый конспект: откуда мы пришли
Из урока 2: Вы хотите попросить Claude Code изменить цвет кнопки. Напишите полную задачу по четырём элементам — одним абзацем, как будто отправляете прорабу прямо сейчас.
Из урока 1: Зачем нетеху вообще «заглядывать под капот», если прораб всё делает за него? Ответьте своими словами — без подглядывания.
Что вы возьмёте из этого урока
- Откроете папку проекта и поймёте, что за файлы там лежат — без страха.
- Узнаете, что такое фреймворк (Next.js) — в одно дыхание, не глубже нужного.
- Поймёте git как машину сохранёнок: коммит, ветка — своими словами.
- Сделаете первый коммит своего проекта — руками Claude Code по вашей просьбе.
Часть 1. Открываем папку: файлы и папки — просто коробки с листами
Откройте проводник (Windows) или Finder (Mac) и найдите папку, которую Claude Code создал в уроке 4. Кликните по ней — внутри будет что-то похожее на это:
Каждый файл — это лист с текстом. Каждая папка — коробка для листов. Всё. Никакой магии: это обычная файловая система, та же, где лежат ваши документы и фотографии. Разница только в том, что некоторые «листы» написаны на языке, который браузер понимает как инструкцию — «нарисуй заголовок», «поставь фото» [1].
Самый важный файл — page.tsx. Это и есть ваша страница. Откройте его в любом текстовом редакторе (даже в Блокноте) — внутри будет текст, похожий на смесь обычного языка и технических знаков. Это и есть тот код, который написал Claude Code. Вы его не обязаны понимать — но видеть, что он существует и это просто текст, — важно.
Расширение .tsx — что это? Это просто тип файла, как .docx для Word. Означает, что внутри — файл на языке TypeScript с HTML-подобными вставками. Звучит страшнее, чем есть. Браузер его не читает напрямую — перед показом фреймворк переводит его в обычный HTML. Подробнее — прямо в следующей части.
Часть 2. Что такое фреймворк — готовый каркас дома
Одно дыхание про Next.js — и больше не возвращаемся.
Когда строят типовой дом, никто не изобретает фундамент с нуля. Берут проверенный проект: стандартный фундамент, типовые перекрытия, известный набор коммуникаций. Строители знают его, материалы известны, ошибок меньше. Хозяин получает дом быстрее и дешевле — потому что не платит за изобретение того, что уже изобретено.
Next.js — это такой типовой проект для веб-страниц [1]. Claude Code использует его, потому что в нём уже есть: маршрутизация (у каждой страницы есть адрес), оптимизация картинок, hot reload (обновление в браузере без нажатия F5), и ещё пятьдесят вещей, которые вам не нужно знать. Вы говорите прорабу, что хотите — он строит на этом каркасе.
Где аналогия ломается: типовой дом сложнее переделать, чем построенный с нуля. Next.js тоже накладывает ограничения: некоторые нестандартные вещи делать сложнее. Для личной страницы-визитки это не важно. Для будущих больших проектов — учтите, что каркас выбирают под задачу.
Часть 3. Git — машина сохранёнок
В видеоиграх есть система сохранений. Прошли трудный уровень — сохранились. Пошли вперёд, провалились в ловушку — загрузили сохранёнку и попробовали по-другому. Никто не начинает игру заново только потому, что ошибся после трёх часов прохождения.
В проекте без сохранёнок всё иначе: сделали одно изменение, что-то сломалось, и непонятно, что именно и когда. Откатиться некуда. Прораб пытается угадать и исправить — иногда получается, иногда нет. git решает эту проблему [2].
Git — это программа, которая ведёт журнал всех изменений в вашем проекте. Каждая запись в журнале называется коммит. Коммит — это именованная точка: «добавил фото», «исправил цвет кнопки», «добавил третью ссылку». К любой из них можно вернуться [2].
Есть ещё одна вещь в git, которую стоит знать: ветка. Ветка — это параллельная версия проекта. Представьте: у прораба есть работающий дом — и рядом идёт стройка нового крыла. Крыло строят на «ветке», основной дом не трогают. Когда крыло готово — его «сливают» с основным домом. Если крыло не получилось — ветку просто удаляют, основной дом цел.
main). Коммиты на ней — это наши сохранёнки. Ветки появятся в жизни естественно, когда проект вырастет.
finansy_final_FINAL_v3_provereno_tochno.xlsx.— А это точно финальная версия?
— Нет, подожди, есть ещё
final_FINAL_copy2.Git — это именно про то, чтобы больше никогда не называть файлы вот так. Каждое изменение — в журнал, с именем и датой.
Часть 4. Закрепляем понятия
Разберём четыре слова, которые только что появились в вашем словаре. Убедитесь, что они сидят правильно — потом будет проще говорить с прорабом и читать его ответы.
Часть 5. Зачем это прорабу-нетеху
Честный вопрос: если Claude Code делает всё сам, зачем вам вообще знать, что такое файлы, фреймворк и git? Можно же просто говорить «сделай страницу» и не думать об остальном.
Можно. Но тогда вы попадаете в ситуацию хозяина, который не знает, где в его доме щиток. Он зависит от электрика при каждом вопросе: «а можно ли включить ещё один прибор?», «что значит этот мигающий индикатор?», «почему сработал автомат?». Пока электрик доступен — всё хорошо. Как только возникает мелкая проблема в воскресенье вечером — хозяин беспомощен.
Знание устройства проекта даёт три конкретные вещи:
Точнее ставить задачу
Когда вы знаете, что стиль лежит в globals.css, а страница — в page.tsx, вы говорите: «измени цвет только в globals.css, не трогай page.tsx». Это ограничение из урока 2, и теперь вы можете его произнести точно.
Замечать раньше, если что-то не туда
Если прораб говорит «удалил файл layout.tsx» — вы знаете, что это общая обёртка всех страниц, и задаёте вопрос: «зачем?» Без этого знания — просто соглашаетесь и потом удивляетесь, почему шапка пропала.
Не бояться смотреть на код
Код — это текст. Открыть файл и посмотреть глазами, что там написано, — это не программирование. Это просто чтение. Иногда достаточно увидеть своё имя внутри «текстового потока», чтобы понять: прораб написал верное имя или опечатался.
Часть 6. Первый коммит — делаем прямо сейчас
Теория позади. Делаем первую сохранёнку.
Откройте терминал с запущенным проектом из урока 4. Напишите Claude Code — одной задачей, по формуле из урока 2:
# Просим прораба сохранить точку:
Инициализируй git в папке проекта (если ещё не сделано)
и сделай первый коммит со всеми текущими файлами.
Назови коммит: "начальная версия страницы".
Объясни мне в двух предложениях, что именно ты сделал.
Claude Code инициализирует git в папке, добавит все файлы и создаст коммит. Он покажет вам, что сделал — и объяснит. После этого в вашем проекте есть первая именованная точка в журнале. Если завтра что-то сломается — всегда можно вернуться сюда [3].
Как часто делать коммиты? Правило одно: после каждого значимого шага, который «жалко потерять». Добавили блок — коммит. Поправили дизайн и понравилось — коммит. Не нужно ждать, пока проект «готов». Маленькие частые коммиты — это страховочная сетка. Один большой коммит в конце — это прыжок без сетки. Подробнее об этом в задании ниже.
Резюме
Код — это текст
Файлы проекта — обычные текстовые документы. Ничего магического. Открыть и посмотреть — не опасно.
Фреймворк — готовый каркас
Next.js сделан так, чтобы не строить стандартные вещи с нуля. Claude Code использует его как основу. Знать устройство изнутри не нужно — нужно знать, что он есть.
Git — журнал с точками отката
Коммит — именованная точка в истории проекта. Ветка — параллельная версия. Первый коммит сделан — сохранёнка есть.
Понимание = уверенность
Нетеху не нужно писать код. Но понимать, что файл существует, где он лежит и что коммит — точка отката — делает вас хозяином, а не гостем в своём проекте.
Что дальше, в Уроке 6 — «Данные и база»: страница собрана, первая сохранёнка сделана. Пора добавить «живой» элемент: форму, которая запоминает сообщения. В аналогии с домом — это кладовка, которая помнит, кто приходил. Разберём, что такое база данных без единой SQL-команды, и добавим гостевой блок на страницу.
Источники / Sources
-
docs
Vercel / Next.js team. «Getting Started — Project Structure» — структура файлов и папок проекта Next.js:
app/,public/,page.tsx,layout.tsx,globals.css,package.json. - docs Chacon, S., Straub, B. «Pro Git, 2nd ed. — Getting Started: About Version Control» — определение системы контроля версий, коммит как именованная точка отката, история изменений.
- docs Anthropic. «Claude Code — Git and GitHub workflow» — как Claude Code инициализирует git, создаёт коммиты и работает с историей проекта по запросу пользователя.