Röviden
Telepítsd a Claude Code-ot, és lépj be egy fizetős Claude csomaggal vagy egy Claude Console-fiókkal. A Studióban nyisd meg az Assistant-et, kattints a … > Manage MCP Servers pontra, kapcsold be az Enable Studio as MCP server beállítást, aztán kapcsold be a Claude Code-ot a Quick connect listában. Indítsd újra a Claude Code-ot, írd be a /mcp parancsot, hogy meggyőződj róla, csatlakozott-e a Studio szervere, és kezdj egy csak olvasó kéréssel.
- A Claude Code nincs benne az Anthropic Free csomagjában. A Pro, Max, Team és Enterprise csomagok része, vagy API-használat szerint fizetsz érte egy Claude Console-fiókon keresztül (ellenőrizve 2026. október 9-én).
- Helyi munkamenetet használj: terminált, VS Code vagy Cursor bővítményt, vagy az asztali alkalmazást kiválasztott Local beállítással. A felhős munkamenetek nem a számítógépeden futnak, és nem érik el a Studiót.
- A v2.1.283-as verziótól a terminálos és VS Code-os munkamenetek alapból auto módban indulnak, ahol ez elérhető, ezért adj ask szabályokat a place-t módosító Studio-eszközökhöz. A Claude Code
/rewindparancsa nem vonja vissza a Studióban végzett módosításokat, ezért előbb ments egy verziót.
Ezen az oldalon
Mi kell a kezdéshez
| Mi kell | Részletek |
|---|---|
| Roblox Studio | A legújabb verzió, Windowson vagy macOS-en. Az MCP-szerver be van építve a Studióba, így a Roblox oldalán semmi mást nem kell telepíteni. |
| A Claude Code-ot támogató számítógép | macOS 13.0 vagy újabb, illetve Windows 10 1809 vagy újabb, legalább 4 GB RAM, internetkapcsolat és olyan országbeli tartózkodási hely, amelyet az Anthropic támogat. |
| Claude-fiók, amelyben benne van a Claude Code | Fizetős Claude csomag (Pro, Max, Team vagy Enterprise) vagy Claude Console-fiók. Az Anthropic árak oldala szerint a Claude Code nincs benne a Free csomagban. |
| Életkor | Az Anthropic Consumer Terms (2025. október 8-tól hatályos) szerint legalább 18 évesnek kell lenned, vagy elérned az országodban érvényes beleegyezési korhatárt, ha az magasabb. |
| Opcionálisan | Git a scriptek előzményeinek tárolásához. Visual Studio Code 1.94.0 vagy újabb, illetve Cursor, ha a Claude Code-ot a szerkesztő paneljén szeretnéd, nem a terminálban. |
Melyik Claude Code-ot használd
A Claude Code több helyen fut. Az Anthropic szerint mindegyik ugyanazt a motort használja, így a CLAUDE.md, a beállítások és az MCP-szerverek mindenhol működnek. A Studio szempontjából az számít, hol fut a munkamenet: a Roblox MCP-szervere egy helyi folyamat a számítógépeden, ezért a munkamenetnek is a számítógépeden kell futnia.
| Változat | Eléri a Studiót? | Megjegyzések |
|---|---|---|
Terminál (claude parancs) | Igen | A projektmappában indítsd. Az alábbi claude mcp parancsokhoz is ez kell. |
| VS Code vagy Cursor bővítmény | Igen | A Roblox coding harness útmutatójának útja. A bővítmény a Claude Code saját példányát tartalmazza, de nem adja hozzá a claude parancsot a PATH-hoz, ezért ha ezekre a parancsokra szükséged van, telepítsd a terminálos változatot is. |
| Asztali alkalmazás, Code fül, kiválasztott Local beállítással | Igen | A számítógépeden fut. Az Anthropic szerint fizetős előfizetés kell hozzá. |
| Felhős munkamenetek (claude.ai/code vagy Cloud az asztali alkalmazásban) | Nem | Felhős infrastruktúrán futnak, nem a számítógépeden, ezért nem tudják elindítani a Studio helyi szerverét. |
1. lépés: telepítsd a Claude Code-ot, és lépj be
Az Anthropic egyetlen terminálparancsos telepítést ajánl. Ezek a parancsok voltak a telepítési oldalán 2026. október 9-én; az aktuálisakat az Anthropic telepítési oldalán találod.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Nyiss egy új terminálablakot, és futtasd a
claude --versionparancsot. Ha verziószámot látsz, minden rendben. Ha a parancs nem található, a telepítési mappa még nincs a PATH-ban; a megoldás az Anthropic telepítési problémákról szóló oldalán van. - Lépj a projektmappába, és futtasd a
claudeparancsot. Első indításkor böngészőablakot nyit a belépéshez. Ha a böngésző nem nyílt meg, nyomd meg acbillentyűt a belépési link kimásolásához. - Lépj be a Claude-fiókodba. A Pro vagy Max csomaggal való belépés a csomagodban foglalt limiteket használja.
Windowson az Anthropic a Git for Windows telepítését ajánlja, hogy a Claude Code használhassa a Bash eszközét; enélkül a Claude Code PowerShellben futtatja a parancsokat. Ehhez a beállításhoz magára a Windowsra telepítsd a Claude Code-ot, ne WSL-be: a Roblox Windowsos konfigurációja a cmd.exe-t indítja egy %LOCALAPPDATA% útvonallal, a WSL-t pedig a Roblox nem dokumentálja.
Inkább a szerkesztő paneljét használnád? A VS Code-ban vagy a Cursorban nyisd meg az Extensions nézetet (Ctrl+Shift+X, Macen Cmd+Shift+X), keresd meg a Claude Code-ot, telepítsd, és lépj be a Claude panelről. Pontosan ezt a beállítást használja a Roblox coding harness útmutatója.
2. lépés: csatlakoztasd a Claude Code-ot a Studióhoz
Először kapcsold be a szervert. A Studióban nyisd meg az Assistant-et, kattints a … > Manage MCP Servers pontra, és kapcsold be az Enable Studio as MCP server beállítást. A Studio MCP útmutató részletesebben is bemutatja ezt a lépést. Nincs Assistant gomb? Nézd meg, hogyan nyisd meg az Assistant panelt.
Quick connect
- Ugyanezen a panelen (Assistant Settings > MCP Servers) nyisd le a Quick connect listát. Ebben a számítógépedre telepített támogatott kliensek vannak.
- Kapcsold be a Claude Code-ot. Ha nincs ott, telepítsd a Claude Code-ot, és indítsd újra a Studiót.
- Indítsd újra a Claude Code-ot: zárd le a munkamenetet, és futtasd újra a
claudeparancsot, vagy kezdj új beszélgetést a bővítményben. A Roblox szerint a kliensnek újraindítás kell, hogy átvegye az új konfigurációt.
A Roblox nem mondja meg, melyik fájlba írja a quick connect a Claude Code beállítását, és milyen néven nevezi a szervert. Írd be a /mcp parancsot a Claude Code-ban, hogy lásd a nevet. A 3. lépés engedélyszabályaihoz szükséged lesz rá.
A Claude Code bővítményt használod a VS Code-ban vagy a Cursorban? Itt is a Claude Code-ot kapcsold be. A Roblox coding harness útmutatója a Cursort vagy a Visual Studio Code-ot kapcsolja be, de az Anthropic azt dokumentálja, hogy a bővítmény a terminálos Claude Code-dal közös MCP-konfigurációt használ, és nem mondja, hogy a szerkesztő saját MCP-beállításait olvasná.
Kézi beállítás .mcp.json fájllal
Ha a quick connect nálad nem működik, add hozzá magad a Studiót. A Claude Code a projekt MCP-szervereit a projektmappában lévő .mcp.json nevű fájlból olvassa, ugyanabban az mcpServers formátumban, amelyet a Roblox dokumentál, és a type nélküli bejegyzést helyi stdio-szervernek tekinti. Ezért a Roblox konfigurációja változtatás nélkül működik. Mentsd el a rendszerednek megfelelő változatot .mcp.json néven abba a mappába, ahol a claude parancsot futtatod:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Amikor legközelebb ebben a mappában futtatod a claude parancsot, kérni fogja a szerver jóváhagyását: az Anthropic ezt a kérést minden olyan szervernél megmutatja, amely .mcp.json fájlból érkezik. Az Anthropic úgy tervezte ezt a fájlt, hogy commitolják, és az egész csapat megossza, de a Windowsos és a macOS-es útvonal eltér. Ha a csapatodban mindkét rendszer előfordul, tartsd a fájlt a repositoryn kívül, és mindenki maga adja hozzá a Studiót.
macOS-en a Studiót egyetlen paranccsal is hozzáadhatod. A --scope user a számítógéped minden projektjében elérhetővé teszi; nélküle a szerver csak az aktuális mappában töltődik be. A -- elválasztja a Claude Code saját paramétereit a szervert indító parancstól.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Windowson a JSON-fájlos út egyszerűbb, mert a PowerShell és a CMD másképp kezeli a %LOCALAPPDATA% értéket a parancssorban.
Ellenőrizd a kapcsolatot
- A terminálban a
claude mcp listminden szervert és annak állapotát mutatja. Aclaude mcp get Roblox_Studiotöbbet mutat, többek között egyIssue:sort, ha a szerver nem tudott csatlakozni. - A Claude Code-on belül írd be a
/mcpparancsot. A csatlakozott szervereknél a név mellett az eszközök száma látszik. - A Studióban az Assistant > … > Manage MCP Servers egy zöld jelzőt mutat a csatlakozott kliensek számával.
3. lépés: döntsd el, mit tehet a Claude kérdezés nélkül
Ezt állítsd be, mielőtt a Claude hozzányúlna a place-edhez. Az Anthropic engedélymódokról szóló oldala szerint a Claude Code v2.1.283-as verziójától az interaktív terminálos és VS Code-os munkamenetek alapból auto módban indulnak mindenhol, ahol ez elérhető, auto módban pedig a műveleteket helyetted egy háttérben futó osztályozó ellenőrzi. Ilyenkor egy MCP-hívás, amely scriptet szerkeszt vagy Luau kódot futtat a Studióban, kérdés nélkül is átmehet.
Kétféleképpen tarthatsz minden módosítást a kezedben:
- Indítsd Manual módban. Futtasd a
claude --permission-mode defaultparancsot. Manual módban kérdés nélkül csak az olvasás fut le. Munkamenet közben a Shift+Tab billentyűvel válthatsz a módok között. - Adj ask szabályokat a módosító Studio-eszközökhöz. Az Anthropic szerint egyik mód sem hagy jóvá automatikusan olyan eszközt, amelyre kifejezett ask szabály vonatkozik, még a bypass mód sem.
{
"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"
]
}
}
Az MCP-szabályok formája mcp__<server>__<tool>, a szerver nevével úgy, ahogy a Claude Code ismeri. Cseréld a Roblox_Studio nevet arra, amit a /mcp mutat. A projekt .claude/settings.json fájljában lévő allow szabályok csak azután lépnek életbe, hogy elfogadtad a munkamappára vonatkozó bizalmi párbeszédet ehhez a mappához. Azokhoz a szabályokhoz, amelyek csak neked kellenek, használd a .claude/settings.local.json fájlt.
Az allow lista a csak olvasó eszközöket fedi le: a játékfát, a tulajdonságokat, a scripteket, az Outputot és a nyitott Studio ablakok listáját. Az ask lista azokat az eszközöket fedi le, amelyek módosítják a place-t, kódot futtatnak, playteszteket indítanak, külső asseteket hoznak be vagy képeket küldenek a Robloxra. Az egyik listán sem szereplő eszközökre, például a screen_capture-re és a beviteli eszközökre, az engedélymódod vonatkozik. Az eszközök teljes listája mindegyik leírásával a Studio MCP útmutatóban van.
4. lépés: kezdj egy csak olvasó kéréssel
Nyisd meg a place-t, amellyel dolgozni szeretnél, és zárd be azokat, amelyekkel nem. Aztán adj a Claude-nak egy első kérést, amely semmit sem tud megváltoztatni:
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.
Egy friss Baseplate-en a Roblox coding harness útmutatója azt várja, hogy a válasz felsorolja a szokásos Camera, Terrain, Baseplate és SpawnLocation elemeket. Jó szokás először a list_roblox_studios hívását kérni: egy kliens minden nálad nyitott Studio ablakot elér, és minden eszközhívás a studio_id azonosítóval nevezi meg a célablakot.
Mindenhez, ami egy scriptnél nagyobb, előbb kérj tervet. Plan módban (nyomd meg a Shift+Tab billentyűt, vagy kezdd a promptot a /plan paranccsal) a Claude felderít és javasol anélkül, hogy a fájljaidat szerkesztené. Az Anthropic a plan módot a fájlszerkesztések és a shellparancsok fogalmaival írja le, ezért a Studio-eszközökre vonatkozó ask szabályokat is hagyd meg.
5. lépés: kezeld a scripteket fájlokként a Script Sync vagy a Rojo segítségével
A Claude Code egy mappában lévő fájlokra épül. A saját eszközeivel szerkeszti őket, a Git tárolja az előzményeiket, a /rewind pedig vissza tudja állítani őket. Ha a scripteket a lemezre teszed, mindezt használhatod, az MCP-eszközök pedig a place azon részeire maradnak, amelyek nem scriptek, például a StarterGui GUI-jaira, a RemoteEventekre és a partokra. A Roblox kétféle módot dokumentál erre.
| Script Sync | Rojo | |
|---|---|---|
| Mi ez | A Studio funkciója, amely a place scriptjeit a lemezen lévő fájlokkal szinkronizálja, mindkét irányban. | Külső eszköz: egy szerver a számítógépeden és egy Studio plugin. |
| Mit szinkronizál | Csak a Script, LocalScript, ModuleScript és Folder objektumokat. A szinkronizált mappában lévő többi objektumot figyelmen kívül hagyja. | Az egész projektet kezelheti fájlokként, ahol a fájlrendszered az igazság forrása. |
| Beállítás | Kattints jobb gombbal egy szolgáltatásra vagy mappára az Explorerben, válaszd a Sync to… lehetőséget, és adj meg egy mappát. A Roblox coding harness útmutatója előbb bekapcsolja a File > Beta Features alatt. | Telepítsd a Rokittal (rokit add rojo-rbx/rojo, aztán rokit install), add hozzá a plugint a rojo plugin install paranccsal, futtasd a rojo serve parancsot, és csatlakozz a pluginból. |
| Team Create | Működik vele. Kerüld, hogy ketten egyszerre szerkesszék ugyanazt a szinkronizált scriptet. | A Roblox megjegyzi, hogy a külső eszközök gyakran nem működnek a beépített közös munkát segítő eszközeivel. |
| A Roblox tanácsa | Jól illik hozzád, ha a kódhoz a saját szerkesztődet és verziókezelést szeretnél, minden máshoz a Studiót. | A legjobb választás, ha az egész projektet verziókezelésben szeretnéd tartani, nem csak a kódot. |
Ugyanaz a fájlnév mást jelenthet
Mindkét eszköz a fájlnév alapján választja ki a script típusát, és az utótagjaik nem egyeznek. A .client fájl a Rojóban LocalScript, a Script Syncben viszont Client futtatási kontextusú Script. Mondd meg a Claude-nak, melyik eszközt használja a projekted; az alábbi CLAUDE.md példa ezt teszi.
| A fájlnév vége | A Script Sync létrehoz | A Rojo létrehoz |
|---|---|---|
.server | Script Server futtatási kontextussal | Script |
.client | Script Client futtatási kontextussal | LocalScript |
.local | LocalScript | Nincs különleges jelentése (bármely más .lua fájl ModuleScript) |
| Utótag nélkül | ModuleScript | ModuleScript |
Mappa init fájllal | Gyermekobjektumokkal rendelkező script, amelynek típusát az init fájl neve adja meg | A mappa olyan scriptté válik, amelyet az init.server.lua, az init.client.lua vagy az init.lua ír le |
A Script Sync beállítása a Claude Code-hoz
- Hozz létre egy projektmappát, benne egy-egy mappával minden olyan szolgáltatáshoz, amelyet a lemezen szeretnél tartani, például
ServerScriptService,ReplicatedStorageésStarterPlayerScripts, és futtasd benne agit initparancsot. - Ha a Script Sync nem jelenik meg, amikor jobb gombbal egy szolgáltatásra kattintasz, kapcsold be a File > Beta Features alatt, nyomd meg a Save gombot, és indítsd újra a Studiót.
- Az Explorerben kattints jobb gombbal a ServerScriptService-re, válaszd a Script Sync > Sync to lehetőséget, és add meg a legfelső szintű projektmappát, ne egy benne lévő mappát. Ismételd meg a többi szolgáltatásnál.
- Futtasd a
claudeparancsot ebben a mappában. Most a Claude a.luaufájlokat szerkeszti, a Studio pedig átvesz minden módosítást. - Minden munkamenet előtt commitolj, hogy mindig legyen egy tiszta pont, ahová visszatérhetsz.
git add .
git commit -m "Before Claude session"
A Script Sync két szabálya ügynökkel még fontosabbá válik. Ne szinkronizálj olyan scripteket, amelyeknek attribútumaik vagy tagjeik vannak: a Script Sync figyelmen kívül hagyja őket, és a Roblox figyelmeztet, hogy ez adatvesztéshez vezethet. Ha pedig a fájlok akkor változnak, amikor a Studio zárva van, a place újbóli megnyitásakor a Studio megkérdezi, hogyan oldja fel ezt, és felsorolja, mit ad hozzá, módosít vagy töröl a Keep Studio és a Keep Disk. Olvasd el ezt a listát, mielőtt választasz.
Bekapcsolt Script Sync mellett egy fájl szerkesztése a mentés után azonnal megjelenik a Studióban. Ha elfogadsz egy szerkesztést a Claude Code-ban, a place-edbe fogadod el, ezért elfogadás előtt ellenőrizd, különösen azokban a módokban, amelyek automatikusan elfogadják a szerkesztéseket.
A szerkesztőbeli automatikus kiegészítéshez és típushibákhoz a Roblox a Luau Language Server bővítményt ajánlja a hozzá tartozó Studio pluginnal. A VS Code-ban a Claude Code bővítmény egy beépített eszközzel olvashatja a Problems panelt, így a Claude ugyanazokat a figyelmeztetéseket látja, mint te.
6. lépés: add meg a Claude-nak a Roblox-szabályaidat a CLAUDE.md-ben
Minden Claude Code munkamenet friss kontextussal indul. A projektmappában lévő CLAUDE.md fájlt minden munkamenet elején beolvassa, ezért a konvencióidnak ebben kell lenniük. Futtasd az /init parancsot, hogy a Claude felvázolja, vagy írd meg magad. Az Anthropic azt tanácsolja, hogy tartsd 200 sornál rövidebbre, a szabályokat elég konkrétan írd ahhoz, hogy ellenőrizni lehessen őket, és futtasd a /context parancsot, hogy meggyőződj a betöltéséről.
Ezt a példát ehhez az útmutatóhoz írtuk, egy Script Synces projekthez. Írd át a neveket a saját játékodra, és töröld, ami nem kell.
# 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.
Néhány sor az eszközök működése miatt került bele. A fájlnév-szabályok azért vannak ott, mert a .client.luau a Script Syncben nem LocalScript. A list_roblox_studios sor azért, mert a szerver minden nyitott ablakot elér. Az assetekről szóló sor azért, mert az insert_asset külső tartalmat hoz be a place-be, az upload_image pedig képeket küld a Roblox assetszerverére. A wait sor a Roblox API-referenciáját követi, amely a wait, a spawn és a delay függvényt elavultnak jelöli a task könyvtár javára.
Ha a projektedben már van AGENTS.md más kódoló ügynökök számára, a Claude Code projektutasításként olvashatja, így egyetlen fájlt tarthatsz mindkettőhöz. Az Anthropic memóriáról szóló oldala elmagyarázza, melyik fájl nyer, ha mindkettő megvan.
Hogyan néznek ki ezek a szabályok kódban
Íme egy szerverscript, amely követi a fenti Luau szabályokat. Kézzel írtuk ehhez az útmutatóhoz, nem a Claude generálta. Használd mércének, amikor azt ellenőrzöd, amit a Claude ad. Egy LocalScript a RequestTool:FireServer("Sword") hívással kér eszközt, a szerver pedig mindent ellenőriz.
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")
-- A Script Sync csak scripteket és mappákat szinkronizál, ezért a szerver maga hozza létre a remote-ját.
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)
-- Figyelmen kívül hagyjuk a kérést, ha a játékos kilépése után érkezett.
if player.Parent ~= Players then
return
end
-- 1. Ellenőrizzük az argumentumot: a kliens bármit küldhet.
if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
return
end
-- 2. Korlátozzuk, milyen gyakran kérhet egy játékos.
local now = os.clock()
local last = lastRequest[player]
if last ~= nil and now - last < COOLDOWN_SECONDS then
return
end
lastRequest[player] = now
-- 3. A szerver dönt. Ide tedd a saját tulajdonjog-ellenőrzésedet (gamepass, vásárlási bejegyzés).
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. A játékos adatainak törlése.
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
A lemezen Script Synccel: ServerScriptService/ToolRequests.server.luau. A Tool objektumokat tedd egy Tools nevű Folderbe a ServerStorage-ban. Amíg nem adsz hozzá tulajdonjog-ellenőrzést, minden játékos bármelyik eszközt megkaphatja ebből a mappából.
Ugyanezt keresd minden remote-kezelőben, amelyet a Claude ír: ellenőrzi a kliens által küldött adat típusát és méretét, korlátozza, milyen gyakran hívhatja egy játékos, a döntést a szerver hozza meg, és a játékos bejegyzése törlődik, amikor kilép. A RemoteEvent útmutató elmagyarázza, miért fontos mindegyik pont.
Biztonságos munkamódszer: ellenőrzőpont, átnézés, playtest
- Készíts ellenőrzőpontot mindkét oldalon. Commitold a fájlokat a Gitbe, és ments egy place-verziót a Studióban a File > Save to Roblox with Notes menüponttal. A Studio MCP útmutató megmutatja, hogyan állítsd vissza a Version History-ból.
- Kérj tervet mindenhez, ami egy scriptnél nagyobb, és olvasd el, mielőtt jóváhagyod.
- Nézd át a diffet. Fájloknál olvasd el a
git diffkimenetét vagy a bővítmény beépített diffjeit, mielőtt elfogadod. A Studióban végzett módosításoknál olvasd el a scripteket, amelyekhez a Claude hozzányúlt, és nézd meg az Explorerben a megjelent vagy eltűnt objektumokat. - Tesztelj magad. A Claude elindíthat egy playtestet és elolvashatja az Outputot, de csak azt ellenőrzi, amit maga ellenőrizni akart. Játszd ki a funkciót úgy, ahogy egy játékos tenné, mielőtt commitolsz vagy publikálsz.
- Commitolj, amikor minden működik, egy üzenettel arról, mi változott.
Mit tud visszavonni a /rewind, és mit nem
A Claude Code minden prompt előtt ellenőrzőpontot ment, a /rewind (vagy kétszer Esc) pedig visszaállítja azokat a fájlokat, amelyeket a Claude a fájlszerkesztő eszközeivel módosított. Az Anthropic felsorolja, mit nem követ, köztük a shellparancsokkal végzett módosításokat. A Studióban MCP-eszközökkel végzett módosítások nem fájlszerkesztések, ezért ne várd, hogy a /rewind visszavonja őket, a Roblox MCP oldala pedig nem mondja meg, hogy bekerülnek-e a Studio visszavonási előzményeibe. Script Synccel a /rewind által visszaállított fájl ugyanúgy visszaszinkronizálódik a Studióba, mint bármely más lemezes módosítás. Minden máshoz a visszaút a mentett verzió.
Tartsd távol a titkokat és az élő adatokat
- Ne illessz API-kulcsokat, Open Cloud kulcsokat, webhook URL-eket és jelszavakat a promptba vagy a
CLAUDE.md-be. Mindkettő olyan szöveg, amelyet a Claude olvas, aCLAUDE.md-t pedig általában commitolják a repositoryba. - A scriptekbe se égesd bele őket. A Robloxnak játékonkénti titoktára van: hozd létre a titkokat a Creator Dashboardon, és olvasd ki őket egy szerverscriptben a
HttpService:GetSecret()hívással. Helyi playtestekhez adj meg helyi titkokat a File > Experience Settings > Security alatt. - A személyes beállításokat a
.claude/settings.local.jsonés aCLAUDE.local.mdfájlban tartsd, amelyeket úgy terveztek, hogy a Giten kívül maradjanak. ACLAUDE.local.md-t magad add hozzá a.gitignore-hoz. - Az Enable Studio Access to API Services beállítást csak a játék egy külön tesztmásolatában kapcsold be. A Roblox figyelmeztet, hogy a Studio ugyanazokat az adattárakat használja, mint az élő játék, ezért egy ott indított Claude playtest felülírhatja a valódi játékosadatokat.
- Olvasd el a külső skillt, mielőtt telepíted. A skillkatalógusokban vannak Robloxos skillek a Claude Code-hoz, és az Anthropic megjegyzi, hogy egy skill az
allowed-toolsmezőn keresztül széles eszközhozzáférést adhat magának.
Mennyibe kerül a Claude Code a Roblox fejlesztéshez
A Studio oldalának nincs dokumentált ára: az MCP-szerver a Studio része, és a Roblox MCP oldala nem említ díjat. A költség a Claude Code költsége, és az Anthropic kétféle fizetési módot kínál (2026. október 9-i állapot szerint):
- Claude előfizetés. A Claude Code benne van a Pro, Max, Team és Enterprise csomagban, a Free-ben nem. Ugyanazt a használati limitet fogyasztja, mint a Claude a weben, asztali gépen és mobilon. A limitek egy gördülő ötórás ablak szerint nullázódnak, a fizetős csomagoknál pedig erre heti limitek is rájönnek. Ha elérsz egyet, várhatsz, válthatsz magasabb csomagra, vagy bekapcsolhatod a használati krediteket.
- Claude Console-fiók. Az API-használatért a feldolgozott szöveg mennyisége szerint fizetsz. Az Anthropic költségekről szóló oldala szerint a kiadás erősen függ a modell választásától, a kódbázis méretétől és attól, hogyan használod.
Az aktuális árak a claude.com/pricing oldalon vannak. Ez az útmutató nem ismétli meg őket, mert változnak. A Claude Code-on belül a /usage parancs az előfizetőknek a csomag használati sávjait, az API-felhasználóknak pedig a munkamenet becsült költségét mutatja.
Mitől fogyaszt többet egy Robloxos munkamenet
- A kontextus mérete. A fogyasztás azzal együtt nő, ami a Claude kontextusában van. Használd a
/clearparancsot az egymással nem összefüggő feladatok között. - Nagy eszközeredmények. Egy nagy place teljes játékfájának bejárása vagy hosszú scriptek teljes beolvasása sok szöveget ad vissza. A Claude Code a szöveget azokban az egységekben számolja, amelyekkel a modell méri: figyelmeztet, ha egy MCP-eszköz eredménye meghaladja a 10 000 ilyen egységet, és alapból 25 000-nél korlátozza. Ehelyett kérj egy mappát, mélységkorlátot vagy sortartományt: a
search_game_treeés ascript_readis támogatja ezt. - A modell választása. Az Anthropic szerint a Sonnet a legtöbb kódolási feladatot jól megoldja, és kevesebbe kerül, mint az Opus. A
/modelparanccsal válthatsz.
Hibaelhárítás a Claude Code és a Studio esetében
A Roblox saját ellenőrzőlistája rövid: indítsd újra a Studiót és a klienst, ellenőrizd, hogy a parancs útvonala létezik-e, és ellenőrizd a JSON-t. Íme a kifejezetten a Claude Code-ra jellemző esetek.
A Claude Code nincs a Quick connect listán
A lista csak a számítógépedre telepített támogatott klienseket mutatja. Telepítsd a Claude Code-ot, aztán indítsd újra a Studiót. Ha nyitott Studio mellett telepítetted, indítsd újra a Studiót, a Claude Code-ot vagy mindkettőt. A 2. lépés .mcp.json fájlja quick connect nélkül is működik.
A /mcp nem mutatja a Roblox Studio szervert
A szerver hozzáadása után indítsd újra a Claude Code-ot. Aztán nézd meg, hová lett hozzáadva: a --scope nélkül hozzáadott szerver csak abban a mappában töltődik be, ahol hozzáadtad, ezért abból a mappából futtasd a claude parancsot, vagy add hozzá újra a --scope user beállítással. A VS Code-ban kezdj új beszélgetést, mert a módosítások az utánuk indított beszélgetésekre vonatkoznak.
A szerver Pending approval állapotot mutat
Egy .mcp.json fájlból érkezett, a Claude Code pedig rákérdez, mielőtt ilyen szervereket használna. Futtasd a claude parancsot ebben a mappában, fogadd el a munkamappára vonatkozó bizalmi párbeszédet, és hagyd jóvá a szervert. A claude mcp reset-project-choices nullázza a korábbi döntéseket.
A szerver Failed to connect állapotot mutat
Futtasd a claude mcp get Roblox_Studio parancsot, és olvasd el az Issue: sort. Ellenőrizd, hogy a fájl létezik-e: %LOCALAPPDATA%\Roblox\mcp.bat Windowson, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP macOS-en (módosítsd az útvonalat, ha a Studio máshová van telepítve). Győződj meg róla, hogy az Enable Studio as MCP server még be van kapcsolva, aztán indítsd újra a Studiót és a Claude Code-ot.
A terminál azt írja, hogy a claude nem ismert parancs
Telepítés után nyiss egy új terminálablakot. Ha a parancs még mindig nem található, a telepítési mappa nincs a PATH-ban; a megoldás az Anthropic telepítési problémákról szóló oldalán van. A VS Code bővítmény nem adja hozzá a claude parancsot a PATH-hoz, ezért az útmutató parancsaihoz telepítsd külön a terminálos változatot.
A Claude rossz place-t módosított
Több nyitott Studio ablaknál minden eszközhívás a studio_id azonosítóval nevezi meg a célt. Kérd meg a Claude-ot, hogy hívja meg a list_roblox_studios eszközt, és nevezd meg a kívánt place-t, zárd be a nem használt ablakokat, a módosított place-t pedig állítsd vissza a Version History-ból.
A Claude Code az API-kulcsomat terheli, nem a csomagomat
Miután jóváhagytad, az ANTHROPIC_API_KEY környezeti változó elsőbbséget kap az előfizetéssel szemben. Töröld a változót (vagy kapcsold ki a Use custom API key beállítást a /config alatt), indítsd újra a Claude Code-ot, és futtasd a /status parancsot, hogy lásd, melyik belépés aktív. Ha még mindig a Console-fiók az, futtasd a /login parancsot, és válaszd a Claude-fiókodat.
A felhős munkamenet nem látja a Studiót
A felhős munkamenetek az Anthropic infrastruktúráján futnak, nem a számítógépeden, ezért nem érik el a Studio helyi szerverét. Használd a terminált, a szerkesztőbővítményt vagy az asztali alkalmazást kiválasztott Local beállítással.
Vagy válassz helyette plugin-ügynököt: RoCode
A Claude Code MCP-vel azoknak való, akik otthon vannak a terminálban vagy egy kódszerkesztőben. A RoCode (RoCode.app) egy másik út: független AI-ügynök a Roblox Studióhoz, webes chattel a rocode.app oldalon és a Creator Store-ból származó ingyenes pluginnal, amely a nálad nyitott place-ben hajtja végre a lépéseket. Nem MCP-termék, és nem használja a Studio MCP-szerverét, így nincs beállítandó parancssor, konfigurációs fájl vagy MCP-szerver. A plugin magától csatlakozik, ha a Studio ugyanabba a Roblox-fiókba van belépve, amelyet a RoCode-ban használsz; különben egyszer összekötöd a chatet és a plugint a plugin paneljén látható 8 karakteres kóddal.
Amit érdemes tudni váltás előtt: a RoCode nem tud Claude vagy Claude Code előfizetést csatlakoztatni. Külső modelleket futtat az OpenRouteren keresztül, köztük a Claude Sonnet 5.5-öt a Pro és a magasabb csomagokban és a Claude Opus 5.5-öt a Studio és a magasabb csomagokban, az ingyenes Starter csomag pedig napi 1 kreditet ad GPT-6 Lunán. Szerkesztő módból dolgozik. A 3.9-es vagy újabb pluginnal, Build módban, rövid playtestet indíthat és elolvashatja a hibákat, a 3.9.11-es vagy újabb pluginnal pedig tesztkaraktert irányíthat, hogy ellenőrizze, működik-e a játék. A 3.9.14-es vagy újabb pluginnal szerkesztő módban képeket is készít arról, amit épített, és kijavíthatja, ami rosszul néz ki. Nem futtat közvetlenül kódot, és nem generál mesheket, a Studio MCP eszközei viszont mindkettőre képesek. Kereshet ingyenes modelleket a Creator Store-ban a szavaid alapján (a bennük lévő scripteket eltávolítja), vagy asset ID alapján beilleszthet egy modellt, decalt vagy mesht, a díszítést, épületeket és kellékeket pedig minden játékhoz újonnan találja ki. Az Ask módja csak olvasó eszközökkel válaszol a place-eddel kapcsolatos kérdésekre, és semmit sem változtat. Fiókot 13 éves kortól lehet nyitni, 18 éves kor alatt szülő vagy gondviselő engedélyével.
Adj hozzá egy RemoteEventet, hogy a játékosok eszközt kérhessenek a ServerStorage.Tools mappából. Mindent a szerveren ellenőrizz.
- Előbb átnézheti a place-t a Search Game és a List Children eszközzel, hogy megtalálja a Tools mappát és a már eszközöket kiosztó scripteket
- A Create Script eszközzel szerverscriptet ír, és a Create Instance eszközzel RemoteEventet adhat hozzá
- Befejezés előtt a Check Script eszközzel ellenőrzi a script fordítását a Studióban. Ez fordítási ellenőrzés, nem típusellenőrzés és nem playtest
- A módosításokat csomagokban küldi, és minden csomag egy visszavonási pont magának a Studiónak az előzményeiben
A 3.9-es vagy újabb pluginnal a RoCode rövid playtestet indíthat és elolvashatja a hibákat, a 3.9.15-ös vagy újabb pluginnal pedig a tesztkaraktere járni, billentyűket nyomni és a képernyőn lévő gombokra kattintani is tud, de csak azt ellenőrzi, amit maga ellenőrizni akart, ezért nyomd meg magad a Playt, hogy játékosként ellenőrizd az eredményt. A prompt általunk írt példa; a lépésekben a valódi eszköznevek szerepelnek. Hogyan működik a plugin és a párosítás. A RoCode független termék, amely nem kapcsolódik a Roblox Corporationhöz, és azt sem jóvá nem hagyta, sem nem szponzorálja.
Gyakori kérdések
Használhatom a Claude Desktopot a Claude Code helyett?
Igen. A Claude Desktop szerepel a Quick connect listán a Studio Manage MCP Servers paneljén, így egyetlen kapcsolóval csatlakozik, Windowson vagy Macen. Ugyanazokat a Studio-eszközöket használja; a Claude Code azt adja hozzá, amiben egy terminálos ügynök jó, például a scriptfájlokkal és a Gittel való munkát. Mindkettő lépései a Studio MCP beállítási útmutatóban vannak.
Csatlakozhat a Claude Code a Roblox Studióhoz?
Igen. A Roblox quick connect kliensként sorolja fel a Claude Code-ot a Studióba beépített MCP-szerverhez. Kapcsold be az Enable Studio as MCP server beállítást az Assistant > … > Manage MCP Servers alatt, kapcsold be a Claude Code-ot a Quick connect listában, és indítsd újra a Claude Code-ot. A scriptjeidet fájlokként is kezelheti a Script Sync vagy a Rojo segítségével.
Ingyenes a Claude Code a Roblox Studióhoz?
A Studio MCP-szerverének nincs dokumentált ára, de a Claude Code nincs benne az Anthropic Free csomagjában (claude.com/pricing, ellenőrizve 2026. október 9-én). Fizetős Claude csomag kell, ahol a csomagod használati limitjein osztozik, vagy egy Claude Console-fiók API-használat szerinti fizetéssel.
Kell Roblox plugin vagy HTTP-kérés a Claude Code használatához?
A Studio beépített MCP-szerveréhez nem. A Roblox beállítási lépései: bekapcsolni a szervert az Assistantben, és csatlakoztatni a klienst; nincs bennük sem telepítendő plugin, sem módosítandó HTTP-beállítás. Néhány régebbi útmutató közösségi MCP-szervereket ír le, amelyek másképp működnek. A Rojo, ha a fájlokhoz azt választod, saját Studio plugint használ.
Tesztelheti a Claude Code a Roblox játékomat?
A Studio MCP eszközein keresztül igen. A start_stop_play elindítja és leállítja a playtestet, a get_console_output olvassa az Outputot, a screen_capture rögzíti a viewportot, a beviteli eszközök pedig mozgatják a karaktert, és billentyűket és kattintásokat küldenek. Ellenőrizd, amiről beszámol, és publikálás előtt játssz magad is a játékkal.
Mit válasszak a Roblox Studióhoz: Claude Code-ot vagy Codexet?
Mindkettő szerepel a Roblox quick connect listáján, és ugyanazokat a Studio MCP eszközöket éri el, így a különbség a modellben, a fiókban és a köré épülő kliensben van. A Roblox nem tesz közzé összehasonlítást, és mi sem végeztünk összehasonlító teszteket. Próbáld ki mindkettőt a place-ed egy másolatán ugyanazokkal az írásos szabályokkal, és tartsd meg azt, amelyiknek a módosításai kevesebb javítást igényelnek.
Működik a Claude Code a Roblox Studióval Macen?
Igen. A Claude Code támogatja a macOS 13.0-s és újabb verzióit, a Roblox pedig dokumentálja a szerver macOS-es útvonalát, a /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP fájlt, a kézzel beállított kliensekhez.
Források és további olvasnivaló
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (angolul). a szerver bekapcsolása, quick connect, beállítás JSON-nal és CLI-vel, eszközök, több Studio ablak és hibaelhárítás
- Roblox Creator Docs: Build with a coding harness (angolul). a Claude Code a VS Code-ban, a Script Sync, az MCP és a Git együtt
- Roblox Creator Docs: Script Sync (angolul). mi szinkronizálódik, fájlnév-szabályok, ütközések és language server
- Roblox Creator Docs: Third-party tools (angolul). Rojo Rokittal és verziókezelés
- Roblox Creator Docs: Secrets stores (angolul). hogyan tartsd az API-kulcsokat a scripteken kívül
- Roblox Creator Docs: Data stores (angolul). miért csak tesztmásolatban kell a Studio API services hozzáférése
- Rojo documentation (v7) (angolul). telepítés, és hogyan lesznek a fájlnevekből objektumok
- Claude Code Docs: Overview (angolul). minden változat ugyanazt a motort használja, az asztali alkalmazáshoz pedig fizetős előfizetés kell
- Claude Code Docs: Advanced setup (angolul). rendszerkövetelmények és telepítési parancsok
- Claude Code Docs: Authentication (angolul). belépés és megfelelő fióktípusok
- Claude Code Docs: Connect Claude Code to tools via MCP (angolul). stdio-szerverek, .mcp.json, hatókörök és a szerver állapota
- Claude Code Docs: Configure permissions (angolul). allow, ask és deny szabályok, az MCP-eszközöket is beleértve
- Claude Code Docs: Choose a permission mode (angolul). az auto mód mint kezdőmód, a Manual mód és a plan mód
- Claude Code Docs: How Claude remembers your project (angolul). CLAUDE.md, /init és AGENTS.md
- Claude Code Docs: Checkpointing (angolul). mit állít vissza a /rewind, és mit nem követ
- Claude Code Docs: Manage costs effectively (angolul). /usage, a kontextus mérete és a modell választása
- Claude Code Docs: Use Claude Code in the cloud (angolul). miért nem a számítógépeden futnak a felhős munkamenetek
- Claude Code Docs: Use Claude Code in VS Code (angolul). követelmények, a PATH-megjegyzés, közös MCP-konfiguráció és a Problems panel
- Claude Code Docs: Extend Claude with skills (angolul). mit ad egy skill allowed-tools mezője
- Claude pricing (angolul). mely csomagokban van benne a Claude Code, és a használati limitek
- Claude Help Center: Use Claude Code with your Pro or Max plan (angolul). közös limitek és figyelmeztetés az ANTHROPIC_API_KEY változóról
- Anthropic: Consumer Terms of Service (angolul). minimális életkor
Hogyan ellenőriztük a kódot: az oldalon minden script átmegy a Luau szigorú típusellenőrzésén a Roblox API definícióival (luau-lsp, 2026. november 20.). A típusellenőrzés kiszűri az elírt API-neveket és a rossz típusokat, de a játéklogikai hibákat nem, ezért publikálás előtt mindent tesztelj a Studióban.