Ръководство · ИИ в 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.

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

Накратко

Инсталирай 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 ГБ RAM, интернет връзка и местоположение в държава, която 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, 20 ноември 2026 г.). Проверката на типовете хваща грешки в имената на API и грешни типове, но не и грешки в логиката на играта, затова тествай всичко в Studio, преди да публикуваш.

Пробвай RoCode в своята игра.

Безплатни кредити всеки ден, без карта. Инсталирай плъгина, опиши функцията и виж какво се е появило в Studio.