Первое приложение на Битрикс24 VibeCode за час: старт и честные лимиты облака

Что такое «приложение за час» и чего от него ожидать

Прежде чем запускать первый проект, полезно зафиксировать правильные ожидания. За час в VibeCode реально получить рабочий прототип уровня приложения Битрикс24: виджет или плейсмент, встроенный в интерфейс портала, автоматизацию через REST API, чат-бота в мессенджере. Это полноценный рабочий инструмент - просто не мегасистема с нуля.

Два примера, что реально успеть за один сеанс:

• Виджет быстрого отчёта в CRM - карточка в сделке, которая показывает агрегированные данные по контакту из нескольких сущностей.
• Телеграм-бот для уведомлений - приложение, которое слушает события портала (новая сделка, смена статуса) и отправляет сообщение в нужный чат.

Приложение крутится на стороне: бизнес-логика живёт на серверах Галактики/Black Hole или вашем сервере, обращается к порталу через REST API и встраивается через плейсменты. О том, что такое Битрикс24 VibeCode и как устроена платформа в целом, - в отдельном материале.

Шаг 0. Что нужно до старта

Доступ и подписка

VibeCode работает на сайте vibecode.bitrix24.tech. Для входа используются данные учётной записи Битрикс24.

Ключевые условия:

• Тариф. Подписка «BitrixGPT + Маркетплейс» оформляется только на платных тарифах Битрикс24. Для тестирования доступен 14-дневный триал на демо-портале; при первой оплате триал снимается, наработки и серверы остаются.
• Баланс вайбов. Внутренняя валюта платформы, курс 1:1 к рублю. На портал при старте начисляется 1 000 вайбов. Пакеты для пополнения: Стартовый (1 000 вайбов), Командный (5 000), Профи (25 000). При нулевом балансе новые запросы ограничиваются.
• API-ключ. Для первого знакомства достаточно ключа «для себя» (проще). Для командного приложения под правами пользователей нужен ключ авторизации (OAuth-приложение) - его создаёт администратор портала.

Бесплатные ИИ-модели

В облаке доступны бесплатные ИИ-модели с хостингом в РФ: BitrixGPT 5 / 5.5 / 5.5 Agent, GPT-OSS 120B, Gemma 4 26B (в том числе с thinking), Vision, Whisper. С июля 2026 они бесплатны в пределах ИИ-квоты по вашему тарифу (Pricing v2); сверх квоты вызовы идут с баланса вайбов. Подробнее о моделях - в статье Vibe API и бесплатные ИИ-модели BitrixGPT в VibeCode.

Шаг 1. Создаём API-ключ

1. Войдите на vibecode.bitrix24.tech через учётную запись Битрикс24.
2. Перейдите в раздел API-ключи → создайте новый ключ типа «Для себя».
3. Задайте скоупы - явно укажите, к каким данным и операциям будет доступ (CRM, задачи, чаты, диск). Ключ «только чтение для аналитики» не создаст сделку и не изменит данные - это намеренно.
4. Скопируйте ключ: он понадобится при постановке задачи ИИ-агенту.

Совет по безопасности. Для первого эксперимента используйте ключ с минимальными скоупами - только то, что нужно приложению. Если ключ окажется у посторонних, его можно отозвать в один клик. Подробнее - в статье Безопасность вайбкодинга в Битрикс24.

Шаг 2. Ставим задачу ИИ-агенту

VibeCode использует ИИ-агентов (Claude Code, Codex) для написания кода. Агент понимает задачи на естественном языке - программировать не нужно.

Как сформулировать задачу

Хорошая постановка содержит:

1. Что должно делать приложение - конкретное действие, а не абстрактное «автоматизировать продажи».
2. Где отображается - в карточке сделки, в боковой панели CRM, в мессенджере Битрикс24.
3. Какие данные использует - из каких сущностей читает/пишет.

Пример слабой задачи: «Сделай приложение для CRM».

Пример рабочей задачи: «Создай виджет в карточке сделки Битрикс24, который показывает список последних трёх задач по этой сделке с их статусами. Используй API-ключ [вставить ключ]. Встрой в плейсмент карточки сделки».

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

Скилл superpowers

Для работы с Vibe API у агента должен быть установлен скилл superpowers - это обязательное условие. Скилл ставится через интерфейс платформы или командой в чате.

Шаг 3. Генерация, предпросмотр, правки

После получения задачи агент:

1. Пишет код приложения.
2. Создаёт сервер Black Hole (закрытый облачный сервер, невидимый из интернета) - деплой занимает 1-2 минуты.
3. Разворачивает приложение на сервере.

Путь от запроса к работающему приложению: ИИ-агент получает промпт, пишет код, деплоит на сервер Black Hole, а сервер через REST API обменивается с порталом Битрикс24 и встраивается в интерфейс через плейсмент.

flowchart LR
    USER[Ваш запрос на языке] --> AGENT[ИИ-агент VibeCode]
    AGENT --> CODE[Пишет код]
    CODE --> BH[Сервер Black Hole]
    BH <-->|REST API| B24[Портал Битрикс24]
    B24 --> UI[Плейсмент / виджет в интерфейсе]

После деплоя приложение открывается в разделе Серверы Black Hole (если это UI-виджет) или в Мессенджере (если бот). Проверьте работу, внесите правки в чате с агентом - и снова деплойте. Цикл «правка → деплой» занимает минуты.

Шаг 4. Публикация приложения в портал

Когда прототип готов:

• Для себя / команды - приложение уже доступно через плейсмент в портале после деплоя. Дополнительной публикации не требуется.
• Для всего портала - администратор устанавливает приложение через раздел «Разработчикам» в настройках Битрикс24.
• В Маркетплейс - публикация приложений из VibeCode в Маркетплейс пока недоступна; функция готовится в следующих версиях платформы.

Стоимость серверов. Выключенный (спящий) сервер обходится примерно в 200-300 ₽/мес за место, micro-сервер - от 600 ₽/мес. Серверы можно усыплять и удалять, когда приложение не нужно.

Что можно и чего нельзя в облачной версии

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

Что работает через вайбкодинг в облаке

• Приложения и виджеты, встроенные в интерфейс через плейсменты.
• Автоматизации через REST API (создание/чтение/обновление сделок, задач, контактов, событий).
• Чат-боты в мессенджере Битрикс24.
• Использование ИИ-моделей (BitrixGPT, Gemma, GPT-OSS) внутри логики приложения.
• Интеграции с внешними сервисами через вебхуки и REST.
• Доступ к 300+ методам Vibe API, 41 сущности с полным CRUD.

Чего нельзя в облаке через вайбкодинг

• ❌ Менять исходный код ядра и стандартных компонентов Битрикс24.
• ❌ Писать серверный PHP внутри портала.
• ❌ Добавлять кастомные типы полей или сущностей на уровне базы данных портала.
• ❌ Напрямую обращаться к базе данных портала.
• ❌ Обходить лимиты REST API - частоту запросов и доступность методов на конкретном тарифе.
• ❌ Править системные шаблоны и дизайн ядра.

Ключевой вывод: «приложение за час» - это инструмент поверх Битрикс24, а не переделка облака изнутри. Глубокие изменения на уровне кода и базы данных портала через вайбкодинг невозможны - для них нужна коробочная (self-hosted) версия.

Облако vs коробка: сравнение возможностей вайбкодинга

Если вашей задаче достаточно возможностей REST API - облако подойдёт. Если нужны глубокие изменения ядра, прямая работа с БД или коробочные модули - это тема для отдельного разговора. Читайте подробнее в статье Переход с облачного Битрикс24 на коробку: когда нужен и как сделать.

Типичные ошибки при первом запуске

• Слишком общая задача. «Автоматизируй работу отдела» - агент не поймёт. Начинайте с одного конкретного действия.
• Лишние скоупы в ключе. Выдавать полный доступ для тестового проекта - плохая практика. Ограничьте ключ нужными сущностями.
• Ожидание изменений в ядре. Если задача звучит «измени стандартную форму сделки» - это за пределами облачного вайбкодинга.
• Игнорирование лимитов REST API. Часть методов недоступна на младших тарифах; при высокой частоте запросов возможны ограничения. Если приложение «тормозит» - проверьте логи в разделе «Разработчикам».
• Забыли усыпить сервер. Неиспользуемый активный сервер продолжает тарифицироваться. После тестирования переводите в режим сна.

Когда вайбкодинг - не тот инструмент

VibeCode отлично подходит для проверки гипотез и быстрых внутренних инструментов. Но есть случаи, когда лучше сразу идти другим путём:

• Нужна сложная интеграция с 1С с двусторонней синхронизацией и обработкой нагруженных очередей - здесь лучше классическая разработка через REST API или коробочный модуль. Подробнее - в статье Интеграция Битрикс24 и 1С: 3 рабочих сценария.
• Требуется изменить логику стандартных роботов и триггеров на уровне ядра - только коробка.
• Высокие требования к производительности и нагрузочному тестированию - прототип из VibeCode стоит перенести в полноценную разработку после проверки идеи.
• Публикация в Маркетплейс - функция пока недоступна, готовится в следующих версиях.

Проверенный подход: сначала собрать прототип в VibeCode, убедиться в ценности инструмента, затем принять решение - оставить как есть или перенести в полноценную разработку с разработчиком.

С чего начать прямо сейчас

Самый быстрый старт:

1. Откройте vibecode.bitrix24.tech, войдите через Битрикс24.
2. Создайте API-ключ с минимально необходимыми скоупами.
3. Опишите одну конкретную задачу в чате с агентом.
4. Дождитесь деплоя (1-2 минуты), проверьте результат в портале.
5. Уточняйте в том же чате - агент помнит контекст.

Если вы не уверены, подойдёт ли облако под вашу задачу или нужна коробка - АС Проект (платиновый партнёр Битрикс24) поможет разобраться и выбрать подходящий путь без лишних экспериментов.

Что нового к июлю 2026

• AI-квоты (Pricing v2). Бесплатные модели теперь бесплатны в пределах квоты по тарифу, сверх - с баланса вайбов.
• Галактики стали основным способом деплоя (десятки приложений на одном хосте по нулевой цене за место).
• Полные бэкапы серверов (код + данные + файлы) - по кнопке или расписанию.
• Новое в API: расшифровки звонков (/v1/activities/:id/transcript), База знаний 2.0 (/v1/note), эмбеддинги (/v1/embeddings).

Данные на июль 2026 - платформа VibeCode в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией VibeCode.

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