Как задеплоить Торговод на Railway: пошагово с Claude Code и браузерным агентом

Торговод живёт у вас на компьютере: включили - работает, закрыли ноутбук - инструмент выключился вместе с ним. Railway - это способ вынести его в облако, чтобы он работал сам по себе, а не только пока вы сидите за столом. Разберём пошагово, как это сделать руками Claude Code и браузерного агента, ничего не настраивая вручную самостоятельно.

Довести собранный инструмент до состояния «работает сам, без меня» - это тоже вайб-кодинг: мало собрать программу, важно ещё и не бросать её на полпути.

Ведём тему AI-помощников для селлеров в Telegram-канале «Вайб Селлер Клуб» - разборы, кейсы и готовые сборки. Больше материалов - в разделе Статьи.

Зачем переносить Торговод с компьютера на Railway

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

• Работает, только пока включён компьютер. Ушли, выключили ноутбук, закрыли терминал - инструмент недоступен.
• Открывается только с этого компьютера. Посмотреть остатки с телефона в дороге или показать таблицу партнёру - нужно физически сидеть за тем же ноутбуком.
• После сна компьютера часто нужно перезапускать вручную. Мелочь, но она накапливается в рутину.

Деплой на Railway снимает все три ограничения разом: инструмент получает постоянный адрес в интернете (домен вида что-то.up.railway.app), работает сам по себе и не зависит от того, включён ли ваш ноутбук. Дальше разберём, как это сделать, не открывая ни одной настройки руками - только через готовые промты для Claude Code и браузерного агента.

Что такое Railway простыми словами

Хостинг - это, по сути, аренда чужого компьютера, который никогда не выключается. Railway - один из таких сервисов, заточенный под то, чтобы запустить программу можно было без своего системного администратора: подключаете репозиторий с кодом на GitHub, Railway сам определяет, на чём написана программа, ставит зависимости и запускает её.

Компания американская, поэтому пара практических нюансов сразу на берег. Оплата идёт через платёжную систему Stripe, а она с 2022 года не обрабатывает карты российских банков - понадобится карта, выпущенная не в России, или сервис-прокладка для оплаты зарубежных подписок. Само пользование сервисом при этом технически доступно из России - Railway не запрашивает страну и не блокирует доступ к панели.

Что такое браузерный агент и как подключить его к Claude Code

Часть шагов дальше - это не код, а обычные клики по сайту Railway: войти, нажать кнопку, вставить значение в поле. Именно тут и нужен браузерный агент - тот же Claude, но с доступом к браузеру, который делает эти клики за вас по вашим инструкциям.

Есть два рабочих варианта:

Если выбираете второй путь, подключите его одной командой в терминале, где обычно запускаете Claude Code:

claude mcp add playwright -- npx -y @playwright/mcp@latest

Проверить, что агент подключился, можно командой claude mcp list - должна появиться строка playwright с пометкой о подключении. Нужен установленный Node.js - тот же, что и для самого Claude Code.

Важно. Не разрешайте браузерному агенту самостоятельно вводить данные карты или пароли. Дошёл до такого поля - остановите его и введите сами. Это касается и ключей доступа к Ozon: вставляйте их своими руками, а не диктуйте агенту в чат.

Чтобы не путаться, кому что поручать, - вот карта шагов дальше:

Всё, что происходит на сайте Railway (клики, формы, кнопки) - работа браузерного агента. Всё, что происходит на вашем компьютере (форк, команды, файлы) - работа Claude Code в терминале.

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

Три вещи до старта:

1. Аккаунт на GitHub. Если его нет - браузерный агент зарегистрирует его на первом шаге.
2. Карта для оплаты Railway. Не обязательно на старте: бесплатного пробного лимита хватит, чтобы пройти всю инструкцию и посмотреть, работает ли всё как надо, привязывать карту сразу не нужно.
3. Ключи Ozon Seller API (необязательно). Берутся в кабинете продавца Ozon: Настройки → Seller API. Роли «Admin read only» достаточно. Если ключей пока нет - инструмент прекрасно стартует и без них: есть демо-режим с примерными товарами, на нём и потренируетесь.

Шаг 1. Сделайте себе копию репозитория

Официальный репозиторий - github.com/Kabankok/torgovod-fbo. Лицензия проекта прямо просит не тащить собственные копии в другие места, а форкать (делать связанную копию) официальный репозиторий - так у вас всегда остаётся ссылка на первоисточник и обновления.

Промт для Claude Code (терминал, если у вас настроен gh - консольный клиент GitHub):

Выполни в терминале команду для форка репозитория
https://github.com/Kabankok/torgovod-fbo в мой аккаунт GitHub
и склонируй форк на компьютер. Если команда gh не настроена -
скажи мне об этом и не пытайся угадывать другие способы.

Если gh не настроен или вы не работаете с терминалом - тот же результат даёт браузерный агент:

Открой в браузере https://github.com/Kabankok/torgovod-fbo.
Если я не залогинен в GitHub - останови работу и попроси меня
войти самостоятельно. После входа нажми кнопку Fork в правом
верхнем углу и подтверди создание форка в моём аккаунте.

Шаг 2. Зарегистрируйтесь на Railway и создайте проект

Промт для браузерного агента:

Открой railway.app. Если аккаунта нет - нажми Login, выбери
вход через GitHub и пройди авторизацию. После входа нажми
New Project → Deploy from GitHub repo, выбери в списке мой
форк torgovod-fbo (если репозитория нет в списке - нажми
Configure GitHub App и дай Railway доступ именно к нему).
Останови работу и сообщи мне, когда дойдёшь до экрана
настроек сервиса - дальше настрою сам.

После этого шага Railway сразу же попробует определить, на чём написана программа, и начнёт первую сборку - она почти наверняка упадёт с ошибкой, потому что команду запуска нужно указать вручную. Это нормально, разберём в следующем шаге.

Шаг 3. Настройте команду запуска

В настройках сервиса (Settings → Deploy) есть поле Custom Start Command. Промт для браузерного агента:

Открой Settings сервиса → раздел Deploy. В поле Custom Start
Command впиши ровно эту строку и сохрани:
python -m uvicorn dashboard.app:app --host 0.0.0.0 --port $PORT
Не меняй ничего в других полях этого раздела.

$PORT - переменную с номером порта Railway подставляет сам, руками её задавать не нужно. Мы точно так же держим на Railway свой собственный, гораздо более крупный (и закрытый) проект - и там команда старта устроена так же: тот же uvicorn, тот же паттерн модуль.файл:переменная_приложения.

Если сборка вдруг падает с ошибкой про недостающие системные библиотеки или шрифты (типичная история для python-инструментов, которые рисуют штрихкоды или PDF) - решение в отдельном файле nixpacks.toml в корне репозитория:

[phases.setup]
aptPkgs = ["fonts-dejavu-core"]

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

Шаг 4. Добавьте переменные окружения

Промт для браузерного агента:

Открой вкладку Variables сервиса. Нажми Raw Editor и покажи
мне пустое поле для ввода. Дальше остановись - я сам вставлю
значения и нажму Save.

Дальше своими руками вставьте туда две строки (значения ключей - только ваши собственные, из личного кабинета Ozon):

OZON_CLIENT_ID=ваш_client_id
OZON_API_KEY=ваш_api_key

Хотите для начала посмотреть на инструмент без реальных ключей - оставьте переменные пустыми и запустите вместо этого демо-наполнение (шаг ниже, после первого успешного деплоя).

Шаг 5. Подключите постоянное хранилище для базы

Это самый незаметный, но самый важный шаг: без него после каждого обновления кода (в том числе автоматического, при каждом git push) все накопленные данные исчезают, и инструмент стартует заново «с чистого листа».

Промт для браузерного агента:

На канве проекта Railway нажми правой кнопкой по сервису
torgovod-fbo → New Volume. В поле Mount Path укажи:
/app/data
Подтверди создание и покажи мне итоговый экран.

/app/data - это путь к папке data, где инструмент хранит свои файлы базы. Обратная сторона Volume: он привязывает сервис к одному инстансу и региону, а при каждом обновлении будет короткая пауза в несколько секунд, пока Railway перезапускает сервис с тем же диском - для инструмента, которым пользуется один человек, это не проблема.

Шаг 6. Получите домен и включите автообновление

Промт для браузерного агента:

Открой Settings сервиса → раздел Networking. Нажми Generate
Domain и покажи мне итоговую ссылку.

Готово - по этой ссылке инструмент доступен из любого места, а не только с вашего компьютера. Автодеплой при пуше в GitHub включён с момента подключения репозитория: изменили код и отправили его в свой форк - Railway сам пересоберёт и перезапустит сервис в течение пары минут.

Хотите для начала посмотреть инструмент на примерных данных, не подключая настоящие ключи Ozon - попросите Claude Code запустить наполнение демо-данными:

В склонированной папке репозитория выполни команду
python seed_demo.py и покажи мне результат.

Сколько это стоит: тарифы Railway

Цены и лимиты - актуальны на середину 2026 года, уточняйте на официальной странице тарифов перед оплатой, Railway их время от времени пересматривает.

Сверх включённого лимита плата идёт по факту использования: за занятую память, процессор, исходящий трафик и объём диска Volume. Для инструмента, которым пользуется один человек и который не хранит горы данных, это единицы долларов в месяц сверх тарифа - львиную долю расхода даёт не использование, а сама подписка.

Грабли: на что смотреть после запуска

• Забыли Volume - данные пропали при первом же обновлении. Если после git push инструмент вдруг «обнулился» - вернитесь к шагу про постоянное хранилище и проверьте, что Volume действительно подключён именно к этому сервису.
• Ключи Ozon оказались в коде, а не в переменных окружения. Если форк репозитория публичный, а ключ случайно попал в файл и был закоммичен - считайте его скомпрометированным и выпустите новый в кабинете Ozon.
• Не подтверждайте платёжные действия и удаление сервиса «на автомате». Как и с любым агентом - смотрите глазами, что он собирается сделать, прежде чем соглашаться, особенно на шагах с деньгами.
• Каждый пуш в GitHub - это redeploy на боевом сервисе. Если экспериментируете с кодом, делайте это в отдельной ветке, а автодеплой оставляйте только на основной.

Что можно и что нельзя: лицензия, ответственность и данные

Лицензия репозитория разрешает бесплатно использовать и дорабатывать инструмент для себя и своего бизнеса, устанавливать его на свои компьютеры и серверы - в том числе на Railway. И прямо запрещает без письменного разрешения продавать его, сдавать в аренду, предлагать как платную услугу (SaaS) или раздавать копии третьим лицам, даже бесплатно: делитесь ссылкой на оригинальный репозиторий, а не своей копией. Программа предоставляется «как есть», без гарантий - автор не отвечает за решения, принятые на основе её данных.

Отдельная тема - данные, которые вы туда загружаете. Сам Торговод работает с товарами, остатками и ценами - без имён и адресов покупателей. Но если в будущем вы дорабатываете инструмент и добавляете туда персональные данные клиентов (ФИО, адрес, телефон), учтите: с лета 2025 года 152-ФЗ требует, чтобы такие данные российских граждан первично собирались и хранились на серверах в России - размещение подобной базы на зарубежном хостинге вроде Railway в этом случае несёт юридический риск, причём независимо от размера бизнеса.

Этот материал - образовательный и не является юридической или налоговой консультацией. Все решения - регистрация на Railway, оплата, состав данных, которые вы туда загружаете - вы принимаете и выполняете самостоятельно и несёте за них ответственность сами.

Что дальше

Деплой на Railway - это финальный штрих поверх уже настроенного «Торговод»: инструмент, который до этого работал только на вашем компьютере, получает постоянный адрес и работает сам. Если тема ИИ-агентов для селлера пока новая - начните с азов в статье Claude Code простыми словами. Пошаговые сборки и разборы для селлеров - в Telegram-канале «Вайб Селлер Клуб». Другие материалы - в разделе Статьи.