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