Установка: от пустого компьютера до первого прогона

01Что подготовить заранее#

«Пока пропустим» — нормальный ответ мастеру. Без необязательных сервисов уже работают карусели, гайды и конвейеры на вашей съёмке.

02Шаги установки#

1. 1

   Git и Claude Code

   делаете вы

   Поставьте Git с git-scm.com (всё по умолчанию) и Claude Code с claude.com/claude-code, войдите в аккаунт. В PowerShell обе команды git --version и claude --version должны ответить версией.

2. 2

   Скачать студию

   делаете вы

   git clone <ссылка-из-сообщения> C:\studio. Если доступ пришёл приглашением GitHub — сначала примите приглашение.

3. 3

   Системные программы

   делает агент

   install.ps1 ставит Node.js, FFmpeg, Python 3.12, Chrome, pnpm, распознавание речи, навыки HyperFrames и кладёт пустые образцы конфигов. Уже стоящее пропускает. Шаг можно не делать — мастер вызовет его сам.

4. 4

   Мастер /setup

   вместе

   В папке студии запустите claude и наберите /setup. Дальше мастер ведёт по фазам и говорит, что сделать вам.

5. 5

   Перезапуск

   делаете вы

   Закройте Claude Code и снова запустите claude — так подхватятся глобальные навыки.

git --version
claude --version

git clone <ссылка-из-сообщения> C:\studio
cd C:\studio
powershell -ExecutionPolicy Bypass -File install.ps1

claude
# в Claude Code:
/setup

03Фазы мастера /setup#

Мастер идёт по фазам, в конце каждой говорит, что готово. Повторный запуск безопасен: сделанное он пропускает. Значения ключей после ввода он никогда не повторяет в чате.

04Конфиги и примеры#

Все конфиги лежат вне git и создаются мастером. Пустые образцы кладёт node scripts/setup-configs.mjs, а --check показывает, какие ключи ещё не вписаны, не печатая сами значения.

{
  "botToken": "<токен от @BotFather>",
  "chatIds": ["<ваш chat_id>"]
}

05Логины в браузеры#

Каждый сервис живёт в своём Chrome со своим профилем и портом: ChatGPT — 9222, Google Flow — 9223. Вы входите один раз руками, логин хранится в папке профиля в auth/, а скрипты подключаются к этому живому окну.

# надёжный способ: Chrome не умирает вместе с окном PowerShell
node scripts/cdp/chatgpt-browser-up.mjs --port 9222 --profile auth/chrome-auto-profile

# Google Flow на своём порту и со своим профилем
node scripts/flow-launch.mjs
node scripts/flow/flow-set-en.mjs       # интерфейс Flow обязан быть английским

# проверка: какой порт жив, какой профиль, есть ли вход
node scripts/cdp-status.mjs

06Телеграм-бот приёмки#

1. 1

   Создать бота

   делаете вы

   В Telegram откройте @BotFather → /newbot → имя → получите токен.

2. 2

   Написать боту

   делаете вы

   Отправьте своему боту любое сообщение — иначе он не сможет писать вам первым.

3. 3

   Узнать chat_id

   делаете вы

   Через @userinfobot. Токен и chat_id отдайте мастеру — он запишет их в конфиг.

4. 4

   Проверить

   делает агент

   node scripts/send-to-telegram.mjs --dry — конфиг читается.

07Сайт-витрина#

Сайт для гайдов — Next.js в папке site/, живёт на вашем сервере. Агент дописывает туда гайды сам. Деплой одной командой: исходники уходят на сервер новым релизом, сайт собирается там же, переключается и проверяется. Не отдал 200 — скрипт сам вернёт прошлую версию.

node scripts/site-deploy.mjs              # деплой + проверка 200, при сбое сам откатывается
node scripts/site-deploy.mjs --check      # только проверить, что домен живой
node scripts/site-deploy.mjs --rollback   # вернуть предыдущий релиз

Можно отложить: тогда /гайд соберёт страницу локально, а /воронка запускаться не будет — кнопка вела бы на несуществующую страницу.

08Проверки и бэкап#

node scripts/cdp-status.mjs
node scripts/setup-configs.mjs --check                 # какие ключи заполнены (без значений)
node scripts/send-to-telegram.mjs --dry                # телеграм-конфиг читается
node scripts/content/search-instagram.mjs --estimate   # RapidAPI отвечает
node scripts/media/download-social.mjs <публичный пост> --out workspace/refs/smoke/
pnpm dlx hyperframes --version
node scripts/fish-tts.mjs info                         # если подключали голос

Главный тест — пробная обложка карусели через ChatGPT: PNG должен появиться в workspace/carousel/smoke/ за 1–3 минуты. Сразу после первого удачного теста мастер подключает бэкап: движки вернутся клоном студии, а реестр, кодовые слова и гайды — только из бэкапа.

node scripts/backup-studio.mjs --init                 # подключить приватный репозиторий (gh уже вошёл)
node scripts/backup-studio.mjs --init <ссылка .git>   # или по ссылке
node scripts/backup-studio.mjs --dry                  # что уедет, без отправки
node scripts/backup-studio.mjs                        # бэкап
node scripts/backup-studio.mjs --restore              # восстановление на новой машине

09Частые ошибки установки#

Повторный /setup безопасен. В тупике опишите проблему агенту словами в той же сессии.