Как работать с порталом
Пошаговый гайд: что где находится, как создать проект, как открыть VS Code и где Claude.
Портал живёт на vibe.paav.ru. Если ты уже зарегистрирован — нажми «Войти →», введи логин и пароль. Если ты новый ученик — попроси администратора создать тебе аккаунт.
В шапке: PAVLOV — логотип, 4 таба (VS Code, Проекты, Курс, Материалы), справа — кнопки Claude, тема, история, настройки.
На таб’е «VS Code» — большая серая кнопка «Открыть → VS Code». Слева от неё — состояние контейнера (Вкл/Выкл) с таймером авто-стопа.
Таблица: Тип, Статус, Название, Автор, Дата, Действия. По кнопкам: 📁 Файлы, CLAUDE (чат по проекту), VS Code, 🗑 Удалить (в архив .deleted/).
Две кнопки сверху: + Пустой (пустая папка) и + Шаблон (выбор из двух базовых шаблонов).
В строке проекта — кнопка CLAUDE. Открывается левая панель: сессии, выбор модели (sonnet/opus), история, attachments. Справа сверху — общий помощник Claude (по всему workspace).
Кнопка 📁 в строке проекта — открывает встроенный просмотрщик файлов. Дерево слева, содержимое справа.
У тебя свой Docker-контейнер (1.5GB RAM / 1 CPU). Авто-останавливается через 30 мин простоя. Таймер виден сверху. Workspace сохраняется — следующий клик «Открыть VS Code» подымет контейнер за 2–4 сек.
Шпаргалка по Claude Code
Горячие клавиши, slash-команды и флаги CLI. Подходит для печати на A4.
claude # открыть Claude Code claude --dangerously-skip-permissions # без запросов разрешений
--dangerously-skip-permissions — Claude не будет спрашивать «разрешить?» на каждое действие. Удобно для быстрой работы, но давай только в своём проекте.
free -h && df -h / && ps aux --sort=-%mem | head -10
free -h — оперативная память (всего / занято / свободно) ·
df -h / — диск ·
ps aux --sort=-%mem | head -10 — топ-10 процессов по RAM
Shift+Tab | режим: normal → auto-accept (▶▶) → plan |
! команда | выполнить bash прямо из Клода |
# текст | сохранить факт в память (MEMORY.md) |
@путь | вставить файл/папку в контекст |
Esc | прервать текущий ответ |
Esc Esc | откатиться к прошлому сообщению |
Ctrl+C ×1 | отменить ввод |
Ctrl+C ×2 | выйти из Клода |
Ctrl+Z / fg | приостановить / вернуть |
Ctrl+U | стереть строку ввода |
Ctrl+B | фоновая задача (если включено) |
← ← | войти в Agent View |
! и @ работают только в начале строки. # — в любой момент.
| Сессии | |
|---|---|
/resume | список прошлых сессий папки |
/clear | начать новую (старая сохранится) |
/compact | сжать длинный контекст |
/exit | выйти |
| Контекст и память | |
/init | создать CLAUDE.md проекта |
/memory | открыть MEMORY.md |
/add-dir | добавить папку в рабочую область |
/status | модель, токены, id сессии |
| Настройка | |
/config | тема, модель и пр. |
/model | Opus / Sonnet / Haiku |
/permissions | что разрешено без спроса |
/login /logout | аккаунт |
| Работа с кодом | |
/review | ревью пулл-реквеста |
/security-review | аудит безопасности |
/agents | список сабагентов |
/help | вся справка |
| Вход / выход | |
|---|---|
← ← | войти из обычной сессии (дважды) |
claude agents | открыть в новом терминале |
→ | вернуться в свою сессию |
| Навигация | |
↑ ↓ | листать карточки |
Enter | войти в сессию (полный экран) |
← | из сессии обратно в список |
? | все горячие клавиши |
| Действия над сессией | |
Space | peek — написать не входя |
Ctrl+R | переименовать |
Ctrl+T | закрепить (pin) |
Ctrl+X | остановить (история сохранится) |
Статусы карточек: ● needs input · ждёт ответа ● working · думает ● completed · готово ● error · упал
--cwd ~/path | фильтр по папке |
--model opus | модель по умолчанию |
--resume <id> | оживить конкретную сессию |
-c / --continue | продолжить последнюю в папке |
-p "промпт" | print-mode: один запрос, без TUI |
--output-format stream-json | стрим NDJSON для скриптов |
CLAUDE.md — память проекта
Обычный Markdown-файл с особым именем. Claude Code читает его первым делом в начале каждой сессии и сразу понимает контекст — как записка новому сотруднику.
.md — это обычный текстовый файл (Markdown). Вы пишете текст и пару значков, а файл «оживает»: где-то заголовок, где-то список, где-то жирное слово. Открывается где угодно, лёгкий, понятен и человеку, и ИИ.
CLAUDE.md — такой же Markdown, но с особым именем и ролью: это записка для ИИ-помощника о вашем проекте. Лежит в главной папке проекта, рядом с остальными файлами.
CLAUDE.md — та самая записка, только для ИИ.
| Напечатать | Получится |
|---|---|
# Заголовок | крупный заголовок |
## Поменьше | подзаголовок |
**жирный** | жирный |
*курсив* | курсив |
- пункт | маркированный список |
1. пункт | нумерованный список |
[текст](ссылка) | ссылка |
`код` | код в строке |
90% случаев: # для заголовков, - для списков, ** вокруг слова для жирного. Этого хватит на старте.
Без него ИИ каждый раз начинает «с чистого листа». С ним — работает как сотрудник, который уже в курсе дела.
| 🔁 Не повторяться | Один раз записали правила — не объясняете одно и то же в каждом разговоре. |
| 🎯 Точнее результат | Помощник знает проект и реже делает не то, что вы хотели. |
| 🎨 Единый стиль | Код и тексты в одном стиле — правила лежат в одном месте. |
| ⚡ Быстрее старт | Новый человек или ИИ сразу видит, как всё устроено. |
Коротко и по делу — то, что рассказали бы новому помощнику:
- Что за проект — пара предложений.
- Как запускать — команды или шаги.
- Правила и стиль — язык, цвета, как оформлять.
- Чего избегать — что точно не нужно делать.
# Мой проект Сайт-визитка для кофейни. Делаю в одиночку. ## Как запускать - Открыть `index.html` двойным кликом — работает без установок. ## Стиль - Тексты на русском, дружелюбно и просто. - Цвета: бежевый фон, коричневый акцент. - Только чистый HTML и CSS, без сложных библиотек. ## Чего избегать - Без рекламы и всплывающих окон. - Не усложнять код — он должен быть понятен новичку.
Чёткой схемы нет, но удачный файл обычно содержит блоки:
| Назначение | Что это и для чего — пара строк сверху. |
| Структура | Где что лежит, ключевые файлы и папки. |
| Правила работы | Договорённости: «сначала прототип», «секреты — мимо репо». |
| Команды | Как запускать, какие MCP подключены. |
| Стиль и ограничения | Чего делать не нужно, на каком языке отвечать. |
~/.claude/CLAUDE.md (глобально, для всех проектов) и ./CLAUDE.md (этот проект). Локальный дополняет и переопределяет глобальный.
CLAUDE.md (с большими буквами) · кладите его в главную папку проекта · пишите коротко (лучше 10 понятных строк, чем 3 страницы) · обновляйте, когда правила меняются.
claude.txt или Claude.MD — не сработает · забыть значки Markdown — текст «слипнется» · писать «воду» вместо конкретики · положить файл не в ту папку.
.md — это текст, который умеет красиво оформляться, а CLAUDE.md — записка о проекте для ИИ-помощника. Всё остальное — детали. Создать заготовку в проекте можно командой /init.
Папка .claude изнутри
Всё, что настраивает поведение Claude Code в проекте, лежит в .claude/. Рядом — CLAUDE.md (память) и .mcp.json (внешние инструменты). Каждая папка внутри — отдельный тип расширения.
проект/
├── CLAUDE.md # память и правила проекта
├── .mcp.json # MCP-серверы (общие для команды)
└── .claude/
├── settings.json # права, хуки, тумблеры MCP
├── settings.local.json # личные настройки (в .gitignore)
├── skills/ # навыки (SKILL.md)
├── commands/ # слэш-команды (/имя)
├── agents/ # субагенты
├── hooks/ # скрипты на события
└── output-styles/ # стили вывода (тон ответов)
| Сущность | Где | Что делает |
|---|---|---|
| CLAUDE.md | корень / ~/.claude/ | Память и правила. Грузится в контекст всегда. |
| skills | skills/<имя>/SKILL.md | Навыки «как делать X». Вызываются по запросу. |
| commands | commands/<имя>.md | Слэш-команды /имя — шаблон запроса. |
| agents | agents/<имя>.md | Субагенты со своим набором инструментов. |
| hooks | hooks/ + settings | Скрипты на события. Запускает сам harness. |
| output-styles | output-styles/<имя>.md | Меняют манеру ответов Claude. |
| .mcp.json | корень | Внешние серверы инструментов (Figma, Playwright…). |
| settings.json | .claude/ | Права, env, хуки, тумблеры MCP. |
Переиспользуемый «рецепт»: как делать X (процесс, правила, чек-листы). Claude подгружает скилл только когда он нужен (по полю description), а не держит в контексте всегда — это экономит память.
Где: .claude/skills/<имя>/SKILL.md · Вызов: авто по смыслу или /имя
--- name: commit-style description: Use when writing git commits — формат сообщений --- # Стиль коммитов 1. Заголовок ≤ 50 символов, в повелительном наклонении. 2. Тело: что и зачем, не «как».
В этом портале скиллы дают superpowers (brainstorming, test-driven-development, systematic-debugging) и ui-ux-pro-max (стиль, палитра, шрифты под задачу).
Готовый шаблон запроса, который запускается командой /имя. Удобно для действий, которые повторяешь часто. Аргументы подставляются через $ARGUMENTS.
Где: .claude/commands/<имя>.md · Вызов: /имя аргументы
--- description: Ревью текущих изменений по чек-листу argument-hint: [папка или файл] allowed-tools: Read, Grep, Bash(git diff:*) --- Проверь изменения в $ARGUMENTS на баги, безопасность, читаемость. Дай список замечаний с приоритетами.
Отдельный «работник» со своим набором инструментов и чистым контекстом. Главный Claude поручает ему узкую задачу, тот выполняет и возвращает только результат — основной диалог не засоряется. Можно запускать несколько параллельно.
Где: .claude/agents/<имя>.md · Вызов: авто или явно «через субагента»
- Тяжёлый поиск по кодовой базе — субагент перелопачивает сотни файлов, главный контекст чист.
- Параллельные варианты — три субагента дают 3 наброска одновременно.
- Ограничение прав — ревьюеру дать только
Read/Grep, он физически не сможет ничего изменить.
Shell-команды, которые сам Claude Code (не модель!) запускает на событие: старт сессии, перед/после вызова инструмента, остановка. Поэтому хуки — для гарантированных действий, которые должны срабатывать всегда.
Где: .claude/hooks/ + регистрация в settings.json · События: SessionStart, PreToolUse, PostToolUse, Stop…
"hooks": {
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{ "type": "command",
"command": "npx prettier --write \"$CLAUDE_FILE_PATHS\"" }]
}]
}
Меняют манеру и тон ответов Claude, не трогая логику работы. Один запрос можно получить «по-инженерному кратко» или «как от наставника с пояснениями».
Где: .claude/output-styles/<имя>.md · Вызов: команда /output-style
--- name: Наставник description: Объясняет каждый шаг простыми словами --- Перед действием говори ЧТО и ЗАЧЕМ делаешь. После — что получилось и как проверить.
Главный конфиг поведения: права (что можно без спроса, что спросить, что запретить), переменные окружения, регистрация хуков и тумблеры MCP. Личное (не для репозитория) выносят в settings.local.json (в .gitignore).
{
"permissions": {
"allow": ["Read", "Bash(git diff:*)"],
"ask": ["Bash(git push:*)"],
"deny": ["Read(./.env)"]
},
"enabledMcpjsonServers": ["figma", "pencil"]
}
Read, git diff) в allow → Claude не дёргает разрешением на каждом шаге. Опасное (git push, .env) — в ask/deny.
MCP (Model Context Protocol) — стандарт, по которому Claude подключается к внешним «серверам инструментов». Каждый сервер добавляет реальные действия: Figma — дизайн, Playwright — браузер, Context7 — свежая документация. Конфиг проекта — .mcp.json (коммитится, шарится на команду).
{
"mcpServers": {
"figma": {
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": { "FIGMA_API_KEY": "${FIGMA_API_KEY}" }
}
}
}
- Получить токен. Figma → Settings → Security → Personal access tokens.
- Положить токен в окружение. В
~/.zshrc:export FIGMA_API_KEY="figd_…", перезапустить терминал. - Описать сервер в
.mcp.json(блок как выше). - Разрешить сервер — добавить имя в
enabledMcpjsonServersвsettings.json. - Перезапустить Claude Code и проверить статус командой
/mcp(должен быть connected).
env и ${...}, а не текстом: .mcp.json коммитится в git. Быстрая альтернатива JSON: claude mcp add figma -- npx -y figma-developer-mcp --stdio.
Шаблоны проектов
Скачай готовый шаблон-заготовку и распакуй у себя в проекте. Внутри — структура, системные файлы и CLAUDE.md с инструкциями для Claude.
Каркас vibe-проекта: src/, deploy-скрипт, базовые настройки и CLAUDE.md с онбордингом для ученика. Хорош как старт для своего приложения.
Готовый single-PHP шаблон приложения Битрикс24: www/, REST-обвязка, deploy-скрипт, инструкции в CLAUDE.md.
Тот же стек, что и базовый, плюс память проекта (docs/ + автокоммиты): что делали, где сейчас, куда идём. Для передачи проекта другому исполнителю без потери контекста.
Как опубликовать приложение
Публикация делает твой проект доступным по ссылке внутри портала. Открыть его смогут только авторизованные — ты, админ и (по желанию) другие ученики.
На вкладке Проекты в строке проекта нажми иконку «Публикация» (стрелка вверх ↥). Откроется окно настроек.
- Опубликовать приложение — поставь галочку, чтобы включить.
- Кто может смотреть — «Только я и админ», «Все залогиненные ученики» или «Публично» (внешние пользователи без входа — например, чтобы показать клиенту).
- Авто-засыпание — если включено, приложение засыпает вместе с контейнером через 30 минут простоя и само поднимается при следующем заходе. Выключи, если приложение должно работать постоянно.
Нажми Сохранить. Появится ссылка вида
vibe.paav.ru/<твой-логин>/<проект>/ — её можно скопировать и открыть.
Если ты изменил код приложения — открой окно публикации и нажми «Деплой». Это перезапустит приложение с новой версией кода. Заодно деплой поднимет приложение, если оно «спит».
- Приложение запускается прямо в твоём контейнере (как и VS Code) — отдельный сервер не нужен.
- Node-проекты (есть
package.json) и PHP-проекты (папкаwww/) поднимаются автоматически — настраивать ничего не надо. - Подключай стили и скрипты относительным путём (
css/style.css, а не/css/style.css) — приложение живёт под адресом/<логин>/<проект>/. - По умолчанию ссылка работает только для вошедших в портал. Вариант «Публично» открывает приложение всем по ссылке (без входа) — удобно показать клиенту, но не публикуй так черновики и ничего с секретами.
Установленные скиллы
Скиллы — переиспользуемые промпт-инструкции для Claude. Один раз описал процесс → навсегда упаковал в команду. Загружаются автоматически когда подходят по контексту.
Скилл — это markdown-файл, который превращает отлаженный промпт в вызываемую slash-команду. Вместо того чтобы вспоминать точную формулировку, пишешь одно имя: /review-pr, /frontend-design, /mcp-builder.
Claude подгружает скилл только когда он нужен (по полю description), а не держит в контексте постоянно — это экономит токены.
~/.claude/
├── commands/ ← /slash-команды
│ └── my-cmd.md
└── skills/ ← авто-навыки
└── superpowers/
└── SKILL.md
- ✓ Работает во всех проектах
- ✓ Только на твоём компьютере
- ✗ Не попадает в git
- ✗ Команда не видит
перекрывает
глобальное
project/
└── .claude/
├── commands/ ← /slash-команды
│ └── deploy.md
├── skills/ ← авто-навыки
│ └── review/
│ └── SKILL.md
└── agents/ ← субагенты
└── tester.md
- ✓ Только в этом репозитории
- ✓ Версионируется в git
- ✓ Вся команда использует
- ✗ Другие проекты не видят
| Тип | Путь | Вызов | Назначение |
|---|---|---|---|
commands | .claude/commands/имя.md | /имя аргументы | Шаблон запроса — запускается вручную |
skills | .claude/skills/имя/SKILL.md | авто по смыслу или /имя | Рецепт процесса — как делать X |
agents | .claude/agents/имя.md | Claude сам выбирает | Субагент со своим набором инструментов |
Три разных механизма. Главное отличие — кто и когда запускает.
/deploy main
──────►
commands/имя.md
/имя аргументы$ARGUMENTS.skills/имя/SKILL.md
descriptionagents/имя.md
--- name: review-pr description: Use when reviewing a pull request argument-hint: "<pr-number>" allowed-tools: Read, Bash(gh pr:*) --- Просмотри PR #$ARGUMENTS. Проверь: логика, edge cases, безопасность, читаемость. Дай структурированный отчёт: Critical / Warning / Suggestion.
Совет: Скиллы версионируются в git вместе с кодом — это инфраструктура команды, а не одноразовые заметки.
- Открой Claude Code в папке проекта, напиши и отладь промпт.
- Скажи: «Преврати эту логику в переиспользуемый скилл /review-pr, принимающий номер PR как аргумент».
- Claude сохранит файл в
.claude/commands/или.claude/skills/. - Добавь файл в git — теперь он у всей команды.
Установлены в контейнере каждого ученика. Кликни на карточку — откроется репозиторий для установки.
Полезные ссылки
Веб-сервисы и документация. Программы для установки — в разделе «Полезный софт».
Документация и справочники
- apidocs.bitrix24.ru — справочник REST API
- CRM widgets — встраивание в карточки CRM
- OAuth tokens — токены и обновление
- vibecode.bitrix24.tech — главная
- Quickstart
- llms-full.txt — справочник для AI
Полезный софт
Программы, которые упрощают работу. Сгруппированы по назначению — версии для Mac и Windows рядом.
Редактор кода
Основной инструмент: десктопный VS Code с расширением Claude Code. На портале он уже стоит — это для работы офлайн / на своей машине.
AI-редакторы · альтернативы
Не обязательны — мы работаем в Claude Code. Но полезно знать, что есть рядом.
Голосовой ввод · диктовка
Handy — бесплатная программа распознавания речи. Зажал горячую клавишу, проговорил мысль — текст сам вставляется в активное поле (чат с Claude, редактор, браузер). Работает офлайн, аудио никуда не уходит. Лучшая модель для русского — GigaAM v3 (как её включить — в шагах ниже).
winget install cjpais.HandyНе знаешь, какой у тебя Mac? Меню Apple → «Об этом Mac» → строка «Чип». Всегда свежая версия и другие платформы (Linux, ARM-Windows) — на handy.computer/download.
GigaAM v3 от Сбера — лучшая на сегодня модель распознавания русской речи: знаки препинания, цифры, латиница. ~225 МБ, работает на CPU. Ставится прямо из Handy:
- Открой Handy → Settings (иконка шестерёнки).
- В разделе Models найди в списке GigaAM v3 и выбери его.
- Модель скачается автоматически при первом запуске (~225 МБ, интернет нужен один раз) — дальше работает офлайн.
- Проверь, что у карточки модели горит статус «Активный» — значит распознавание идёт через неё.
Документация по моделям — handy.computer/docs/models; исходники модели — github.com/salute-developers/GigaAM.
Скриншоты
Shottr — крошечная и быстрая программа для скриншотов на Mac: аннотации (стрелки, текст, выделения, размытие), скриншоты с прокруткой (длинная страница или переписка целиком), красивые фоны для картинок. А ещё умеет распознавать текст: нажал горячую клавишу, выделил область — и текст (и даже QR-код) с картинки уже в буфере обмена. Бесплатна, сколько угодно времени — иногда лишь предлагает купить лицензию.
Всегда свежая версия и описание всех возможностей — на shottr.cc.
Буфер обмена · история копирования
Maccy — крошечный бесплатный менеджер буфера обмена для Mac с открытым кодом. Хранит историю всего, что ты копировал (Cmd+C): можно вернуться к скопированному раньше, искать по истории и вставлять горячей клавишей. Удобно, когда копируешь по очереди несколько кусков кода или текста — ничего не теряется.
brew install --cask maccyИсходники, горячие клавиши и настройки — на github.com/p0deje/Maccy.
VIBE. Портал
Отдельный раздел про то, как устроен и собирается сам портал. Скоро здесь появятся материалы по созданию портала с нуля.
Битрикс24 Вайбкод
Полный конспект платформы: что это, как работает, какие проекты строить. Для тех, кто не программист, но хочет разобраться в архитектуре и возможностях.
Битрикс24 Вайбкод — платформа для создания приложений, чат-ботов и автоматизаций поверх Битрикс24 с помощью ИИ. Запущена в апреле 2026 года.
Главная идея: ты описываешь задачу на человеческом языке → ИИ-инструмент (Claude Code, Cursor) читает документацию, пишет код и сам разворачивает готовое приложение на сервере. Знать программирование при этом не обязательно.
- Приложения-надстройки поверх Битрикс24 (дашборды, аналитика, формы)
- Чат-боты в мессенджере Битрикс24
- Автоматизации: синхронизация данных, обработка сделок, рассылки
- Интеграции с внешними системами и AI-моделями
Для работы нужны два платных компонента:
| 1 | Платный тариф Битрикс24 (Базовый, Стандартный, Профессиональный или Энтерпрайз) |
| 2 | Подписка BitrixGPT + Маркетплейс — ИИ-инструменты + каталог 5 300+ приложений |
Система вайбов: 1 вайб = 1 рубль — внутренняя валюта платформы.
| Бесплатно | API, боты, создание приложений, бесплатные AI-модели |
| Тратят вайбы | Серверы Black Hole, платные AI-модели, AI-поиск в интернете |
| Бонус | 1 000 вайбов при первом подключении (до 12 месяцев) |
| Пополнение | 1 000 вайбов = 1 000 ₽ · 5 000 = 5 000 ₽ · 25 000 = 25 000 ₽ |
Ключ — пропуск, который позволяет ИИ-инструменту работать с платформой от твоего имени. Создаётся в личном кабинете Вайбкод.
vibe_api_… | Личный ключ — для своих инструментов, своего портала |
vibe_app_… | Командный ключ — для приложений других сотрудников; для публикации в каталог. Выдаётся один раз — сохрани сразу |
Ключ передаётся в заголовке каждого запроса:
X-Api-Key: vibe_api_твой_ключ
Пример промпта для ИИ:
Мой Вайбкод ключ: vibe_api_xxx Документация: https://vibecode.bitrix24.tech/docs Задача: создай дашборд со статистикой открытых сделок по стадиям
ИИ сам прочитает документацию, напишет код и задеплоит приложение.
AI Router — маршрутизатор AI-моделей с единым интерфейсом, совместимым с OpenAI. Любой инструмент для OpenAI заработает и здесь.
Базовый адрес: https://vibecode.bitrix24.tech/v1
POST /v1/chat/completions | Запрос к модели, ответ синхронно или потоком |
GET /v1/models | Список доступных моделей |
POST /v1/audio/transcriptions | Распознать речь в текст (Whisper) |
GET /v1/ai/usage | Статистика использования токенов |
GET /v1/ai/providers | Список провайдеров для подключения своих ключей |
| Бесплатно | Модели BitrixGPT — доступны сразу, без настройки |
| BYOK | OpenAI, Anthropic (Claude), DeepSeek, ЯндексGPT, GigaChat, OpenRouter — платишь напрямую провайдеру |
- Классификация лидов и сделок по тексту переписки
- Генерация описаний товаров и коммерческих предложений
- Суммаризация переписок, извлечение данных из комментариев
- Генерация отчётов по данным CRM
- Распознавание речи из записей звонков
Entity API — универсальный интерфейс для чтения и изменения любых данных Битрикс24. 300+ методов для всех сущностей системы.
| CRM | Сделки, контакты, компании, лиды |
| Задачи | Задачи, проекты, рабочие группы |
| Пользователи | Сотрудники, отделы |
| Файлы | Хранилище, папки, документы |
| Календарь | События, встречи, активности |
| Смарт-процессы | Кастомные процессы через entityTypeId |
Шесть стандартных операций — одинаковые для каждой сущности (пример на сделках):
GET /v1/deals | Список с фильтрами и пагинацией |
GET /v1/deals/42 | Получить одну запись по ID |
POST /v1/deals | Создать новую |
PATCH /v1/deals/42 | Изменить поля |
DELETE /v1/deals/42 | Удалить |
POST /v1/deals/search | Поиск по сложному фильтру |
- Агрегация: сумма, среднее, min/max — например, общая сумма сделок за месяц
- Пакетные операции: до 500 записей одним запросом
- Лимит: 10 запросов в секунду на портал
Когда приложению нужна серверная логика (фоновые задачи, боты), оно запускается на сервере Black Hole — изолированном облачном сервере, невидимом снаружи.
| Публичный IP | Нет — невидим снаружи |
| Открытые порты | Нет (iptables DROP ALL) |
| Доступ к приложению | Через зашифрованный WebSocket-туннель |
| URL приложения | https://app-{id}.vibecode.bitrix24.tech |
| ОС | Ubuntu 24.04, root-доступ |
| Порт приложения | 3000 (фиксированный) |
| Лимит на ключ | 3 сервера |
| Автосон | При неактивности → экономия до 80% |
| Деплой | ИИ разворачивает за 1–2 мин через Deploy API |
Управление доступом: одним кликом — только ты, конкретные сотрудники, отдел, весь портал или публично.
Боты живут в мессенджере Битрикс24: отвечают на сообщения, выполняют slash-команды, участвуют в чатах. Публичного сервера не нужно — бот сам периодически опрашивает платформу о новых событиях.
| Зарегистрировать | POST /v1/bots |
| Получить события | GET /v1/bots/:botId/events |
| Отправить ответ | POST /v1/bots/:botId/messages |
ONIMBOTV2MESSAGEADD | Новое сообщение |
ONIMBOTV2COMMANDADD | Пользователь написал команду (/report) |
ONIMBOTV2REACTIONCHANGE | Поставили emoji-реакцию |
ONIMBOTV2JOINCHAT | Бота добавили в групповой чат |
- Отправлять, редактировать, удалять сообщения
- Форматировать текст:
[B]жирный[/B],[I]курсив[/I] - Кнопки-действия прямо в сообщении
- Индикатор «печатает…», создавать чаты, управлять участниками
- Slash-команды:
/report,/helpи любые другие - Прикреплять файлы
33 эндпоинта: боты (5), сообщения (9), чаты (10), интерфейс (5), команды (5), файлы (2).
Приложение Вайбкод — надстройка над Битрикс24, встраивается прямо в его интерфейс: боковая панель, карточка сделки, страница CRM.
Цикл: Создать → Задеплоить код → Задать адрес → Опубликовать
| PRIVATE | По умолчанию. Видит только автор — режим разработки |
| PUBLISHED | Опубликовано. Доступно всем сотрудникам с активными интеграциями |
| UNPUBLISHED | Снято. Данные сохранены для повторной публикации |
- Командный ключ (
vibe_app_…) выдаётся один раз — сохрани сразу - Скоуп
placementнужно добавить при создании — после нельзя, нужно пересоздать - Статичные HTML/JS-приложения не требуют сервера вообще
MCP (Model Context Protocol) — стандартный протокол, через который внешние AI-инструменты могут читать и изменять данные Битрикс24.
Адрес: https://mcp.bitrix24.tech/mcp/
- ChatGPT — данные Битрикс24 как источник в диалоге
- Yandex AI Studio — интеграция с ЯндексGPT
- Cursor — IDE с AI, которая видит данные CRM
- n8n — автоматизация между Битрикс24 и другими системами
Полная карта компонентов и потоков данных. Читай диаграммы последовательно — от общего к частному.
① Полная карта платформы
X-Api-Key: vibe_api_…
OpenAI · Claude
DeepSeek
ЯндексGPT · GigaChat
CRM · Задачи
Файлы
Календарь
Битрикс24
чаты
slash-команды
карточки CRM
боковые
панели
Серверы
Ubuntu 24.04
порт :3000
② Путь запроса к данным Битрикс24 — шаг за шагом
GET /v1/deals X-Api-Key: vibe_api_xxx
403 Forbidden.crm.deal.list и т.п.).{"success":true,"data":[{"id":1,"title":"Сделка #1",...}]}③ Туннель Black Hole — как невидимый сервер принимает запросы
нет IP · нет портов
исходящий
WebSocket
выдаёт поддомен
app-xxx
.vibecode
.bitrix24.techGET app-xxx
.vibecode…WebSocket-канал
:3000
④ Жизненный цикл чат-бота (polling loop)
регистрация в Битрикс24
раз в N секунд
Нет → ждать → ②
Entity API
/messages → в чат
После шага ⑤ — снова ②. Цикл работает, пока сервер запущен.
⑤ AI Router — маршрутизация к нужной модели
POST /v1/chat/completions {"model":"…","messages":[…]}
model определяет, куда идёт запросbitrix/bitrixgpt-5.5
gpt-4o, gpt-4o-mini
claude-sonnet-4-6
deepseek-chat
yandexgpt/latest
GigaChat-Max
BYOK = Bring Your Own Keys — подключаешь свой аккаунт у провайдера, платишь напрямую ему.
⑥ Жизненный цикл OAuth-приложения
этап разработки
настроить URL
с интеграциями
можно вернуть
Без сервера (только HTML/JS)
- Дашборд по сделкам — графики и статистика CRM в интерфейсе Битрикс24
- Расширенная карточка клиента — дополнительные поля и визуализация
- Кастомная форма создания — только нужные поля, без лишнего
С сервером (Black Hole)
- Ночная синхронизация — каждую ночь обновляет данные из 1С или Google Sheets в CRM
- AI-классификатор лидов — при создании нового лида автоматически определяет приоритет
- Напоминалка по задачам — каждое утро пишет сотруднику список задач на день
Чат-боты
- HR-бот — отвечает на вопросы об отпусках, льготах и политике компании
- Бот-аналитик — по команде
/reportприсылает сводку продаж за день - Бот для заявок — принимает заявку через чат и создаёт задачу в CRM
AI-интеграции
- Суммаризатор встреч — берёт текст активности из CRM, делает краткое резюме
- Генератор КП — по данным клиента из CRM генерирует коммерческое предложение
- Анализатор переписки — определяет тональность общения с клиентом, ставит метку
| 1 | Платный тариф Битрикс24 + подписка BitrixGPT + Маркетплейс |
| 2 | Создать личный ключ vibe_api_… в личном кабинете Вайбкод |
| 3 | Открыть Claude Code, вставить промпт с ключом и описанием задачи |
| 4 | ИИ прочитает документацию, напишет код, задеплоит приложение |
| 5 | Опубликовать приложение для сотрудников |
- Quickstart — официальный старт
- AI Router — модели и эндпоинты
- Bot API — 33 эндпоинта для чат-ботов
- Entity API — данные Битрикс24
- Infra API — серверы и деплой
- Apps API — OAuth-приложения
- Black Hole — про серверы
- Pricing — тарифы и вайбы
- llms-full.txt — справочник для AI (дать Claude Code)
FAQ · Решение проблем
Типовые ситуации и как из них выбраться.
«Открыть VS Code» открыло пустую страницу
Контейнер только что запустился — code-server поднимается ~2 сек. Закрой вкладку и нажми снова. Если опять — обратись к админу.
Claude отвечает «Please run /login» или «401»
Токен на хосте устарел и не обновился. Подожди 5 минут — sync-таймер делает обновление каждые 5 мин. Если не помогло — пингуй админа.
Контейнер всё время выключается
Idle-reaper: 30 мин без heartbeat → stop. Держи вкладку портала открытой — UI шлёт heartbeat каждую минуту.
Удалил файлы — можно восстановить?
Если делал git commit — да, git checkout HEAD~ -- <file>. Если нет — увы. Совет: commit'ить после каждого крупного шага.
Claude забывает контекст
Используй скилл claude-memory: /memory update в чате — сохранит ключевые моменты. Или открой новую сессию из чата проекта в портале (история в портале сохраняется).
Свой Vibe Portal
Полная копия Vibe Portal на твоём VPS — свой workspace, свои правила, полный контроль.
Полная копия Vibe Portal на твоём VPS: VS Code в браузере, изолированные Docker-контейнеры, чат с Claude, публикация приложений. Ты — администратор.
Данные нашего портала никуда не утекают — ты получаешь чистую программу без чужих файлов и паролей.
| ОС | Ubuntu 22.04 или 24.04 LTS |
| CPU | от 2 vCPU |
| RAM | от 4 GB |
| Диск | от 40 GB SSD |
| Доступ | SSH root или sudo |
| Домен | желательно (можно работать по IP) |
Где арендовать: мы сами используем NetAngels — самый простой интерфейс, быстрая поддержка, цена средняя по рынку.
Выбери способ — оба приводят к одному результату:
Зайди на сервер по SSH и запусти одну команду. Скрипт установит Docker, nginx и поднимет портал.
curl -fsSL https://vibe.paav.ru/install.sh | bash
⚠ Скрипт готовится — появится здесь скоро.
Создай проект, открой чат с Claude и вставь готовый промпт из шага 4. Claude подключится по SSH и всё настроит сам.
Перейти к промпту →Также можно скачать свои проекты и перенести их на новый сервер вручную:
↓ Все мои проекты (.zip)Создай новый проект, нажми CLAUDE и вставь этот промпт — подставь свои данные сервера:
Привет! Помоги мне установить Vibe Portal на мой сервер. Данные сервера: - IP / хост: [ВСТАВЬ IP] - Пользователь: root - Пароль: [ВСТАВЬ ПАРОЛЬ] Задачи по порядку: 1. Подключись по SSH, проверь ОС (Ubuntu 22.04/24.04) 2. Установи Docker и docker-compose plugin (если нет) 3. Склонируй репозиторий Vibe Portal в /opt/vibe-portal 4. Настрой .env (SESSION_SECRET, домен) 5. Запусти: docker compose up -d 6. Настрой nginx как reverse-proxy → порт 3020 7. Создай первого admin: ./scripts/create-admin.sh admin ПАРОЛЬ 8. Проверь что портал открывается по http://[IP] После каждого шага — пауза, жди моего ОК.
Claude API недоступен напрямую из РФ. Решение — арендовать дешёвый VPS в Европе (Амстердам/Германия) и поднять на нём HTTP-прокси. Все запросы к Claude пойдут через него.
Твой сервер (РФ)
└── anthropic-shim
└── HTTPS_PROXY → EU-VPS :3128 (Squid)
└── api.anthropic.com
Достаточно минимального EU-VPS: 1 vCPU, 1 GB RAM (~€3–5/мес).
apt update && apt install -y squid apache2-utils htpasswd -cb /etc/squid/passwd vibeuser ПАРОЛЬ cat > /etc/squid/squid.conf <<'EOF' auth_param basic program /usr/lib/squid/basic_ncsa_auth /etc/squid/passwd auth_param basic realm proxy acl authenticated proxy_auth REQUIRED http_access allow authenticated http_access deny all http_port 3128 EOF systemctl restart squid && systemctl enable squid
# /data/config/env/proxy.env HTTPS_PROXY=http://vibeuser:ПАРОЛЬ@EU_IP:3128 systemctl restart anthropic-shim curl http://127.0.0.1:8190/_shim/health
Открой чат с Claude на этой странице и вставь промпт — он подключится к обоим серверам и настроит всё:
Помоги настроить HTTP-прокси для Claude. EU-VPS (для прокси): - IP: [EU_IP] - user: root, пароль: [ПАРОЛЬ] Основной сервер (Vibe Portal): - IP: [MAIN_IP] - user: root, пароль: [ПАРОЛЬ] Задачи: 1. На EU-VPS установить Squid с паролём 2. На основном сервере прописать HTTPS_PROXY в /data/config/env/proxy.env 3. Перезапустить anthropic-shim 4. Проверить health-endpoint шима
Материалы курса (шпаргалки, уроки, шаблоны) можно перенести на свой портал. Попроси Claude скопировать папку /opt/vibe-portal/panel/public/content/ и /panel/public/js/lessons-*.js на твой сервер по SSH.
Шаблоны проектов можно скачать в разделе База знаний → Шаблоны и распаковать в /opt/vibe-portal/templates/ на своём сервере.
Оплата Claude из России
Пошаговый гайд: как зарегистрироваться и оплатить Claude Pro из РФ без бана. Главное правило — VPN, почта, номер телефона и карта должны быть из одной страны.
┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐
│ 1. VPN │──▶│ 2. Почта │──▶│ 3. Карта │──▶│ 4. Номер │──▶│ 5. Клод │
│ │ │ │ │ │ │ │ │ │
│ Страна │ │ Gmail │ │ Вирт. │ │ SMS из │ │ claude.ai│
│ не РФ │ │ не РФ │ │ карта │ │ той же │ │ регист- │
│ │ │ (с VPN) │ │ EU/USA │ │ страны │ │ рация │
└──────────┘ └──────────┘ └──────────┘ └──────────┘ └──────────┘
│ │ │ │ │
└──────────────┴──────────────┴──────────────┴──────────────┘
ВСЁ из ОДНОЙ страны: VPN = почта = карта = номер
Пример: карта Испания 🇪🇸 → всё остальное тоже Испания
Anthropic блокирует аккаунты из РФ, Белоруссии и ряда других стран. VPN — обязательное условие. Важно: IP-адрес VPN должен совпадать со страной твоей карты и номера телефона.
Твой ПК (РФ)
│
└──▶ VPN-сервер (например, Нидерланды, Германия, США)
│
└──▶ claude.ai — видит IP из Нидерландов ✓
| Страна | Работает | Примечание |
|---|---|---|
| Нидерланды 🇳🇱 | ✓ Хорошо | Проверено, стабильно |
| Германия 🇩🇪 | ✓ Хорошо | Wise выдаёт EU-карты |
| США 🇺🇸 | ✓ Хорошо | Много сервисов карт |
| Великобритания 🇬🇧 | ✓ Хорошо | Revolut, Wise |
| Россия 🇷🇺 | ✗ Заблок. | Бан при регистрации |
| Беларусь, Иран | ✗ Заблок. | Санкционные страны |
Стандартные VPN-сервисы: Mullvad, ProtonVPN, Windscribe — поддерживают оплату без привязки аккаунта.
Вместо чужого VPN — поднять свой на купленном сервере
Amnezia — приложение, которое само настраивает VPN на твоём EU-сервере. Вводишь IP, логин и пароль сервера — Amnezia сама ставит все протоколы и выдаёт конфиг. Итог: VPN с твоим личным IP, который никто не банит, потому что он известен только тебе.
┌──────────────────────┐ ┌──────────────────────┐
│ Твой ПК (Россия) │ │ EU-VPS (твой сервер)│
│ │ │ │
│ Amnezia App │◀──VPN──▶│ AmneziaWG / OpenVPN │
│ (клиент) │ │ (поставила Amnezia) │
│ │ │ │
└──────────────────────┘ └──────────┬────────────┘
│
▼
api.anthropic.com
claude.ai
- Арендуй EU-VPS (Vultr или Timeweb Cloud — см. раздел «Свой Vibe»), минимальный тариф: 1 vCPU, 1 GB RAM
- Скачай Amnezia на свой компьютер/телефон (ссылки ниже)
- В приложении нажми «Настроить свой сервер» → введи IP, логин и пароль VPS
- Amnezia сама устанавливает AmneziaWG и настраивает конфиг — занимает 2–3 минуты
- Готово — VPN работает, IP сервера = страна VPS
Для регистрации Claude используй Gmail, созданный с включённым VPN. Google привяжет аккаунт к стране по твоему IP — получится почта с EU/US-регионом, а не российским.
Как создать Gmail с EU/US-регионом:
────────────────────────────────────────────────────────
[ ] VPN включён (та же страна, что карта и номер)
[ ] Браузер в режиме инкогнито
1. Открой accounts.google.com/signup
2. Заполни имя, придумай адрес вида name.work2025@gmail.com
3. Телефон для подтверждения — виртуальный номер из шага 4
(или пропусти, если Google предложит альтернативу)
4. Дата рождения и пол → Next
5. Регион Google автоматически определит по VPN-IP ✓
6. Аккаунт готов — этот email используешь при регистрации Claude
Российские карты (Visa/MC/Мир) не принимаются. Нужна зарубежная виртуальная карта. Страна карты = страна VPN = страна номера = страна почты.
При оформлении выбирай тариф «для подписок» — он предназначен именно для регулярных платежей (Claude Pro $20/мес). Карта выпускается испанским банком, регион — Испания 🇪🇸.
Если Platipomiru не подошёл — другие сервисы: ┌──────────────┬─────────────┬───────────────┬───────────────────┐ │ Сервис │ Страна │ Пополнение │ Сложность │ ├──────────────┼─────────────┼───────────────┼───────────────────┤ │ Wise │ EU / UK │ SWIFT/крипто │ Средняя (KYC) │ │ Revolut │ EU / UK │ SWIFT/крипто │ Средняя (KYC) │ │ Capitalist │ EU │ Крипто/карта │ Простая │ │ Paysera │ EU (Литва) │ SWIFT │ Средняя │ └──────────────┴─────────────┴───────────────┴───────────────────┘
Anthropic использует платёжную систему Stripe, которая проверяет сразу три вещи: страну карты, IP-адрес в момент транзакции и платёжный адрес. Все три должны совпадать или хотя бы не противоречить друг другу.
Что Stripe проверяет при оплате: ───────────────────────────────────────────────────── ✓ Страна карты → Испания (Platipomiru) ✓ IP в момент оплаты → VPN = Испания ✓ Платёжный адрес → адрес в Испании (не РФ!) ✗ Российский адрес + испанская карта → отказ ✗ Российский IP + любая карта → отказ
Используй генератор случайных адресов — он создаёт реалистичный адрес для любой страны: улица, город, индекс.
Открыть bestrandoms.com →Выбери страну карты (например, Spain), скопируй адрес и вставь его в форму оплаты Claude. Такой адрес проходит проверку Stripe.
Claude требует подтверждение по SMS. Российские номера (+7) заблокированы. Нужен виртуальный номер из той же страны, что VPN, почта и карта.
Прямая ссылка на страницу Claude. Выбираешь страну, покупаешь номер, получаешь SMS.
Открыть SMSFast →Пополнение через российскую карту. Есть испанские номера — удобно если карта Platipomiru.
Открыть Hero SMS →Другие сервисы (если SMSFast не подошёл): ┌─────────────────┬──────────────┬─────────────────────┐ │ Сервис │ Оплата │ Примечание │ ├─────────────────┼──────────────┼─────────────────────┤ │ onlinesim.io │ Крипто/карта│ Много стран │ │ sms-activate.ru │ Крипто/карта│ Большой выбор │ │ 5sim.net │ Крипто/карта│ EU-номера │ └─────────────────┴──────────────┴─────────────────────┘
Подготовка (до открытия браузера): ───────────────────────────────────────────────────────── [ ] VPN включён → страна совпадает с картой и номером [ ] Браузер в режиме инкогнито / очищены куки [ ] Gmail (EU-регион) из шага 2 готов [ ] Виртуальная карта пополнена (≥$20 для Pro) [ ] Виртуальный номер куплен на SMSFast, ждёт SMS Шаг 1. Открой claude.ai → «Sign up» Шаг 2. Email — вводи Gmail из шага 2 (EU-регион, не Яндекс) Шаг 3. Подтверди email → перейди по ссылке из письма Шаг 4. Введи виртуальный номер → получи SMS → введи код Шаг 5. Выбери страну — ТУ ЖЕ, что VPN + карта + номер Шаг 6. Claude готов к использованию (бесплатный план) Оплата Pro ($20/мес): ───────────────────────────────────────────────────────── Шаг 7. Настройки → «Upgrade to Pro» Шаг 8. Введи данные виртуальной карты Шаг 9. Страна выставления счёта = страна карты Шаг 10. Оплата прошла → Pro активирован ✓
┌────────────────────────────────────┬────────────────────────────┐ │ Не делай │ Почему │ ├────────────────────────────────────┼────────────────────────────┤ │ Регистрация без VPN │ Блок по IP-адресу │ │ Российский номер (+7) │ Блок по коду страны │ │ Российская карта │ Отказ при оплате │ │ Смена страны VPN во время сессии │ Подозрительная активность │ │ Один IP → несколько аккаунтов │ Массовый бан аккаунтов │ │ Бесплатные онлайн-номера SMS │ Заблоклированы Anthropic │ │ VPN ≠ страна карты │ Отказ при оплате │ │ Яндекс/Mail.ru / старый Gmail из РФ│ Ассоциация с РФ │ │ Реальный адрес РФ при оплате │ Блок по адресу │ └────────────────────────────────────┴────────────────────────────┘
Аккаунт создан. Чтобы не потерять его:
- Всегда заходи через тот же VPN (или хотя бы ту же страну)
- Не давай доступ к аккаунту десяткам людей с разных IP
- Не пытайся обойти политику использования (контент-фильтры)
- Продление подписки — тоже с включённым VPN
- Если используешь API — запросы через прокси той же страны (как в разделе «Свой Vibe»)
Ежедневное использование:
Личный Claude (браузер):
VPN вкл. → claude.ai → работаешь
Claude API (свой сервер / Vibe Portal):
Сервер в РФ → anthropic-shim → EU-прокси → api.anthropic.com
(см. раздел «Свой Vibe → Прокси для Claude из РФ»)
Не торопись сразу покупать дорогой план. Вот проверенная последовательность:
1. Регистрируешься → пользуешься бесплатно
Посмотри на возможности, пойми как работать с Клодом
2. Упёрся в лимиты → покупаешь Pro $20/мес
Этого хватает большинству для работы
3. Работаешь 3–5 дней … 1–2 недели
Пока не почувствуешь, что Pro реально тесен
4. Только если очень нужно → MAX $100/мес
Для интенсивной профессиональной работы
Самый быстрый способ — без карты, без верификации и лишних шагов. Но со своими рисками и ограничениями.
Крупный агрегатор цифровых товаров. Широкий выбор: базовые аккаунты, Pro, Max. Автовыдача, гарантия от магазина.
Перейти на GGSEL →Маркетплейс с десятками продавцов. Рейтинговая система и история продаж — выбирай проверенных.
Перейти на Plati.Market →- Рейтинг продавца — только с высоким рейтингом и большим числом продаж. Новые без истории — риск.
- Цена — не должна быть в несколько раз ниже рыночной ($20). Аномально низкая цена — тревожный сигнал.
- Продление — главная проблема готовых аккаунтов. Привязан к чужой карте → продлить самому не выйдет. Уточняй у продавца заранее.
- Стратегия смены — если устраивает покупать новый аккаунт раз в месяц вместо продления, такие сервисы вполне подходят. Опыт есть, люди так работают.