Гайд · ИИ в Roblox Studio

Как подключить Claude Code к Roblox Studio

Claude Code это агентный инструмент Anthropic для написания кода. Roblox указывает его как клиент quick connect для MCP-сервера, встроенного в Studio, поэтому он может читать ваш плейс, править скрипты и запускать плейтесты в открытом у вас окне Studio. Ещё он может работать с вашими скриптами как с файлами через Script Sync или Rojo. Этот гайд о стороне Claude Code: что нужно, как его подключить, разрешения, CLAUDE.md с правилами для Roblox, безопасный способ работы и сколько это стоит. Про агента OpenAI смотрите гайд как использовать OpenAI Codex с Roblox Studio (на английском); про Cursor, Claude Desktop и другие клиенты смотрите гайд по настройке Studio MCP.

Обновлено 13 ноября 2026 г.20 мин чтенияАвтор:

Коротко

Установите Claude Code и войдите с платным планом Claude или аккаунтом Claude Console. В Studio откройте Assistant, нажмите … > Manage MCP Servers, включите Enable Studio as MCP server, затем включите Claude Code в списке Quick connect. Перезапустите Claude Code, введите /mcp, чтобы убедиться, что сервер Studio подключён, и начните с запроса, который только читает.

  • Claude Code нет в плане Free от Anthropic. Он входит в Pro, Max, Team и Enterprise или оплачивается по объёму использования API через аккаунт Claude Console (проверено 9 октября 2026 года).
  • Используйте локальную сессию: терминал, расширение для VS Code или Cursor либо десктопное приложение с выбранным Local. Облачные сессии работают не на вашем компьютере и до Studio не достают.
  • Начиная с v2.1.283 сессии в терминале и VS Code по умолчанию стартуют в режиме auto там, где он доступен, поэтому добавьте правила ask для инструментов Studio, которые меняют плейс. Команда /rewind в Claude Code не отменяет изменения, сделанные в Studio, поэтому сначала сохраните версию.
На этой странице
  1. Что нужно
  2. 1. Установка и вход
  3. 2. Подключение к Studio
  4. 3. Разрешения
  5. 4. Первый запрос
  6. 5. Script Sync или Rojo
  7. 6. CLAUDE.md
  8. Безопасная работа
  9. Стоимость
  10. Решение проблем
  11. Агент-плагин
  12. Частые вопросы
  13. Источники и что почитать

Что нужно перед началом

Требования, по документации Roblox и Anthropic, 9 октября 2026 года
Что нужноПодробности
Roblox StudioПоследняя версия, на Windows или macOS. MCP-сервер встроен в Studio, поэтому на стороне Roblox больше ничего ставить не нужно.
Компьютер, который поддерживает Claude CodemacOS 13.0 или новее либо Windows 10 1809 или новее, от 4 ГБ оперативной памяти, подключение к интернету и местоположение в стране, которую поддерживает Anthropic.
Аккаунт Claude, в который входит Claude CodeПлатный план Claude (Pro, Max, Team или Enterprise) или аккаунт Claude Console. На странице цен Anthropic указано, что Claude Code не входит в план Free.
ВозрастВ Consumer Terms от Anthropic (действуют с 8 октября 2025 года) сказано, что вам должно быть не меньше 18 лет или минимальный возраст согласия в вашей стране, если он выше.
По желаниюGit, чтобы хранить историю скриптов. Visual Studio Code 1.94.0 или новее либо Cursor, если хотите Claude Code в панели редактора, а не в терминале.

Какой Claude Code использовать

Claude Code работает в нескольких местах. Anthropic пишет, что у всех один и тот же движок, поэтому ваши CLAUDE.md, настройки и MCP-серверы работают везде. Для Studio важно, где идёт сессия: MCP-сервер Roblox это локальный процесс на вашем компьютере, поэтому и сессия должна быть на вашем компьютере.

Варианты Claude Code и Roblox Studio
ВариантДостаёт до Studio?Заметки
Терминал (команда claude)ДаЗапускайте его в папке проекта. Он также нужен для команд claude mcp ниже.
Расширение для VS Code или CursorДаПуть из гайда Roblox по coding harness. Расширение содержит собственную копию Claude Code, но не добавляет claude в PATH, поэтому, если эти команды вам нужны, поставьте и версию для терминала.
Десктопное приложение, вкладка Code, с выбранным LocalДаРаботает на вашем компьютере. Anthropic пишет, что нужна платная подписка.
Облачные сессии (claude.ai/code или Cloud в десктопном приложении)НетОни работают в облачной инфраструктуре, а не на вашем компьютере, поэтому не могут запустить локальный сервер Studio.

Шаг 1: установите Claude Code и войдите

Anthropic рекомендует установку одной командой в терминале. Это команды, которые были на его странице установки 9 октября 2026 года; актуальные смотрите на странице установки Anthropic.

Терминал · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Откройте новое окно терминала и выполните claude --version. Номер версии значит, что всё получилось. Если команда не найдена, папка установки ещё не в PATH, и решение есть на странице Anthropic о проблемах с установкой.
  2. Перейдите в папку проекта и выполните claude. При первом запуске он открывает окно браузера для входа. Если браузер не открылся, нажмите c, чтобы скопировать ссылку для входа.
  3. Войдите в свой аккаунт Claude. Вход с Pro или Max использует лимиты, включённые в ваш план.

На Windows Anthropic рекомендует установить Git for Windows, чтобы Claude Code мог использовать свой инструмент Bash; без него Claude Code выполняет команды в PowerShell. Для этой настройки ставьте Claude Code в саму Windows, а не внутрь WSL: конфигурация Roblox для Windows запускает cmd.exe с путём %LOCALAPPDATA%, а WSL Roblox не документирует.

Предпочитаете панель в редакторе? В VS Code или Cursor откройте Extensions (Ctrl+Shift+X или Cmd+Shift+X на Mac), найдите Claude Code, установите его и войдите из панели Claude. Именно такую настройку использует гайд Roblox по coding harness.

Шаг 2: подключите Claude Code к Studio

Сначала включите сервер. В Studio откройте Assistant, нажмите … > Manage MCP Servers и включите Enable Studio as MCP server. Гайд по Studio MCP разбирает этот шаг подробнее. Нет кнопки Assistant? Смотрите как открыть панель Assistant.

Quick connect

  1. В той же панели (Assistant Settings > MCP Servers) раскройте список Quick connect. В нём поддерживаемые клиенты, установленные на вашем компьютере.
  2. Включите Claude Code. Если его нет, установите Claude Code и перезапустите Studio.
  3. Перезапустите Claude Code: завершите сессию и снова выполните claude или начните новый разговор в расширении. Roblox пишет, что клиенту нужен перезапуск, чтобы подхватить новую конфигурацию.

Roblox не говорит, в какой файл Claude Code пишет quick connect и как он называет сервер. Введите /mcp в Claude Code, чтобы увидеть имя. Оно понадобится для правил разрешений на шаге 3.

Пользуетесь расширением Claude Code в VS Code или Cursor? Здесь тоже включите Claude Code. Гайд Roblox по coding harness включает Cursor или Visual Studio Code, но Anthropic документирует, что расширение делит конфигурацию MCP с версией Claude Code для терминала, и не говорит, что оно читает собственные настройки MCP редактора.

Ручная настройка через файл .mcp.json

Если quick connect у вас не работает, добавьте Studio сами. Claude Code читает MCP-серверы проекта из файла с именем .mcp.json в папке проекта, в том же формате mcpServers, который документирует Roblox, и считает запись без type локальным stdio-сервером. Поэтому конфигурация Roblox работает как есть. Сохраните вариант для своей системы как .mcp.json в папке, где вы запускаете claude:

.mcp.json · Windows (конфигурация Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
.mcp.json · macOS (конфигурация Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

Когда вы в следующий раз запустите claude в этой папке, он попросит одобрить сервер: Anthropic показывает этот запрос для каждого сервера, который приходит из файла .mcp.json. Anthropic задумал этот файл так, чтобы его коммитили и им делилась вся команда, но пути для Windows и macOS разные. Если в вашей команде есть обе системы, держите файл вне репозитория, и пусть каждый добавит Studio себе сам.

На macOS вместо этого можно добавить Studio одной командой. --scope user делает его доступным в каждом проекте на вашем компьютере; без него сервер загружается только в текущей папке. -- отделяет собственные параметры Claude Code от команды, которая запускает сервер.

Терминал · macOS
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

На Windows проще путь с JSON-файлом, потому что PowerShell и CMD по-разному обрабатывают %LOCALAPPDATA% в командной строке.

Проверьте подключение

  • В терминале claude mcp list показывает каждый сервер и его статус. claude mcp get Roblox_Studio показывает больше, включая строку Issue:, если сервер не смог подключиться.
  • Внутри Claude Code введите /mcp. У подключённых серверов рядом с именем показано число инструментов.
  • В Studio Assistant > … > Manage MCP Servers показывает зелёный индикатор с числом подключённых клиентов.

Шаг 3: решите, что Claude можно делать без спроса

Настройте это до того, как Claude тронет ваш плейс. Согласно странице Anthropic о режимах разрешений, начиная с Claude Code v2.1.283 интерактивные сессии в терминале и VS Code по умолчанию стартуют в режиме auto везде, где он доступен, а в режиме auto действия вместо вас проверяет фоновый классификатор. Тогда вызов MCP, который правит скрипт или выполняет Luau в Studio, может пройти без запроса.

Есть два способа оставить каждое изменение в своих руках:

  • Запускайте в режиме Manual. Выполните claude --permission-mode default. В режиме Manual без спроса выполняется только чтение. Нажимайте Shift+Tab во время сессии, чтобы переключать режимы.
  • Добавьте правила ask для инструментов Studio, которые что-то меняют. Anthropic пишет, что ни один режим не одобряет автоматически инструмент, попавший под явное правило ask, даже режим bypass.
.claude/settings.json · пример
{
  "permissions": {
    "allow": [
      "mcp__Roblox_Studio__list_roblox_studios",
      "mcp__Roblox_Studio__get_studio_state",
      "mcp__Roblox_Studio__search_game_tree",
      "mcp__Roblox_Studio__inspect_instance",
      "mcp__Roblox_Studio__script_read",
      "mcp__Roblox_Studio__script_search",
      "mcp__Roblox_Studio__script_grep",
      "mcp__Roblox_Studio__get_console_output"
    ],
    "ask": [
      "mcp__Roblox_Studio__multi_edit",
      "mcp__Roblox_Studio__execute_luau",
      "mcp__Roblox_Studio__start_stop_play",
      "mcp__Roblox_Studio__subagent",
      "mcp__Roblox_Studio__insert_asset",
      "mcp__Roblox_Studio__upload_image",
      "mcp__Roblox_Studio__generate_mesh",
      "mcp__Roblox_Studio__generate_material",
      "mcp__Roblox_Studio__generate_procedural_model"
    ]
  }
}

Правила MCP имеют вид mcp__<server>__<tool>, с именем сервера таким, каким его знает Claude Code. Замените Roblox_Studio на имя, которое показывает /mcp. Правила allow в файле проекта .claude/settings.json начинают действовать только после того, как вы примете диалог доверия к рабочей папке для этой папки. Для правил, которые нужны только вам, используйте .claude/settings.local.json.

Список allow покрывает инструменты, которые только читают: дерево игры, свойства, скрипты, Output и список открытых окон Studio. Список ask покрывает инструменты, которые меняют плейс, выполняют код, запускают плейтесты, вносят внешние ассеты или отправляют изображения в Roblox. Инструменты, которых нет ни в одном списке, например screen_capture и инструменты ввода, подчиняются вашему режиму разрешений. Полный список инструментов с описанием каждого есть в гайде по Studio MCP.

Шаг 4: начните с запроса, который только читает

Откройте плейс, с которым хотите работать, и закройте те, с которыми не хотите. Затем дайте Claude первый запрос, который ничего не может изменить:

Промпт
Use the Roblox Studio MCP tools. Call list_roblox_studios and tell me which place you are connected to, then list what is in Workspace. Do not change anything.

На свежем Baseplate гайд Roblox по coding harness ожидает, что ответ перечислит стандартные Camera, Terrain, Baseplate и SpawnLocation. Просить сначала list_roblox_studios это хорошая привычка: один клиент достаёт до каждого открытого у вас окна Studio, и каждый вызов инструмента называет целевое окно через studio_id.

Для всего, что больше одного скрипта, сначала попросите план. В режиме plan (нажмите Shift+Tab или начните промпт с /plan) Claude исследует и предлагает, не редактируя ваши файлы. Anthropic описывает режим plan в терминах правок файлов и команд оболочки, поэтому правила ask для инструментов Studio тоже оставьте.

Шаг 5: работайте со скриптами как с файлами через Script Sync или Rojo

Claude Code построен вокруг файлов в папке. Он правит их своими инструментами, Git хранит их историю, а /rewind может их восстановить. Если положить скрипты на диск, всем этим можно пользоваться, а инструменты MCP остаются для тех частей плейса, которые не скрипты, например GUI в StarterGui, RemoteEvent и парты. Roblox документирует два способа это сделать.

Script Sync и Rojo, по страницам Roblox о Script Sync и сторонних инструментах
Script SyncRojo
Что этоФункция Studio, которая синхронизирует скрипты в плейсе с файлами на диске, в обе стороны.Сторонний инструмент: сервер на вашем компьютере плюс плагин для Studio.
Что синхронизируетТолько объекты Script, LocalScript, ModuleScript и Folder. Остальные объекты в синхронизируемой папке игнорируются.Может вести весь проект как файлы, где источником истины служит ваша файловая система.
НастройкаНажмите правой кнопкой на сервис или папку в Explorer, выберите Sync to… и укажите папку. Гайд Roblox по coding harness сначала включает его в File > Beta Features.Установите его через Rokit (rokit add rojo-rbx/rojo, затем rokit install), добавьте плагин командой rojo plugin install, выполните rojo serve и подключитесь из плагина.
Team CreateРаботает с ним. Избегайте ситуации, когда двое одновременно правят один и тот же синхронизируемый скрипт.Roblox отмечает, что сторонние инструменты часто не работают с его встроенными инструментами совместной работы.
Совет RobloxХорошо подходит, если вам нужны свой редактор и контроль версий для кода, а Studio для всего остального.Лучший выбор, если вы хотите держать в контроле версий весь проект, а не только код.

Одно и то же имя файла может значить разное

Оба инструмента выбирают тип скрипта по имени файла, и суффиксы у них не совпадают. Файл .client это LocalScript в Rojo, но Script с контекстом выполнения Client в Script Sync. Скажите Claude, какой инструмент использует ваш проект; пример CLAUDE.md ниже это делает.

Правила Script Sync со страницы Roblox о Script Sync (файлы .luau). Правила Rojo со страницы Sync Details для Rojo v7, где перечислены файлы .lua
Имя файла кончается наScript Sync создаётRojo создаёт
.serverScript с контекстом выполнения ServerScript
.clientScript с контекстом выполнения ClientLocalScript
.localLocalScriptОсобого значения нет (любой другой файл .lua это ModuleScript)
Без суффиксаModuleScriptModuleScript
Папка с файлом initСкрипт с дочерними объектами, тип которого задаёт имя файла initПапка становится скриптом, который описывает init.server.lua, init.client.lua или init.lua

Настройка Script Sync для Claude Code

  1. Создайте папку проекта с одной папкой на каждый сервис, который хотите держать на диске, например ServerScriptService, ReplicatedStorage и StarterPlayerScripts, и выполните в ней git init.
  2. Если Script Sync не появляется, когда вы нажимаете правой кнопкой на сервис, включите его в File > Beta Features, нажмите Save и перезапустите Studio.
  3. В Explorer нажмите правой кнопкой на ServerScriptService, выберите Script Sync > Sync to и укажите папку проекта верхнего уровня, а не папку внутри неё. Повторите для остальных сервисов.
  4. Выполните claude в этой папке. Теперь Claude правит файлы .luau, а Studio подхватывает каждое изменение.
  5. Делайте коммит перед каждой сессией, чтобы всегда была чистая точка, к которой можно вернуться.
Терминал, в папке проекта
git add .
git commit -m "Before Claude session"

Два правила Script Sync с агентом становятся важнее. Не синхронизируйте скрипты, у которых есть атрибуты или теги: Script Sync их игнорирует, и Roblox предупреждает, что это может привести к потере данных. А если файлы меняются, пока Studio закрыт, при повторном открытии плейса Studio спрашивает, как это разрешить, и перечисляет, что добавят, изменят или удалят Keep Studio и Keep Disk. Прочитайте этот список, прежде чем выбирать.

С включённым Script Sync правка файла попадает в Studio сразу после сохранения. Принять правку в Claude Code значит принять её в свой плейс, поэтому проверяйте, прежде чем принимать, особенно в режимах, которые принимают правки автоматически.

Для автодополнения и ошибок типов в редакторе Roblox рекомендует расширение Luau Language Server с его плагином-компаньоном для Studio. В VS Code расширение Claude Code может читать панель Problems через встроенный инструмент, так что Claude видит те же предупреждения, что и вы.

Шаг 6: дайте Claude свои правила для Roblox в CLAUDE.md

Каждая сессия Claude Code начинается со свежего контекста. Файл CLAUDE.md в папке проекта читается в начале каждой сессии, поэтому ваши соглашения должны лежать в нём. Выполните /init, чтобы Claude набросал его, или напишите сами. Anthropic советует держать его короче 200 строк, писать правила достаточно конкретно, чтобы их можно было проверить, и выполнить /context, чтобы убедиться, что он загрузился.

Этот пример написан для этого гайда, для проекта со Script Sync. Поменяйте имена под свою игру и уберите то, что вам не нужно.

CLAUDE.md · пример для проекта со Script Sync
# Roblox project rules (example: edit to fit your game)

## Project
- Roblox game "Wave Survival". The place open in Studio is named WaveSurvival.
- Scripts sync to Studio with Script Sync:
  - ServerScriptService/ holds server game logic
  - ReplicatedStorage/ holds ModuleScripts shared by server and client
  - StarterPlayerScripts/ holds client code
- File names set the script type (Script Sync rules):
  - name.server.luau = Script with Server run context
  - name.local.luau = LocalScript
  - name.luau = ModuleScript
  - Do not use name.client.luau unless I ask. In Script Sync it makes a Script with Client run context, not a LocalScript.
- Never add attributes or tags to synced scripts. Script Sync ignores them.

## Roblox Studio MCP
- Call list_roblox_studios first. Work only in the place named WaveSurvival.
- Edit synced scripts as files, not with multi_edit.
- Use the MCP tools only for what is not a synced script: GUIs in StarterGui, RemoteEvents, parts, attributes.
- Never use insert_asset, upload_image or the generate tools unless I ask in this session.
- Ask before deleting any instance you did not create in this session.

## Luau
- Use task.wait, task.spawn and task.delay. Never wait, spawn or delay.
- Get services with game:GetService.
- The server decides coins, health, inventory and rewards. A LocalScript only asks.
- Every OnServerEvent handler checks the type and size of each argument and limits how often each player can call it.
- Wrap DataStore and HttpService calls in pcall and handle the failure.
- Remove per-player table entries in Players.PlayerRemoving.
- Never put API keys, webhook URLs or passwords in scripts or in this repository.

## Before you say a task is done
- List every script and instance you changed.
- Read the Output with get_console_output and report any errors.
- Tell me what to playtest by hand.

Некоторые строки появились из-за того, как работают инструменты. Правила имён файлов есть потому, что .client.luau в Script Sync не LocalScript. Строка про list_roblox_studios есть потому, что сервер достаёт до каждого открытого окна. Строка про ассеты есть потому, что insert_asset вносит в плейс внешний контент, а upload_image отправляет изображения на сервер ассетов Roblox. Строка про wait следует справочнику API Roblox, который помечает wait, spawn и delay как устаревшие в пользу библиотеки task.

Если в вашем проекте уже есть AGENTS.md для других агентов для кода, Claude Code может читать его как инструкции проекта, так что можно держать один файл для обоих. Страница Anthropic о памяти объясняет, какой файл побеждает, когда есть оба.

Как эти правила выглядят в коде

Вот серверный скрипт, который следует правилам Luau выше. Он написан вручную для этого гайда, а не сгенерирован Claude. Используйте его как мерку, когда проверяете то, что отдаёт Claude. LocalScript просит инструмент через RequestTool:FireServer("Sword"), а сервер проверяет всё.

Script в ServerScriptService с именем ToolRequests
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")

local COOLDOWN_SECONDS = 1
local MAX_NAME_LENGTH = 50
local toolsFolder = ServerStorage:WaitForChild("Tools")

-- Script Sync синхронизирует только скрипты и папки, поэтому сервер создаёт свой remote сам.
local function getRemote(name: string): RemoteEvent
	local existing = ReplicatedStorage:FindFirstChild(name)
	if existing and existing:IsA("RemoteEvent") then
		return existing
	end
	local remote = Instance.new("RemoteEvent")
	remote.Name = name
	remote.Parent = ReplicatedStorage
	return remote
end

local requestTool = getRemote("RequestTool")
local lastRequest: { [Player]: number } = {}

local function onRequestTool(player: Player, toolName: unknown)
	-- Игнорируем запрос, который пришёл после того, как игрок вышел.
	if player.Parent ~= Players then
		return
	end

	-- 1. Проверяем аргумент: клиент может прислать что угодно.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Ограничиваем, как часто один игрок может просить.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Решает сервер. Добавьте сюда свою проверку владения (геймпасс, запись о покупке).
	local template = toolsFolder:FindFirstChild(toolName)
	if not (template and template:IsA("Tool")) then
		return
	end
	local backpack = player:FindFirstChildOfClass("Backpack")
	local character = player.Character
	if not backpack or backpack:FindFirstChild(toolName) then
		return
	end
	if character and character:FindFirstChild(toolName) then
		return
	end

	template:Clone().Parent = backpack
end

requestTool.OnServerEvent:Connect(onRequestTool)

-- 4. Очистка данных игрока.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

На диске со Script Sync: ServerScriptService/ToolRequests.server.luau. Положите объекты Tool в Folder с именем Tools в ServerStorage. Пока вы не добавите проверку владения, каждый игрок может получить любой инструмент из этой папки.

Ищите то же самое в любом обработчике remote, который пишет Claude: он проверяет тип и размер того, что прислал клиент, ограничивает, как часто один игрок может его вызывать, решение принимает сервер, и запись игрока удаляется, когда тот выходит. Гайд по RemoteEvent объясняет, почему важен каждый пункт.

Безопасный способ работы: контрольная точка, проверка, плейтест

  1. Сделайте контрольную точку с обеих сторон. Закоммитьте файлы в Git и сохраните версию плейса в Studio через File > Save to Roblox with Notes. Гайд по Studio MCP показывает, как восстановить её из Version History.
  2. Просите план для всего, что больше одного скрипта, и читайте его, прежде чем одобрить.
  3. Проверяйте diff. Для файлов читайте git diff или встроенные diff в расширении, прежде чем принять. Для изменений, сделанных в Studio, читайте скрипты, которые трогал Claude, и проверяйте Explorer на объекты, которые появились или пропали.
  4. Тестируйте сами. Claude может запустить плейтест и прочитать Output, но он проверяет только то, что сам решил проверить. Сыграйте в функцию так, как сыграл бы игрок, прежде чем коммитить или публиковать.
  5. Делайте коммит, когда всё работает, с сообщением о том, что изменилось.

Что /rewind может отменить, а что нет

Claude Code сохраняет контрольную точку перед каждым промптом, а /rewind (или дважды Esc) восстанавливает файлы, которые Claude изменил своими инструментами редактирования файлов. Anthropic перечисляет, что он не отслеживает, включая изменения, сделанные командами оболочки. Изменения, сделанные в Studio через инструменты MCP, это не правки файлов, поэтому не ждите, что /rewind их отменит, а страница MCP от Roblox не говорит, попадают ли они в историю отмены Studio. Со Script Sync файл, который восстановил /rewind, синхронизируется обратно в Studio, как любое другое изменение на диске. Для всего остального путь назад это сохранённая версия.

Держите секреты и живые данные вне досягаемости

  • Не вставляйте API-ключи, ключи Open Cloud, URL вебхуков и пароли в промпт или в CLAUDE.md. И то и другое это текст, который читает Claude, а CLAUDE.md обычно коммитят в репозиторий.
  • В скрипты их тоже не зашивайте. У Roblox есть хранилище секретов для каждой игры: создайте секреты в Creator Dashboard и читайте их в серверном скрипте через HttpService:GetSecret(). Для локальных плейтестов добавьте локальные секреты в File > Experience Settings > Security.
  • Личные настройки держите в .claude/settings.local.json и CLAUDE.local.md, которые задуманы так, чтобы оставаться вне Git. Добавьте CLAUDE.local.md в .gitignore сами.
  • Включайте Enable Studio Access to API Services только в отдельной тестовой копии игры. Roblox предупреждает, что Studio использует те же хранилища данных, что и живая игра, поэтому плейтест, который Claude запустит там, может перезаписать реальные данные игроков.
  • Прочитайте сторонний skill, прежде чем его ставить. В каталогах skills есть skills по Roblox для Claude Code, и Anthropic отмечает, что skill может выдать себе широкий доступ к инструментам через поле allowed-tools.

Сколько стоит Claude Code для работы с Roblox

У стороны Studio документированной цены нет: MCP-сервер это часть Studio, и страница MCP от Roblox не упоминает платы. Стоимость это стоимость Claude Code, и Anthropic предлагает два способа платить (на 9 октября 2026 года):

  • Подписка Claude. Claude Code входит в Pro, Max, Team и Enterprise, но не во Free. Он расходует тот же лимит использования, что и Claude в вебе, на десктопе и на мобильных. Лимиты сбрасываются по скользящему пятичасовому окну, а у платных планов поверх этого есть недельные лимиты. Когда вы достигаете одного из них, можно подождать, перейти на план выше или включить кредиты на использование.
  • Аккаунт Claude Console. Вы платите за использование API по объёму обработанного текста. Страница Anthropic о расходах говорит, что траты сильно зависят от выбора модели, размера кодовой базы и того, как вы им пользуетесь.

Текущие цены есть на claude.com/pricing. Этот гайд их не повторяет, потому что они меняются. Внутри Claude Code команда /usage показывает подписчикам шкалы использования плана, а пользователям API примерную стоимость сессии.

От чего сессия с Roblox расходует больше

  • Размер контекста. Расход растёт вместе с тем, что у Claude в контексте. Используйте /clear между несвязанными задачами.
  • Большие результаты инструментов. Обход всего дерева игры в большом плейсе или чтение длинных скриптов целиком возвращает много текста. Claude Code считает текст в единицах, которыми его меряет модель: он предупреждает, когда результат инструмента MCP превышает 10 000 таких единиц, и по умолчанию ограничивает его 25 000. Просите вместо этого одну папку, ограничение глубины или диапазон строк: и search_game_tree, и script_read это поддерживают.
  • Выбор модели. Anthropic пишет, что Sonnet хорошо справляется с большинством задач по коду и стоит меньше, чем Opus. Переключайтесь через /model.

Решение проблем с Claude Code и Studio

Собственный чек-лист Roblox короткий: перезапустить Studio и клиент, проверить, что путь к команде существует, и проверить JSON. Вот случаи, характерные именно для Claude Code.

Claude Code нет в списке Quick connect

Список показывает только поддерживаемые клиенты, установленные на вашем компьютере. Установите Claude Code, затем перезапустите Studio. Если вы установили его при открытом Studio, перезапустите Studio, Claude Code или оба. Файл .mcp.json из шага 2 работает без quick connect.

/mcp не показывает сервер Roblox Studio

Перезапустите Claude Code после добавления сервера. Затем проверьте, куда он был добавлен: сервер, добавленный без --scope, загружается только в той папке, где вы его добавили, поэтому запускайте claude из этой папки или добавьте его снова с --scope user. В VS Code начните новый разговор, потому что изменения применяются к разговорам, начатым после них.

Сервер показывает Pending approval

Он пришёл из файла .mcp.json, а Claude Code спрашивает, прежде чем использовать такие серверы. Выполните claude в этой папке, примите диалог доверия к рабочей папке и одобрите сервер. claude mcp reset-project-choices сбрасывает прежние решения.

Сервер показывает Failed to connect

Выполните claude mcp get Roblox_Studio и прочитайте строку Issue:. Проверьте, что файл существует: %LOCALAPPDATA%\Roblox\mcp.bat на Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP на macOS (измените путь, если Studio установлен в другом месте). Убедитесь, что Enable Studio as MCP server всё ещё включён, затем перезапустите Studio и Claude Code.

Терминал пишет, что claude не распознан

После установки откройте новое окно терминала. Если команда всё ещё не найдена, папка установки не в PATH; решение есть на странице Anthropic о проблемах с установкой. Расширение для VS Code не добавляет claude в PATH, поэтому для команд из этого гайда поставьте версию для терминала отдельно.

Claude изменил не тот плейс

При нескольких открытых окнах Studio каждый вызов инструмента называет цель через studio_id. Попросите Claude вызвать list_roblox_studios и назовите нужный плейс, закройте окна, которыми не пользуетесь, и восстановите изменённый плейс из Version History.

Claude Code списывает с моего API-ключа, а не с плана

Как только вы её одобрили, переменная окружения ANTHROPIC_API_KEY берёт верх над подпиской. Удалите переменную (или выключите Use custom API key в /config), запустите Claude Code заново и выполните /status, чтобы проверить, какой вход активен. Если это по-прежнему аккаунт Console, выполните /login и выберите свой аккаунт Claude.

Облачная сессия не видит Studio

Облачные сессии работают в инфраструктуре Anthropic, а не на вашем компьютере, поэтому не достают до локального сервера Studio. Используйте терминал, расширение для редактора или десктопное приложение с выбранным Local.

Или возьмите вместо этого агент-плагин: RoCode

Claude Code с MCP подходит тем, кому удобно в терминале или редакторе кода. RoCode (RoCode.app) это другой путь: независимый ИИ-агент для Roblox Studio с веб-чатом на rocode.app и бесплатным плагином из Creator Store, который выполняет шаги в открытом у вас плейсе. Это не MCP-продукт, и он не использует MCP-сервер Studio, поэтому нет командной строки, файла конфигурации или MCP-сервера для настройки. Плагин подключается сам, если Studio вошёл в тот же аккаунт Roblox, которым вы пользуетесь в RoCode; иначе вы один раз связываете чат и плагин кодом из 8 символов, показанным в панели плагина.

Что стоит знать до перехода. RoCode не может подключить подписку Claude или Claude Code. Он запускает сторонние модели через OpenRouter, включая Claude Sonnet 5.5 на Pro и выше и Claude Opus 5.5 на Studio и выше, а бесплатный план Starter даёт 1 кредит в день на GPT-6 Luna. Он работает из режима редактирования. С плагином 3.9 или новее, в режиме Build, он может запустить короткий плейтест и прочитать ошибки, а с плагином 3.9.11 или новее управлять тестовым персонажем, чтобы проверить, что игра работает. С плагином 3.9.14 или новее он ещё делает снимки того, что построил, в режиме редактирования, и может исправить то, что выглядит неправильно. Он не выполняет код напрямую и не генерирует меши, а инструменты Studio MCP умеют и то и другое. Он может искать бесплатные модели в Creator Store по вашим словам (скрипты внутри удаляются) или вставить модель, декаль или меш по ID ассета, а декор, здания и реквизит придумывает заново для каждой игры. Его режим Ask отвечает на вопросы о вашем плейсе инструментами только для чтения и ничего не меняет. Аккаунты для тех, кому 13 лет и больше, а до 18 лет с разрешения родителя или опекуна.

Вы пишете

Добавь RemoteEvent, чтобы игроки могли запросить инструмент из ServerStorage.Tools. Проверяй всё на сервере.

RoCode делает
  • Может сначала осмотреть плейс через Search Game и List Children, чтобы найти папку Tools и скрипты, которые уже выдают инструменты
  • Пишет серверный скрипт через Create Script и может добавить RemoteEvent через Create Instance
  • Проверяет компиляцию скрипта в Studio через Check Script перед завершением. Это проверка компиляции, а не проверка типов и не плейтест
  • Отправляет изменения пачками, и каждая пачка это точка отмены в истории самого Studio

С плагином 3.9 или новее RoCode может запустить короткий плейтест и прочитать ошибки, а с плагином 3.9.15 или новее его тестовый персонаж умеет ходить, нажимать клавиши и кликать по кнопкам на экране, но он проверяет только то, что сам решил проверить, поэтому нажмите Play сами, чтобы проверить результат как игрок. Промпт это пример, написанный нами; в шагах настоящие названия инструментов. Как работают плагин и сопряжение. RoCode это независимый продукт, не связанный с Roblox Corporation, не одобренный и не спонсируемый ею.

Частые вопросы

Можно ли использовать Claude Desktop вместо Claude Code?

Да. Claude Desktop есть в списке Quick connect в панели Manage MCP Servers в Studio, поэтому он подключается одним переключателем, на Windows или Mac. Он использует те же инструменты Studio; Claude Code добавляет то, что хорошо умеет агент в терминале, например работу с файлами скриптов и Git. Шаги для обоих есть в гайде по настройке Studio MCP.

Может ли Claude Code подключиться к Roblox Studio?

Да. Roblox указывает Claude Code как клиент quick connect для MCP-сервера, встроенного в Studio. Включите Enable Studio as MCP server в Assistant > … > Manage MCP Servers, включите Claude Code в списке Quick connect и перезапустите Claude Code. Ещё он может работать с вашими скриптами как с файлами через Script Sync или Rojo.

Claude Code бесплатен для работы с Roblox Studio?

У MCP-сервера Studio документированной цены нет, но Claude Code не входит в план Free от Anthropic (claude.com/pricing, проверено 9 октября 2026 года). Нужен платный план Claude, где он делит лимиты использования вашего плана, или аккаунт Claude Console с оплатой за использование API.

Нужен ли плагин Roblox или HTTP-запросы, чтобы пользоваться Claude Code?

Для встроенного MCP-сервера Studio нет. Шаги настройки Roblox это включить сервер в Assistant и подключить клиент; в них нет ни плагина для установки, ни настройки HTTP, которую надо менять. Некоторые старые гайды описывают MCP-серверы от сообщества, которые работают иначе. Rojo, если вы выберете его для файлов, использует собственный плагин для Studio.

Может ли Claude Code тестировать мою игру Roblox?

Через инструменты Studio MCP да. start_stop_play запускает и останавливает плейтест, get_console_output читает Output, screen_capture снимает вьюпорт, а инструменты ввода двигают персонажа и отправляют клавиши и клики. Проверяйте то, о чём он отчитывается, и сыграйте в игру сами перед публикацией.

Что выбрать для Roblox Studio: Claude Code или Codex?

Оба есть в списке quick connect от Roblox и достают до одних и тех же инструментов Studio MCP, поэтому разница в модели, аккаунте и клиенте вокруг неё. Roblox не публикует сравнения, и мы не проводили их сравнительных тестов. Попробуйте каждый на копии своего плейса с одинаковыми письменными правилами и оставьте тот, чьи изменения требуют меньше исправлений.

Claude Code работает с Roblox Studio на Mac?

Да. Claude Code поддерживает macOS 13.0 или новее, а Roblox документирует путь к серверу для macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, для клиентов, которые вы настраиваете вручную.

Источники и что почитать

Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 13 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.

Попробуйте RoCode в своей игре.

Бесплатные кредиты каждый день, без карты. Установите плагин, опишите функцию и проверьте, что появилось в Studio.