Коротко
Установите 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, поэтому сначала сохраните версию.
На этой странице
Что нужно перед началом
| Что нужно | Подробности |
|---|---|
| Roblox Studio | Последняя версия, на Windows или macOS. MCP-сервер встроен в Studio, поэтому на стороне Roblox больше ничего ставить не нужно. |
| Компьютер, который поддерживает Claude Code | macOS 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 это локальный процесс на вашем компьютере, поэтому и сессия должна быть на вашем компьютере.
| Вариант | Достаёт до 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.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Откройте новое окно терминала и выполните
claude --version. Номер версии значит, что всё получилось. Если команда не найдена, папка установки ещё не в PATH, и решение есть на странице Anthropic о проблемах с установкой. - Перейдите в папку проекта и выполните
claude. При первом запуске он открывает окно браузера для входа. Если браузер не открылся, нажмитеc, чтобы скопировать ссылку для входа. - Войдите в свой аккаунт 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
- В той же панели (Assistant Settings > MCP Servers) раскройте список Quick connect. В нём поддерживаемые клиенты, установленные на вашем компьютере.
- Включите Claude Code. Если его нет, установите Claude Code и перезапустите Studio.
- Перезапустите 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:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Когда вы в следующий раз запустите claude в этой папке, он попросит одобрить сервер: Anthropic показывает этот запрос для каждого сервера, который приходит из файла .mcp.json. Anthropic задумал этот файл так, чтобы его коммитили и им делилась вся команда, но пути для Windows и macOS разные. Если в вашей команде есть обе системы, держите файл вне репозитория, и пусть каждый добавит Studio себе сам.
На macOS вместо этого можно добавить Studio одной командой. --scope user делает его доступным в каждом проекте на вашем компьютере; без него сервер загружается только в текущей папке. -- отделяет собственные параметры Claude Code от команды, которая запускает сервер.
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.
{
"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 | |
|---|---|---|
| Что это | Функция 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 создаёт | Rojo создаёт |
|---|---|---|
.server | Script с контекстом выполнения Server | Script |
.client | Script с контекстом выполнения Client | LocalScript |
.local | LocalScript | Особого значения нет (любой другой файл .lua это ModuleScript) |
| Без суффикса | ModuleScript | ModuleScript |
Папка с файлом init | Скрипт с дочерними объектами, тип которого задаёт имя файла init | Папка становится скриптом, который описывает init.server.lua, init.client.lua или init.lua |
Настройка Script Sync для Claude Code
- Создайте папку проекта с одной папкой на каждый сервис, который хотите держать на диске, например
ServerScriptService,ReplicatedStorageиStarterPlayerScripts, и выполните в нейgit init. - Если Script Sync не появляется, когда вы нажимаете правой кнопкой на сервис, включите его в File > Beta Features, нажмите Save и перезапустите Studio.
- В Explorer нажмите правой кнопкой на ServerScriptService, выберите Script Sync > Sync to и укажите папку проекта верхнего уровня, а не папку внутри неё. Повторите для остальных сервисов.
- Выполните
claudeв этой папке. Теперь Claude правит файлы.luau, а Studio подхватывает каждое изменение. - Делайте коммит перед каждой сессией, чтобы всегда была чистая точка, к которой можно вернуться.
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. Поменяйте имена под свою игру и уберите то, что вам не нужно.
# 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"), а сервер проверяет всё.
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 объясняет, почему важен каждый пункт.
Безопасный способ работы: контрольная точка, проверка, плейтест
- Сделайте контрольную точку с обеих сторон. Закоммитьте файлы в Git и сохраните версию плейса в Studio через File > Save to Roblox with Notes. Гайд по Studio MCP показывает, как восстановить её из Version History.
- Просите план для всего, что больше одного скрипта, и читайте его, прежде чем одобрить.
- Проверяйте diff. Для файлов читайте
git diffили встроенные diff в расширении, прежде чем принять. Для изменений, сделанных в Studio, читайте скрипты, которые трогал Claude, и проверяйте Explorer на объекты, которые появились или пропали. - Тестируйте сами. Claude может запустить плейтест и прочитать Output, но он проверяет только то, что сам решил проверить. Сыграйте в функцию так, как сыграл бы игрок, прежде чем коммитить или публиковать.
- Делайте коммит, когда всё работает, с сообщением о том, что изменилось.
Что /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. Проверяй всё на сервере.
- Может сначала осмотреть плейс через 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, для клиентов, которые вы настраиваете вручную.
Источники и что почитать
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (на английском). включение сервера, quick connect, настройка через JSON и CLI, инструменты, несколько окон Studio и решение проблем
- Roblox Creator Docs: Build with a coding harness (на английском). Claude Code в VS Code, Script Sync, MCP и Git вместе
- Roblox Creator Docs: Script Sync (на английском). что синхронизируется, правила имён файлов, конфликты и language server
- Roblox Creator Docs: Third-party tools (на английском). Rojo с Rokit и контроль версий
- Roblox Creator Docs: Secrets stores (на английском). как держать API-ключи вне скриптов
- Roblox Creator Docs: Data stores (на английском). почему доступ Studio к API services нужен только в тестовой копии
- Rojo documentation (v7) (на английском). установка и то, как имена файлов превращаются в объекты
- Claude Code Docs: Overview (на английском). у всех вариантов один движок, а десктопному приложению нужна платная подписка
- Claude Code Docs: Advanced setup (на английском). системные требования и команды установки
- Claude Code Docs: Authentication (на английском). вход и подходящие типы аккаунтов
- Claude Code Docs: Connect Claude Code to tools via MCP (на английском). stdio-серверы, .mcp.json, области действия и статус сервера
- Claude Code Docs: Configure permissions (на английском). правила allow, ask и deny, включая инструменты MCP
- Claude Code Docs: Choose a permission mode (на английском). режим auto как стартовый, режим Manual и режим plan
- Claude Code Docs: How Claude remembers your project (на английском). CLAUDE.md, /init и AGENTS.md
- Claude Code Docs: Checkpointing (на английском). что восстанавливает /rewind и что он не отслеживает
- Claude Code Docs: Manage costs effectively (на английском). /usage, размер контекста и выбор модели
- Claude Code Docs: Use Claude Code in the cloud (на английском). почему облачные сессии работают не на вашем компьютере
- Claude Code Docs: Use Claude Code in VS Code (на английском). требования, заметка про PATH, общая конфигурация MCP и панель Problems
- Claude Code Docs: Extend Claude with skills (на английском). что даёт поле allowed-tools у skill
- Claude pricing (на английском). в какие планы входит Claude Code и лимиты использования
- Claude Help Center: Use Claude Code with your Pro or Max plan (на английском). общие лимиты и предупреждение про ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (на английском). минимальный возраст
Как проверялся код: каждый скрипт на этой странице проходит строгую проверку типов Luau с определениями Roblox API (luau-lsp, 13 ноября 2026 г.). Проверка типов ловит опечатки в API и неверные типы, но не ошибки игровой логики, поэтому протестируйте всё в Studio перед публикацией.