Kurz gesagt
Installiere Claude Code und melde dich mit einem bezahlten Claude-Plan oder einem Claude-Console-Konto an. Öffne in Studio Assistant, klick auf … > Manage MCP Servers, schalte Enable Studio as MCP server ein und aktiviere dann unter Quick connect den Schalter Claude Code. Starte Claude Code neu, tipp /mcp, um zu prüfen, ob der Studio-Server verbunden ist, und fang mit einer Anfrage an, die nur liest.
- Claude Code ist nicht im Free-Plan von Anthropic. Es ist in Pro, Max, Team und Enterprise enthalten oder wird über ein Claude-Console-Konto nach Verbrauch abgerechnet (geprüft am 9. Oktober 2026).
- Nutze eine lokale Sitzung: das Terminal, die Erweiterung für VS Code oder Cursor oder die Desktop-App mit der Auswahl Local. Cloud-Sitzungen laufen nicht auf deinem Computer und erreichen Studio nicht.
- Seit v2.1.283 starten Sitzungen im Terminal und in VS Code standardmäßig im Auto-Modus, wo er verfügbar ist, also füge ask-Regeln für die Studio-Tools hinzu, die dein Spiel ändern.
/rewindvon Claude Code macht Änderungen in Studio nicht rückgängig, also speichere vorher eine Version.
Auf dieser Seite
Was du brauchst, bevor du anfängst
| Du brauchst | Details |
|---|---|
| Roblox Studio | Die neueste Version, unter Windows oder macOS. Der MCP-Server ist in Studio eingebaut, also gibt es auf der Roblox-Seite sonst nichts zu installieren. |
| Einen Computer, den Claude Code unterstützt | macOS 13.0 oder neuer oder Windows 10 1809 oder neuer, mit 4 GB RAM oder mehr, einer Internetverbindung und einem Standort in einem Land, das Anthropic unterstützt. |
| Ein Claude-Konto, das Claude Code enthält | Einen bezahlten Claude-Plan (Pro, Max, Team oder Enterprise) oder ein Claude-Console-Konto. Die Preisseite von Anthropic führt Claude Code als nicht im Free-Plan enthalten. |
| Alter | Laut den Consumer Terms von Anthropic (gültig ab 8. Oktober 2025) musst du mindestens 18 sein oder das Mindestalter für eine Einwilligung an deinem Standort haben, wenn das höher ist. |
| Optional | Git, um einen Verlauf deiner Skripte zu führen. Visual Studio Code 1.94.0 oder neuer oder Cursor, wenn du Claude Code in einem Editor-Panel statt in einem Terminal willst. |
Welches Claude Code du nutzt
Claude Code läuft an mehreren Orten. Laut Anthropic teilen sich alle dieselbe Engine, also funktionieren deine CLAUDE.md, deine Einstellungen und deine MCP-Server überall. Für Studio zählt, wo die Sitzung läuft: Der MCP-Server von Roblox ist ein lokaler Prozess auf deinem Computer, also muss auch die Sitzung auf deinem Computer sein.
| Oberfläche | Erreicht Studio? | Hinweise |
|---|---|---|
Terminal (der Befehl claude) | Ja | Führ ihn in deinem Projektordner aus. Du brauchst ihn auch für die Befehle claude mcp weiter unten. |
| Erweiterung für VS Code oder Cursor | Ja | Der Weg im Coding-Harness-Guide von Roblox. Die Erweiterung bringt ihre eigene Kopie von Claude Code mit, fügt claude aber nicht zu deinem PATH hinzu, also installier auch die Terminal-Version, wenn du diese Befehle willst. |
| Desktop-App, Tab Code, mit der Auswahl Local | Ja | Läuft auf deinem Rechner. Laut Anthropic ist ein bezahltes Abo nötig. |
| Cloud-Sitzungen (claude.ai/code oder Cloud in der Desktop-App) | Nein | Sie laufen auf Cloud-Infrastruktur statt auf deinem Rechner, also können sie den lokalen Server von Studio nicht starten. |
Schritt 1: Claude Code installieren und anmelden
Die von Anthropic empfohlene Installation ist ein einziger Befehl in einem Terminal. Das sind die Befehle, die die Setup-Seite am 9. Oktober 2026 genannt hat; die aktuellen stehen auf der Setup-Seite von Anthropic.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Öffne ein neues Terminalfenster und führ
claude --versionaus. Eine Versionsnummer bedeutet, dass es geklappt hat. Wird der Befehl nicht gefunden, ist der Installationsordner noch nicht in deinem PATH, und die Seite von Anthropic zur Fehlerbehebung bei der Installation hat die Lösung. - Geh in deinen Projektordner und führ
claudeaus. Beim ersten Start öffnet es ein Browserfenster zum Anmelden. Öffnet sich der Browser nicht, drückc, um den Anmeldelink zu kopieren. - Melde dich mit deinem Claude-Konto an. Eine Anmeldung mit Pro oder Max nutzt das Kontingent, das in deinem Plan enthalten ist.
Unter Windows empfiehlt Anthropic, Git for Windows zu installieren, damit Claude Code sein Bash-Tool nutzen kann; ohne das führt Claude Code Befehle in PowerShell aus. Installier Claude Code für diese Einrichtung in Windows selbst und nicht in WSL: Die Windows-Konfiguration von Roblox startet cmd.exe mit einem Pfad mit %LOCALAPPDATA%, und Roblox dokumentiert WSL nicht.
Lieber ein Editor-Panel? Öffne in VS Code oder Cursor die Extensions (Strg+Shift+X, auf dem Mac Cmd+Shift+X), such nach Claude Code, installier es und melde dich im Claude-Panel an. Das ist die Einrichtung, die der Coding-Harness-Guide von Roblox nutzt.
Schritt 2: Claude Code mit Studio verbinden
Schalte zuerst den Server ein. Öffne in Studio Assistant, klick auf … > Manage MCP Servers und schalte Enable Studio as MCP server ein. Der Guide zu Studio MCP behandelt diesen Schritt ausführlicher. Kein Assistant-Button? Sieh dir an, wie du das Assistant-Panel öffnest.
Quick connect
- Klapp im selben Panel (Assistant Settings > MCP Servers) das Dropdown Quick connect auf. Es listet die unterstützten Clients, die auf deinem Computer installiert sind.
- Schalte Claude Code ein. Fehlt es, installier Claude Code und starte Studio neu.
- Starte Claude Code neu: Beende die Sitzung und führ
claudenoch einmal aus, oder starte in der Erweiterung eine neue Unterhaltung. Laut Roblox braucht ein Client einen Neustart, um eine neue Konfiguration zu übernehmen.
Roblox sagt nicht, in welche Datei von Claude Code Quick connect schreibt oder wie es den Server nennt. Tipp in Claude Code /mcp, um den Namen zu sehen. Du brauchst ihn für die Berechtigungsregeln in Schritt 3.
Du nutzt die Claude-Code-Erweiterung in VS Code oder Cursor? Schalte auch hier Claude Code ein. Der Coding-Harness-Guide von Roblox schaltet Cursor oder Visual Studio Code ein, aber Anthropic dokumentiert, dass die Erweiterung ihre MCP-Konfiguration mit der Terminal-Version von Claude Code teilt, und sagt nicht, dass sie die eigenen MCP-Einstellungen des Editors liest.
Manuelle Einrichtung mit einer Datei .mcp.json
Wenn Quick connect bei dir nicht funktioniert, füge Studio selbst hinzu. Claude Code liest MCP-Server des Projekts aus einer Datei namens .mcp.json in deinem Projektordner, im selben Format mcpServers, das Roblox dokumentiert, und behandelt einen Eintrag ohne type als lokalen stdio-Server. Die Konfiguration von Roblox funktioniert also so, wie sie ist. Speichere die für dein System als .mcp.json in dem Ordner, in dem du claude ausführst:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Wenn du claude das nächste Mal in diesem Ordner ausführst, bittet es dich, den Server freizugeben: Anthropic zeigt diese Nachfrage für jeden Server, der aus einer Datei .mcp.json kommt. Anthropic hat die Datei so entworfen, dass sie committet wird und ein Team sie teilt, aber die Pfade für Windows und macOS unterscheiden sich. Nutzt dein Team beide, halte die Datei aus dem Repository heraus und lass jede Person Studio für sich selbst hinzufügen.
Unter macOS kannst du Studio stattdessen mit einem Befehl hinzufügen. --scope user macht es in jedem Projekt auf deinem Computer verfügbar; lässt du es weg, lädt der Server nur im aktuellen Ordner. Das -- trennt die eigenen Optionen von Claude Code von dem Befehl, der den Server startet.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Unter Windows ist die JSON-Datei der einfachere Weg, weil PowerShell und CMD %LOCALAPPDATA% auf einer Befehlszeile unterschiedlich behandeln.
Die Verbindung prüfen
- In einem Terminal zeigt
claude mcp listjeden Server und seinen Status.claude mcp get Roblox_Studiozeigt mehr, darunter eine ZeileIssue:, wenn der Server sich nicht verbinden konnte. - Tipp in Claude Code
/mcp. Verbundene Server zeigen neben ihrem Namen eine Tool-Anzahl. - In Studio zeigt Assistant > … > Manage MCP Servers einen grünen Indikator mit der Zahl der verbundenen Clients.
Schritt 3: Entscheiden, was Claude ohne Nachfrage tun darf
Stell das ein, bevor Claude dein Spiel anfasst. Laut der Seite von Anthropic zu den Berechtigungsmodi starten interaktive Sitzungen im Terminal und in VS Code seit Claude Code v2.1.283 standardmäßig im Auto-Modus, wann immer er verfügbar ist, und im Auto-Modus prüft ein Klassifikator im Hintergrund die Aktionen statt du. Ein MCP-Aufruf, der in Studio ein Skript bearbeitet oder Luau ausführt, kann dann ohne Nachfrage durchgehen.
Du hast zwei Wege, jede Änderung in der Hand zu behalten:
- Starte im Manual-Modus. Führ
claude --permission-mode defaultaus. Im Manual-Modus laufen nur Lesezugriffe ohne Nachfrage. Drück während einer Sitzung Shift+Tab, um durch die Modi zu wechseln. - Füge ask-Regeln für die Studio-Tools hinzu, die etwas ändern. Laut Anthropic gibt kein Modus ein Tool automatisch frei, auf das eine ausdrückliche ask-Regel passt, nicht einmal der Bypass-Modus.
{
"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-Regeln haben die Form mcp__<server>__<tool>, mit dem Servernamen, wie Claude Code ihn führt. Ersetze Roblox_Studio durch den Namen, den /mcp zeigt. Allow-Regeln in der .claude/settings.json eines Projekts gelten erst, nachdem du für diesen Ordner den Dialog zum Vertrauen in den Arbeitsbereich angenommen hast. Für Regeln, die nur für dich sind, nutze stattdessen .claude/settings.local.json.
Die allow-Liste deckt Tools ab, die nur lesen: den Spielbaum, Eigenschaften, Skripte, den Output und die Liste der offenen Studio-Fenster. Die ask-Liste deckt Tools ab, die dein Spiel ändern, Code ausführen, Playtests starten, fremde Assets hineinholen oder Bilder an Roblox schicken. Tools in keiner der beiden Listen, etwa screen_capture und die Eingabe-Tools, folgen deinem Berechtigungsmodus. Die vollständige Tool-Liste, mit dem, was jedes macht, steht im Guide zu Studio MCP.
Schritt 4: Mit einer Anfrage anfangen, die nur liest
Öffne das Spiel, an dem du arbeiten willst, und schließ alle, an denen du nicht arbeiten willst. Gib Claude dann eine erste Anfrage, die nichts ändern kann:
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.
Bei einer frischen Baseplate erwartet der Coding-Harness-Guide von Roblox, dass die Antwort die Standardobjekte Camera, Terrain, Baseplate und SpawnLocation auflistet. Zuerst nach list_roblox_studios zu fragen ist eine gute Gewohnheit: Ein Client kann jedes Studio-Fenster erreichen, das du offen hast, und jeder Tool-Aufruf nennt sein Zielfenster mit einer studio_id.
Bitte bei allem, was größer als ein Skript ist, zuerst um einen Plan. Im Plan-Modus (drück Shift+Tab oder beginn einen Prompt mit /plan) recherchiert Claude und macht Vorschläge, ohne deine Dateien zu bearbeiten. Anthropic beschreibt den Plan-Modus anhand von Dateiänderungen und Shell-Befehlen, also behalte auch deine ask-Regeln für die Studio-Tools.
Schritt 5: Mit Script Sync oder Rojo an Skripten als Dateien arbeiten
Claude Code ist um Dateien in einem Ordner herum gebaut. Es bearbeitet sie mit seinen eigenen Tools, Git führt ihren Verlauf, und /rewind kann sie wiederherstellen. Wenn du deine Skripte auf die Festplatte legst, kannst du all das nutzen, und die MCP-Tools bleiben für die Teile eines Spiels, die keine Skripte sind, etwa GUIs in StarterGui, RemoteEvents und Parts. Roblox dokumentiert zwei Wege dafür.
| Script Sync | Rojo | |
|---|---|---|
| Was es ist | Eine Studio-Funktion, die Skripte in deinem Spiel mit Dateien auf der Festplatte synchronisiert, in beide Richtungen. | Ein Tool eines Drittanbieters: ein Server auf deinem Computer plus ein Studio-Plugin. |
| Was es synchronisiert | Nur Instanzen vom Typ Script, LocalScript, ModuleScript und Folder. Andere Instanzen in einem synchronisierten Ordner werden ignoriert. | Kann das ganze Projekt als Dateien verwalten, mit deinem Dateisystem als maßgeblicher Quelle. |
| Einrichtung | Rechtsklick auf einen Service oder Ordner im Explorer, Sync to… wählen und einen Ordner aussuchen. Der Coding-Harness-Guide von Roblox schaltet es zuerst unter File > Beta Features ein. | Installier es mit Rokit (rokit add rojo-rbx/rojo, dann rokit install), füge das Plugin mit rojo plugin install hinzu, führ rojo serve aus und verbinde dich vom Plugin aus. |
| Team Create | Funktioniert damit. Vermeide, dass zwei Personen dasselbe synchronisierte Skript gleichzeitig bearbeiten. | Roblox weist darauf hin, dass Tools von Drittanbietern oft nicht mit den eingebauten Tools zur Zusammenarbeit funktionieren. |
| Der Rat von Roblox | Passt gut, wenn du für Code deinen eigenen Editor und Versionskontrolle willst und für alles andere Studio. | Die bessere Wahl, wenn du dein ganzes Projekt, nicht nur den Code, in der Versionskontrolle haben willst. |
Derselbe Dateiname kann Verschiedenes bedeuten
Beide Tools bestimmen den Skripttyp über den Dateinamen, und die Endungen passen nicht zusammen. Eine Datei mit .client ist in Rojo ein LocalScript, in Script Sync aber ein Script mit dem Run Context Client. Sag Claude, welches Tool dein Projekt nutzt; das CLAUDE.md-Beispiel unten tut das.
| Dateiname endet auf | Script Sync erstellt | Rojo erstellt |
|---|---|---|
.server | Script mit dem Run Context Server | Script |
.client | Script mit dem Run Context Client | LocalScript |
.local | LocalScript | Keine besondere Bedeutung (jede andere .lua-Datei ist ein ModuleScript) |
| Keine Endung | ModuleScript | ModuleScript |
Ein Ordner mit einer Datei init | Ein Skript mit Kindern, dessen Typ der Name der Datei init festlegt | Der Ordner wird zu dem Skript, das init.server.lua, init.client.lua oder init.lua beschreibt |
Script Sync für Claude Code einrichten
- Leg einen Projektordner an, mit einem Ordner für jeden Service, den du auf der Festplatte haben willst, zum Beispiel
ServerScriptService,ReplicatedStorageundStarterPlayerScripts, und führ daringit initaus. - Wenn Script Sync beim Rechtsklick auf einen Service nicht erscheint, schalte es unter File > Beta Features ein, klick auf Save und starte Studio neu.
- Mach im Explorer einen Rechtsklick auf ServerScriptService, wähl Script Sync > Sync to und such den obersten Projektordner aus, nicht einen Ordner darin. Wiederhol das für die anderen Services.
- Führ
claudein diesem Ordner aus. Claude bearbeitet jetzt.luau-Dateien, und Studio übernimmt jede Änderung. - Committe vor jeder Sitzung, damit du immer einen sauberen Punkt hast, zu dem du zurückkannst.
git add .
git commit -m "Before Claude session"
Zwei Regeln von Script Sync zählen mit einem Agenten mehr. Synchronisiere keine Skripte, die Attribute oder Tags haben: Script Sync ignoriert sie, und Roblox warnt, dass das zu Datenverlust führen kann. Und wenn sich Dateien ändern, während Studio geschlossen ist, fragt Studio beim erneuten Öffnen des Spiels, wie das aufgelöst werden soll, und listet auf, was Keep Studio und Keep Disk hinzufügen, ändern oder löschen würden. Lies diese Liste, bevor du wählst.
Mit eingeschaltetem Script Sync erreicht eine Dateiänderung Studio, sobald sie gespeichert ist. Eine Änderung in Claude Code anzunehmen heißt, sie in dein Spiel zu übernehmen, also prüf, bevor du annimmst, besonders in Modi, die Änderungen automatisch annehmen.
Für Autovervollständigung und Typfehler in deinem Editor empfiehlt Roblox die Erweiterung Luau Language Server mit ihrem zugehörigen Studio-Plugin. In VS Code kann die Claude-Code-Erweiterung das Problems-Panel über ein eingebautes Tool lesen, also sieht Claude dieselben Warnungen wie du.
Schritt 6: Claude deine Roblox-Regeln in der CLAUDE.md geben
Jede Sitzung von Claude Code beginnt mit einem frischen Kontext. Eine Datei CLAUDE.md in deinem Projektordner wird zu Beginn jeder Sitzung gelesen, also gehören deine Konventionen dorthin. Führ /init aus, damit Claude einen Entwurf schreibt, oder schreib sie selbst. Der Rat von Anthropic: Halte sie unter 200 Zeilen, schreib Regeln, die konkret genug sind, um sie zu überprüfen, und führ /context aus, um zu bestätigen, dass sie geladen wurde.
Dieses Beispiel wurde für diesen Guide geschrieben, für ein Projekt, das Script Sync nutzt. Pass die Namen an dein Spiel an und streich, was du nicht brauchst.
# 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.
Manche Zeilen stehen da, weil die Tools so funktionieren. Die Regeln für Dateinamen gibt es, weil .client.luau in Script Sync kein LocalScript ist. Die Zeile mit list_roblox_studios gibt es, weil der Server jedes offene Fenster erreichen kann. Die Asset-Zeile gibt es, weil insert_asset fremde Inhalte in dein Spiel holt und upload_image Bilder an den Asset-Server von Roblox schickt. Die Zeile mit wait folgt der API-Referenz von Roblox, die wait, spawn und delay als veraltet zugunsten der Bibliothek task markiert.
Wenn dein Projekt schon eine AGENTS.md für andere Coding-Agenten hat, kann Claude Code sie als seine Projektanweisungen lesen, also kannst du eine Datei für beide behalten. Die Memory-Seite von Anthropic erklärt, welche Datei gewinnt, wenn beide existieren.
Wie diese Regeln im Code aussehen
Hier ist ein Serverskript, das den Luau-Regeln oben folgt. Es wurde für diesen Guide von Hand geschrieben, nicht von Claude erzeugt. Nutze es als Maßstab, wenn du prüfst, was Claude dir zurückgibt. Ein LocalScript bittet mit RequestTool:FireServer("Sword") um ein Tool, und der Server prüft 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 synchronisiert nur Skripte und Ordner, also legt der Server sein Remote selbst an.
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)
-- Ignoriere eine Anfrage, die ankommt, nachdem der Spieler gegangen ist.
if player.Parent ~= Players then
return
end
-- 1. Prüf das Argument: Ein Client kann alles schicken.
if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
return
end
-- 2. Begrenze, wie oft ein Spieler anfragen kann.
local now = os.clock()
local last = lastRequest[player]
if last ~= nil and now - last < COOLDOWN_SECONDS then
return
end
lastRequest[player] = now
-- 3. Der Server entscheidet. Füge hier deine eigene Besitzprüfung ein (ein Game Pass, ein Kaufeintrag).
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. Aufräumen pro Spieler.
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
Auf der Festplatte mit Script Sync: ServerScriptService/ToolRequests.server.luau. Leg deine Tool-Objekte in einen Folder namens Tools in ServerStorage. Bis du eine Besitzprüfung hinzufügst, kann jeder Spieler jedes Tool in diesem Ordner bekommen.
Such in jedem Remote-Handler, den Claude schreibt, nach denselben Dingen: Er prüft Typ und Größe dessen, was der Client geschickt hat, er begrenzt, wie oft ein Spieler ihn aufrufen kann, der Server trifft die Entscheidung, und er entfernt den Eintrag des Spielers, wenn dieser geht. Der Guide zu RemoteEvents erklärt, warum jedes davon wichtig ist.
Eine sichere Arbeitsweise: sichern, prüfen, testen
- Sichere beide Seiten. Committe deine Dateien in Git und speichere in Studio eine Version des Spiels mit File > Save to Roblox with Notes. Der Guide zu Studio MCP zeigt, wie du eine aus der Version History wiederherstellst.
- Bitte um einen Plan für alles, was größer als ein Skript ist, und lies ihn, bevor du ihn freigibst.
- Prüf den Diff. Bei Dateien lies
git diffoder die Inline-Diffs der Erweiterung, bevor du annimmst. Bei Änderungen, die in Studio gemacht wurden, lies die Skripte, die Claude angefasst hat, und schau im Explorer nach Objekten, die aufgetaucht oder verschwunden sind. - Teste es selbst. Claude kann einen Playtest starten und den Output lesen, aber es prüft nur, was es prüfen wollte. Spiel die Funktion so, wie ein Spieler es tun würde, bevor du committest oder veröffentlichst.
- Committe, sobald es funktioniert, mit einer Nachricht, die sagt, was sich geändert hat.
Was /rewind rückgängig machen kann und was nicht
Claude Code speichert vor jedem Prompt einen Checkpoint, und /rewind (oder zweimal Esc) stellt Dateien wieder her, die Claude mit seinen Tools zur Dateibearbeitung geändert hat. Anthropic listet auf, was es nicht erfasst, darunter Änderungen durch Shell-Befehle. Änderungen, die über MCP-Tools in Studio gemacht werden, sind keine Dateiänderungen, also erwarte nicht, dass /rewind sie rückgängig macht, und die MCP-Seite von Roblox sagt nicht, ob sie im Rückgängig-Verlauf von Studio landen. Mit Script Sync wird eine Datei, die /rewind wiederherstellt, wie jede andere Änderung auf der Festplatte zurück nach Studio synchronisiert. Für alles andere ist deine gespeicherte Version der Weg zurück.
Geheimnisse und Live-Daten außer Reichweite halten
- Füge keine API-Schlüssel, Open-Cloud-Schlüssel, Webhook-URLs oder Passwörter in einen Prompt oder in die
CLAUDE.mdein. Beides ist Text, den Claude liest, und dieCLAUDE.mdwird meist in dein Repository committet. - Schreib sie auch nicht fest in Skripte. Roblox hat für jedes Spiel einen Secrets Store: Leg Secrets im Creator Dashboard an und lies sie in einem Serverskript mit
HttpService:GetSecret(). Für lokale Playtests füge lokale Secrets unter File > Experience Settings > Security hinzu. - Halte persönliche Einstellungen in
.claude/settings.local.jsonundCLAUDE.local.md, die dafür gedacht sind, aus Git herauszubleiben. FügeCLAUDE.local.mdselbst zur.gitignorehinzu. - Schalte Enable Studio Access to API Services nur in einer separaten Testkopie deines Spiels ein. Roblox warnt, dass Studio dieselben Data Stores wie das Live-Spiel nutzt, also könnte ein Playtest, den Claude dort startet, echte Spielerdaten überschreiben.
- Lies einen Skill eines Drittanbieters, bevor du ihn installierst. Skill-Verzeichnisse führen Roblox-Skills für Claude Code, und Anthropic weist darauf hin, dass ein Skill sich über sein Feld
allowed-toolsselbst weitreichenden Tool-Zugriff geben kann.
Was Claude Code für Roblox-Arbeit kostet
Die Studio-Seite hat keinen dokumentierten Preis: Der MCP-Server ist Teil von Studio, und die MCP-Seite von Roblox erwähnt keine Gebühr. Die Kosten sind die von Claude Code, und Anthropic bietet zwei Wege zu zahlen (Stand 9. Oktober 2026):
- Ein Claude-Abo. Claude Code ist in Pro, Max, Team und Enterprise enthalten, nicht in Free. Es greift auf dasselbe Kontingent zu wie Claude im Web, auf dem Desktop und mobil. Limits setzen sich in einem rollierenden Fünf-Stunden-Fenster zurück, und bezahlte Pläne haben zusätzlich Wochenlimits. Wenn du eines erreichst, kannst du warten, auf einen höheren Plan wechseln oder Usage Credits einschalten.
- Ein Claude-Console-Konto. Du zahlst die API-Nutzung nach Verbrauch. Laut der Kostenseite von Anthropic schwanken die Ausgaben stark, je nach Modellwahl, Größe der Codebasis und Art der Nutzung.
Die aktuellen Preise stehen auf claude.com/pricing. Dieser Guide wiederholt sie nicht, weil sie sich ändern. In Claude Code zeigt /usage Abonnenten Balken zur Plan-Nutzung und API-Nutzern geschätzte Kosten der Sitzung.
Was eine Roblox-Sitzung mehr verbrauchen lässt
- Größe des Kontexts. Der Verbrauch wächst mit dem, was Claude im Kontext hat. Nutze
/clearzwischen Aufgaben, die nichts miteinander zu tun haben. - Große Tool-Ergebnisse. Den ganzen Spielbaum eines großen Spiels durchzugehen oder lange Skripte vollständig zu lesen liefert viel Text zurück. Claude Code warnt, wenn das Ergebnis eines MCP-Tools 10.000 Zähleinheiten des Modells überschreitet, und begrenzt es standardmäßig auf 25.000. Frag stattdessen nach einem Ordner, einem Tiefenlimit oder einem Zeilenbereich:
search_game_treeundscript_readunterstützen das beide. - Modellwahl. Laut Anthropic erledigt Sonnet die meisten Coding-Aufgaben gut und kostet weniger als Opus. Wechsle mit
/model.
Fehlerbehebung für Claude Code und Studio
Die eigene Checkliste von Roblox ist kurz: Studio und den Client neu starten, prüfen, ob der Befehlspfad existiert, und das JSON prüfen. Das sind die Fälle, die speziell Claude Code betreffen.
Claude Code steht nicht in der Quick-connect-Liste
Die Liste zeigt nur unterstützte Clients, die auf deinem Computer installiert sind. Installier Claude Code und starte dann Studio neu. Hast du es installiert, während Studio offen war, starte Studio, Claude Code oder beide neu. Die Datei .mcp.json aus Schritt 2 funktioniert ohne Quick connect.
/mcp zeigt den Server von Roblox Studio nicht
Starte Claude Code neu, nachdem du den Server hinzugefügt hast. Prüf dann, wo er hinzugefügt wurde: Ein Server, der ohne --scope hinzugefügt wurde, lädt nur in dem Ordner, in dem du ihn hinzugefügt hast, also starte claude aus diesem Ordner oder füge ihn mit --scope user noch einmal hinzu. Starte in VS Code eine neue Unterhaltung, weil Änderungen für Unterhaltungen gelten, die danach begonnen werden.
Der Server meldet Pending approval
Er kommt aus einer Datei .mcp.json, und Claude Code fragt nach, bevor es solche nutzt. Führ claude in diesem Ordner aus, nimm den Dialog zum Vertrauen in den Arbeitsbereich an und gib den Server frei. claude mcp reset-project-choices löscht frühere Entscheidungen.
Der Server zeigt Failed to connect
Führ claude mcp get Roblox_Studio aus und lies die Zeile Issue:. Prüf, ob die Datei existiert: %LOCALAPPDATA%\Roblox\mcp.bat unter Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP unter macOS (pass den Pfad an, wenn Studio woanders installiert ist). Stell sicher, dass Enable Studio as MCP server noch eingeschaltet ist, und starte dann Studio und Claude Code neu.
Das Terminal sagt, claude werde nicht erkannt
Öffne nach der Installation ein neues Terminalfenster. Wird es weiter nicht gefunden, ist der Installationsordner nicht in deinem PATH; die Seite von Anthropic zur Fehlerbehebung bei der Installation hat die Lösung. Die Erweiterung für VS Code fügt claude nicht zu deinem PATH hinzu, also installier die Terminal-Version separat für die Befehle in diesem Guide.
Claude hat das falsche Spiel geändert
Mit mehreren offenen Studio-Fenstern nennt jeder Tool-Aufruf sein Ziel mit einer studio_id. Bitte Claude, list_roblox_studios aufzurufen, und nenn das Spiel, das du meinst, schließ die Fenster, die du nicht nutzt, und stell das geänderte Spiel aus der Version History wieder her.
Claude Code belastet meinen API-Schlüssel statt meines Plans
Sobald du sie bestätigst, übernimmt eine Umgebungsvariable ANTHROPIC_API_KEY anstelle deines Abos. Entfern die Variable (oder schalte in /config Use custom API key aus), starte Claude Code neu und führ /status aus, um zu prüfen, welche Anmeldung aktiv ist. Ist es weiter ein Console-Konto, führ /login aus und wähl dein Claude-Konto.
Eine Cloud-Sitzung sieht Studio nicht
Cloud-Sitzungen laufen auf der Infrastruktur von Anthropic, nicht auf deinem Computer, also erreichen sie den lokalen Server von Studio nicht. Nutze das Terminal, die Editor-Erweiterung oder die Desktop-App mit der Auswahl Local.
Oder nutze stattdessen einen Plugin-Agenten: RoCode
Claude Code mit MCP passt zu Leuten, die sich in einem Terminal oder Code-Editor wohlfühlen. RoCode (RoCode.app) ist ein anderer Weg: ein unabhängiger KI-Agent für Roblox Studio, mit einem Webchat auf rocode.app und einem kostenlosen Plugin aus dem Creator Store, das die Schritte in dem Spiel ausführt, das du offen hast. Es ist kein MCP-Produkt und nutzt den MCP-Server von Studio nicht, also gibt es keine Kommandozeile, keine Konfigurationsdatei und keinen MCP-Server einzurichten. Das Plugin verbindet sich von selbst, wenn Studio mit demselben Roblox-Konto angemeldet ist, das du bei RoCode nutzt; sonst koppelst du Chat und Plugin einmal mit dem Code mit 8 Zeichen, den das Plugin-Panel zeigt.
Was du wissen solltest, bevor du wechselst. RoCode kann kein Claude- oder Claude-Code-Abo verbinden. Es nutzt Modelle von Drittanbietern über OpenRouter, darunter Claude Sonnet 5.5 ab Pro und Claude Opus 5.5 ab Studio, und der kostenlose Starter-Plan gibt 1 Credit pro Tag mit GPT-6 Luna. Es arbeitet aus dem Bearbeitungsmodus heraus. Mit Plugin 3.9 oder neuer kann es im Build-Modus einen kurzen Playtest machen und die Fehler lesen, und mit Plugin 3.9.11 oder neuer eine Testfigur steuern, um zu prüfen, ob das Spiel funktioniert. Mit Plugin 3.9.14 oder neuer macht es außerdem Screenshots von dem, was es gebaut hat, im Bearbeitungsmodus, und kann korrigieren, was falsch aussieht. Es führt keinen Code direkt aus und erzeugt keine Meshes, was die Studio-MCP-Tools beide können. Es kann den Creator Store mit deinen Worten nach kostenlosen Modellen durchsuchen (Skripte darin werden entfernt) oder ein Modell, Decal oder Mesh per Asset-ID einfügen, und Szenerie, Gebäude und Requisiten entwirft es für jedes Spiel neu. Sein Ask-Modus beantwortet Fragen zu deinem Spiel mit nur lesenden Tools und ändert nichts. Konten sind ab 13 Jahren, unter 18 mit Erlaubnis eines Elternteils oder Erziehungsberechtigten.
Füge ein RemoteEvent hinzu, damit Spieler ein Tool aus ServerStorage.Tools anfordern können. Prüf alles auf dem Server.
- Kann sich zuerst mit Search Game und List Children im Spiel umsehen, um den Ordner Tools und Skripte zu finden, die schon Tools ausgeben
- Schreibt das Serverskript mit Create Script und kann das RemoteEvent mit Create Instance hinzufügen
- Prüft das Skript vor dem Ende mit Check Script in Studio auf Kompilierfehler. Das ist eine Kompilierprüfung, keine Typprüfung und kein Playtest
- Schickt seine Änderungen in Gruppen, und jede Gruppe ist ein Rückgängig-Punkt im eigenen Verlauf von Studio
Mit Plugin 3.9 oder neuer kann RoCode einen kurzen Playtest machen und die Fehler lesen, und mit Plugin 3.9.15 oder neuer kann seine Testfigur laufen, Tasten drücken und Buttons auf dem Bildschirm anklicken, aber es prüft nur, was es testen wollte, also drück selbst auf Play, um das Ergebnis als Spieler zu testen. Der Prompt ist ein von uns geschriebenes Beispiel; die Schritte nutzen die echten Tool-Namen. Wie Plugin und Kopplung funktionieren. RoCode ist ein unabhängiges Produkt, nicht mit der Roblox Corporation verbunden und von ihr weder unterstützt noch gesponsert.
Häufige Fragen
Kann ich Claude Desktop statt Claude Code nutzen?
Ja. Claude Desktop steht auf der Liste Quick connect im Panel Manage MCP Servers von Studio, also verbindet es sich mit einem Schalter, unter Windows oder auf dem Mac. Es nutzt dieselben Studio-Tools; Claude Code bringt zusätzlich mit, was ein Terminal-Agent gut kann, etwa die Arbeit an Skriptdateien und Git. Die Schritte für beide stehen im Guide zur Einrichtung von Studio MCP.
Kann sich Claude Code mit Roblox Studio verbinden?
Ja. Roblox führt Claude Code als Quick-connect-Client für den MCP-Server, der in Studio eingebaut ist. Schalte unter Assistant > … > Manage MCP Servers die Option Enable Studio as MCP server ein, aktiviere unter Quick connect den Schalter Claude Code und starte Claude Code neu. Es kann auch über Script Sync oder Rojo an deinen Skripten als Dateien arbeiten.
Ist Claude Code mit Roblox Studio kostenlos?
Der Studio-MCP-Server hat keinen dokumentierten Preis, aber Claude Code ist nicht Teil des Free-Plans von Anthropic (claude.com/pricing, geprüft am 9. Oktober 2026). Du brauchst einen bezahlten Claude-Plan, bei dem es sich die Nutzungslimits deines Plans teilt, oder ein Claude-Console-Konto, das nach API-Nutzung abgerechnet wird.
Brauche ich ein Roblox-Plugin oder HTTP-Anfragen, um Claude Code zu nutzen?
Nicht für den eingebauten MCP-Server von Studio. Die Einrichtungsschritte von Roblox sind, den Server in Assistant einzuschalten und den Client zu verbinden; sie enthalten kein Plugin, das zu installieren wäre, und keine HTTP-Einstellung, die zu ändern wäre. Manche älteren Guides beschreiben MCP-Server aus der Community, die anders funktionieren. Rojo nutzt, wenn du es für Dateien wählst, allerdings sein eigenes Studio-Plugin.
Kann Claude Code mein Roblox-Spiel testen?
Über die Studio-MCP-Tools, ja. start_stop_play startet und stoppt einen Playtest, get_console_output liest den Output, screen_capture nimmt den Viewport auf, und die Eingabe-Tools bewegen die Figur und senden Tasten und Klicks. Prüf, was es meldet, und spiel das Spiel selbst, bevor du veröffentlichst.
Soll ich Claude Code oder Codex mit Roblox Studio nutzen?
Beide stehen auf der Quick-connect-Liste von Roblox und erreichen dieselben Studio-MCP-Tools, also liegt der Unterschied im Modell, im Konto und im Client darum herum. Roblox veröffentlicht keinen Vergleich, und wir haben sie nicht gegeneinander gemessen. Probier jedes an einer Kopie deines Spiels mit denselben schriftlichen Regeln aus und behalte das, dessen Änderungen weniger Nacharbeit brauchen.
Funktioniert Claude Code mit Roblox Studio auf dem Mac?
Ja. Claude Code unterstützt macOS 13.0 oder neuer, und Roblox dokumentiert einen Serverpfad für macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, für Clients, die du von Hand einrichtest.
Quellen und weiterführende Links
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (auf Englisch). Server einschalten, Quick connect, JSON- und CLI-Einrichtung, die Tools, mehrere Studio-Fenster und Fehlerbehebung
- Roblox Creator Docs: Build with a coding harness (auf Englisch). Claude Code in VS Code, Script Sync, MCP und Git zusammen
- Roblox Creator Docs: Script Sync (auf Englisch). was synchronisiert wird, Regeln für Dateinamen, Konflikte und der Language Server
- Roblox Creator Docs: Third-party tools (auf Englisch). Rojo mit Rokit und Versionskontrolle
- Roblox Creator Docs: Secrets stores (auf Englisch). API-Schlüssel aus Skripten heraushalten
- Roblox Creator Docs: Data stores (auf Englisch). warum der Studio-Zugriff auf API-Services in eine Testkopie gehört
- Rojo documentation (v7) (auf Englisch). Installation und wie Dateinamen auf Instanzen abgebildet werden
- Claude Code Docs: Overview (auf Englisch). die Oberflächen teilen sich eine Engine, und die Desktop-App braucht ein bezahltes Abo
- Claude Code Docs: Advanced setup (auf Englisch). Systemanforderungen und Installationsbefehle
- Claude Code Docs: Authentication (auf Englisch). Anmeldung und die Kontotypen, die funktionieren
- Claude Code Docs: Connect Claude Code to tools via MCP (auf Englisch). stdio-Server, .mcp.json, Scopes und Serverstatus
- Claude Code Docs: Configure permissions (auf Englisch). allow-, ask- und deny-Regeln, auch für MCP-Tools
- Claude Code Docs: Choose a permission mode (auf Englisch). der Auto-Modus als Startmodus, Manual-Modus und Plan-Modus
- Claude Code Docs: How Claude remembers your project (auf Englisch). CLAUDE.md, /init und AGENTS.md
- Claude Code Docs: Checkpointing (auf Englisch). was /rewind wiederherstellt und was es nicht erfasst
- Claude Code Docs: Manage costs effectively (auf Englisch). /usage, Größe des Kontexts und Modellwahl
- Claude Code Docs: Use Claude Code in the cloud (auf Englisch). warum Cloud-Sitzungen nicht auf deinem Rechner laufen
- Claude Code Docs: Use Claude Code in VS Code (auf Englisch). Anforderungen, der Hinweis zum PATH, geteilte MCP-Konfiguration und das Problems-Panel
- Claude Code Docs: Extend Claude with skills (auf Englisch). was das Feld allowed-tools eines Skills gewährt
- Claude pricing (auf Englisch). welche Pläne Claude Code enthalten, und Nutzungslimits
- Claude Help Center: Use Claude Code with your Pro or Max plan (auf Englisch). geteilte Limits und die Warnung zu ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (auf Englisch). Mindestalter
So wurde der Code geprüft: Jedes Skript auf dieser Seite besteht die strikte Typprüfung von Luau mit den Roblox API-Definitionen (luau-lsp, 13. November 2026). Eine Typprüfung findet falsch geschriebene APIs und falsche Typen, aber keine Fehler in der Spiellogik. Teste also in Studio, bevor du veröffentlichst.