Вайб-кодинг приложений: от идеи до работающего MVP с агентом

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

Выберите маленькую задачу

MVP для агента должен помещаться в одну фразу и в два-три экрана. Примеры: трекер задач для команды из пяти человек, форма записи на приём с календарём, личный кабинет с загрузкой файлов. Плохие примеры: «маркетплейс», «социальная сеть», «CRM для всех». Чем шире задача, тем больше агент додумывает сам, и тем сложнее потом проверить результат.

Перед запуском агента напишите короткое задание в файле SPEC.md:

• кто пользователь и что он делает за 2–3 шага;
• список экранов и данных, которые хранятся;
• чего в первой версии точно нет (платежи, роли, уведомления);
• как вы поймёте, что всё работает (три сценария, которые можно пройти руками).

Этот файл агент будет перечитывать, а вы получите критерий приёмки.

Стек: бери скучное

Агент лучше всего справляется с тем, что много раз встречалось в открытом коде. Для первого MVP хватит одной связки, где всё в одном репозитории:

Это не рекомендация «единственно верного» стека, а способ уменьшить число мест, где агент может ошибиться. Если вы уже знаете другой стек, берите его: проверять код вам, и вы должны его читать.

Подключите агента

Для сборки приложения подходят консольный агент вроде Claude Code или плагин в IDE. Claude Code настраивается через переменные окружения:

export ANTHROPIC_BASE_URL="https://api.zukko.pro"
export ANTHROPIC_AUTH_TOKEN="fetch_ваш_ключ"
export ANTHROPIC_MODEL="claude-sonnet-5-5"
claude

Адрес здесь без /v1, потому что Claude Code добавляет путь сам; переменная именно ANTHROPIC_AUTH_TOKEN. Подробности и подводные камни разобраны в документации по Claude Code↗. Если вам удобнее редактор, например Cursor, там используется OpenAI-совместимый адрес https://api.zukko.pro/v1, а точные пункты настроек лучше сверить с документацией самого редактора.

Модель для основной работы можно взять из середины таблицы: claude-sonnet-5-5, индекс силы 48. Для сложных мест (архитектура, трудный баг) переключитесь на claude-opus-5-5, индекс 58. Какая модель справляется с вашим проектом, проверьте на своих задачах: цифры индекса не заменяют пробу.

Правила для агента

Положите в корень проекта файл CLAUDE.md (или правила вашего редактора) с короткими инструкциями. Как его писать, показано в статье про CLAUDE.md↗. Минимум:

Прочитай SPEC.md перед любой задачей.
Делай по одному шагу и после каждого запускай тесты.
Не добавляй зависимости без вопроса.
Секреты берём только из переменных окружения, в код их не пишем.
Миграции базы пишем отдельными файлами, существующие не правим.

Работайте маленькими шагами

Рабочий цикл выглядит так:

1. Попросите агента создать каркас: структура папок, пустые экраны, подключение к базе, один тест.
2. Запустите и убедитесь, что приложение открывается. Закоммитьте.
3. Просите по одной функции: «добавь создание задачи с валидацией и тестом».
4. После каждой функции пройдите сценарий руками и закоммитьте.
5. Если агент застрял на одной ошибке больше двух попыток, остановите его и опишите проблему своими словами, иначе он начнёт переписывать лишнее.

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

База данных

Базу нельзя отдавать агенту целиком. Договоритесь о правилах:

• схема меняется только через файлы миграций, которые вы читаете перед применением;
• у агента нет доступа к рабочей базе, только к локальной тестовой;
• перед каждой миграцией на проде делается копия;
• команды вроде DROP и DELETE без условия вы выполняете сами.

Эти правила занимают пять минут и защищают от самой неприятной ошибки: потери данных пользователей.

Деплой

Попросите агента подготовить Dockerfile и короткую инструкцию запуска, но выкладывайте сами. Проверьте, что: секреты лежат в переменных окружения сервера, режим отладки выключен, база лежит на постоянном диске, а не внутри контейнера, настроено резервное копирование. После выкладки пройдите те же три сценария из SPEC.md на живом адресе.

Где обязательно нужен человек

Агент пишет код, но ответственность остаётся за вами. Вручную проверяйте:

• Авторизацию и права доступа. Попробуйте открыть чужие данные под другим пользователем.
• Работу с деньгами и персональными данными. Любые платежи и хранение личных данных требуют отдельной проверки и знания требований закона.
• Зависимости. Агент может добавить лишний или неподдерживаемый пакет.
• Секреты. Ключи не должны попасть в репозиторий. Если это всё же случилось, сразу отзовите ключ в кабинете и создайте новый.
• Понимание кода. Если вы не можете объяснить, что делает модуль, попросите агента объяснить его и перепроверьте ответ по коду.

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

Цены на 18 октября 2026: claude-sonnet-5-5 стоит $0.4 за 1M токенов входа и $2 за 1M выхода, чтение кэша $0.05, запись кэша $0.5. В Anthropic-формате (Claude Code) шлюз видит кэш, поэтому повторяющийся контекст считается по цене чтения.

Пример: одна функция, 20 запросов агента. В каждом запросе 27 000 токенов контекста читаются из кэша, 3 000 новых токенов записываются в кэш, ответ 1 000 токенов (допущения для иллюстрации, ваши цифры будут другими).

• Чтение кэша: 20 × 27 000 = 540 000 токенов × $0.05 / 1M = $0.027
• Запись кэша: 20 × 3 000 = 60 000 × $0.5 / 1M = $0.03
• Выход: 20 × 1 000 = 20 000 × $2 / 1M = $0.04
• Итого: $0.027 + $0.03 + $0.04 = $0.097

Реальный счёт зависит от размера проекта и числа правок. Лимиты расхода на ключ задавайте заранее: как ограничить расход API-ключа↗. Актуальные цены: GET https://api.zukko.pro/v1/models или страница «Модели» в кабинете.

Чтобы начать, создайте ключ в кабинете↗, пополните баланс (СБП, MasterCard или криптовалюта) и запустите агента на пустом репозитории с SPEC.md.

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

Можно ли собрать приложение, не умея программировать?

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

Какой агент выбрать для первого приложения?

Подойдёт любой, который читает файлы проекта и запускает команды. Выбирайте по привычному интерфейсу: терминал или редактор. Подключение обоих вариантов к шлюзу описано в документации Zukko.

Почему агент ломает то, что работало раньше?

Чаще всего потому, что нет тестов и мелких коммитов. Просите писать тест вместе с каждой функцией и запускать весь набор после правок.

Сколько стоит довести MVP до конца?

Это зависит от объёма проекта и числа итераций. Посчитайте один шаг по формуле выше, умножьте на примерное число шагов и поставьте дневной лимит на ключ.