Написать в Telegram

Claude Code: как собрать игру для Roblox с помощью навыков, MCP и внешних API. Пошагово

Содержание
  1. Что получится в итоге
  2. Что понадобится
  3. Если вы работаете из России
  4. Что важно знать до старта
  5. Шаг 1. Работайте через Claude Code на своём компьютере
  6. Шаг 2. Соберите первый навык
  7. Шаг 3. Подключите MCP-сервер Roblox Studio
  8. Шаг 4. Храните код в файлах и подключите внешние API
  9. Шаг 5. Получите ключ Roblox Open Cloud API
  10. Шаг 6. Спрячьте ключ, не вставляя его в чат
  11. Шаг 7. Навык кода: проверки до Studio
  12. Шаг 8. Остальные навыки: интерфейс, карта, эффекты, звук, анимация
  13. Шаг 9. Навык-менеджер собирает всё вместе
  14. С чего начать

Большинство игр, которые ИИ собирает по одному промту, похожи друг на друга. Карта это код, интерфейс это код, модели тоже код. Отсюда одинаковый вид у всех таких игр.

Есть другой подход: агент остаётся мозгом, но у каждого участка работы свой набор инструкций, свои инструменты и своя проверка. Для 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.

Пять шагов встроенного навыка skill creator: от запроса до многократных проверок
Пять шагов встроенного навыка skill creator: от запроса до многократных проверок

Шаг 3. Подключите MCP-сервер Roblox Studio

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

В примере сначала взяли сторонний MCP для Roblox: он не мог достучаться до игры во время запуска. У встроенного есть нормальные инструменты для режима игры, поэтому выбор пал на него. Но он иногда ломается, и в схеме прописано: если встроенный сервер упал, агент сразу переключается на сторонний.

Выбор MCP: у встроенного есть инструменты для режима игры, при сбое включается сторонний
Выбор MCP: у встроенного есть инструменты для режима игры, при сбое включается сторонний

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

Меню ассистента в Roblox Studio: пункт Manage MCP Servers
Меню ассистента в Roblox Studio: пункт Manage MCP Servers

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

Включённый переключатель MCP-сервера Studio и список быстрого подключения
Включённый переключатель MCP-сервера Studio и список быстрого подключения

Дальше откройте сессию Claude Code, вставьте скопированную команду и добавьте фразу. Команда в примере выглядела так:

claude mcp add --transport stdio Roblox_Studio -- "cmd.exe" "/c" "cd /d %LOCALAPPDATA%\Roblox && .\mcp.bat"

А вопрос агенту был такой:

Я запустил MCP-сервер. Используй его, чтобы подключиться.

Команда подключения MCP и фраза для агента в поле ввода Claude Code
Команда подключения MCP и фраза для агента в поле ввода Claude Code

Это всё, дальше 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.
Документация модели Flux Schnell для генерации картинок на Cloudflare
Документация модели Flux Schnell для генерации картинок на Cloudflare

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

Шаг 5. Получите ключ Roblox Open Cloud API

Ключ нужен, чтобы агент загружал ассеты в ваш аккаунт. На сайте для разработчиков Roblox откройте центр создателей, затем все инструменты, внизу найдите Open Cloud API и раздел с ключами. Дальше следуйте инструкции на странице: имя ключа, права на нужные операции, при желании ограничение по IP и срок действия.

Инструкция по созданию API-ключа: имя, права, ограничение по IP, срок действия
Инструкция по созданию API-ключа: имя, права, ограничение по IP, срок действия

Шаг 6. Спрячьте ключ, не вставляя его в чат

Если вставить ключ в Claude Code, он останется в истории чата. Этого не нужно. Вместо этого попросите агента объяснить, как сохранить ключ в секретной переменной на вашем компьютере. Запрос в примере был такой:

У меня есть API-ключ Roblox, чтобы ты мог загружать ассеты в мою игру. Объясни, как сохранить его в секретной переменной на моём компьютере так, чтобы ты мог им пользоваться, но он не попадал в чат.

Запрос к Claude Code про хранение ключа в секретной переменной вне чата
Запрос к Claude Code про хранение ключа в секретной переменной вне чата

Дальше 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, найдите одно, что ИИ делает у вас хуже всего, и напишите навык именно под это. Каждый раз, когда агент ошибся, записывайте исправление как правило. Навык, который прошёл десяток таких кругов, работает надёжнее любого промта.

Мы в Агентехе учим сотрудников собирать агентов под задачи своего отдела: раскладывать работу на навыки, подключать инструменты и настраивать проверки результата. Как устроено обучение.

Написать в Telegram