Claude Code: как собрать игру для Roblox с помощью навыков, MCP и внешних API. Пошагово
Содержание
- Что получится в итоге
- Что понадобится
- Если вы работаете из России
- Что важно знать до старта
- Шаг 1. Работайте через Claude Code на своём компьютере
- Шаг 2. Соберите первый навык
- Шаг 3. Подключите MCP-сервер Roblox Studio
- Шаг 4. Храните код в файлах и подключите внешние API
- Шаг 5. Получите ключ Roblox Open Cloud API
- Шаг 6. Спрячьте ключ, не вставляя его в чат
- Шаг 7. Навык кода: проверки до Studio
- Шаг 8. Остальные навыки: интерфейс, карта, эффекты, звук, анимация
- Шаг 9. Навык-менеджер собирает всё вместе
- С чего начать
Большинство игр, которые ИИ собирает по одному промту, похожи друг на друга. Карта это код, интерфейс это код, модели тоже код. Отсюда одинаковый вид у всех таких игр.
Есть другой подход: агент остаётся мозгом, но у каждого участка работы свой набор инструкций, свои инструменты и своя проверка. Для Roblox это три кирпича: навыки, MCP-серверы и внешние API. Ниже разбираем, как это устроено и как собрать такую схему у себя. Тот же принцип годится не только для игр: любую повторяющуюся работу агента можно разложить на навыки с проверками.
Что получится в итоге
Claude Code работает на вашем компьютере и управляет Roblox Studio. Код лежит в файлах, а не вводится руками в Studio. Картинки и 3D-модели делают внешние сервисы, готовые файлы агент заливает в игру сам. А каждый участок, будь то код, интерфейс, карта или эффекты, проверяется отдельными правилами до того, как результат попадёт в игру.
Что понадобится
- Claude Code на своём компьютере. Через приложение Claude для компьютера, а не через сайт с чатом. Сайт выдаёт только текст для копирования, а приложение может запускать скрипты Python, открывать Blender и править файлы.
- Платный тариф Claude Pro. В примере это около 18-20 фунтов в месяц.
- Мощная модель. В примере выбрана Claude Opus: длинная работа требует держать в голове много деталей и не терять нить.
- Roblox Studio со встроенным MCP-сервером.
- Внешние сервисы для картинок и 3D. О них в шаге 4.
Если вы работаете из России
Claude Code из России напрямую недоступен, это главное ограничение. Доступность Roblox Studio, Cloudflare и Kaggle тоже проверьте до старта, она может меняться.
Но сама схема не привязана к одному продукту. Навык это папка с инструкцией и готовыми скриптами. Проверки это обычные скрипты. Такую организацию можно повторить в другом кодинг-агенте, который умеет читать файлы с инструкциями и запускать скрипты, в том числе на открытых моделях на своём сервере. Для 3D в примере используется открытая модель под лицензией MIT, её можно запустить на своей видеокарте. Если подходящей видеокарты нет, придётся искать замену бесплатному GPU. Какие именно отечественные модели справятся с такой работой, в примере не проверялось, пробуйте на небольшой задаче.
Что важно знать до старта
- Нужен мощный компьютер или внешний GPU. 3D-модель из картинки требует хорошей видеокарты. В примере её нет, поэтому генерация идёт на бесплатных GPU-часах Kaggle: 30 часов в неделю, один объект занимает около 100 секунд GPU.
- Проверяйте лицензии моделей. Некоторые открытые модели не разрешают использование в отдельных странах. В примере одну модель отбросили именно из-за этого. Читайте лицензию до выбора.
- У Roblox есть лимиты. Один меш не должен превышать 20 000 треугольников. Загрузка звуков через API ограничена в месяц.
- Ключи не вставляйте в чат. Всё, что вы вставили в Claude Code, остаётся в истории чата. Для ключей есть отдельный способ, он в шаге 6.
- Первый навык будет сырым. Придётся тестировать его снова и снова. Особенно это касается анимации: нужно много проб и ошибок.
- Встроенный MCP-сервер Studio иногда ломается. Поэтому в схеме есть запасной сторонний.
Шаг 1. Работайте через Claude Code на своём компьютере
Установите Claude Code и приложение Claude для компьютера, войдите в аккаунт с тарифом Pro и выберите модель Opus. Всё остальное делает сам агент: если что-то не получается при настройке, просто спросите его, как это сделать.
Шаг 2. Соберите первый навык
Навык это папка с инструкциями и инструментами, которую Claude подгружает, когда задача её требует. Главный файл внутри называется SKILL.md. В его начале стоят имя и описание, и по описанию Claude решает, когда навык нужен.
Хитрость в том, что описания читаются всегда, полные инструкции только когда навык понадобился, а справочные файлы только на нужном шаге. Поэтому можно держать два десятка навыков, и память не забьётся.

Рядом лежит папка scripts. Её часто пропускают, а зря. Вместо того чтобы каждый раз писать код заново, навык запускает скрипты Python, которые уже написаны и проверены. Если во время работы что-то сломалось, Claude чинит проблему и записывает, какой скрипт помог. В следующий раз ошибка не повторится. Идея в том, что каждая поломка превращается в правило с причиной.
Чтобы сделать навык самому, создайте папку навыков, положите туда SKILL.md с именем и описанием и напишите, как именно должна делаться работа. Это большой промт, написанный под одну задачу.
Если писать самому лень, есть встроенный навык для создания навыков. Напишите skill creator, расскажите, чего хотите, и он проведёт с вами интервью и составит первый черновик. Дальше вы многократно тестируете навык, пока он не начнёт работать так, как нужно. Обновлять и запускать навык тоже можно просьбой к Claude.

Шаг 3. Подключите MCP-сервер Roblox Studio
MCP, протокол контекста модели, это стандартный способ подключать к Claude другие программы. У Roblox Studio есть встроенный MCP-сервер. Через него Claude создаёт объекты, задаёт свойства, запускает код внутри Studio, делает скриншоты и запускает тестовую игру.
В примере сначала взяли сторонний MCP для Roblox: он не мог достучаться до игры во время запуска. У встроенного есть нормальные инструменты для режима игры, поэтому выбор пал на него. Но он иногда ломается, и в схеме прописано: если встроенный сервер упал, агент сразу переключается на сторонний.

Подключить сервер несложно. В Studio нажмите на значок ассистента, затем на три точки и выберите Manage MCP Servers.

Включите переключатель Enable Studio as MCP server. Ниже в списке быстрого подключения есть пункт Claude Code CLI: откройте его и скопируйте команду.

Дальше откройте сессию Claude Code, вставьте скопированную команду и добавьте фразу. Команда в примере выглядела так:
claude mcp add --transport stdio Roblox_Studio -- "cmd.exe" "/c" "cd /d %LOCALAPPDATA%\Roblox && .\mcp.bat"
А вопрос агенту был такой:
Я запустил MCP-сервер. Используй его, чтобы подключиться.

Это всё, дальше Claude подключается сам. MCP есть не только для Roblox, а для множества программ, так что тема стоит отдельного изучения.
Шаг 4. Храните код в файлах и подключите внешние API
Код игры не живёт в Studio. Он лежит файлами на компьютере и синхронизируется в Studio инструментом Rojo. Благодаря этому Claude может тестировать код ещё до открытия Studio.
Claude пишет текст, но не умеет рисовать и лепить 3D. Для этого навыки передают работу другим моделям через API:
- Картинки и иконки. Модель Flux Schnell через облачный сервис Cloudflare для запуска моделей. В примере она на бесплатном тарифе, быстрая и не тратит GPU-часы, которые нужны дальше.
- 3D-модели. Hi3DGen, открытая модель под лицензией MIT: превращает одну картинку в 3D-меш. Запускается на бесплатном GPU Kaggle.
- Загрузка в игру. Облачный API самого Roblox: с ключом готовые модели и картинки попадают прямо в аккаунт, и их остаётся только использовать в Studio.

Есть нюанс с размером. Из 3D-модели выходит около 600 000 граней, а лимит Roblox 20 000 треугольников на меш. Поэтому Claude открывает Blender без окна и сокращает модель примерно до 6 000 треугольников. Детали при этом теряются, и их запекают обратно в текстуру. Цвет красят по небольшой спецификации, а не угадывают. Предметы с жёсткими краями, например ящики или оружие, строят прямо в Blender.
Шаг 5. Получите ключ Roblox Open Cloud API
Ключ нужен, чтобы агент загружал ассеты в ваш аккаунт. На сайте для разработчиков Roblox откройте центр создателей, затем все инструменты, внизу найдите Open Cloud API и раздел с ключами. Дальше следуйте инструкции на странице: имя ключа, права на нужные операции, при желании ограничение по IP и срок действия.

Шаг 6. Спрячьте ключ, не вставляя его в чат
Если вставить ключ в Claude Code, он останется в истории чата. Этого не нужно. Вместо этого попросите агента объяснить, как сохранить ключ в секретной переменной на вашем компьютере. Запрос в примере был такой:
У меня есть API-ключ Roblox, чтобы ты мог загружать ассеты в мою игру. Объясни, как сохранить его в секретной переменной на моём компьютере так, чтобы ты мог им пользоваться, но он не попадал в чат.

Дальше Claude проведёт по шагам: команды терминала, которые кладут ключ в переменную окружения, а сам ключ в чат не попадает.
Шаг 7. Навык кода: проверки до Studio
В Roblox нельзя наблюдать за игрой во время запуска. Claude не видит режим игры, скриншоты работают только в режиме редактирования, а из запущенной игры возвращается только журнал вывода. Поэтому как можно больше нужно проверять, пока игра стоит.
Для этого правила игры, то есть урон, цены улучшений и подобное, лежат в отдельной папке. Они записаны простыми числами без объектов Roblox, и их можно тестировать на своём компьютере. Перед Studio проект должен пройти четыре проверки:
- Сборка через Rojo. Собирает игру целиком и за секунду ловит битые файлы.
- Тесты. Проверяют, что правила остались верными.
- Линтер. Ловит небрежный код.
- Форматтер. Приводит код к единому виду.
Новый пустой проект тоже должен пройти все четыре проверки до того, как появится первая строка кода игры. Иначе непонятно, где ваши ошибки, а где мусор от ИИ.
В навыке прописаны ещё правила, которые выросли из игры, которую пришлось переписывать с нуля.

- Код только в файлах. Первая версия умерла, потому что Studio и файлы разошлись.
- Все числа в одной папке настроек. Баланс меняется данными, а не переписыванием кода.
- Все сообщения между игроком и сервером через один файл. Название каждого лежит в одном месте.
- Список ловушек. Каждая из них стоила нескольких дней работы.
Шаг 8. Остальные навыки: интерфейс, карта, эффекты, звук, анимация
Те же принципы повторяются на других участках. Вот как это выглядит в примере.
- Интерфейс. Нет отдельной программы для дизайна, потому что картинка и реальный интерфейс расходятся. Пишется одна спецификация, и из неё навык делает три вещи: картинку для предпросмотра, файл интерфейса и скрипт, который строит его в Studio. Поэтому размер или цвет не могут не совпасть. Каждая панель и кнопка получает «стек глубины»: тень с синим оттенком, градиент, подсветку сверху и обводку одной толщины. Иконки генерирует Flux, а не берёт смайлики. Проверяющий скрипт смотрит каждую страницу на четырёх размерах экрана: кнопки должны быть под большой палец, ничего не касается друг друга, центрирование проверяется с точностью до 1,5 пикселя.
- Карта. Это не набор деталей, а пространство, по которому можно ходить. Навык измеряет проходимость лучами и реальными числами движения из конфига: высота прыжка, скорость. Каждое число подписано источником, а догадки перечислены в отчёте. Девять проверок ловят парящие платформы, недостижимые места, ловушки без выхода, слишком открытые или закрытые линии обзора и детали, застрявшие друг в друге. Вместо кубиков карту строят из мешей через Blender или навык 3D.
- Эффекты. Частицы сложно смоделировать вне Roblox, поэтому навык не создаёт их с нуля. Он собирает бесплатные паки эффектов из каталога, классифицирует их в блоки и комбинирует. Для проверки используется «заморозка фазы»: вспышка длится меньше секунды, поэтому скриншот случаен. Навык запускает эффект, ждёт нужное время, замораживает частицы и смотрит начало, середину и конец.
- Звук. Загрузок через API в месяц мало, поэтому Claude комбинирует звуки из заранее собранной и размеченной библиотеки: взрыв, огонь, выстрел.
- Анимация. Позы записаны данными: какой сустав повернулся, насколько и когда. Blender превращает их в анимацию, рендерит каждый кадр и собирает в один лист. Claude смотрит на лист и решает, выглядит ли это связно. Получается у него неидеально, поэтому нужны образцы готовых анимаций Roblox и терпение.
Образец для интерфейса и карт можно взять у чужой игры. Скриншоты любимой игры отдают Claude, и он запоминает стиль как шаблон внутри навыка.
Шаг 9. Навык-менеджер собирает всё вместе
Над остальными навыками стоит ещё один. Он отвечает за три вещи, которых нет у других: исследование, дизайн и финальную сборку игры. Остальное делают навыки, описанные выше. Это менеджер: он следит, чтобы каждый навык выполнял свою часть работы.
С чего начать
Не пытайтесь повторить всё сразу. Поставьте Claude Code, найдите одно, что ИИ делает у вас хуже всего, и напишите навык именно под это. Каждый раз, когда агент ошибся, записывайте исправление как правило. Навык, который прошёл десяток таких кругов, работает надёжнее любого промта.
Мы в Агентехе учим сотрудников собирать агентов под задачи своего отдела: раскладывать работу на навыки, подключать инструменты и настраивать проверки результата. Как устроено обучение.