In het kort
Installeer Claude Code en log in met een betaald Claude-plan of een Claude Console-account. Open in Studio Assistant, klik op … > Manage MCP Servers, zet Enable Studio as MCP server aan en zet daarna Claude Code aan in de lijst Quick connect. Herstart Claude Code, typ /mcp om te controleren dat de server van Studio verbonden is, en begin met een verzoek dat alleen leest.
- Claude Code zit niet in het Free-plan van Anthropic. Het zit in Pro, Max, Team en Enterprise, of je betaalt naar API-gebruik via een Claude Console-account (gecontroleerd op 9 oktober 2026).
- Gebruik een lokale sessie: de terminal, de extensie voor VS Code of Cursor, of de desktopapp met Local gekozen. Cloudsessies draaien niet op je computer en bereiken Studio niet.
- Vanaf v2.1.283 starten sessies in de terminal en VS Code standaard in de auto-modus waar die beschikbaar is, dus voeg ask-regels toe voor Studio-tools die de place veranderen. Het commando
/rewindin Claude Code maakt wijzigingen in Studio niet ongedaan, dus sla eerst een versie op.
Op deze pagina
Wat je nodig hebt voordat je begint
| Wat je nodig hebt | Details |
|---|---|
| Roblox Studio | De nieuwste versie, op Windows of macOS. De MCP-server zit in Studio ingebouwd, dus aan de kant van Roblox hoef je niets anders te installeren. |
| Een computer die Claude Code ondersteunt | macOS 13.0 of nieuwer, of Windows 10 1809 of nieuwer, minstens 4 GB werkgeheugen, een internetverbinding en een locatie in een land dat Anthropic ondersteunt. |
| Een Claude-account waarin Claude Code zit | Een betaald Claude-plan (Pro, Max, Team of Enterprise) of een Claude Console-account. Op de prijspagina van Anthropic staat dat Claude Code niet in het Free-plan zit. |
| Leeftijd | In de Consumer Terms van Anthropic (geldig sinds 8 oktober 2025) staat dat je minstens 18 moet zijn, of de minimumleeftijd voor toestemming in je land als die hoger is. |
| Optioneel | Git, om de geschiedenis van je scripts te bewaren. Visual Studio Code 1.94.0 of nieuwer, of Cursor, als je Claude Code in een editorpaneel wilt in plaats van in de terminal. |
Welke Claude Code je gebruikt
Claude Code draait op meerdere plekken. Anthropic schrijft dat ze allemaal dezelfde motor hebben, dus je CLAUDE.md, instellingen en MCP-servers werken overal. Voor Studio telt waar de sessie draait: de MCP-server van Roblox is een lokaal proces op je computer, dus de sessie moet ook op je computer draaien.
| Variant | Bereikt Studio? | Opmerkingen |
|---|---|---|
Terminal (commando claude) | Ja | Start hem in de projectmap. Je hebt hem ook nodig voor de commando's claude mcp hieronder. |
| Extensie voor VS Code of Cursor | Ja | De route uit de handleiding van Roblox over een coding harness. De extensie bevat een eigen kopie van Claude Code, maar zet claude niet in het PATH, dus installeer ook de terminalversie als je die commando's nodig hebt. |
| Desktopapp, tabblad Code, met Local gekozen | Ja | Draait op je computer. Anthropic schrijft dat je een betaald abonnement nodig hebt. |
| Cloudsessies (claude.ai/code of Cloud in de desktopapp) | Nee | Die draaien op cloudinfrastructuur en niet op je computer, dus ze kunnen de lokale server van Studio niet starten. |
Stap 1: installeer Claude Code en log in
Anthropic raadt een installatie met één commando in de terminal aan. Dit zijn de commando's die op 9 oktober 2026 op de installatiepagina stonden; de actuele vind je op de installatiepagina van Anthropic.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Open een nieuw terminalvenster en voer
claude --versionuit. Een versienummer betekent dat het gelukt is. Wordt het commando niet gevonden, dan staat de installatiemap nog niet in het PATH, en de oplossing staat op de pagina van Anthropic over installatieproblemen. - Ga naar de projectmap en voer
claudeuit. Bij de eerste start opent hij een browservenster om in te loggen. Opent de browser niet, druk dan opcom de inloglink te kopiëren. - Log in met je Claude-account. Inloggen met Pro of Max gebruikt de limieten die in je plan zitten.
Op Windows raadt Anthropic aan Git for Windows te installeren, zodat Claude Code zijn Bash-tool kan gebruiken; zonder Git voert Claude Code commando's uit in PowerShell. Installeer Claude Code voor deze opzet in Windows zelf, niet in WSL: de Windows-configuratie van Roblox start cmd.exe met een pad met %LOCALAPPDATA%, en WSL documenteert Roblox niet.
Liever een paneel in je editor? Open in VS Code of Cursor Extensions (Ctrl+Shift+X, of Cmd+Shift+X op een Mac), zoek Claude Code, installeer het en log in vanuit het Claude-paneel. Precies die opzet gebruikt de handleiding van Roblox over een coding harness.
Stap 2: verbind Claude Code met Studio
Zet eerst de server aan. Open in Studio Assistant, klik op … > Manage MCP Servers en zet Enable Studio as MCP server aan. De handleiding over Studio MCP behandelt deze stap uitgebreider. Geen Assistant-knop? Zie hoe je het Assistant-paneel opent.
Quick connect
- Klap in hetzelfde paneel (Assistant Settings > MCP Servers) de lijst Quick connect open. Daarin staan de ondersteunde clients die op je computer geïnstalleerd zijn.
- Zet Claude Code aan. Staat hij er niet in, installeer Claude Code dan en herstart Studio.
- Herstart Claude Code: beëindig de sessie en voer opnieuw
claudeuit, of begin een nieuw gesprek in de extensie. Roblox schrijft dat de client een herstart nodig heeft om de nieuwe configuratie op te pikken.
Roblox zegt niet naar welk bestand Claude Code de Quick connect schrijft en hoe hij de server noemt. Typ /mcp in Claude Code om de naam te zien. Die heb je nodig voor de toestemmingsregels in stap 3.
Gebruik je de Claude Code-extensie in VS Code of Cursor? Zet ook dan Claude Code aan. De handleiding van Roblox over een coding harness noemt Cursor of Visual Studio Code, maar Anthropic documenteert dat de extensie de MCP-configuratie deelt met de terminalversie van Claude Code, en zegt niet dat hij de eigen MCP-instellingen van de editor leest.
Handmatig instellen met een .mcp.json-bestand
Werkt Quick connect bij jou niet, voeg Studio dan zelf toe. Claude Code leest de MCP-servers van een project uit een bestand met de naam .mcp.json in de projectmap, in hetzelfde formaat mcpServers dat Roblox documenteert, en ziet een entry zonder type als lokale stdio-server. Daarom werkt de configuratie van Roblox zoals ze is. Sla de variant voor jouw systeem op als .mcp.json in de map waarin je claude start:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
De volgende keer dat je claude in die map start, vraagt hij je de server goed te keuren: Anthropic toont die vraag voor elke server die uit een .mcp.json-bestand komt. Anthropic heeft dit bestand bedoeld om te committen en met het hele team te delen, maar de paden voor Windows en macOS verschillen. Gebruikt je team beide systemen, houd het bestand dan buiten de repository en laat iedereen Studio zelf toevoegen.
Op macOS kun je Studio in plaats daarvan met één commando toevoegen. --scope user maakt hem beschikbaar in elk project op je computer; zonder die optie laadt de server alleen in de huidige map. -- scheidt de eigen opties van Claude Code van het commando dat de server start.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Op Windows is de route met het JSON-bestand eenvoudiger, omdat PowerShell en CMD %LOCALAPPDATA% op de commandoregel verschillend behandelen.
Controleer de verbinding
- In de terminal toont
claude mcp listelke server en de status ervan.claude mcp get Roblox_Studiotoont meer, waaronder een regelIssue:als de server geen verbinding kon maken. - Typ in Claude Code
/mcp. Bij verbonden servers staat het aantal tools naast de naam. - In Studio toont Assistant > … > Manage MCP Servers een groene indicator met het aantal verbonden clients.
Stap 3: bepaal wat Claude zonder te vragen mag doen
Stel dit in voordat Claude je place aanraakt. Volgens de pagina van Anthropic over toestemmingsmodi starten interactieve sessies in de terminal en VS Code vanaf Claude Code v2.1.283 standaard in de auto-modus waar die beschikbaar is, en in de auto-modus controleert een classifier op de achtergrond de acties in jouw plaats. Een MCP-aanroep die een script bewerkt of Luau uitvoert in Studio kan dan zonder vraag doorgaan.
Er zijn twee manieren om elke wijziging in eigen hand te houden:
- Start in de Manual-modus. Voer
claude --permission-mode defaultuit. In de Manual-modus gebeurt alleen lezen zonder vraag. Druk tijdens een sessie op Shift+Tab om van modus te wisselen. - Voeg ask-regels toe voor Studio-tools die iets veranderen. Anthropic schrijft dat geen enkele modus een tool automatisch goedkeurt die onder een expliciete ask-regel valt, zelfs de bypass-modus niet.
{
"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-regels hebben de vorm mcp__<server>__<tool>, met de servernaam zoals Claude Code die kent. Vervang Roblox_Studio door de naam die /mcp toont. Allow-regels in het projectbestand .claude/settings.json gaan pas gelden nadat je het vertrouwensdialoog voor de werkmap van die map hebt geaccepteerd. Gebruik .claude/settings.local.json voor regels die alleen jij nodig hebt.
De allow-lijst dekt tools die alleen lezen: de gameboom, properties, scripts, de Output en de lijst met open vensters van Studio. De ask-lijst dekt tools die de place veranderen, code uitvoeren, playtests starten, externe assets binnenbrengen of afbeeldingen naar Roblox sturen. Tools die in geen van beide lijsten staan, zoals screen_capture en de invoertools, volgen je toestemmingsmodus. De volledige lijst met tools en een beschrijving van elke tool staat in de handleiding over Studio MCP.
Stap 4: begin met een verzoek dat alleen leest
Open de place waarmee je wilt werken en sluit de places waarmee je dat niet wilt. Geef Claude daarna een eerste verzoek dat niets kan veranderen:
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.
Op een verse Baseplate verwacht de handleiding van Roblox over een coding harness dat het antwoord de standaard Camera, Terrain, Baseplate en SpawnLocation noemt. Eerst om list_roblox_studios vragen is een goede gewoonte: één client bereikt elk venster van Studio dat je open hebt, en elke tool-aanroep noemt het doelvenster via studio_id.
Vraag voor alles wat groter is dan één script eerst om een plan. In de plan-modus (druk op Shift+Tab of begin de prompt met /plan) onderzoekt Claude en doet hij voorstellen zonder je bestanden te bewerken. Anthropic beschrijft de plan-modus in termen van bestandsbewerkingen en shell-commando's, dus laat de ask-regels voor Studio-tools ook staan.
Stap 5: werk met scripts als bestanden via Script Sync of Rojo
Claude Code is gebouwd rond bestanden in een map. Hij bewerkt ze met zijn eigen tools, Git bewaart hun geschiedenis, en /rewind kan ze herstellen. Zet je de scripts op schijf, dan kun je dat allemaal gebruiken, en blijven de MCP-tools voor de delen van de place die geen scripts zijn, zoals GUI's in StarterGui, RemoteEvents en parts. Roblox documenteert twee manieren om dat te doen.
| Script Sync | Rojo | |
|---|---|---|
| Wat het is | Een functie van Studio die scripts in de place synchroniseert met bestanden op schijf, in beide richtingen. | Een tool van derden: een server op je computer plus een plugin voor Studio. |
| Wat het synchroniseert | Alleen objecten van het type Script, LocalScript, ModuleScript en Folder. Andere objecten in een gesynchroniseerde map worden genegeerd. | Kan het hele project als bestanden bijhouden, met je bestandssysteem als bron van waarheid. |
| Instellen | Klik met rechts op een service of map in de Explorer, kies Sync to… en wijs een map aan. De handleiding van Roblox over een coding harness zet het eerst aan in File > Beta Features. | Installeer het via Rokit (rokit add rojo-rbx/rojo, daarna rokit install), voeg de plugin toe met rojo plugin install, voer rojo serve uit en verbind vanuit de plugin. |
| Team Create | Werkt ermee. Vermijd dat twee mensen tegelijk hetzelfde gesynchroniseerde script bewerken. | Roblox merkt op dat tools van derden vaak niet werken met de ingebouwde tools voor samenwerken. |
| Advies van Roblox | Geschikt als je je eigen editor en versiebeheer voor code wilt, en Studio voor al het andere. | De beste keuze als je het hele project in versiebeheer wilt, niet alleen de code. |
Dezelfde bestandsnaam kan iets anders betekenen
Beide tools kiezen het type script op basis van de bestandsnaam, en hun achtervoegsels komen niet overeen. Een bestand .client is in Rojo een LocalScript, maar in Script Sync een Script met de run context Client. Vertel Claude welke tool je project gebruikt; het voorbeeld van CLAUDE.md hieronder doet dat.
| Bestandsnaam eindigt op | Script Sync maakt | Rojo maakt |
|---|---|---|
.server | Script met run context Server | Script |
.client | Script met run context Client | LocalScript |
.local | LocalScript | Geen speciale betekenis (elk ander .lua-bestand is een ModuleScript) |
| Zonder achtervoegsel | ModuleScript | ModuleScript |
Map met een init-bestand | Een script met child-objecten, waarvan de bestandsnaam van init het type bepaalt | De map wordt het script dat init.server.lua, init.client.lua of init.lua beschrijft |
Script Sync instellen voor Claude Code
- Maak een projectmap met één map voor elke service die je op schijf wilt houden, bijvoorbeeld
ServerScriptService,ReplicatedStorageenStarterPlayerScripts, en voer daaringit inituit. - Verschijnt Script Sync niet als je met rechts op een service klikt, zet het dan aan in File > Beta Features, klik op Save en herstart Studio.
- Klik in de Explorer met rechts op ServerScriptService, kies Script Sync > Sync to en wijs de bovenste projectmap aan, niet een map daarbinnen. Herhaal dit voor de andere services.
- Voer
claudeuit in die map. Nu bewerkt Claude.luau-bestanden en pikt Studio elke wijziging op. - Commit voor elke sessie, zodat er altijd een schoon punt is om naar terug te gaan.
git add .
git commit -m "Before Claude session"
Twee regels van Script Sync worden belangrijker met een agent. Synchroniseer geen scripts met attributen of tags: Script Sync negeert die, en Roblox waarschuwt dat dat tot gegevensverlies kan leiden. En veranderen bestanden terwijl Studio dicht is, dan vraagt Studio bij het opnieuw openen van de place hoe je dat wilt oplossen, en somt het op wat Keep Studio en Keep Disk toevoegen, veranderen of verwijderen. Lees die lijst voordat je kiest.
Met Script Sync aan komt een bestandsbewerking direct na het opslaan in Studio terecht. Een bewerking accepteren in Claude Code is dus die bewerking accepteren in je place, dus controleer voordat je accepteert, vooral in modi die bewerkingen automatisch accepteren.
Voor autocomplete en typefouten in de editor raadt Roblox de extensie Luau Language Server aan, met de bijbehorende plugin voor Studio. In VS Code kan de Claude Code-extensie het Problems-paneel lezen via een ingebouwde tool, zodat Claude dezelfde waarschuwingen ziet als jij.
Stap 6: geef Claude je regels voor Roblox in CLAUDE.md
Elke sessie van Claude Code begint met een verse context. Het bestand CLAUDE.md in de projectmap wordt aan het begin van elke sessie gelezen, dus daar horen je afspraken in. Voer /init uit zodat Claude een opzet maakt, of schrijf het zelf. Anthropic raadt aan het korter dan 200 regels te houden, regels zo concreet te schrijven dat je ze kunt controleren, en /context uit te voeren om te zien of het geladen is.
Dit voorbeeld is voor deze handleiding geschreven, voor een project met Script Sync. Pas de namen aan je game aan en haal weg wat je niet nodig hebt.
# 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.
Sommige regels staan erin vanwege de manier waarop de tools werken. De regels over bestandsnamen staan erin omdat .client.luau in Script Sync geen LocalScript is. De regel over list_roblox_studios staat erin omdat de server elk open venster bereikt. De regel over assets staat erin omdat insert_asset externe content in de place brengt en upload_image afbeeldingen naar de assetserver van Roblox stuurt. De regel over wait volgt de API-naslag van Roblox, die wait, spawn en delay als verouderd markeert ten gunste van de task-bibliotheek.
Heeft je project al een AGENTS.md voor andere agents voor code, dan kan Claude Code die lezen als projectinstructies, dus je kunt één bestand voor allebei houden. De pagina van Anthropic over geheugen legt uit welk bestand wint als er allebei zijn.
Hoe deze regels er in code uitzien
Hier is een serverscript dat de Luau-regels hierboven volgt. Het is met de hand voor deze handleiding geschreven, niet door Claude gegenereerd. Gebruik het als maatstaf als je controleert wat Claude oplevert. Een LocalScript vraagt een tool aan via RequestTool:FireServer("Sword"), en de server controleert alles.
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 synchroniseert alleen scripts en mappen, dus de server maakt zijn remote zelf.
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)
-- Negeer een verzoek dat binnenkomt nadat de speler is vertrokken.
if player.Parent ~= Players then
return
end
-- 1. Controleer het argument: de client kan van alles sturen.
if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
return
end
-- 2. Beperk hoe vaak één speler iets mag vragen.
local now = os.clock()
local last = lastRequest[player]
if last ~= nil and now - last < COOLDOWN_SECONDS then
return
end
lastRequest[player] = now
-- 3. De server beslist. Voeg hier je eigen controle op bezit toe (gamepass, aankoopregistratie).
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. Gegevens van de speler opruimen.
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
Op schijf met Script Sync: ServerScriptService/ToolRequests.server.luau. Zet de Tool-objecten in een Folder met de naam Tools in ServerStorage. Zolang je geen controle op bezit toevoegt, kan elke speler elke tool uit die map krijgen.
Zoek naar hetzelfde in elke remote-handler die Claude schrijft: hij controleert het type en de grootte van wat de client stuurde, beperkt hoe vaak één speler hem kan aanroepen, de server neemt de beslissing, en de gegevens van de speler worden verwijderd als die vertrekt. De handleiding over RemoteEvent legt uit waarom elk punt belangrijk is.
Een veilige werkwijze: controlepunt, controle, playtest
- Maak aan beide kanten een controlepunt. Commit de bestanden in Git en sla in Studio een versie van de place op via File > Save to Roblox with Notes. De handleiding over Studio MCP laat zien hoe je die herstelt uit Version History.
- Vraag om een plan voor alles wat groter is dan één script, en lees het voordat je het goedkeurt.
- Controleer de diff. Lees voor bestanden
git diffof de ingebouwde diffs in de extensie voordat je accepteert. Lees voor wijzigingen in Studio de scripts die Claude heeft aangeraakt, en kijk in de Explorer naar objecten die erbij zijn gekomen of verdwenen. - Test zelf. Claude kan een playtest starten en de Output lezen, maar hij controleert alleen wat hij zelf besloot te controleren. Speel de functie zoals een speler dat zou doen, voordat je commit of publiceert.
- Commit als alles werkt, met een bericht over wat er veranderd is.
Wat /rewind wel en niet ongedaan kan maken
Claude Code slaat voor elke prompt een controlepunt op, en /rewind (of twee keer Esc) herstelt bestanden die Claude met zijn eigen bewerkingstools heeft veranderd. Anthropic somt op wat hij niet bijhoudt, waaronder wijzigingen via shell-commando's. Wijzigingen in Studio via MCP-tools zijn geen bestandsbewerkingen, dus verwacht niet dat /rewind ze ongedaan maakt, en de MCP-pagina van Roblox zegt niet of ze in de undo-geschiedenis van Studio komen. Met Script Sync synchroniseert een bestand dat /rewind herstelde terug naar Studio, net als elke andere wijziging op schijf. Voor al het andere is de weg terug een opgeslagen versie.
Houd geheimen en live gegevens buiten bereik
- Plak geen API-sleutels, Open Cloud-sleutels, webhook-URL's of wachtwoorden in de prompt of in
CLAUDE.md. Allebei zijn het tekst die Claude leest, enCLAUDE.mdwordt meestal in de repository gecommit. - Zet ze ook niet vast in scripts. Roblox heeft een opslag voor geheimen per game: maak de geheimen aan in het Creator Dashboard en lees ze in een serverscript via
HttpService:GetSecret(). Voeg voor lokale playtests lokale geheimen toe in File > Experience Settings > Security. - Houd persoonlijke instellingen in
.claude/settings.local.jsonenCLAUDE.local.md, die bedoeld zijn om buiten Git te blijven. VoegCLAUDE.local.mdzelf toe aan.gitignore. - Zet Enable Studio Access to API Services alleen aan in een aparte testkopie van de game. Roblox waarschuwt dat Studio dezelfde data stores gebruikt als de live game, dus een playtest die Claude daar start kan echte spelersgegevens overschrijven.
- Lees een skill van derden voordat je hem installeert. In catalogi met skills staan Roblox-skills voor Claude Code, en Anthropic merkt op dat een skill zichzelf brede toegang tot tools kan geven via het veld
allowed-tools.
Wat Claude Code kost voor werk aan Roblox
De kant van Studio heeft geen gedocumenteerde prijs: de MCP-server is een onderdeel van Studio, en de MCP-pagina van Roblox noemt geen kosten. De kosten zijn de kosten van Claude Code, en Anthropic biedt twee manieren om te betalen (per 9 oktober 2026):
- Een Claude-abonnement. Claude Code zit in Pro, Max, Team en Enterprise, maar niet in Free. Het gebruikt dezelfde gebruikslimiet als Claude op het web, op de desktop en op mobiel. De limieten worden gereset in een schuivend venster van vijf uur, en betaalde plannen hebben daarbovenop weeklimieten. Bereik je er een, dan kun je wachten, naar een hoger plan gaan of gebruikscredits aanzetten.
- Een Claude Console-account. Je betaalt voor API-gebruik naar de hoeveelheid verwerkte tekst. De pagina van Anthropic over kosten zegt dat de uitgaven sterk afhangen van de keuze van het model, de grootte van de codebase en hoe je hem gebruikt.
De actuele prijzen staan op claude.com/pricing. Deze handleiding herhaalt ze niet, omdat ze veranderen. In Claude Code toont het commando /usage abonnees de gebruiksbalken van hun plan, en API-gebruikers de geschatte kosten van de sessie.
Waardoor een sessie met Roblox meer verbruikt
- Grootte van de context. Het verbruik groeit met wat Claude in zijn context heeft. Gebruik
/cleartussen taken die niets met elkaar te maken hebben. - Grote resultaten van tools. De hele gameboom van een grote place doorlopen, of lange scripts helemaal lezen, levert veel tekst op. Claude Code telt tekst in de eenheden waarmee het model die meet: hij waarschuwt als het resultaat van een MCP-tool meer dan 10 000 van die eenheden is, en beperkt het standaard tot 25 000. Vraag in plaats daarvan om één map, een dieptegrens of een reeks regels: zowel
search_game_treealsscript_readondersteunt dat. - Keuze van het model. Anthropic schrijft dat Sonnet de meeste taken met code goed aankan en minder kost dan Opus. Wissel met
/model.
Problemen oplossen met Claude Code en Studio
De eigen checklist van Roblox is kort: Studio en de client herstarten, controleren of het pad naar het commando bestaat, en de JSON controleren. Dit zijn de gevallen die typisch zijn voor Claude Code.
Claude Code staat niet in de lijst Quick connect
De lijst toont alleen ondersteunde clients die op je computer geïnstalleerd zijn. Installeer Claude Code en herstart daarna Studio. Heb je hem geïnstalleerd terwijl Studio open was, herstart dan Studio, Claude Code of allebei. Het .mcp.json-bestand uit stap 2 werkt zonder Quick connect.
/mcp toont de server van Roblox Studio niet
Herstart Claude Code na het toevoegen van de server. Controleer daarna waar hij is toegevoegd: een server die zonder --scope is toegevoegd, laadt alleen in de map waar je hem toevoegde, dus start claude vanuit die map of voeg hem opnieuw toe met --scope user. Begin in VS Code een nieuw gesprek, want wijzigingen gelden voor gesprekken die daarna beginnen.
De server toont Pending approval
Hij komt uit een .mcp.json-bestand, en Claude Code vraagt het eerst voordat hij zulke servers gebruikt. Voer claude uit in die map, accepteer het vertrouwensdialoog voor de werkmap en keur de server goed. claude mcp reset-project-choices zet eerdere keuzes terug.
De server toont Failed to connect
Voer claude mcp get Roblox_Studio uit en lees de regel Issue:. Controleer of het bestand bestaat: %LOCALAPPDATA%\Roblox\mcp.bat op Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP op macOS (pas het pad aan als Studio ergens anders staat). Zorg dat Enable Studio as MCP server nog aan staat, en herstart daarna Studio en Claude Code.
De terminal meldt dat claude niet herkend wordt
Open na de installatie een nieuw terminalvenster. Wordt het commando nog steeds niet gevonden, dan staat de installatiemap niet in het PATH; de oplossing staat op de pagina van Anthropic over installatieproblemen. De extensie voor VS Code zet claude niet in het PATH, dus installeer voor de commando's uit deze handleiding de terminalversie apart.
Claude heeft de verkeerde place veranderd
Met meerdere open vensters van Studio noemt elke tool-aanroep het doel via studio_id. Vraag Claude list_roblox_studios aan te roepen en noem de juiste place, sluit vensters die je niet gebruikt, en herstel de gewijzigde place uit Version History.
Claude Code rekent af via mijn API-sleutel en niet via mijn plan
Zodra je hem hebt goedgekeurd, gaat de omgevingsvariabele ANTHROPIC_API_KEY voor het abonnement. Verwijder de variabele (of zet Use custom API key uit in /config), start Claude Code opnieuw en voer /status uit om te zien welke login actief is. Is dat nog steeds een Console-account, voer dan /login uit en kies je Claude-account.
Een cloudsessie ziet Studio niet
Cloudsessies draaien op de infrastructuur van Anthropic, niet op je computer, dus ze bereiken de lokale server van Studio niet. Gebruik de terminal, de extensie voor de editor of de desktopapp met Local gekozen.
Of neem in plaats daarvan een agent als plugin: RoCode
Claude Code met MCP past bij wie zich thuis voelt in een terminal of code-editor. RoCode (RoCode.app) is een andere route: een onafhankelijke AI-agent voor Roblox Studio met een webchat op rocode.app en een gratis plugin uit de Creator Store die de stappen uitvoert in de place die je open hebt. Het is geen MCP-product en het gebruikt de MCP-server van Studio niet, dus er is geen commandoregel, geen configuratiebestand en geen MCP-server om in te stellen. De plugin maakt zelf verbinding als Studio is ingelogd met hetzelfde Roblox-account dat je in RoCode gebruikt; anders koppel je de chat en de plugin één keer met een code van 8 tekens die in het pluginpaneel staat.
Wat je moet weten voordat je overstapt. RoCode kan geen abonnement op Claude of Claude Code koppelen. Het draait modellen van derden via OpenRouter, waaronder Claude Sonnet 5.5 vanaf Pro en Claude Opus 5.5 vanaf Studio, en het gratis Starter-plan geeft 1 credit per dag op GPT-6 Luna. Het werkt vanuit de bewerkmodus. Met plugin 3.9 of nieuwer kan het in de Build-modus een korte playtest starten en de fouten lezen, en met plugin 3.9.11 of nieuwer een testpersonage besturen om te controleren of de game werkt. Met plugin 3.9.14 of nieuwer maakt het ook opnamen van wat het in de bewerkmodus heeft gebouwd en kan het repareren wat er verkeerd uitziet. Het voert geen code direct uit en genereert geen meshes, en de Studio MCP-tools kunnen allebei. Het kan gratis modellen in de Creator Store zoeken op basis van jouw woorden (scripts erin worden verwijderd), of een model, decal of mesh invoegen via asset-ID, en het bedenkt decor, gebouwen en props voor elke game opnieuw. De Ask-modus beantwoordt vragen over je place met tools die alleen lezen en verandert niets. Accounts zijn voor wie 13 jaar of ouder is, en onder de 18 met toestemming van een ouder of voogd.
Voeg een RemoteEvent toe zodat spelers een tool uit ServerStorage.Tools kunnen aanvragen. Controleer alles op de server.
- Kan eerst de place bekijken via Search Game en List Children, om de map Tools te vinden en scripts die al tools uitdelen
- Schrijft het serverscript via Create Script en kan een RemoteEvent toevoegen via Create Instance
- Controleert de compilatie van het script in Studio via Check Script voordat het klaar is. Dat is een compilatiecontrole, geen typecontrole en geen playtest
- Stuurt wijzigingen in groepen, en elke groep is een undo-punt in de geschiedenis van Studio zelf
Met plugin 3.9 of nieuwer kan RoCode een korte playtest starten en de fouten lezen, en met plugin 3.9.15 of nieuwer kan het testpersonage lopen, toetsen indrukken en op knoppen op het scherm klikken, maar het controleert alleen wat het zelf besloot te controleren, dus druk zelf op Play om het resultaat als speler te controleren. De prompt is een voorbeeld dat wij hebben geschreven; de stappen gebruiken de echte namen van de tools. Hoe de plugin en het koppelen werken. RoCode is een onafhankelijk product, niet verbonden aan, niet goedgekeurd en niet gesponsord door Roblox Corporation.
Veelgestelde vragen
Kan ik Claude Desktop gebruiken in plaats van Claude Code?
Ja. Claude Desktop staat in de lijst Quick connect in het paneel Manage MCP Servers in Studio, dus hij verbindt met één schakelaar, op Windows of Mac. Hij gebruikt dezelfde Studio-tools; Claude Code voegt toe waar een agent in de terminal goed in is, zoals werken met scriptbestanden en Git. De stappen voor allebei staan in de handleiding voor het instellen van Studio MCP.
Kan Claude Code verbinden met Roblox Studio?
Ja. Roblox noemt Claude Code als client voor Quick connect bij de MCP-server die in Studio is ingebouwd. Zet Enable Studio as MCP server aan in Assistant > … > Manage MCP Servers, zet Claude Code aan in de lijst Quick connect en herstart Claude Code. Hij kan ook met je scripts als bestanden werken via Script Sync of Rojo.
Is Claude Code gratis voor werk in Roblox Studio?
De MCP-server van Studio heeft geen gedocumenteerde prijs, maar Claude Code zit niet in het Free-plan van Anthropic (claude.com/pricing, gecontroleerd op 9 oktober 2026). Je hebt een betaald Claude-plan nodig, waarin hij de gebruikslimieten van je plan deelt, of een Claude Console-account met betaling naar API-gebruik.
Heb ik een Roblox-plugin of HTTP-verzoeken nodig om Claude Code te gebruiken?
Voor de ingebouwde MCP-server van Studio niet. De installatiestappen van Roblox zijn de server aanzetten in Assistant en een client verbinden; er is geen plugin om te installeren en geen HTTP-instelling om te veranderen. Sommige oudere handleidingen beschrijven MCP-servers van de community die anders werken. Rojo, als je dat voor bestanden kiest, gebruikt een eigen plugin voor Studio.
Kan Claude Code mijn Roblox-game testen?
Via de Studio MCP-tools wel. start_stop_play start en stopt een playtest, get_console_output leest de Output, screen_capture legt de viewport vast, en de invoertools bewegen het personage en sturen toetsen en klikken. Controleer waarover hij rapporteert, en speel de game zelf voor je publiceert.
Wat kies ik voor Roblox Studio: Claude Code of Codex?
Allebei staan ze in de lijst Quick connect van Roblox en bereiken ze dezelfde Studio MCP-tools, dus het verschil zit in het model, het account en de client eromheen. Roblox publiceert geen vergelijking, en wij hebben ze niet vergelijkend getest. Probeer ze allebei op een kopie van je place met dezelfde geschreven regels, en houd de versie waarvan de wijzigingen de minste reparaties nodig hebben.
Werkt Claude Code met Roblox Studio op een Mac?
Ja. Claude Code ondersteunt macOS 13.0 of nieuwer, en Roblox documenteert het serverpad voor macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, voor clients die je met de hand instelt.
Bronnen en verder lezen
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (in het Engels). de server aanzetten, Quick connect, instellen via JSON en CLI, tools, meerdere vensters van Studio en problemen oplossen
- Roblox Creator Docs: Build with a coding harness (in het Engels). Claude Code in VS Code, Script Sync, MCP en Git samen
- Roblox Creator Docs: Script Sync (in het Engels). wat er synchroniseert, regels voor bestandsnamen, conflicten en de language server
- Roblox Creator Docs: Third-party tools (in het Engels). Rojo met Rokit en versiebeheer
- Roblox Creator Docs: Secrets stores (in het Engels). hoe je API-sleutels buiten scripts houdt
- Roblox Creator Docs: Data stores (in het Engels). waarom toegang van Studio tot API services alleen in een testkopie hoort
- Rojo documentation (v7) (in het Engels). installatie en hoe bestandsnamen objecten worden
- Claude Code Docs: Overview (in het Engels). alle varianten hebben dezelfde motor, en de desktopapp heeft een betaald abonnement nodig
- Claude Code Docs: Advanced setup (in het Engels). systeemvereisten en installatiecommando's
- Claude Code Docs: Authentication (in het Engels). inloggen en geschikte soorten accounts
- Claude Code Docs: Connect Claude Code to tools via MCP (in het Engels). stdio-servers, .mcp.json, scopes en de status van de server
- Claude Code Docs: Configure permissions (in het Engels). allow-, ask- en deny-regels, ook voor MCP-tools
- Claude Code Docs: Choose a permission mode (in het Engels). de auto-modus als startmodus, de Manual-modus en de plan-modus
- Claude Code Docs: How Claude remembers your project (in het Engels). CLAUDE.md, /init en AGENTS.md
- Claude Code Docs: Checkpointing (in het Engels). wat /rewind herstelt en wat hij niet bijhoudt
- Claude Code Docs: Manage costs effectively (in het Engels). /usage, grootte van de context en keuze van het model
- Claude Code Docs: Use Claude Code in the cloud (in het Engels). waarom cloudsessies niet op je computer draaien
- Claude Code Docs: Use Claude Code in VS Code (in het Engels). vereisten, de opmerking over het PATH, gedeelde MCP-configuratie en het Problems-paneel
- Claude Code Docs: Extend Claude with skills (in het Engels). wat het veld allowed-tools van een skill geeft
- Claude pricing (in het Engels). in welke plannen Claude Code zit en de gebruikslimieten
- Claude Help Center: Use Claude Code with your Pro or Max plan (in het Engels). gedeelde limieten en de waarschuwing over ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (in het Engels). minimumleeftijd
Hoe de code is gecontroleerd: elk script op deze pagina doorloopt een strikte Luau-typecontrole met de Roblox API-definities (luau-lsp, 20 november 2026). De typecontrole vangt fouten in API-namen en verkeerde types op, maar geen fouten in de gamelogica, dus test alles in Studio voordat je publiceert.