Ghid · AI în Roblox Studio

Cum conectezi Claude Code la Roblox Studio

Claude Code este instrumentul agentic al Anthropic pentru scris cod. Roblox îl listează ca client quick connect pentru serverul MCP integrat în Studio, așa că poate citi place-ul tău, edita scripturi și porni playtesturi în fereastra Studio pe care o ai deschisă. Mai poate lucra cu scripturile tale ca fișiere prin Script Sync sau Rojo. Ghidul acesta e despre partea Claude Code: de ce ai nevoie, cum îl conectezi, permisiunile, un CLAUDE.md cu reguli pentru Roblox, un mod sigur de lucru și cât costă. Pentru agentul OpenAI vezi ghidul cum folosești OpenAI Codex cu Roblox Studio (în engleză); pentru Cursor, Claude Desktop și alți clienți vezi ghidul de configurare Studio MCP.

Actualizat 20 noiembrie 202622 min de cititAutor:

Pe scurt

Instalează Claude Code și conectează-te cu un plan Claude plătit sau un cont Claude Console. În Studio deschide Assistant, apasă … > Manage MCP Servers, activează Enable Studio as MCP server, apoi activează Claude Code în lista Quick connect. Repornește Claude Code, scrie /mcp ca să te asiguri că serverul Studio e conectat și începe cu o cerere care doar citește.

  • Claude Code nu este în planul Free al Anthropic. E inclus în Pro, Max, Team și Enterprise sau se plătește după utilizarea API printr-un cont Claude Console (verificat pe 9 octombrie 2026).
  • Folosește o sesiune locală: terminalul, extensia pentru VS Code sau Cursor ori aplicația desktop cu Local selectat. Sesiunile din cloud nu rulează pe calculatorul tău și nu ajung la Studio.
  • Începând cu v2.1.283, sesiunile din terminal și VS Code pornesc implicit în modul auto acolo unde e disponibil, așa că adaugă reguli ask pentru instrumentele Studio care schimbă place-ul. Comanda /rewind din Claude Code nu anulează modificările făcute în Studio, așa că salvează întâi o versiune.
Pe această pagină
  1. De ce ai nevoie
  2. 1. Instalare și conectare
  3. 2. Conectarea la Studio
  4. 3. Permisiuni
  5. 4. Prima cerere
  6. 5. Script Sync sau Rojo
  7. 6. CLAUDE.md
  8. Lucru sigur
  9. Cost
  10. Rezolvarea problemelor
  11. Agent-plugin
  12. Întrebări frecvente
  13. Surse și lecturi suplimentare

De ce ai nevoie înainte să începi

Cerințe, conform documentației Roblox și Anthropic, 9 octombrie 2026
Ai nevoie deDetalii
Roblox StudioUltima versiune, pe Windows sau macOS. Serverul MCP e integrat în Studio, așa că pe partea Roblox nu mai trebuie instalat nimic.
Un calculator care suportă Claude CodemacOS 13.0 sau mai nou ori Windows 10 1809 sau mai nou, cel puțin 4 GB de RAM, conexiune la internet și o locație într-o țară suportată de Anthropic.
Un cont Claude care include Claude CodeUn plan Claude plătit (Pro, Max, Team sau Enterprise) sau un cont Claude Console. Pagina de prețuri a Anthropic spune că Claude Code nu e inclus în planul Free.
VârstăConsumer Terms ale Anthropic (în vigoare din 8 octombrie 2025) spun că trebuie să ai cel puțin 18 ani sau vârsta minimă de consimțământ din țara ta, dacă e mai mare.
OpționalGit, ca să păstrezi istoria scripturilor. Visual Studio Code 1.94.0 sau mai nou ori Cursor, dacă vrei Claude Code într-un panou de editor, nu în terminal.

Ce Claude Code să folosești

Claude Code rulează în mai multe locuri. Anthropic spune că toate au același motor, deci CLAUDE.md, setările și serverele MCP funcționează peste tot. Pentru Studio contează unde rulează sesiunea: serverul MCP Roblox e un proces local pe calculatorul tău, deci și sesiunea trebuie să fie pe calculatorul tău.

Variantele Claude Code și Roblox Studio
VariantăAjunge la Studio?Note
Terminal (comanda claude)DaRulează-l în folderul proiectului. Îți trebuie și pentru comenzile claude mcp de mai jos.
Extensia pentru VS Code sau CursorDaDrumul din ghidul Roblox despre coding harness. Extensia conține propria copie de Claude Code, dar nu adaugă claude în PATH, așa că, dacă îți trebuie acele comenzi, instalează și versiunea pentru terminal.
Aplicația desktop, fila Code, cu Local selectatDaRulează pe calculatorul tău. Anthropic spune că e nevoie de un abonament plătit.
Sesiuni în cloud (claude.ai/code sau Cloud în aplicația desktop)NuRulează pe infrastructura cloud, nu pe calculatorul tău, deci nu pot porni serverul local Studio.

Pasul 1: instalează Claude Code și conectează-te

Anthropic recomandă instalarea cu o singură comandă în terminal. Acestea sunt comenzile care erau pe pagina lui de instalare pe 9 octombrie 2026; pe cele actuale le găsești pe pagina de instalare Anthropic.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Deschide o fereastră nouă de terminal și rulează claude --version. Un număr de versiune înseamnă că a mers. Dacă comanda nu e găsită, folderul de instalare nu e încă în PATH, iar soluția e pe pagina Anthropic despre problemele de instalare.
  2. Mergi în folderul proiectului și rulează claude. La prima pornire deschide o fereastră de browser pentru conectare. Dacă browserul nu s-a deschis, apasă c ca să copiezi linkul de conectare.
  3. Conectează-te la contul tău Claude. Conectarea cu Pro sau Max folosește limitele incluse în planul tău.

Pe Windows, Anthropic recomandă să instalezi Git for Windows, ca Claude Code să-și poată folosi instrumentul Bash; fără el, Claude Code rulează comenzile în PowerShell. Pentru configurarea asta instalează Claude Code direct în Windows, nu în WSL: configurația Roblox pentru Windows pornește cmd.exe cu o cale %LOCALAPPDATA%, iar WSL nu e documentat de Roblox.

Preferi un panou în editor? În VS Code sau Cursor deschide Extensions (Ctrl+Shift+X sau Cmd+Shift+X pe Mac), caută Claude Code, instalează-l și conectează-te din panoul Claude. Exact configurarea asta o folosește ghidul Roblox despre coding harness.

Pasul 2: conectează Claude Code la Studio

Întâi pornește serverul. În Studio deschide Assistant, apasă … > Manage MCP Servers și activează Enable Studio as MCP server. Ghidul Studio MCP explică pasul ăsta mai pe larg. Nu ai butonul Assistant? Vezi cum deschizi panoul Assistant.

Quick connect

  1. În același panou (Assistant Settings > MCP Servers) deschide lista Quick connect. În ea sunt clienții suportați instalați pe calculatorul tău.
  2. Activează Claude Code. Dacă nu apare, instalează Claude Code și repornește Studio.
  3. Repornește Claude Code: închide sesiunea și rulează din nou claude sau începe o conversație nouă în extensie. Roblox spune că clientul trebuie repornit ca să preia noua configurație.

Roblox nu spune în ce fișier scrie quick connect pentru Claude Code și cum numește serverul. Scrie /mcp în Claude Code ca să vezi numele. Îți va trebui pentru regulile de permisiuni de la pasul 3.

Folosești extensia Claude Code în VS Code sau Cursor? Activează și aici Claude Code. Ghidul Roblox despre coding harness activează Cursor sau Visual Studio Code, dar Anthropic documentează că extensia împarte configurația MCP cu versiunea Claude Code pentru terminal și nu spune că citește setările MCP proprii ale editorului.

Configurare manuală prin fișierul .mcp.json

Dacă quick connect nu îți merge, adaugă Studio singur. Claude Code citește serverele MCP ale proiectului dintr-un fișier numit .mcp.json din folderul proiectului, în același format mcpServers pe care îl documentează Roblox, și tratează o intrare fără type ca server stdio local. Așa că configurația Roblox merge exact cum e. Salvează varianta pentru sistemul tău ca .mcp.json în folderul în care rulezi claude:

.mcp.json · Windows (configurația Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
.mcp.json · macOS (configurația Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

Data viitoare când rulezi claude în acest folder, îți va cere să aprobi serverul: Anthropic arată această cerere pentru fiecare server care vine dintr-un fișier .mcp.json. Anthropic a gândit fișierul ăsta ca să fie pus în commit și împărțit cu toată echipa, dar căile pentru Windows și macOS diferă. Dacă echipa ta are ambele sisteme, ține fișierul în afara repository-ului și lasă-l pe fiecare să-și adauge singur Studio.

Pe macOS poți adăuga Studio și cu o singură comandă. --scope user îl face disponibil în fiecare proiect de pe calculatorul tău; fără el, serverul se încarcă doar în folderul curent. -- separă parametrii proprii ai Claude Code de comanda care pornește serverul.

Terminal · macOS
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Pe Windows e mai simplu drumul cu fișierul JSON, pentru că PowerShell și CMD tratează diferit %LOCALAPPDATA% în linia de comandă.

Verifică conexiunea

  • În terminal, claude mcp list arată fiecare server și starea lui. claude mcp get Roblox_Studio arată mai mult, inclusiv rândul Issue:, dacă serverul nu s-a putut conecta.
  • În Claude Code scrie /mcp. Serverele conectate au lângă nume numărul de instrumente.
  • În Studio, Assistant > … > Manage MCP Servers arată un indicator verde cu numărul de clienți conectați.

Pasul 3: decide ce are voie Claude să facă fără să întrebe

Configurează asta înainte ca Claude să atingă place-ul tău. Potrivit paginii Anthropic despre modurile de permisiuni, începând cu Claude Code v2.1.283 sesiunile interactive din terminal și VS Code pornesc implicit în modul auto oriunde e disponibil, iar în modul auto acțiunile sunt verificate în locul tău de un clasificator din fundal. Atunci un apel MCP care editează un script sau rulează Luau în Studio poate trece fără nicio întrebare.

Sunt două moduri de a păstra fiecare modificare sub controlul tău:

  • Pornește în modul Manual. Rulează claude --permission-mode default. În modul Manual se execută fără întrebare doar citirea. Apasă Shift+Tab în timpul sesiunii ca să comuți modurile.
  • Adaugă reguli ask pentru instrumentele Studio care schimbă ceva. Anthropic spune că niciun mod nu aprobă automat un instrument care intră sub o regulă ask explicită, nici măcar modul bypass.
.claude/settings.json · exemplu
{
  "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"
    ]
  }
}

Regulile MCP au forma mcp__<server>__<tool>, cu numele serverului așa cum îl știe Claude Code. Înlocuiește Roblox_Studio cu numele pe care îl arată /mcp. Regulile allow din fișierul de proiect .claude/settings.json intră în vigoare doar după ce accepți dialogul de încredere în folderul de lucru pentru acest folder. Pentru regulile de care ai nevoie doar tu, folosește .claude/settings.local.json.

Lista allow acoperă instrumentele care doar citesc: arborele jocului, proprietățile, scripturile, Output și lista ferestrelor Studio deschise. Lista ask acoperă instrumentele care schimbă place-ul, rulează cod, pornesc playtesturi, aduc asset-uri externe sau trimit imagini către Roblox. Instrumentele care nu sunt în nicio listă, de exemplu screen_capture și instrumentele de input, urmează modul tău de permisiuni. Lista completă de instrumente, cu descrierea fiecăruia, e în ghidul Studio MCP.

Pasul 4: începe cu o cerere care doar citește

Deschide place-ul cu care vrei să lucrezi și închide-le pe cele cu care nu vrei. Apoi dă-i lui Claude o primă cerere care nu poate schimba nimic:

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.

Pe un Baseplate nou, ghidul Roblox despre coding harness se așteaptă ca răspunsul să enumere obiectele standard Camera, Terrain, Baseplate și SpawnLocation. E un obicei bun să ceri întâi list_roblox_studios: un singur client ajunge la fiecare fereastră Studio pe care o ai deschisă, iar fiecare apel de instrument numește fereastra țintă prin studio_id.

Pentru tot ce e mai mare decât un script, cere întâi un plan. În modul plan (apasă Shift+Tab sau începe promptul cu /plan) Claude explorează și propune, fără să-ți editeze fișierele. Anthropic descrie modul plan în termeni de editări de fișiere și comenzi shell, așa că păstrează și regulile ask pentru instrumentele Studio.

Pasul 5: lucrează cu scripturile ca fișiere prin Script Sync sau Rojo

Claude Code e construit în jurul fișierelor dintr-un folder. Le editează cu instrumentele lui, Git le păstrează istoria, iar /rewind le poate restaura. Dacă pui scripturile pe disc, poți folosi toate astea, iar instrumentele MCP rămân pentru părțile place-ului care nu sunt scripturi, de exemplu GUI-urile din StarterGui, RemoteEvent-urile și part-urile. Roblox documentează două moduri de a face asta.

Script Sync și Rojo, după paginile Roblox despre Script Sync și instrumentele terțe
Script SyncRojo
Ce esteO funcție Studio care sincronizează scripturile din place cu fișiere pe disc, în ambele sensuri.Un instrument terț: un server pe calculatorul tău plus un plugin pentru Studio.
Ce sincronizeazăDoar obiectele Script, LocalScript, ModuleScript și Folder. Celelalte obiecte din folderul sincronizat sunt ignorate.Poate ține tot proiectul ca fișiere, cu sistemul tău de fișiere ca sursă de adevăr.
ConfigurareClic dreapta pe un serviciu sau folder în Explorer, alege Sync to… și indică un folder. Ghidul Roblox despre coding harness îl activează întâi în File > Beta Features.Instalează-l prin Rokit (rokit add rojo-rbx/rojo, apoi rokit install), adaugă pluginul cu comanda rojo plugin install, rulează rojo serve și conectează-te din plugin.
Team CreateFuncționează cu el. Evită situația în care doi oameni editează simultan același script sincronizat.Roblox notează că instrumentele terțe adesea nu funcționează cu instrumentele lui integrate de colaborare.
Sfatul RobloxPotrivit dacă vrei editorul tău și controlul versiunilor pentru cod, iar Studio pentru tot restul.Cea mai bună alegere dacă vrei să ții în controlul versiunilor tot proiectul, nu doar codul.

Același nume de fișier poate însemna lucruri diferite

Ambele instrumente aleg tipul scriptului după numele fișierului, iar sufixele lor nu coincid. Un fișier .client e un LocalScript în Rojo, dar un Script cu context de rulare Client în Script Sync. Spune-i lui Claude ce instrument folosește proiectul tău; exemplul de CLAUDE.md de mai jos face asta.

Regulile Script Sync de pe pagina Roblox despre Script Sync (fișiere .luau). Regulile Rojo de pe pagina Sync Details pentru Rojo v7, unde sunt enumerate fișiere .lua
Numele fișierului se termină înScript Sync creeazăRojo creează
.serverScript cu context de rulare ServerScript
.clientScript cu context de rulare ClientLocalScript
.localLocalScriptNicio semnificație specială (orice alt fișier .lua e ModuleScript)
Fără sufixModuleScriptModuleScript
Folder cu un fișier initUn script cu obiecte copil, al cărui tip îl dă numele fișierului initFolderul devine scriptul descris de init.server.lua, init.client.lua sau init.lua

Configurarea Script Sync pentru Claude Code

  1. Creează un folder de proiect cu câte un folder pentru fiecare serviciu pe care vrei să-l ții pe disc, de exemplu ServerScriptService, ReplicatedStorage și StarterPlayerScripts, și rulează în el git init.
  2. Dacă Script Sync nu apare când dai clic dreapta pe un serviciu, activează-l în File > Beta Features, apasă Save și repornește Studio.
  3. În Explorer dă clic dreapta pe ServerScriptService, alege Script Sync > Sync to și indică folderul de proiect de nivel superior, nu un folder din interiorul lui. Repetă pentru celelalte servicii.
  4. Rulează claude în acest folder. Acum Claude editează fișierele .luau, iar Studio preia fiecare modificare.
  5. Fă un commit înainte de fiecare sesiune, ca să ai mereu un punct curat la care să te întorci.
Terminal, în folderul proiectului
git add .
git commit -m "Before Claude session"

Două reguli Script Sync devin mai importante cu un agent. Nu sincroniza scripturi care au atribute sau taguri: Script Sync le ignoră, iar Roblox avertizează că asta poate duce la pierderi de date. Iar dacă fișierele se schimbă cât Studio e închis, la redeschiderea place-ului Studio te întreabă cum să rezolve situația și enumeră ce vor adăuga, schimba sau șterge Keep Studio și Keep Disk. Citește lista înainte să alegi.

Cu Script Sync activ, o editare de fișier ajunge în Studio imediat după salvare. A accepta o editare în Claude Code înseamnă a o accepta în place-ul tău, așa că verifică înainte să accepți, mai ales în modurile care acceptă editările automat.

Pentru completare automată și erori de tip în editor, Roblox recomandă extensia Luau Language Server cu pluginul ei însoțitor pentru Studio. În VS Code, extensia Claude Code poate citi panoul Problems printr-un instrument integrat, așa că Claude vede aceleași avertismente ca tine.

Pasul 6: dă-i lui Claude regulile tale pentru Roblox în CLAUDE.md

Fiecare sesiune Claude Code începe cu un context nou. Fișierul CLAUDE.md din folderul proiectului se citește la începutul fiecărei sesiuni, deci convențiile tale trebuie să stea în el. Rulează /init ca să-l schițeze Claude sau scrie-l singur. Anthropic recomandă să-l ții sub 200 de rânduri, să scrii regulile destul de concret încât să poată fi verificate și să rulezi /context ca să te asiguri că s-a încărcat.

Exemplul acesta e scris pentru acest ghid, pentru un proiect cu Script Sync. Schimbă numele pentru jocul tău și scoate ce nu îți trebuie.

CLAUDE.md · exemplu pentru un proiect cu Script Sync
# Roblox project rules (example: edit to fit your game)

## Project
- Roblox game "Wave Survival". The place open in Studio is named WaveSurvival.
- Scripts sync to Studio with Script Sync:
  - ServerScriptService/ holds server game logic
  - ReplicatedStorage/ holds ModuleScripts shared by server and client
  - StarterPlayerScripts/ holds client code
- File names set the script type (Script Sync rules):
  - name.server.luau = Script with Server run context
  - name.local.luau = LocalScript
  - name.luau = ModuleScript
  - Do not use name.client.luau unless I ask. In Script Sync it makes a Script with Client run context, not a LocalScript.
- Never add attributes or tags to synced scripts. Script Sync ignores them.

## Roblox Studio MCP
- Call list_roblox_studios first. Work only in the place named WaveSurvival.
- Edit synced scripts as files, not with multi_edit.
- Use the MCP tools only for what is not a synced script: GUIs in StarterGui, RemoteEvents, parts, attributes.
- Never use insert_asset, upload_image or the generate tools unless I ask in this session.
- Ask before deleting any instance you did not create in this session.

## Luau
- Use task.wait, task.spawn and task.delay. Never wait, spawn or delay.
- Get services with game:GetService.
- The server decides coins, health, inventory and rewards. A LocalScript only asks.
- Every OnServerEvent handler checks the type and size of each argument and limits how often each player can call it.
- Wrap DataStore and HttpService calls in pcall and handle the failure.
- Remove per-player table entries in Players.PlayerRemoving.
- Never put API keys, webhook URLs or passwords in scripts or in this repository.

## Before you say a task is done
- List every script and instance you changed.
- Read the Output with get_console_output and report any errors.
- Tell me what to playtest by hand.

Unele rânduri există din cauza felului în care funcționează instrumentele. Regulile despre numele fișierelor sunt acolo pentru că .client.luau în Script Sync nu e un LocalScript. Rândul despre list_roblox_studios e acolo pentru că serverul ajunge la fiecare fereastră deschisă. Rândul despre asset-uri e acolo pentru că insert_asset aduce în place conținut extern, iar upload_image trimite imagini pe serverul de asset-uri Roblox. Rândul despre wait urmează referința API Roblox, care marchează wait, spawn și delay ca învechite în favoarea bibliotecii task.

Dacă proiectul tău are deja un AGENTS.md pentru alți agenți de cod, Claude Code îl poate citi ca instrucțiuni de proiect, deci poți ține un singur fișier pentru amândoi. Pagina Anthropic despre memorie explică ce fișier câștigă când există amândouă.

Cum arată aceste reguli în cod

Iată un script de server care urmează regulile Luau de mai sus. E scris de mână pentru acest ghid, nu generat de Claude. Folosește-l ca etalon când verifici ce îți dă Claude. LocalScript-ul cere un instrument prin RequestTool:FireServer("Sword"), iar serverul verifică totul.

Script în ServerScriptService cu numele 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")

-- Script Sync sincronizează doar scripturi și foldere, așa că serverul își creează singur remote-ul.
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)
	-- Ignorăm o cerere care a sosit după ce jucătorul a ieșit.
	if player.Parent ~= Players then
		return
	end

	-- 1. Verificăm argumentul: clientul poate trimite orice.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Limităm cât de des poate cere un jucător.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Decide serverul. Adaugă aici verificarea ta de proprietate (gamepass, înregistrare de cumpărare).
	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. Curățăm datele jucătorului.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Pe disc cu Script Sync: ServerScriptService/ToolRequests.server.luau. Pune obiectele Tool într-un Folder numit Tools în ServerStorage. Până nu adaugi verificarea de proprietate, orice jucător poate primi orice instrument din acest folder.

Caută aceleași lucruri în orice handler de remote pe care îl scrie Claude: verifică tipul și mărimea a ce a trimis clientul, limitează cât de des îl poate apela un jucător, decizia o ia serverul, iar înregistrarea jucătorului se șterge când acesta iese. Ghidul despre RemoteEvent explică de ce contează fiecare punct.

Un mod sigur de lucru: punct de control, verificare, playtest

  1. Fă un punct de control de ambele părți. Fă commit fișierelor în Git și salvează o versiune a place-ului în Studio prin File > Save to Roblox with Notes. Ghidul Studio MCP arată cum o restaurezi din Version History.
  2. Cere un plan pentru tot ce e mai mare decât un script și citește-l înainte să-l aprobi.
  3. Verifică diff-ul. Pentru fișiere citește git diff sau diff-urile integrate din extensie înainte să accepți. Pentru modificările făcute în Studio citește scripturile atinse de Claude și verifică în Explorer obiectele care au apărut sau au dispărut.
  4. Testează singur. Claude poate porni un playtest și citi Output, dar verifică doar ce a hotărât el să verifice. Joacă funcția așa cum ar juca-o un jucător înainte să faci commit sau să publici.
  5. Fă commit când totul merge, cu un mesaj despre ce s-a schimbat.

Ce poate anula /rewind și ce nu

Claude Code salvează un punct de control înainte de fiecare prompt, iar /rewind (sau Esc de două ori) restaurează fișierele pe care Claude le-a schimbat cu instrumentele lui de editare a fișierelor. Anthropic enumeră ce nu urmărește, inclusiv modificările făcute cu comenzi shell. Modificările făcute în Studio prin instrumentele MCP nu sunt editări de fișiere, așa că nu te aștepta ca /rewind să le anuleze, iar pagina MCP a Roblox nu spune dacă ajung în istoria de anulare a Studio. Cu Script Sync, un fișier restaurat de /rewind se sincronizează înapoi în Studio, ca orice altă modificare pe disc. Pentru tot restul, drumul înapoi e versiunea salvată.

Ține secretele și datele live departe

  • Nu lipi chei API, chei Open Cloud, URL-uri de webhook și parole în prompt sau în CLAUDE.md. Și unul, și celălalt sunt text pe care îl citește Claude, iar CLAUDE.md se pune de obicei în commit în repository.
  • Nici în scripturi nu le scrie direct. Roblox are un depozit de secrete pentru fiecare joc: creează secretele în Creator Dashboard și citește-le într-un script de server prin HttpService:GetSecret(). Pentru playtesturi locale adaugă secrete locale în File > Experience Settings > Security.
  • Ține setările personale în .claude/settings.local.json și CLAUDE.local.md, care sunt gândite să rămână în afara Git. Adaugă singur CLAUDE.local.md în .gitignore.
  • Activează Enable Studio Access to API Services doar într-o copie de test separată a jocului. Roblox avertizează că Studio folosește aceleași depozite de date ca jocul live, așa că un playtest pornit de Claude acolo poate suprascrie datele reale ale jucătorilor.
  • Citește un skill terț înainte să-l instalezi. În cataloagele de skills există skills pentru Roblox pentru Claude Code, iar Anthropic notează că un skill își poate da acces larg la instrumente prin câmpul allowed-tools.

Cât costă Claude Code pentru lucrul cu Roblox

Partea Studio nu are un preț documentat: serverul MCP face parte din Studio, iar pagina MCP a Roblox nu pomenește nicio taxă. Costul este costul Claude Code, iar Anthropic oferă două moduri de plată (la 9 octombrie 2026):

  • Abonament Claude. Claude Code e inclus în Pro, Max, Team și Enterprise, dar nu în Free. Consumă aceeași limită de utilizare ca Claude pe web, pe desktop și pe mobil. Limitele se resetează pe o fereastră glisantă de cinci ore, iar planurile plătite au în plus limite săptămânale. Când ajungi la una dintre ele, poți aștepta, poți trece la un plan superior sau poți activa credite de utilizare.
  • Cont Claude Console. Plătești utilizarea API după volumul de text procesat. Pagina Anthropic despre costuri spune că cheltuielile depind mult de alegerea modelului, de mărimea bazei de cod și de felul în care îl folosești.

Prețurile actuale sunt pe claude.com/pricing. Ghidul acesta nu le repetă, pentru că se schimbă. În Claude Code, comanda /usage le arată abonaților scalele de utilizare ale planului, iar utilizatorilor API costul aproximativ al sesiunii.

Ce face o sesiune Roblox să consume mai mult

  • Mărimea contextului. Consumul crește odată cu ce are Claude în context. Folosește /clear între sarcini fără legătură.
  • Rezultate mari ale instrumentelor. Parcurgerea întregului arbore al jocului într-un place mare sau citirea integrală a scripturilor lungi returnează mult text. Claude Code numără textul în unitățile cu care îl măsoară modelul: avertizează când rezultatul unui instrument MCP depășește 10 000 de astfel de unități și implicit îl limitează la 25 000. Cere în schimb un singur folder, o limită de adâncime sau un interval de rânduri: și search_game_tree, și script_read suportă asta.
  • Alegerea modelului. Anthropic spune că Sonnet se descurcă bine cu majoritatea sarcinilor de cod și costă mai puțin decât Opus. Comută prin /model.

Rezolvarea problemelor cu Claude Code și Studio

Lista de verificare a Roblox e scurtă: repornești Studio și clientul, verifici că există calea comenzii și verifici JSON-ul. Iată cazurile specifice pentru Claude Code.

Claude Code nu apare în lista Quick connect

Lista arată doar clienții suportați instalați pe calculatorul tău. Instalează Claude Code, apoi repornește Studio. Dacă l-ai instalat cu Studio deschis, repornește Studio, Claude Code sau pe amândouă. Fișierul .mcp.json de la pasul 2 funcționează fără quick connect.

/mcp nu arată serverul Roblox Studio

Repornește Claude Code după ce adaugi serverul. Apoi verifică unde a fost adăugat: un server adăugat fără --scope se încarcă doar în folderul în care l-ai adăugat, așa că rulează claude din acel folder sau adaugă-l din nou cu --scope user. În VS Code începe o conversație nouă, pentru că modificările se aplică conversațiilor începute după ele.

Serverul arată Pending approval

A venit dintr-un fișier .mcp.json, iar Claude Code întreabă înainte să folosească astfel de servere. Rulează claude în acel folder, acceptă dialogul de încredere în folderul de lucru și aprobă serverul. claude mcp reset-project-choices resetează deciziile anterioare.

Serverul arată Failed to connect

Rulează claude mcp get Roblox_Studio și citește rândul Issue:. Verifică dacă fișierul există: %LOCALAPPDATA%\Roblox\mcp.bat pe Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP pe macOS (schimbă calea dacă Studio e instalat în altă parte). Asigură-te că Enable Studio as MCP server e încă activ, apoi repornește Studio și Claude Code.

Terminalul scrie că claude nu e recunoscut

După instalare deschide o fereastră nouă de terminal. Dacă tot nu găsește comanda, folderul de instalare nu e în PATH; soluția e pe pagina Anthropic despre problemele de instalare. Extensia pentru VS Code nu adaugă claude în PATH, așa că pentru comenzile din acest ghid instalează separat versiunea pentru terminal.

Claude a schimbat alt place

Cu mai multe ferestre Studio deschise, fiecare apel de instrument numește ținta prin studio_id. Cere-i lui Claude să apeleze list_roblox_studios și numește place-ul dorit, închide ferestrele pe care nu le folosești și restaurează place-ul schimbat din Version History.

Claude Code taxează cheia mea API, nu planul

Odată ce ai aprobat-o, variabila de mediu ANTHROPIC_API_KEY are prioritate față de abonament. Șterge variabila (sau dezactivează Use custom API key în /config), pornește din nou Claude Code și rulează /status ca să verifici ce conectare e activă. Dacă e tot contul Console, rulează /login și alege contul tău Claude.

O sesiune în cloud nu vede Studio

Sesiunile în cloud rulează pe infrastructura Anthropic, nu pe calculatorul tău, deci nu ajung la serverul local Studio. Folosește terminalul, extensia pentru editor sau aplicația desktop cu Local selectat.

Sau ia în schimb un agent-plugin: RoCode

Claude Code cu MCP li se potrivește celor care se simt bine în terminal sau într-un editor de cod. RoCode (RoCode.app) e alt drum: un agent AI independent pentru Roblox Studio, cu chat web pe rocode.app și un plugin gratuit din Creator Store care execută pașii în place-ul pe care îl ai deschis. Nu e un produs MCP și nu folosește serverul MCP din Studio, deci nu ai de configurat linie de comandă, fișier de configurare sau server MCP. Pluginul se conectează singur dacă Studio e conectat la același cont Roblox pe care îl folosești în RoCode; altfel legi o singură dată chatul și pluginul cu un cod de 8 caractere afișat în panoul pluginului.

Ce e bine de știut înainte să treci. RoCode nu poate conecta un abonament Claude sau Claude Code. Rulează modele ale unor terți prin OpenRouter, inclusiv Claude Sonnet 5.5 pe Pro și mai sus și Claude Opus 5.5 pe Studio și mai sus, iar planul gratuit Starter dă 1 credit pe zi pe GPT-6 Luna. Lucrează din modul de editare. Cu pluginul 3.9 sau mai nou, în modul Build, poate porni un playtest scurt și citi erorile, iar cu pluginul 3.9.11 sau mai nou poate controla un personaj de test ca să verifice că jocul funcționează. Cu pluginul 3.9.14 sau mai nou mai face și capturi ale celor construite, în modul de editare, și poate repara ce arată greșit. Nu rulează cod direct și nu generează mesh-uri, iar instrumentele Studio MCP știu să facă ambele. Poate căuta modele gratuite în Creator Store după cuvintele tale (scripturile din interior se elimină) sau poate insera un model, un decal sau un mesh după ID-ul asset-ului, iar decorul, clădirile și recuzita le inventează din nou pentru fiecare joc. Modul lui Ask răspunde la întrebări despre place-ul tău cu instrumente doar de citire și nu schimbă nimic. Conturi pentru cei de 13 ani și peste, iar sub 18 ani cu permisiunea unui părinte sau tutore.

Tu scrii

Adaugă un RemoteEvent ca jucătorii să poată cere un instrument din ServerStorage.Tools. Verifică totul pe server.

RoCode face
  • Poate întâi să cerceteze place-ul prin Search Game și List Children, ca să găsească folderul Tools și scripturile care dau deja instrumente
  • Scrie scriptul de server prin Create Script și poate adăuga RemoteEvent-ul prin Create Instance
  • Verifică compilarea scriptului în Studio prin Check Script înainte să termine. E o verificare de compilare, nu o verificare de tipuri și nici un playtest
  • Trimite modificările în loturi, iar fiecare lot este un punct de anulare în istoria Studio

Cu pluginul 3.9 sau mai nou, RoCode poate porni un playtest scurt și citi erorile, iar cu pluginul 3.9.15 sau mai nou personajul lui de test știe să meargă, să apese taste și să dea clic pe butoanele de pe ecran, dar verifică doar ce a hotărât el să verifice, așa că apasă singur Play ca să verifici rezultatul ca un jucător. Promptul e un exemplu scris de noi; pașii folosesc nume reale de instrumente. Cum funcționează pluginul și asocierea. RoCode este un produs independent, neafiliat cu Roblox Corporation, neaprobat și nesponsorizat de aceasta.

Întrebări frecvente

Pot folosi Claude Desktop în loc de Claude Code?

Da. Claude Desktop e în lista Quick connect din panoul Manage MCP Servers din Studio, deci se conectează cu un singur comutator, pe Windows sau Mac. Folosește aceleași instrumente Studio; Claude Code adaugă ce face bine un agent de terminal, de exemplu lucrul cu fișierele scripturilor și cu Git. Pașii pentru amândouă sunt în ghidul de configurare Studio MCP.

Se poate conecta Claude Code la Roblox Studio?

Da. Roblox listează Claude Code ca client quick connect pentru serverul MCP integrat în Studio. Activează Enable Studio as MCP server în Assistant > … > Manage MCP Servers, activează Claude Code în lista Quick connect și repornește Claude Code. Mai poate lucra cu scripturile tale ca fișiere prin Script Sync sau Rojo.

E gratuit Claude Code pentru lucrul cu Roblox Studio?

Serverul MCP din Studio nu are un preț documentat, dar Claude Code nu e inclus în planul Free al Anthropic (claude.com/pricing, verificat pe 9 octombrie 2026). Ai nevoie de un plan Claude plătit, unde împarte limitele de utilizare ale planului tău, sau de un cont Claude Console cu plată pentru utilizarea API.

Am nevoie de un plugin Roblox sau de cereri HTTP ca să folosesc Claude Code?

Pentru serverul MCP integrat în Studio, nu. Pașii de configurare Roblox sunt să pornești serverul în Assistant și să conectezi clientul; nu e niciun plugin de instalat și nicio setare HTTP de schimbat. Unele ghiduri vechi descriu servere MCP ale comunității, care funcționează altfel. Rojo, dacă îl alegi pentru fișiere, folosește propriul plugin pentru Studio.

Poate Claude Code să-mi testeze jocul Roblox?

Prin instrumentele Studio MCP, da. start_stop_play pornește și oprește un playtest, get_console_output citește Output, screen_capture fotografiază viewport-ul, iar instrumentele de input mișcă personajul și trimit taste și clicuri. Verifică ce raportează și joacă singur jocul înainte să publici.

Ce să aleg pentru Roblox Studio: Claude Code sau Codex?

Amândouă sunt în lista quick connect a Roblox și ajung la aceleași instrumente Studio MCP, deci diferența e modelul, contul și clientul din jurul lui. Roblox nu publică o comparație, iar noi nu le-am testat comparativ. Încearcă-le pe fiecare pe o copie a place-ului tău, cu aceleași reguli scrise, și păstrează-l pe cel ale cărui modificări cer mai puține corecturi.

Funcționează Claude Code cu Roblox Studio pe Mac?

Da. Claude Code suportă macOS 13.0 sau mai nou, iar Roblox documentează calea serverului pentru macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, pentru clienții pe care îi configurezi manual.

Surse și lecturi suplimentare

Cum a fost verificat codul: fiecare script de pe această pagină trece printr-o verificare strictă a tipurilor Luau cu definițiile API Roblox (luau-lsp, 20 noiembrie 2026). Verificarea tipurilor prinde nume greșite de API și tipuri greșite, dar nu și greșelile de logică a jocului, așa că testează totul în Studio înainte să publici.

Încearcă RoCode în jocul tău.

Credite gratuite în fiecare zi, fără card. Instalează pluginul, descrie o funcție și verifică ce a apărut în Studio.