Útmutató · AI a Roblox Studióban

Hogyan csatlakoztasd a Claude Code-ot a Roblox Studióhoz

A Claude Code az Anthropic ügynökalapú kódolóeszköze. A Roblox quick connect kliensként sorolja fel a Studióba beépített MCP-szerverhez, így olvasni tudja a place-edet, szerkesztheti a scripteket, és playteszteket indíthat a nálad nyitott Studio ablakban. A scriptjeidet fájlokként is kezelheti a Script Sync vagy a Rojo segítségével. Ez az útmutató a Claude Code oldaláról szól: mi kell hozzá, hogyan csatlakoztasd, az engedélyek, egy Roblox-szabályokat tartalmazó CLAUDE.md, a biztonságos munkamódszer és a költségek. Az OpenAI ügynökéről a hogyan használd az OpenAI Codexet a Roblox Studióval útmutató szól (angolul); a Cursorról, a Claude Desktopról és más kliensekről a Studio MCP beállítási útmutató.

Frissítve 2026. november 20.21 perc olvasásSzerző:

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 /rewind parancsa nem vonja vissza a Studióban végzett módosításokat, ezért előbb ments egy verziót.
Ezen az oldalon
  1. Mi kell
  2. 1. Telepítés és belépés
  3. 2. Csatlakozás a Studióhoz
  4. 3. Engedélyek
  5. 4. Első kérés
  6. 5. Script Sync vagy Rojo
  7. 6. CLAUDE.md
  8. Biztonságos munka
  9. Költségek
  10. Hibaelhárítás
  11. Plugin-ügynök
  12. Gyakori kérdések
  13. Források és további olvasnivaló

Mi kell a kezdéshez

Követelmények a Roblox és az Anthropic dokumentációja szerint, 2026. október 9.
Mi kellRészletek
Roblox StudioA 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épmacOS 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 CodeFizető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.
ÉletkorAz 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álisanGit 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.

Claude Code változatok és a Roblox Studio
VáltozatEléri a Studiót?Megjegyzések
Terminál (claude parancs)IgenA projektmappában indítsd. Az alábbi claude mcp parancsokhoz is ez kell.
VS Code vagy Cursor bővítményIgenA 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ássalIgenA 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)NemFelhő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.

Terminál · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Nyiss egy új terminálablakot, és futtasd a claude --version parancsot. 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.
  2. Lépj a projektmappába, és futtasd a claude parancsot. Első indításkor böngészőablakot nyit a belépéshez. Ha a böngésző nem nyílt meg, nyomd meg a c billentyűt a belépési link kimásolásához.
  3. 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

  1. 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.
  2. Kapcsold be a Claude Code-ot. Ha nincs ott, telepítsd a Claude Code-ot, és indítsd újra a Studiót.
  3. Indítsd újra a Claude Code-ot: zárd le a munkamenetet, és futtasd újra a claude parancsot, 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:

.mcp.json · Windows (a Roblox konfigurációja)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
.mcp.json · macOS (a Roblox konfigurációja)
{
  "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.

Terminál · macOS
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 list minden szervert és annak állapotát mutatja. A claude mcp get Roblox_Studio többet mutat, többek között egy Issue: sort, ha a szerver nem tudott csatlakozni.
  • A Claude Code-on belül írd be a /mcp parancsot. 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 default parancsot. 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.
.claude/settings.json · példa
{
  "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:

Prompt
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 és Rojo, a Roblox Script Syncről és külső eszközökről szóló oldalai szerint
Script SyncRojo
Mi ezA 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álCsak 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ásKattints 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 CreateMű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ácsaJó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 Script Sync szabályai a Roblox Script Sync oldaláról (.luau fájlok). A Rojo szabályai a Rojo v7 Sync Details oldaláról, ahol .lua fájlok szerepelnek
A fájlnév végeA Script Sync létrehozA Rojo létrehoz
.serverScript Server futtatási kontextussalScript
.clientScript Client futtatási kontextussalLocalScript
.localLocalScriptNincs különleges jelentése (bármely más .lua fájl ModuleScript)
Utótag nélkülModuleScriptModuleScript
Mappa init fájllalGyermekobjektumokkal rendelkező script, amelynek típusát az init fájl neve adja megA 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

  1. 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 és StarterPlayerScripts, és futtasd benne a git init parancsot.
  2. 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.
  3. 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.
  4. Futtasd a claude parancsot ebben a mappában. Most a Claude a .luau fájlokat szerkeszti, a Studio pedig átvesz minden módosítást.
  5. Minden munkamenet előtt commitolj, hogy mindig legyen egy tiszta pont, ahová visszatérhetsz.
Terminál, a projektmappában
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.

CLAUDE.md · példa egy Script Synces projekthez
# 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.

Script helye: ServerScriptService neve: 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")

-- 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

  1. 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.
  2. Kérj tervet mindenhez, ami egy scriptnél nagyobb, és olvasd el, mielőtt jóváhagyod.
  3. Nézd át a diffet. Fájloknál olvasd el a git diff kimeneté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.
  4. 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.
  5. 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, a CLAUDE.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 a CLAUDE.local.md fájlban tartsd, amelyeket úgy terveztek, hogy a Giten kívül maradjanak. A CLAUDE.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-tools mező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 /clear parancsot 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 a script_read is 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 /model paranccsal 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.

Te írod

Adj hozzá egy RemoteEventet, hogy a játékosok eszközt kérhessenek a ServerStorage.Tools mappából. Mindent a szerveren ellenőrizz.

A RoCode elvégzi
  • 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ó

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.

Próbáld ki a RoCode-ot a saját játékodban.

Ingyenes kreditek minden nap, bankkártya nélkül. Telepítsd a plugint, írd le a funkciót, és nézd meg, mi jelenik meg a Studióban.