Guida · IA in Roblox Studio

Come collegare Claude Code a Roblox Studio

Claude Code è lo strumento agentico di Anthropic per scrivere codice. Roblox lo elenca come client quick connect per il server MCP integrato in Studio, quindi può leggere il tuo place, modificare gli script e avviare playtest nella finestra di Studio che hai aperta. Può anche lavorare con i tuoi script come file tramite Script Sync o Rojo. Questa guida riguarda il lato Claude Code: cosa serve, come collegarlo, i permessi, un CLAUDE.md con le regole per Roblox, un modo sicuro di lavorare e quanto costa. Per l'agente di OpenAI vedi la guida come usare OpenAI Codex con Roblox Studio (in inglese); per Cursor, Claude Desktop e gli altri client vedi la guida alla configurazione di Studio MCP.

Aggiornato il 20 novembre 202623 min di letturaScritto da

In breve

Installa Claude Code ed entra con un piano Claude a pagamento o un account Claude Console. In Studio apri Assistant, clicca su … > Manage MCP Servers, attiva Enable Studio as MCP server, poi attiva Claude Code nell'elenco Quick connect. Riavvia Claude Code, scrivi /mcp per verificare che il server di Studio sia collegato e inizia con una richiesta che legge soltanto.

  • Claude Code non è incluso nel piano Free di Anthropic. È incluso in Pro, Max, Team ed Enterprise, oppure si paga in base all'uso dell'API tramite un account Claude Console (verificato il 9 ottobre 2026).
  • Usa una sessione locale: il terminale, l'estensione per VS Code o Cursor oppure l'app desktop con Local selezionato. Le sessioni cloud non girano sul tuo computer e non arrivano a Studio.
  • Dalla v2.1.283 le sessioni nel terminale e in VS Code partono di default in modalità auto dove è disponibile, quindi aggiungi regole ask per gli strumenti di Studio che modificano il place. Il comando /rewind di Claude Code non annulla le modifiche fatte in Studio, quindi salva prima una versione.
In questa pagina
  1. Cosa serve
  2. 1. Installazione e accesso
  3. 2. Collegamento a Studio
  4. 3. Permessi
  5. 4. Prima richiesta
  6. 5. Script Sync o Rojo
  7. 6. CLAUDE.md
  8. Lavorare in sicurezza
  9. Costi
  10. Risoluzione dei problemi
  11. Agente plugin
  12. Domande frequenti
  13. Fonti e letture

Cosa serve prima di iniziare

Requisiti, secondo la documentazione di Roblox e Anthropic, 9 ottobre 2026
Cosa serveDettagli
Roblox StudioL'ultima versione, su Windows o macOS. Il server MCP è integrato in Studio, quindi lato Roblox non serve installare altro.
Un computer che supporta Claude CodemacOS 13.0 o successivo oppure Windows 10 1809 o successivo, almeno 4 GB di RAM, una connessione a internet e una posizione in un paese supportato da Anthropic.
Un account Claude che include Claude CodeUn piano Claude a pagamento (Pro, Max, Team o Enterprise) o un account Claude Console. La pagina dei prezzi di Anthropic indica che Claude Code non è incluso nel piano Free.
EtàLe Consumer Terms di Anthropic (in vigore dall'8 ottobre 2025) dicono che devi avere almeno 18 anni, o l'età minima del consenso nel tuo paese se è più alta.
FacoltativoGit, per tenere la cronologia degli script. Visual Studio Code 1.94.0 o successivo oppure Cursor, se vuoi Claude Code in un pannello dell'editor invece che nel terminale.

Quale Claude Code usare

Claude Code gira in diversi posti. Anthropic scrive che tutti usano lo stesso motore, quindi il tuo CLAUDE.md, le impostazioni e i server MCP funzionano ovunque. Per Studio conta dove gira la sessione: il server MCP di Roblox è un processo locale sul tuo computer, quindi anche la sessione deve essere sul tuo computer.

Le varianti di Claude Code e Roblox Studio
VarianteArriva a Studio?Note
Terminale (comando claude)SìAvvialo nella cartella del progetto. Serve anche per i comandi claude mcp più sotto.
Estensione per VS Code o CursorSìIl percorso della guida di Roblox sul coding harness. L'estensione contiene una propria copia di Claude Code, ma non aggiunge claude al PATH, quindi, se ti servono quei comandi, installa anche la versione per il terminale.
App desktop, scheda Code, con Local selezionatoSìGira sul tuo computer. Anthropic scrive che serve un abbonamento a pagamento.
Sessioni cloud (claude.ai/code o Cloud nell'app desktop)NoGirano su un'infrastruttura cloud, non sul tuo computer, quindi non possono avviare il server locale di Studio.

Passo 1: installa Claude Code ed entra

Anthropic consiglia l'installazione con un solo comando nel terminale. Questi sono i comandi presenti sulla sua pagina di installazione il 9 ottobre 2026; quelli aggiornati sono sulla pagina di installazione di Anthropic (in inglese).

Terminale · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Apri una nuova finestra del terminale ed esegui claude --version. Un numero di versione vuol dire che è andato tutto bene. Se il comando non viene trovato, la cartella di installazione non è ancora nel PATH, e la soluzione è sulla pagina di Anthropic sui problemi di installazione.
  2. Vai nella cartella del progetto ed esegui claude. Al primo avvio apre una finestra del browser per l'accesso. Se il browser non si apre, premi c per copiare il link di accesso.
  3. Entra nel tuo account Claude. L'accesso con Pro o Max usa i limiti inclusi nel tuo piano.

Su Windows Anthropic consiglia di installare Git for Windows, così Claude Code può usare il suo strumento Bash; senza, Claude Code esegue i comandi in PowerShell. Per questa configurazione installa Claude Code in Windows stesso, non dentro WSL: la configurazione di Roblox per Windows avvia cmd.exe con un percorso %LOCALAPPDATA%, e Roblox non documenta WSL.

Preferisci un pannello nell'editor? In VS Code o Cursor apri Extensions (Ctrl+Shift+X o Cmd+Shift+X su Mac), cerca Claude Code, installalo ed entra dal pannello Claude. È proprio la configurazione usata dalla guida di Roblox sul coding harness.

Passo 2: collega Claude Code a Studio

Prima attiva il server. In Studio apri Assistant, clicca su … > Manage MCP Servers e attiva Enable Studio as MCP server. La guida a Studio MCP spiega questo passo più nel dettaglio. Non trovi il pulsante Assistant? Vedi come aprire il pannello Assistant.

Quick connect

  1. Nello stesso pannello (Assistant Settings > MCP Servers) apri l'elenco Quick connect. Contiene i client supportati installati sul tuo computer.
  2. Attiva Claude Code. Se non c'è, installa Claude Code e riavvia Studio.
  3. Riavvia Claude Code: chiudi la sessione ed esegui di nuovo claude, oppure inizia una nuova conversazione nell'estensione. Roblox scrive che il client deve essere riavviato per leggere la nuova configurazione.

Roblox non dice in quale file Claude Code scrive il quick connect né come chiama il server. Scrivi /mcp in Claude Code per vedere il nome. Ti servirà per le regole dei permessi al passo 3.

Usi l'estensione Claude Code in VS Code o Cursor? Anche qui attiva Claude Code. La guida di Roblox sul coding harness attiva Cursor o Visual Studio Code, ma Anthropic documenta che l'estensione condivide la configurazione MCP con la versione di Claude Code per il terminale, e non dice che legga le impostazioni MCP proprie dell'editor.

Configurazione manuale con il file .mcp.json

Se il quick connect non ti funziona, aggiungi Studio tu stesso. Claude Code legge i server MCP del progetto da un file chiamato .mcp.json nella cartella del progetto, nello stesso formato mcpServers documentato da Roblox, e considera una voce senza type come un server stdio locale. Quindi la configurazione di Roblox funziona così com'è. Salva la variante per il tuo sistema come .mcp.json nella cartella in cui avvii claude:

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

La prossima volta che avvii claude in quella cartella, ti chiederà di approvare il server: Anthropic mostra questa richiesta per ogni server che arriva da un file .mcp.json. Anthropic ha pensato questo file per essere committato e condiviso con tutto il team, ma i percorsi per Windows e macOS sono diversi. Se nel tuo team ci sono entrambi i sistemi, tieni il file fuori dal repository e lascia che ognuno aggiunga Studio per conto suo.

Su macOS puoi invece aggiungere Studio con un solo comando. --scope user lo rende disponibile in ogni progetto sul tuo computer; senza, il server si carica solo nella cartella corrente. -- separa i parametri di Claude Code dal comando che avvia il server.

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

Su Windows è più semplice la strada del file JSON, perché PowerShell e CMD gestiscono %LOCALAPPDATA% in modo diverso nella riga di comando.

Verifica il collegamento

  • Nel terminale claude mcp list mostra ogni server e il suo stato. claude mcp get Roblox_Studio mostra di più, inclusa una riga Issue: se il server non è riuscito a collegarsi.
  • Dentro Claude Code scrivi /mcp. Accanto al nome dei server collegati c'è il numero di strumenti.
  • In Studio Assistant > … > Manage MCP Servers mostra un indicatore verde con il numero di client collegati.

Passo 3: decidi cosa può fare Claude senza chiedere

Configuralo prima che Claude tocchi il tuo place. Secondo la pagina di Anthropic sulle modalità dei permessi, dalla v2.1.283 di Claude Code le sessioni interattive nel terminale e in VS Code partono di default in modalità auto ovunque sia disponibile, e in modalità auto le azioni vengono controllate al posto tuo da un classificatore in background. Così una chiamata MCP che modifica uno script o esegue Luau in Studio può passare senza richiesta.

Ci sono due modi per tenere ogni modifica sotto il tuo controllo:

  • Avvia in modalità Manual. Esegui claude --permission-mode default. In modalità Manual senza chiedere viene eseguita solo la lettura. Premi Shift+Tab durante la sessione per cambiare modalità.
  • Aggiungi regole ask per gli strumenti di Studio che cambiano qualcosa. Anthropic scrive che nessuna modalità approva in automatico uno strumento che rientra in una regola ask esplicita, nemmeno la modalità bypass.
.claude/settings.json · esempio
{
  "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"
    ]
  }
}

Le regole MCP hanno la forma mcp__<server>__<tool>, con il nome del server così come lo conosce Claude Code. Sostituisci Roblox_Studio con il nome mostrato da /mcp. Le regole allow nel file di progetto .claude/settings.json entrano in vigore solo dopo che hai accettato la finestra di fiducia per la cartella di lavoro. Per le regole che servono solo a te usa .claude/settings.local.json.

L'elenco allow copre gli strumenti che leggono soltanto: l'albero del gioco, le proprietà, gli script, l'Output e l'elenco delle finestre di Studio aperte. L'elenco ask copre gli strumenti che cambiano il place, eseguono codice, avviano playtest, inseriscono asset esterni o inviano immagini a Roblox. Gli strumenti che non sono in nessuno dei due elenchi, come screen_capture e gli strumenti di input, seguono la tua modalità dei permessi. L'elenco completo degli strumenti con la descrizione di ciascuno è nella guida a Studio MCP.

Passo 4: inizia con una richiesta che legge soltanto

Apri il place su cui vuoi lavorare e chiudi quelli su cui non vuoi lavorare. Poi dai a Claude una prima richiesta che non può cambiare nulla:

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.

Su un Baseplate nuovo la guida di Roblox sul coding harness si aspetta che la risposta elenchi i soliti Camera, Terrain, Baseplate e SpawnLocation. Chiedere prima list_roblox_studios è una buona abitudine: un solo client arriva a ogni finestra di Studio che hai aperta, e ogni chiamata a uno strumento indica la finestra di destinazione tramite studio_id.

Per qualsiasi cosa più grande di un singolo script, chiedi prima un piano. In modalità plan (premi Shift+Tab o inizia il prompt con /plan) Claude esplora e propone senza modificare i tuoi file. Anthropic descrive la modalità plan in termini di modifiche ai file e comandi della shell, quindi tieni anche le regole ask per gli strumenti di Studio.

Passo 5: lavora con gli script come file tramite Script Sync o Rojo

Claude Code è costruito intorno ai file in una cartella. Li modifica con i suoi strumenti, Git ne tiene la cronologia e /rewind può ripristinarli. Se metti gli script su disco, puoi usare tutto questo, e gli strumenti MCP restano per le parti del place che non sono script, come le GUI in StarterGui, i RemoteEvent e le parti. Roblox documenta due modi per farlo.

Script Sync e Rojo, secondo le pagine di Roblox su Script Sync e sugli strumenti di terze parti
Script SyncRojo
Cos'èUna funzione di Studio che sincronizza gli script del place con i file su disco, in entrambe le direzioni.Uno strumento di terze parti: un server sul tuo computer più un plugin per Studio.
Cosa sincronizzaSolo gli oggetti Script, LocalScript, ModuleScript e Folder. Gli altri oggetti nella cartella sincronizzata vengono ignorati.Può gestire tutto il progetto come file, con il tuo file system come fonte di verità.
ConfigurazioneClicca con il tasto destro su un servizio o una cartella nell'Explorer, scegli Sync to… e indica una cartella. La guida di Roblox sul coding harness prima lo attiva in File > Beta Features.Installalo con Rokit (rokit add rojo-rbx/rojo, poi rokit install), aggiungi il plugin con il comando rojo plugin install, esegui rojo serve e collegati dal plugin.
Team CreateFunziona con Team Create. Evita che due persone modifichino nello stesso momento lo stesso script sincronizzato.Roblox nota che gli strumenti di terze parti spesso non funzionano con i suoi strumenti integrati di collaborazione.
Il consiglio di RobloxVa bene se vuoi il tuo editor e il controllo di versione per il codice, e Studio per tutto il resto.La scelta migliore se vuoi tenere sotto controllo di versione tutto il progetto, non solo il codice.

Lo stesso nome di file può significare cose diverse

Entrambi gli strumenti scelgono il tipo di script dal nome del file, e i loro suffissi non coincidono. Un file .client è un LocalScript in Rojo, ma uno Script con contesto di esecuzione Client in Script Sync. Di' a Claude quale strumento usa il tuo progetto; l'esempio di CLAUDE.md più sotto lo fa.

Regole di Script Sync dalla pagina di Roblox su Script Sync (file .luau). Regole di Rojo dalla pagina Sync Details per Rojo v7, che elenca i file .lua
Il nome del file finisce conScript Sync creaRojo crea
.serverScript con contesto di esecuzione ServerScript
.clientScript con contesto di esecuzione ClientLocalScript
.localLocalScriptNessun significato particolare (qualsiasi altro file .lua è un ModuleScript)
Senza suffissoModuleScriptModuleScript
Cartella con un file initUno script con oggetti figli, il cui tipo è dato dal nome del file initLa cartella diventa lo script descritto da init.server.lua, init.client.lua o init.lua

Configurare Script Sync per Claude Code

  1. Crea una cartella di progetto con una cartella per ogni servizio che vuoi tenere su disco, per esempio ServerScriptService, ReplicatedStorage e StarterPlayerScripts, ed esegui al suo interno git init.
  2. Se Script Sync non compare quando clicchi con il tasto destro su un servizio, attivalo in File > Beta Features, clicca su Save e riavvia Studio.
  3. Nell'Explorer clicca con il tasto destro su ServerScriptService, scegli Script Sync > Sync to e indica la cartella di progetto di primo livello, non una cartella al suo interno. Ripeti per gli altri servizi.
  4. Esegui claude in quella cartella. Ora Claude modifica i file .luau e Studio recepisce ogni modifica.
  5. Fai un commit prima di ogni sessione, così hai sempre un punto pulito a cui tornare.
Terminale, nella cartella del progetto
git add .
git commit -m "Before Claude session"

Con un agente due regole di Script Sync diventano più importanti. Non sincronizzare script che hanno attributi o tag: Script Sync li ignora, e Roblox avverte che può causare perdita di dati. E se i file cambiano mentre Studio è chiuso, quando riapri il place Studio chiede come risolvere la cosa ed elenca cosa aggiungeranno, cambieranno o elimineranno Keep Studio e Keep Disk. Leggi quell'elenco prima di scegliere.

Con Script Sync attivo, una modifica a un file arriva in Studio subito dopo il salvataggio. Accettare una modifica in Claude Code vuol dire accettarla nel tuo place, quindi controlla prima di accettare, soprattutto nelle modalità che accettano le modifiche in automatico.

Per il completamento automatico e gli errori di tipo nell'editor Roblox consiglia l'estensione Luau Language Server con il suo plugin compagno per Studio. In VS Code l'estensione Claude Code può leggere il pannello Problems tramite uno strumento integrato, così Claude vede gli stessi avvisi che vedi tu.

Passo 6: dai a Claude le tue regole per Roblox in CLAUDE.md

Ogni sessione di Claude Code parte da un contesto nuovo. Il file CLAUDE.md nella cartella del progetto viene letto all'inizio di ogni sessione, quindi le tue convenzioni devono stare lì. Esegui /init perché Claude ne prepari una bozza, oppure scrivilo tu. Anthropic consiglia di tenerlo sotto le 200 righe, di scrivere regole abbastanza concrete da poter essere verificate e di eseguire /context per controllare che sia stato caricato.

Questo esempio è scritto per questa guida, per un progetto con Script Sync. Cambia i nomi per adattarli al tuo gioco e togli quello che non ti serve.

CLAUDE.md · esempio per un progetto con 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.

Alcune righe ci sono per via di come funzionano gli strumenti. Le regole sui nomi dei file ci sono perché .client.luau in Script Sync non è un LocalScript. La riga su list_roblox_studios c'è perché il server arriva a ogni finestra aperta. La riga sugli asset c'è perché insert_asset inserisce nel place contenuti esterni e upload_image invia immagini al server degli asset di Roblox. La riga su wait segue il riferimento API di Roblox, che indica wait, spawn e delay come deprecati a favore della libreria task.

Se nel tuo progetto c'è già un AGENTS.md per altri agenti di programmazione, Claude Code può leggerlo come istruzioni del progetto, quindi puoi tenere un solo file per entrambi. La pagina di Anthropic sulla memoria spiega quale file vince quando ci sono tutti e due.

Come appaiono queste regole nel codice

Ecco uno script server che segue le regole Luau qui sopra. È scritto a mano per questa guida, non generato da Claude. Usalo come metro di paragone quando controlli quello che ti consegna Claude. Il LocalScript chiede uno strumento con RequestTool:FireServer("Sword"), e il server controlla tutto.

Script in ServerScriptService chiamato 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 sincronizza solo script e cartelle, quindi il server crea da solo il suo remote.
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)
	-- Ignoriamo una richiesta arrivata dopo che il giocatore è uscito.
	if player.Parent ~= Players then
		return
	end

	-- 1. Controlliamo l'argomento: il client può mandare qualsiasi cosa.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Limitiamo quanto spesso un giocatore può chiedere.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Decide il server. Aggiungi qui il tuo controllo di proprietà (gamepass, registro degli acquisti).
	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. Pulizia dei dati del giocatore.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Su disco con Script Sync: ServerScriptService/ToolRequests.server.luau. Metti gli oggetti Tool in un Folder chiamato Tools in ServerStorage. Finché non aggiungi un controllo di proprietà, ogni giocatore può ottenere qualsiasi strumento di quella cartella.

Cerca le stesse cose in ogni gestore di remote scritto da Claude: controlla il tipo e la dimensione di ciò che ha mandato il client, limita quanto spesso un singolo giocatore può chiamarlo, la decisione la prende il server, e i dati del giocatore vengono eliminati quando esce. La guida ai RemoteEvent spiega perché conta ogni punto.

Un modo sicuro di lavorare: punto di ripristino, revisione, playtest

  1. Crea un punto di ripristino da entrambe le parti. Fai il commit dei file in Git e salva una versione del place in Studio con File > Save to Roblox with Notes. La guida a Studio MCP mostra come ripristinarla da Version History.
  2. Chiedi un piano per qualsiasi cosa più grande di un singolo script, e leggilo prima di approvarlo.
  3. Controlla il diff. Per i file leggi git diff o i diff integrati nell'estensione prima di accettare. Per le modifiche fatte in Studio leggi gli script toccati da Claude e controlla nell'Explorer gli oggetti comparsi o spariti.
  4. Testa tu stesso. Claude può avviare un playtest e leggere l'Output, ma controlla solo quello che ha deciso lui di controllare. Gioca la funzione come la giocherebbe un giocatore prima di fare il commit o di pubblicare.
  5. Fai un commit quando tutto funziona, con un messaggio che dice cosa è cambiato.

Cosa può annullare /rewind e cosa no

Claude Code salva un punto di ripristino prima di ogni prompt, e /rewind (o Esc due volte) ripristina i file che Claude ha modificato con i suoi strumenti di modifica dei file. Anthropic elenca cosa non traccia, incluse le modifiche fatte con comandi della shell. Le modifiche fatte in Studio tramite gli strumenti MCP non sono modifiche a file, quindi non aspettarti che /rewind le annulli, e la pagina MCP di Roblox non dice se finiscono nella cronologia di annullamento di Studio. Con Script Sync un file ripristinato da /rewind si sincronizza di nuovo in Studio, come qualsiasi altra modifica su disco. Per tutto il resto la strada per tornare indietro è la versione salvata.

Tieni segreti e dati reali fuori portata

  • Non incollare chiavi API, chiavi Open Cloud, URL di webhook e password nel prompt o in CLAUDE.md. Entrambi sono testo che Claude legge, e CLAUDE.md di solito viene committato nel repository.
  • Non scriverli nemmeno negli script. Roblox ha un archivio di segreti per ogni gioco: crea i segreti nella Creator Dashboard e leggili in uno script server con HttpService:GetSecret(). Per i playtest locali aggiungi segreti locali in File > Experience Settings > Security.
  • Tieni le impostazioni personali in .claude/settings.local.json e CLAUDE.local.md, pensati per restare fuori da Git. Aggiungi tu CLAUDE.local.md al .gitignore.
  • Attiva Enable Studio Access to API Services solo in una copia di test separata del gioco. Roblox avverte che Studio usa gli stessi data store del gioco live, quindi un playtest che Claude avvia lì può sovrascrivere i dati reali dei giocatori.
  • Leggi uno skill di terze parti prima di installarlo. Nei cataloghi di skill ci sono skill per Roblox per Claude Code, e Anthropic nota che uno skill può darsi un accesso ampio agli strumenti tramite il campo allowed-tools.

Quanto costa Claude Code per lavorare su Roblox

Il lato Studio non ha un prezzo documentato: il server MCP fa parte di Studio, e la pagina MCP di Roblox non parla di costi. Il costo è quello di Claude Code, e Anthropic offre due modi di pagare (al 9 ottobre 2026):

  • Abbonamento Claude. Claude Code è incluso in Pro, Max, Team ed Enterprise, ma non in Free. Consuma lo stesso limite di utilizzo di Claude sul web, su desktop e su mobile. I limiti si azzerano su una finestra mobile di cinque ore, e i piani a pagamento hanno in più dei limiti settimanali. Quando ne raggiungi uno, puoi aspettare, passare a un piano superiore o attivare i crediti di utilizzo.
  • Account Claude Console. Paghi l'uso dell'API in base al volume di testo elaborato. La pagina di Anthropic sui costi dice che la spesa dipende molto dalla scelta del modello, dalle dimensioni della codebase e da come lo usi.

I prezzi attuali sono su claude.com/pricing. Questa guida non li ripete, perché cambiano. Dentro Claude Code il comando /usage mostra agli abbonati le barre di utilizzo del piano e agli utenti dell'API il costo stimato della sessione.

Cosa fa consumare di più una sessione su Roblox

  • Dimensione del contesto. Il consumo cresce con quello che Claude ha nel contesto. Usa /clear tra attività non collegate.
  • Risultati grandi degli strumenti. Percorrere l'intero albero del gioco in un place grande o leggere per intero script lunghi restituisce molto testo. Claude Code conta il testo nelle unità con cui lo misura il modello: avvisa quando il risultato di uno strumento MCP supera 10 000 di queste unità, e per impostazione predefinita lo limita a 25 000. Chiedi invece una sola cartella, un limite di profondità o un intervallo di righe: sia search_game_tree sia script_read lo supportano.
  • Scelta del modello. Anthropic scrive che Sonnet se la cava bene con la maggior parte delle attività di programmazione e costa meno di Opus. Cambia modello con /model.

Risolvere i problemi con Claude Code e Studio

La checklist di Roblox è breve: riavviare Studio e il client, verificare che il percorso del comando esista e controllare il JSON. Ecco i casi tipici di Claude Code.

Claude Code non è nell'elenco Quick connect

L'elenco mostra solo i client supportati installati sul tuo computer. Installa Claude Code, poi riavvia Studio. Se l'hai installato con Studio aperto, riavvia Studio, Claude Code o entrambi. Il file .mcp.json del passo 2 funziona senza quick connect.

/mcp non mostra il server di Roblox Studio

Riavvia Claude Code dopo aver aggiunto il server. Poi controlla dove è stato aggiunto: un server aggiunto senza --scope si carica solo nella cartella in cui l'hai aggiunto, quindi avvia claude da quella cartella o aggiungilo di nuovo con --scope user. In VS Code inizia una nuova conversazione, perché le modifiche valgono per le conversazioni iniziate dopo.

Il server mostra Pending approval

Arriva da un file .mcp.json, e Claude Code chiede prima di usare server di questo tipo. Esegui claude in quella cartella, accetta la finestra di fiducia per la cartella di lavoro e approva il server. claude mcp reset-project-choices azzera le scelte precedenti.

Il server mostra Failed to connect

Esegui claude mcp get Roblox_Studio e leggi la riga Issue:. Controlla che il file esista: %LOCALAPPDATA%\Roblox\mcp.bat su Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP su macOS (cambia il percorso se Studio è installato altrove). Verifica che Enable Studio as MCP server sia ancora attivo, poi riavvia Studio e Claude Code.

Il terminale dice che claude non è riconosciuto

Dopo l'installazione apri una nuova finestra del terminale. Se il comando continua a non essere trovato, la cartella di installazione non è nel PATH; la soluzione è sulla pagina di Anthropic sui problemi di installazione. L'estensione per VS Code non aggiunge claude al PATH, quindi per i comandi di questa guida installa a parte la versione per il terminale.

Claude ha modificato il place sbagliato

Con più finestre di Studio aperte ogni chiamata a uno strumento indica la destinazione tramite studio_id. Chiedi a Claude di chiamare list_roblox_studios e indica il place giusto, chiudi le finestre che non usi e ripristina il place modificato da Version History.

Claude Code addebita sulla mia chiave API e non sul piano

Appena l'hai approvata, la variabile d'ambiente ANTHROPIC_API_KEY ha la precedenza sull'abbonamento. Rimuovi la variabile (o disattiva Use custom API key in /config), riavvia Claude Code ed esegui /status per verificare quale accesso è attivo. Se è ancora l'account Console, esegui /login e scegli il tuo account Claude.

La sessione cloud non vede Studio

Le sessioni cloud girano sull'infrastruttura di Anthropic, non sul tuo computer, quindi non arrivano al server locale di Studio. Usa il terminale, l'estensione per l'editor o l'app desktop con Local selezionato.

Oppure usa al suo posto un agente plugin: RoCode

Claude Code con MCP va bene per chi si trova a suo agio nel terminale o in un editor di codice. RoCode (RoCode.app) è un'altra strada: un agente IA indipendente per Roblox Studio con una chat web su rocode.app e un plugin gratuito dal Creator Store che esegue i passi nel place che hai aperto. Non è un prodotto MCP e non usa il server MCP di Studio, quindi non ci sono riga di comando, file di configurazione o server MCP da impostare. Il plugin si collega da solo se Studio ha fatto l'accesso con lo stesso account Roblox che usi su RoCode; altrimenti colleghi chat e plugin una sola volta con un codice di 8 caratteri mostrato nel pannello del plugin.

Cosa sapere prima di passarci. RoCode non può collegare un abbonamento Claude o Claude Code. Usa modelli di terze parti tramite OpenRouter, tra cui Claude Sonnet 5.5 da Pro in su e Claude Opus 5.5 da Studio in su, e il piano gratuito Starter dà 1 credito al giorno su GPT-6 Luna. Lavora dalla modalità di modifica. Con il plugin 3.9 o successivo, in modalità Build, può avviare un breve playtest e leggere gli errori, e con il plugin 3.9.11 o successivo può controllare un personaggio di test per verificare che il gioco funzioni. Con il plugin 3.9.14 o successivo fa anche delle istantanee di quello che ha costruito, in modalità di modifica, e può correggere quello che sembra sbagliato. Non esegue codice direttamente e non genera mesh, mentre gli strumenti di Studio MCP sanno fare entrambe le cose. Può cercare modelli gratuiti nel Creator Store a partire dalle tue parole (gli script all'interno vengono rimossi) o inserire un modello, una decal o una mesh tramite ID dell'asset, e decorazioni, edifici e oggetti di scena li inventa da zero per ogni gioco. La sua modalità Ask risponde a domande sul tuo place con strumenti di sola lettura e non cambia nulla. Gli account sono per chi ha 13 anni o più, e sotto i 18 anni con il permesso di un genitore o tutore.

Tu scrivi

Aggiungi un RemoteEvent così i giocatori possono richiedere uno strumento da ServerStorage.Tools. Controlla tutto sul server.

RoCode fa
  • Può prima esaminare il place con Search Game e List Children per trovare la cartella Tools e gli script che già danno strumenti
  • Scrive lo script server con Create Script e può aggiungere il RemoteEvent con Create Instance
  • Verifica che lo script compili in Studio con Check Script prima di finire. È un controllo di compilazione, non un controllo dei tipi né un playtest
  • Invia le modifiche a blocchi, e ogni blocco è un punto di annullamento nella cronologia di Studio stesso

Con il plugin 3.9 o successivo RoCode può avviare un breve playtest e leggere gli errori, e con il plugin 3.9.15 o successivo il suo personaggio di test sa camminare, premere tasti e cliccare sui pulsanti sullo schermo, ma controlla solo quello che ha deciso lui di controllare, quindi premi Play tu stesso per verificare il risultato da giocatore. Il prompt è un esempio scritto da noi; nei passi ci sono i veri nomi degli strumenti. Come funzionano il plugin e l'abbinamento. RoCode è un prodotto indipendente, non collegato a Roblox Corporation, né approvato o sponsorizzato da essa.

Domande frequenti

Posso usare Claude Desktop invece di Claude Code?

Sì. Claude Desktop è nell'elenco Quick connect del pannello Manage MCP Servers in Studio, quindi si collega con un solo interruttore, su Windows o Mac. Usa gli stessi strumenti di Studio; Claude Code aggiunge quello che un agente nel terminale sa fare bene, come lavorare con i file degli script e con Git. I passi per entrambi sono nella guida alla configurazione di Studio MCP.

Claude Code può collegarsi a Roblox Studio?

Sì. Roblox elenca Claude Code come client quick connect per il server MCP integrato in Studio. Attiva Enable Studio as MCP server in Assistant > … > Manage MCP Servers, attiva Claude Code nell'elenco Quick connect e riavvia Claude Code. Può anche lavorare con i tuoi script come file tramite Script Sync o Rojo.

Claude Code è gratis per lavorare con Roblox Studio?

Il server MCP di Studio non ha un prezzo documentato, ma Claude Code non è incluso nel piano Free di Anthropic (claude.com/pricing, verificato il 9 ottobre 2026). Serve un piano Claude a pagamento, in cui condivide i limiti di utilizzo del tuo piano, o un account Claude Console con pagamento in base all'uso dell'API.

Serve un plugin Roblox o le richieste HTTP per usare Claude Code?

Per il server MCP integrato in Studio no. I passi di configurazione di Roblox sono attivare il server in Assistant e collegare il client; non c'è nessun plugin da installare né impostazione HTTP da cambiare. Alcune guide più vecchie descrivono server MCP della community, che funzionano in modo diverso. Rojo, se lo scegli per i file, usa un proprio plugin per Studio.

Claude Code può testare il mio gioco Roblox?

Tramite gli strumenti di Studio MCP sì. start_stop_play avvia e ferma un playtest, get_console_output legge l'Output, screen_capture cattura la viewport, e gli strumenti di input muovono il personaggio e inviano tasti e clic. Controlla quello che riporta e gioca tu stesso prima di pubblicare.

Cosa scegliere per Roblox Studio: Claude Code o Codex?

Sono entrambi nell'elenco quick connect di Roblox e arrivano agli stessi strumenti di Studio MCP, quindi la differenza sta nel modello, nell'account e nel client intorno. Roblox non pubblica confronti, e noi non li abbiamo messi a confronto con dei test. Prova ciascuno su una copia del tuo place con le stesse regole scritte e tieni quello le cui modifiche richiedono meno correzioni.

Claude Code funziona con Roblox Studio su Mac?

Sì. Claude Code supporta macOS 13.0 o successivo, e Roblox documenta il percorso del server per macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, per i client che configuri a mano.

Fonti e letture

Come è stato controllato il codice: ogni script di questa pagina supera il controllo dei tipi rigoroso di Luau con le definizioni dell'API di Roblox (luau-lsp, 20 novembre 2026). Il controllo dei tipi trova API scritte male e tipi sbagliati, non la logica del gioco, quindi provalo in Studio prima di pubblicare.

Prova RoCode nel tuo gioco.

Crediti gratis ogni giorno, senza carta. Installa il plugin, descrivi la funzione e controlla cosa compare in Studio.