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
/rewinddin Claude Code nu anulează modificările făcute în Studio, așa că salvează întâi o versiune.
Pe această pagină
De ce ai nevoie înainte să începi
| Ai nevoie de | Detalii |
|---|---|
| Roblox Studio | Ultima 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 Code | macOS 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 Code | Un 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țional | Git, 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.
| Variantă | Ajunge la Studio? | Note |
|---|---|---|
Terminal (comanda claude) | Da | Rulează-l în folderul proiectului. Îți trebuie și pentru comenzile claude mcp de mai jos. |
| Extensia pentru VS Code sau Cursor | Da | Drumul 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 selectat | Da | Rulează 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) | Nu | Rulează 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.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- 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. - Mergi în folderul proiectului și rulează
claude. La prima pornire deschide o fereastră de browser pentru conectare. Dacă browserul nu s-a deschis, apasăcca să copiezi linkul de conectare. - 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
- Î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.
- Activează Claude Code. Dacă nu apare, instalează Claude Code și repornește Studio.
- Repornește Claude Code: închide sesiunea și rulează din nou
claudesau î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:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"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.
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 listarată fiecare server și starea lui.claude mcp get Roblox_Studioarată mai mult, inclusiv rândulIssue:, 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.
{
"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:
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 | Rojo | |
|---|---|---|
| Ce este | O 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. |
| Configurare | Clic 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 Create | Funcț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 Roblox | Potrivit 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.
| Numele fișierului se termină în | Script Sync creează | Rojo creează |
|---|---|---|
.server | Script cu context de rulare Server | Script |
.client | Script cu context de rulare Client | LocalScript |
.local | LocalScript | Nicio semnificație specială (orice alt fișier .lua e ModuleScript) |
| Fără sufix | ModuleScript | ModuleScript |
Folder cu un fișier init | Un script cu obiecte copil, al cărui tip îl dă numele fișierului init | Folderul devine scriptul descris de init.server.lua, init.client.lua sau init.lua |
Configurarea Script Sync pentru Claude Code
- 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șiStarterPlayerScripts, și rulează în elgit init. - 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.
- Î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.
- Rulează
claudeîn acest folder. Acum Claude editează fișierele.luau, iar Studio preia fiecare modificare. - Fă un commit înainte de fiecare sesiune, ca să ai mereu un punct curat la care să te întorci.
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.
# 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.
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
- 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.
- Cere un plan pentru tot ce e mai mare decât un script și citește-l înainte să-l aprobi.
- Verifică diff-ul. Pentru fișiere citește
git diffsau 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. - 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.
- 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, iarCLAUDE.mdse 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șiCLAUDE.local.md, care sunt gândite să rămână în afara Git. Adaugă singurCLAUDE.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, șiscript_readsuportă 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.
Adaugă un RemoteEvent ca jucătorii să poată cere un instrument din ServerStorage.Tools. Verifică totul pe server.
- 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
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (în engleză). pornirea serverului, quick connect, configurare prin JSON și CLI, instrumente, mai multe ferestre Studio și rezolvarea problemelor
- Roblox Creator Docs: Build with a coding harness (în engleză). Claude Code în VS Code, Script Sync, MCP și Git împreună
- Roblox Creator Docs: Script Sync (în engleză). ce se sincronizează, regulile numelor de fișiere, conflictele și language server
- Roblox Creator Docs: Third-party tools (în engleză). Rojo cu Rokit și controlul versiunilor
- Roblox Creator Docs: Secrets stores (în engleză). cum ții cheile API în afara scripturilor
- Roblox Creator Docs: Data stores (în engleză). de ce accesul Studio la API services se folosește doar într-o copie de test
- Rojo documentation (v7) (în engleză). instalarea și felul în care numele fișierelor devin obiecte
- Claude Code Docs: Overview (în engleză). toate variantele au același motor, iar aplicația desktop cere un abonament plătit
- Claude Code Docs: Advanced setup (în engleză). cerințele de sistem și comenzile de instalare
- Claude Code Docs: Authentication (în engleză). conectarea și tipurile de cont potrivite
- Claude Code Docs: Connect Claude Code to tools via MCP (în engleză). servere stdio, .mcp.json, domenii de aplicare și starea serverului
- Claude Code Docs: Configure permissions (în engleză). regulile allow, ask și deny, inclusiv pentru instrumentele MCP
- Claude Code Docs: Choose a permission mode (în engleză). modul auto ca mod de pornire, modul Manual și modul plan
- Claude Code Docs: How Claude remembers your project (în engleză). CLAUDE.md, /init și AGENTS.md
- Claude Code Docs: Checkpointing (în engleză). ce restaurează /rewind și ce nu urmărește
- Claude Code Docs: Manage costs effectively (în engleză). /usage, mărimea contextului și alegerea modelului
- Claude Code Docs: Use Claude Code in the cloud (în engleză). de ce sesiunile în cloud nu rulează pe calculatorul tău
- Claude Code Docs: Use Claude Code in VS Code (în engleză). cerințe, nota despre PATH, configurația MCP comună și panoul Problems
- Claude Code Docs: Extend Claude with skills (în engleză). ce oferă câmpul allowed-tools al unui skill
- Claude pricing (în engleză). ce planuri includ Claude Code și limitele de utilizare
- Claude Help Center: Use Claude Code with your Pro or Max plan (în engleză). limitele comune și avertismentul despre ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (în engleză). vârsta minimă
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.