Вайб-кодинг: как начать и сделать первый проект за вечер

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

С чего начать: выбор первого проекта

Главная ошибка первого вечера — слишком большая цель. Хороший первый проект обладает тремя свойствами:

• результат можно проверить глазами за минуту;
• всё помещается в один-два файла;
• вы сами пользуетесь итогом.

Примеры: скрипт, который раскладывает файлы из папки «Загрузки» по подпапкам по расширению; утилита, которая переименовывает фотографии по дате; консольный конвертер CSV в Markdown-таблицу; телеграм-бот из двадцати строк. Для статьи возьмём первый вариант: сортировщик файлов. Он наглядный, безопасный при условии, что сначала запускается в режиме «только показать, что будет сделано», и не требует внешних сервисов.

Выбор инструмента

Для вайб-кодинга для начинающих подходят три типа инструментов:

Если вы совсем впервые, начните с редактора и расширения: изменения видны подсветкой, а откатить их проще. Если терминал вас не пугает, возьмите агента из третьей строки. Про подключение Claude Code к Zukko — в документации↗. Точные команды установки и названия пунктов меню берите из документации самого инструмента: они меняются от версии к версии.

Модель для первого проекта не нужно выбирать долго. Для старта подойдёт claude-sonnet-5-5 или gpt-6.1-sol. Если хочется проверить идею по минимальной цене, можно взять deepseek-v4.1-flash. Проверьте на своей задаче, что результат вас устраивает, и меняйте модель, если нет. Актуальные цены и список: GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

Шаг 1. Создайте папку и репозиторий

Прежде чем просить нейросеть что-либо писать, заведите git. Это ваша страховка от случая, когда агент «улучшил» всё до неузнаваемости.

mkdir file-sorter && cd file-sorter
git init

Сделайте первый коммит с пустым README.md. С этой точки вы всегда можете вернуться.

Шаг 2. Подключите модель

Создайте ключ в кабинете↗ и поставьте на него дневной лимит, например $2: так даже ошибочный цикл агента не уйдёт далеко. В расширениях для редактора выбирайте провайдера «OpenAI Compatible», Base URL https://api.zukko.pro/v1, ключ вида fetch_.... Для Claude Code адрес другой: ANTHROPIC_BASE_URL=https://api.zukko.pro без /v1, а токен кладётся в ANTHROPIC_AUTH_TOKEN. Какой формат нужен именно вашему инструменту, подскажет страница выбора провайдера↗.

Шаг 3. Поставьте задачу так, чтобы её можно было проверить

Слабая постановка: «сделай программу для сортировки файлов». Рабочая постановка включает входные данные, ожидаемое поведение и границы:

Напиши на Python 3 скрипт sorter.py без внешних зависимостей.
Он принимает путь к папке и раскладывает файлы по подпапкам по расширению:
images (jpg, png, gif), docs (pdf, docx, txt), archives (zip, rar), other.
Требования:
- по умолчанию только печатает, что будет перемещено (режим --dry-run включён);
- реальное перемещение — только с флагом --apply;
- не трогает вложенные папки;
- при конфликте имён добавляет суффикс _1, _2.
Не добавляй ничего сверх перечисленного.

Последняя строка важна: агенты любят «заодно» добавлять логирование, конфиги и тесты на сорок файлов. Для первого вечера это шум.

Шаг 4. Итерации: маленькие шаги вместо одного огромного запроса

Получили первую версию — не просите сразу всё переписать. Ритм такой:

1. Запустили скрипт в режиме --dry-run на тестовой папке.
2. Сравнили вывод с ожиданием.
3. Сформулировали одно замечание: «файлы без расширения должны попадать в other, сейчас скрипт падает».
4. Получили правку, снова запустили.

Одно замечание за итерацию даёт читаемый diff и быстро показывает, что именно сломалось. Если агент застрял на одном месте три итерации подряд, не продолжайте спорить: откатитесь коммитом, переформулируйте задачу и начните чистый диалог. Длинная переписка раздувает контекст и расход токенов.

Шаг 5. Проверка результата

Вайб-кодинг не отменяет проверку, он её смещает на вас. Минимальный набор:

• создайте тестовую папку с десятком файлов, включая файл без расширения, файл с двумя точками в имени и дубликаты;
• запустите с --dry-run и прочитайте вывод;
• только затем запустите с --apply на копии папки;
• попросите модель объяснить код построчно, и если что-то непонятно, спросите, зачем это нужно.

Последний пункт превращает вайб-кодинг в обучение. Через несколько проектов вы начнёте замечать лишнее сами.

Шаг 6. Git: коммит после каждого рабочего состояния

git add -A
git commit -m "sorter: dry-run and apply modes"

Правило простое: рабочая версия закоммичена до следующей просьбы к агенту. Когда он сломает то, что работало, git diff покажет, что изменилось, а git restore . вернёт файлы.

Сколько это стоит

Небольшой проект за вечер — это десятки коротких запросов. Для оценки возьмём условное допущение и цены на 18 октября 2026: 40 запросов по 8 000 токенов входа и 1 000 токенов выхода на claude-sonnet-5-5 (0.4 / 2 за 1M токенов). Вход: 40 × 8 000 = 320 000 токенов × 0.4 / 1 000 000 = $0.128. Выход: 40 × 1 000 = 40 000 × 2 / 1 000 000 = $0.08. Итого около $0.21 без учёта кэша. Реальный расход зависит от размера проекта и поведения агента, поэтому лимит на ключе — лучшая защита. Ещё про расходы агента: сколько реально стоит час работы с агентом↗.

Частые вопросы

Нужно ли уметь программировать, чтобы начать вайб-кодинг?

Для первого проекта не обязательно, но понимать базовые вещи (файл, папка, терминал, git) нужно. Без этого вы не сможете проверить результат, а проверка и есть ваша часть работы.

Какой первый проект лучше всего выбрать?

Маленькую утилиту с проверяемым результатом: сортировщик файлов, конвертер форматов, простой бот. Избегайте проектов с авторизацией, оплатой и базой данных: ошибки там дорогие.

Как не потерять деньги, если агент зациклится?

Задайте дневной лимит на ключе и следите за расходом в разделе «Использование» кабинета. Лимит задаётся в долларах при создании или редактировании ключа.

Что дальше после первого проекта?

Добавьте в проект файл с инструкциями для агента (для Claude Code это CLAUDE.md, подробнее в нашей статье как написать CLAUDE.md↗), а затем возьмите задачу побольше. Чтобы подключиться, создайте ключ в кабинете и вставьте его в настройки выбранного инструмента.