Как выложить ИИ-агента на Railway: деплой для нетехнаря

Если вы не программист, а ваш ИИ-агент готов и работает у вас на ноутбуке, выложить его на Railway реально за один вечер. Railway (произносится «рэйлвэй») это сервис, куда вы заливаете код своего агента, и он крутится там круглосуточно, даже когда ваш ноутбук закрыт. Порядок простой: даёте одну команду самому ИИ-кодеру, который писал агента, чтобы он подготовил проект к деплою и залил его в репозиторий на GitHub, затем в Railway жмёте New Project, выбираете Deploy from GitHub repo и вписываете свои ключи-доступы во вкладку Variables. Слово «деплой» звучит страшно, но по факту это «выложить код туда, где он живёт сам». При входе через GitHub Railway даёт 5 долларов пробного баланса, его хватает примерно на две недели. Дальше от 5 долларов в месяц за Railway плюс оплата модели по API. Программистом для этого быть не нужно. Ниже разберу каждый шаг и покажу на живых сборках, где это выручает.

Что такое деплой и зачем он ИИ-агенту

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

Самый частый вопрос, который мне задают: куда поселить агента, чтобы он работал 24/7, а не умирал вместе с ноутом. Пока ваш телеграм-бот или ИИ-помощник запущен локально, он живёт ровно до того момента, как вы закроете крышку или выключите компьютер. Заснул ноут, и бот замолчал. Для теста это нормально, для реальной работы никуда не годится.

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

И сразу без розовых очков: «без сервера своими руками» не значит «совсем без возни». Пару раз придётся скопировать ключи, один раз связать Railway с GitHub, а если сборка вспыхнет красным, разобраться, что пошло не так. Но всё это делается один раз, и почти всё за вас делает сам ИИ-кодер.

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

Два слова, которые встретятся вам в любой инструкции по деплою. Разберём по-человечески, поехали.

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

Railway. Это площадка, которая берёт код из вашего репозитория на GitHub и запускает его у себя круглосуточно. Ключевой момент, который снимает половину страхов: Railway смотрит на код в репозитории, а не на то, кто его написал. Ему всё равно, программист вы или вайбкодер, который собрал агента через Claude. Код есть код.

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

Шаг за шагом: как выложить агента на Railway

Дальше по порядку. Это ровно та схема, по которой деплоят и мои участники клуба, и по которой я советую идти новичкам. Самое приятное: почти всю подготовку делает не человек, а сам ИИ-кодер.

1. Дайте одну команду вашему ИИ-кодеру. Не готовьте проект руками. Напишите тому же Claude Code, который писал вашего агента, буквально одной фразой: «Подготовь проект к деплою на Railway: requirements.txt, ключи в переменные окружения и залей в новый репозиторий на GitHub». По-простому вы просите его собрать список нужных библиотек, вынести секретные ключи в отдельные настройки и загрузить всё на GitHub. Он сам это сделает.
2. Зайдите в Railway через GitHub. Регистрируйтесь входом через GitHub, так два сервиса сразу подружатся, и Railway увидит ваши репозитории. За вход через GitHub дают 5 долларов пробного баланса, его хватает примерно на две недели работы. Первый месяц по сути бесплатный.
3. Создайте проект и заберите код с GitHub. Жмёте New Project, дальше выбираете Deploy from GitHub repo и указываете тот самый репозиторий, куда ИИ-кодер только что залил агента. Railway сам подтянет код и начнёт собирать проект.
4. Впишите ключи во вкладку Variables. Это самый занудный шаг, настройтесь заранее. Секретные доступы (ключ к модели, токен бота) вписываются не в код, а в отдельную вкладку Variables, чтобы не светились в репозитории. Если не помните, какие переменные нужны, спросите у самого Claude Code. Он вашего агента писал, так что подскажет точно, что и куда вставить.
5. Дождитесь сборки и проверьте. Railway соберёт проект и покажет, живой он или упал. Зелёная сборка, отлично, агент работает. Красная, ничего страшного, это лечится.
6. Если загорелось красным, отдайте ошибку обратно ИИ-кодеру. Не пытайтесь читать логи глазами и гадать. Скопируйте текст ошибки из Railway и вставьте его обратно агенту, который писал код. Он разберётся и подскажет, что поправить. Пара таких кругов, и сборка становится зелёной.

Заметили? В четырёх шагах из шести главный исполнитель не вы, а ваш ИИ-кодер. Ваше дело нажать нужные кнопки и скопировать пару строк.

Кейс: бот-навигатор по клубу, который живёт на Railway

Покажу на живой сборке, ради чего вообще этот деплой. У меня в клубе накопилось столько материалов, что новичкам стало трудно в них ориентироваться. Меня много раз просили рассказать, как повторить такого помощника, поэтому я собрала бота-навигатора, который подсказывает, где что лежит.

Собирала так. ТЗ сложила в Claude со скиллом explore (это режим, в котором модель сначала изучает задачу, а потом пишет), дальше вайбкодила самого бота в Claude Code. Проверку, что человек действительно участник клуба, сделала через официальный метод Telegram, который называется getChatMember: бот добавлен админом в канал и сам спрашивает у Telegram, состоит ли пользователь в клубе. Никаких таблиц с ручным ведением списков. А дальше как раз деплой на Railway через приватный репозиторий на GitHub, чтобы бот работал без моего ноутбука.

Что интересного вышло по деньгам и технике. Список всех материалов весит всего около 6 тысяч токенов, это где-то 30 страниц текста. Поэтому я отдаю его модели целиком в системном промпте, и никаких сложных RAG-баз с векторным поиском не нужно, для моего объёма это оверкилл (по-простому, стрельба из пушки по воробьям). Кэш системного промпта в Claude живёт 5 минут, и каждый следующий запрос в этом окне обходится в 10 раз дешевле обычного. Модель Claude Sonnet 4.6, память последние 4 пары сообщений. Ответ приходит за 5–7 секунд, поэтому я добавила индикатор «печатает», чтобы человек видел, что бот думает, а не завис.

По расходам честно: примерно 8 долларов в месяц за API Claude плюс минимальный тариф Railway. Сам код Claude Code писал минут 5–10. Вот такой живой бот, который крутится на Railway и не зависит от того, включён у меня компьютер или нет.

Две грабли, на которые я наступила (чтобы вы не наступили)

Раз уж мы про честность, расскажу про два места, где я споткнулась на этом же боте. Оба лечатся легко, если знать заранее.

Первая грабля: локальный бот и деплой одновременно. После того как бот уехал на Railway, обязательно остановите его локальную копию у себя на компьютере. Если этого не сделать, два процесса начнут конкурировать за один токен Telegram, и каждое второе сообщение будет теряться. Выглядит это как «бот отвечает через раз», и поначалу непонятно, почему. Просто выключите локального, и всё наладится.

Вторая грабля: задержка проверки членства. Кэш проверки, состоит ли человек в клубе, живёт 10 минут. Значит, только что добавленный участник ещё 10 минут может получать от бота «вы не участник клуба», хотя он уже вступил. Не пугайтесь и не переделывайте бота, просто подождите эти 10 минут, и доступ откроется.

Работает с любым ИИ-кодером, не только с Claude

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

Это значит, что вся схема выше работает одинаково, каким бы ИИ-кодером вы ни пользовались. Собрали бота в Claude Code, в другом ассистенте или наполовину руками, неважно. Как только код лежит на GitHub, Railway его подхватит и запустит. Ему интересен сам код, а не биография его автора.

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

Сколько это стоит на самом деле

Коротко про деньги, без таблиц с тарифами. При входе через GitHub Railway даёт 5 долларов пробного баланса, этого хватает примерно на две недели. То есть первый месяц у вас по сути бесплатный, можно спокойно потестировать, не платя ничего.

Дальше расходы складываются из двух частей. Сам Railway обойдётся от 5 долларов в месяц. Плюс отдельно вы платите за модель по API, то есть за то, что ваш агент реально думает и отвечает. На живом примере моего бота-навигатора это вышло примерно в 8 долларов в месяц за API Claude плюс минимальный тариф Railway. То есть речь про десятку-другую долларов в месяц за агента, который работает круглосуточно и не просит у вас включённый ноутбук. Для большинства задач нетехнаря это копейки по сравнению с тем, сколько времени он экономит.

А как выложить не агента, а сайт: короткая ремарка

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

У меня помощница собрала мини-сайт в Claude, а тот предлагал выложить его на домене GitHub, и адрес получался некрасивый. Решили так: HTML-файл или папку перетаскиваешь мышкой прямо на Netlify (это площадка для публикации сайтов), потом в разделе Domain Management покупаешь домен на Namecheap и прописываешь в Namecheap настройки, которые выдал Netlify. Дальше надо подождать буквально 30 минут или около часика, и сайт открывается уже с красивым адресом. Проверить, что всё разъехалось по интернету, можно через сервис DNS Checker.

Так что для агента ваш путь Railway, а для статичного сайта скорее Netlify с Namecheap. Разные задачи, разные инструменты.

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

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

Если у вас уже есть агент, который крутится на ноутбуке, откройте того ИИ-кодера, который его писал, и дайте ему ту самую команду: подготовить проект к деплою на Railway, вынести ключи в переменные и залить в новый репозиторий на GitHub. Пока он это делает, зарегистрируйтесь в Railway через GitHub и заберите пробные 5 долларов. Цель первой недели скромная: чтобы агент один раз собрался зелёным и ответил вам, уже живя не у вас на компьютере, а на сервере. Первый раз, когда закрываешь ноут, а бот всё равно отвечает, ощущается лучше любой прочитанной инструкции.

Подписывайтесь на канал, если хотите больше таких разборов: t.me/gruboprostiite

FAQ

Что такое деплой на Railway простыми словами?

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

Нужно ли уметь программировать, чтобы выложить агента на Railway?

Нет. Основную подготовку делает сам ИИ-кодер: вы даёте ему одну команду собрать проект и залить его на GitHub. В Railway вам остаётся нажать New Project, выбрать Deploy from GitHub repo и вписать ключи во вкладку Variables. Если что-то забыли или сборка упала, спрашиваете у того же Claude Code, который писал агента, он подскажет точно.

Сколько стоит Railway и можно ли попробовать бесплатно?

Попробовать можно бесплатно: при входе через GitHub дают 5 долларов пробного баланса, его хватает примерно на две недели, поэтому первый месяц по сути бесплатный. Дальше от 5 долларов в месяц за сам Railway плюс отдельно оплата модели по API. На живом примере моего бота это вышло примерно 8 долларов в месяц за API Claude плюс минимальный тариф Railway.

Что делать, если сборка на Railway загорелась красным?

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

Работает ли Railway с любым ИИ-кодером, не только с Claude?

Да. Railway смотрит на код в репозитории, а не на то, кто его написал. Каким бы ассистентом вы ни собирали агента, как только код лежит на GitHub, Railway его подхватит и запустит. Схема деплоя от этого не меняется.

Почему бот отвечает через раз после деплоя?

Скорее всего, вы забыли остановить локальную копию бота на своём компьютере. Тогда два процесса начинают конкурировать за один токен Telegram, и каждое второе сообщение теряется. Просто выключите бота у себя локально, и он перестанет спорить сам с собой. Оставляем работать только копию на Railway.