La respuesta corta
Instala Claude Code e inicia sesión con un plan de pago de Claude o una cuenta de Claude Console. En Studio, abre Assistant, haz clic en … > Manage MCP Servers, activa Enable Studio as MCP server y luego enciende Claude Code en Quick connect. Reinicia Claude Code, escribe /mcp para comprobar que el servidor de Studio está conectado, y empieza con una petición que solo lea.
- Claude Code no está en el plan Free de Anthropic. Viene incluido en Pro, Max, Team y Enterprise, o se cobra por unidad de texto procesado a través de una cuenta de Claude Console (comprobado el 9 de octubre de 2026).
- Usa una sesión local: la terminal, la extensión de VS Code o Cursor, o la app de escritorio con Local seleccionado. Las sesiones en la nube se ejecutan fuera de tu computadora y no pueden llegar a Studio.
- Desde la v2.1.283, las sesiones de terminal y de VS Code empiezan en modo auto por defecto donde está disponible, así que añade reglas ask para las herramientas de Studio que cambian tu juego. El
/rewindde Claude Code no deshace los cambios hechos en Studio, así que guarda una versión antes.
En esta página
Qué necesitas antes de empezar
| Necesitas | Detalles |
|---|---|
| Roblox Studio | La última versión, en Windows o macOS. El servidor MCP está integrado en Studio, así que no hay nada más que instalar del lado de Roblox. |
| Una computadora compatible con Claude Code | macOS 13.0 o posterior, o Windows 10 1809 o posterior, con 4 GB de RAM o más, conexión a internet y una ubicación en un país que Anthropic admita. |
| Una cuenta de Claude que incluya Claude Code | Un plan de pago de Claude (Pro, Max, Team o Enterprise) o una cuenta de Claude Console. La página de precios de Anthropic indica que Claude Code no está incluido en el plan Free. |
| Edad | Los Consumer Terms de Anthropic (vigentes desde el 8 de octubre de 2025) dicen que debes tener al menos 18 años, o la edad mínima para dar consentimiento en tu ubicación si es mayor. |
| Opcional | Git, para llevar un historial de tus scripts. Visual Studio Code 1.94.0 o posterior, o Cursor, si quieres Claude Code en un panel del editor en lugar de una terminal. |
Qué Claude Code usar
Claude Code se ejecuta en varios sitios. Anthropic dice que todos comparten el mismo motor, así que tu CLAUDE.md, tus ajustes y tus servidores MCP funcionan en todos. Lo que importa para Studio es dónde se ejecuta la sesión: el servidor MCP de Roblox es un proceso local en tu computadora, así que la sesión también tiene que estar en tu computadora.
| Superficie | ¿Llega a Studio? | Notas |
|---|---|---|
Terminal (el comando claude) | Sí | Ejecútalo en la carpeta de tu proyecto. También lo necesitas para los comandos claude mcp de más abajo. |
| Extensión de VS Code o Cursor | Sí | La vía de la guía de coding harness de Roblox. La extensión trae su propia copia de Claude Code pero no añade claude a tu PATH, así que instala también la versión de terminal si quieres esos comandos. |
| App de escritorio, pestaña Code, con Local seleccionado | Sí | Se ejecuta en tu máquina. Anthropic dice que hace falta una suscripción de pago. |
| Sesiones en la nube (claude.ai/code, o Cloud en la app de escritorio) | No | Se ejecutan en infraestructura en la nube y no en tu máquina, así que no pueden iniciar el servidor local de Studio. |
Paso 1: instala Claude Code e inicia sesión
La instalación que recomienda Anthropic es un solo comando en una terminal. Estos son los comandos que daba su página de configuración el 9 de octubre de 2026; consulta la página de configuración de Anthropic (en inglés) para ver los actuales.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Abre una ventana de terminal nueva y ejecuta
claude --version. Si aparece un número de versión, funcionó. Si no se encuentra el comando, la carpeta de instalación todavía no está en tu PATH, y la página de solución de problemas de instalación de Anthropic tiene el arreglo. - Ve a la carpeta de tu proyecto y ejecuta
claude. La primera vez abre una ventana del navegador para iniciar sesión. Si el navegador no se abre, pulsacpara copiar el enlace de inicio de sesión. - Inicia sesión con tu cuenta de Claude. Un inicio de sesión de Pro o Max usa el uso incluido en tu plan.
En Windows, Anthropic recomienda instalar Git for Windows para que Claude Code pueda usar su herramienta Bash; sin él, Claude Code ejecuta los comandos en PowerShell. Para esta configuración, instala Claude Code en Windows mismo y no dentro de WSL: la configuración de Roblox para Windows ejecuta cmd.exe con una ruta de %LOCALAPPDATA%, y Roblox no documenta WSL.
¿Prefieres un panel en el editor? En VS Code o Cursor, abre Extensions (Ctrl+Shift+X, o Cmd+Shift+X en Mac), busca Claude Code, instálala e inicia sesión desde el panel de Claude. Esta es la configuración que usa la guía de coding harness de Roblox.
Paso 2: conecta Claude Code a Studio
Primero activa el servidor. En Studio, abre Assistant, haz clic en … > Manage MCP Servers y activa Enable Studio as MCP server. La guía de Studio MCP cubre este paso con más detalle. ¿No ves el botón de Assistant? Consulta cómo abrir el panel de Assistant.
Quick connect
- En el mismo panel (Assistant Settings > MCP Servers), despliega Quick connect. Muestra los clientes compatibles instalados en tu computadora.
- Activa Claude Code. Si no aparece, instala Claude Code y reinicia Studio.
- Reinicia Claude Code: termina la sesión y ejecuta
claudeotra vez, o empieza una conversación nueva en la extensión. Roblox dice que un cliente necesita reiniciarse para tomar una configuración nueva.
Roblox no dice en qué archivo de Claude Code escribe Quick connect ni qué nombre le pone al servidor. Escribe /mcp en Claude Code para ver el nombre. Lo necesitas para las reglas de permisos del paso 3.
¿Usas la extensión de Claude Code en VS Code o Cursor? Activa Claude Code aquí también. La guía de coding harness de Roblox enciende Cursor o Visual Studio Code, pero Anthropic documenta que la extensión comparte su configuración MCP con la versión de terminal de Claude Code, y no dice que lea los ajustes MCP del propio editor.
Configuración manual con un archivo .mcp.json
Si Quick connect no te funciona, añade Studio tú. Claude Code lee los servidores MCP del proyecto de un archivo llamado .mcp.json en la carpeta de tu proyecto, en el mismo formato mcpServers que documenta Roblox, y trata una entrada sin type como un servidor stdio local. Así que la configuración de Roblox funciona tal cual. Guarda la de tu sistema como .mcp.json en la carpeta donde ejecutas claude:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
La próxima vez que ejecutes claude en esa carpeta, te pide aprobar el servidor: Anthropic muestra este aviso para cada servidor que viene de un archivo .mcp.json. Anthropic diseñó el archivo para subirlo al repositorio y que un equipo lo comparta, pero las rutas de Windows y de macOS son distintas. Si tu equipo usa los dos, deja el archivo fuera del repositorio y que cada persona añada Studio por su cuenta.
En macOS puedes añadir Studio con un solo comando. --scope user lo deja disponible en todos los proyectos de tu computadora; si lo omites, el servidor se carga solo en la carpeta actual. El -- separa las opciones propias de Claude Code del comando que inicia el servidor.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
En Windows, el archivo JSON es la vía más simple, porque PowerShell y CMD tratan %LOCALAPPDATA% de forma distinta en una línea de comandos.
Comprueba la conexión
- En una terminal,
claude mcp listmuestra cada servidor y su estado.claude mcp get Roblox_Studiomuestra más, incluida una líneaIssue:si el servidor no pudo conectarse. - Dentro de Claude Code, escribe
/mcp. Los servidores conectados muestran un número de herramientas junto a su nombre. - En Studio, Assistant > … > Manage MCP Servers muestra un indicador verde con el número de clientes conectados.
Paso 3: decide qué puede hacer Claude sin preguntar
Configura esto antes de que Claude toque tu juego. Según la página de modos de permisos de Anthropic, desde Claude Code v2.1.283 las sesiones interactivas de terminal y de VS Code empiezan en modo auto por defecto siempre que está disponible, y en modo auto un clasificador en segundo plano revisa las acciones en tu lugar. Una llamada MCP que edita un script o ejecuta Luau en Studio puede entonces seguir adelante sin preguntar.
Tienes dos formas de mantener cada cambio en tus manos:
- Empieza en modo Manual. Ejecuta
claude --permission-mode default. En modo Manual solo las lecturas se ejecutan sin preguntar. Pulsa Shift+Tab durante una sesión para pasar de un modo a otro. - Añade reglas ask para las herramientas de Studio que cambian cosas. Anthropic dice que ningún modo aprueba automáticamente una herramienta que coincide con una regla ask explícita, ni siquiera el modo 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"
]
}
}
Las reglas MCP tienen la forma mcp__<server>__<tool>, con el nombre del servidor tal como lo tiene Claude Code. Cambia Roblox_Studio por el nombre que muestra /mcp. Las reglas allow del .claude/settings.json de un proyecto solo se aplican después de que aceptas el diálogo de confianza del espacio de trabajo para esa carpeta. Para reglas que son solo para ti, usa .claude/settings.local.json.
La lista allow cubre las herramientas que solo leen: el árbol del juego, las propiedades, los scripts, el Output y la lista de ventanas de Studio abiertas. La lista ask cubre las herramientas que cambian tu juego, ejecutan código, inician pruebas de juego, traen assets externos o envían imágenes a Roblox. Las herramientas que no están en ninguna de las dos listas, como screen_capture y las herramientas de entradas, siguen tu modo de permisos. La lista completa de herramientas, con lo que hace cada una, está en la guía de Studio MCP.
Paso 4: empieza con una petición que solo lea
Abre el juego en el que quieres trabajar y cierra los que no. Luego dale a Claude una primera petición que no pueda cambiar nada:
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.
En un Baseplate nuevo, la guía de coding harness de Roblox espera que la respuesta incluya los objetos por defecto Camera, Terrain, Baseplate y SpawnLocation. Pedir primero list_roblox_studios es una buena costumbre: un cliente puede llegar a todas las ventanas de Studio que tengas abiertas, y cada llamada a una herramienta indica su ventana de destino con un studio_id.
Para cualquier cosa más grande que un script, pide primero un plan. En modo plan (pulsa Shift+Tab, o empieza un prompt con /plan) Claude investiga y propone sin editar tus archivos. Anthropic describe el modo plan en términos de ediciones de archivos y comandos de shell, así que conserva también tus reglas ask para las herramientas de Studio.
Paso 5: trabaja con los scripts como archivos con Script Sync o Rojo
Claude Code está pensado para trabajar con archivos en una carpeta. Los edita con sus propias herramientas, Git guarda su historial y /rewind puede restaurarlos. Tener tus scripts en disco te deja usar todo eso, y deja las herramientas MCP para las partes de un juego que no son scripts, como las GUI de StarterGui, los RemoteEvents y las partes. Roblox documenta dos formas de hacerlo.
| Script Sync | Rojo | |
|---|---|---|
| Qué es | Una función de Studio que sincroniza los scripts de tu juego con archivos en disco, en los dos sentidos. | Una herramienta de terceros: un servidor en tu computadora más un plugin de Studio. |
| Qué sincroniza | Solo instancias Script, LocalScript, ModuleScript y Folder. Las demás instancias de una carpeta sincronizada se ignoran. | Puede manejar todo el proyecto como archivos, con tu sistema de archivos como fuente de verdad. |
| Configuración | Haz clic derecho en un servicio o una carpeta en el Explorer, elige Sync to… y escoge una carpeta. La guía de coding harness de Roblox primero lo activa en File > Beta Features. | Instálalo con Rokit (rokit add rojo-rbx/rojo, y luego rokit install), añade el plugin con rojo plugin install, ejecuta rojo serve y conéctate desde el plugin. |
| Team Create | Funciona con él. Evita que dos personas editen el mismo script sincronizado al mismo tiempo. | Roblox señala que las herramientas de terceros muchas veces no funcionan con sus herramientas de colaboración integradas. |
| El consejo de Roblox | Encaja bien si quieres tu propio editor y control de versiones para el código, y Studio para todo lo demás. | Una mejor opción si quieres todo tu proyecto, no solo el código, en control de versiones. |
El mismo nombre de archivo puede significar cosas distintas
Las dos herramientas eligen el tipo de script por el nombre del archivo, y los sufijos no coinciden. Un archivo .client es un LocalScript en Rojo, pero un Script con contexto de ejecución Client en Script Sync. Dile a Claude qué herramienta usa tu proyecto; el ejemplo de CLAUDE.md de más abajo lo hace.
| El nombre del archivo termina en | Script Sync crea | Rojo crea |
|---|---|---|
.server | Script con contexto de ejecución Server | Script |
.client | Script con contexto de ejecución Client | LocalScript |
.local | LocalScript | Sin significado especial (cualquier otro archivo .lua es un ModuleScript) |
| Sin sufijo | ModuleScript | ModuleScript |
Una carpeta con un archivo init | Un script con hijos, cuyo tipo lo fija el nombre del archivo init | La carpeta se convierte en el script que describe init.server.lua, init.client.lua o init.lua |
Configura Script Sync para Claude Code
- Crea una carpeta de proyecto con una carpeta por cada servicio que quieras en disco, por ejemplo
ServerScriptService,ReplicatedStorageyStarterPlayerScripts, y ejecutagit initen ella. - Si Script Sync no aparece al hacer clic derecho en un servicio, actívalo en File > Beta Features, haz clic en Save y reinicia Studio.
- En el Explorer, haz clic derecho en ServerScriptService, elige Script Sync > Sync to y escoge la carpeta principal del proyecto, no una carpeta dentro de ella. Repite con los demás servicios.
- Ejecuta
claudeen esa carpeta. Ahora Claude edita archivos.luau, y Studio toma cada cambio. - Haz commit antes de cada sesión, para tener siempre un punto limpio al que volver.
git add .
git commit -m "Before Claude session"
Dos reglas de Script Sync importan más con un agente. No sincronices scripts que tengan atributos o tags: Script Sync los ignora, y Roblox advierte que esto puede causar pérdida de datos. Y si los archivos cambian mientras Studio está cerrado, Studio pregunta cómo resolverlo cuando vuelves a abrir el juego, y enumera lo que Keep Studio y Keep Disk añadirían, cambiarían o borrarían. Lee esa lista antes de elegir.
Con Script Sync activado, una edición de archivo llega a Studio en cuanto se guarda. Aceptar una edición en Claude Code es aceptarla en tu juego, así que revisa antes de aceptar, sobre todo en los modos que aceptan ediciones automáticamente.
Para el autocompletado y los errores de tipos en tu editor, Roblox recomienda la extensión Luau Language Server con su plugin de Studio complementario. En VS Code, la extensión de Claude Code puede leer el panel Problems con una herramienta integrada, así que Claude ve las mismas advertencias que tú.
Paso 6: dale a Claude tus reglas de Roblox en CLAUDE.md
Cada sesión de Claude Code empieza con un contexto nuevo. Un archivo CLAUDE.md en la carpeta de tu proyecto se lee al inicio de cada sesión, así que ahí van tus convenciones. Ejecuta /init para que Claude redacte uno, o escríbelo tú. El consejo de Anthropic es mantenerlo por debajo de 200 líneas, escribir reglas lo bastante específicas como para comprobarlas, y ejecutar /context para confirmar que se cargó.
Este ejemplo se escribió para esta guía, para un proyecto que usa Script Sync. Cambia los nombres para que coincidan con tu juego y quita lo que no necesites.
# 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.
Algunas líneas están ahí por cómo funcionan las herramientas. Las reglas de nombres de archivo existen porque .client.luau no es un LocalScript en Script Sync. La línea de list_roblox_studios existe porque el servidor puede llegar a todas las ventanas abiertas. La línea de los assets existe porque insert_asset trae contenido externo a tu juego y upload_image envía imágenes al servidor de assets de Roblox. La línea de wait sigue la referencia de la API de Roblox, que marca wait, spawn y delay como obsoletos en favor de la biblioteca task.
Si tu proyecto ya tiene un AGENTS.md para otros agentes de programación, Claude Code puede leerlo como sus instrucciones de proyecto, así que puedes mantener un solo archivo para los dos. La página de memoria de Anthropic explica qué archivo gana cuando existen los dos.
Cómo se ven esas reglas en el código
Este es un script del servidor que sigue las reglas de Luau de arriba. Se escribió a mano para esta guía, no lo generó Claude. Úsalo como vara de medir cuando revises lo que Claude te entregue. Un LocalScript pide una herramienta con RequestTool:FireServer("Sword"), y el servidor lo comprueba todo.
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 solo sincroniza scripts y carpetas, así que el servidor crea su propio 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)
-- Ignora una petición que llega después de que el jugador se fue.
if player.Parent ~= Players then
return
end
-- 1. Comprueba el argumento: un cliente puede enviar cualquier cosa.
if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
return
end
-- 2. Limita la frecuencia con la que un jugador puede pedir.
local now = os.clock()
local last = lastRequest[player]
if last ~= nil and now - last < COOLDOWN_SECONDS then
return
end
lastRequest[player] = now
-- 3. El servidor decide. Añade aquí tu propia comprobación de propiedad (un game pass, un registro de compra).
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. Limpieza por jugador.
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
En disco con Script Sync: ServerScriptService/ToolRequests.server.luau. Pon tus objetos Tool en un Folder llamado Tools en ServerStorage. Hasta que añadas una comprobación de propiedad, cualquier jugador puede obtener cualquier herramienta de esa carpeta.
Busca lo mismo en cualquier manejador de remotes que escriba Claude: comprueba el tipo y el tamaño de lo que envió el cliente, limita la frecuencia con la que un jugador puede llamarlo, el servidor toma la decisión, y quita la entrada del jugador cuando se va. La guía de RemoteEvents explica por qué importa cada una.
Una forma segura de trabajar: punto de control, revisión, prueba
- Crea un punto de control en los dos lados. Haz commit de tus archivos en Git, y guarda una versión del juego en Studio con File > Save to Roblox with Notes. La guía de Studio MCP muestra cómo restaurar una desde Version History.
- Pide un plan para cualquier cosa más grande que un script, y léelo antes de aprobarlo.
- Revisa el diff. Para los archivos, lee
git diffo los diffs en línea de la extensión antes de aceptar. Para los cambios hechos en Studio, lee los scripts que tocó Claude y revisa el Explorer en busca de objetos que aparecieron o desaparecieron. - Pruébalo tú. Claude puede iniciar una prueba de juego y leer el Output, pero solo comprueba lo que decidió comprobar. Juega la función como lo haría un jugador antes de hacer commit o publicar.
- Haz commit cuando funcione, con un mensaje que diga qué cambió.
Qué puede deshacer /rewind y qué no
Claude Code guarda un punto de control antes de cada prompt, y /rewind (o Esc dos veces) restaura los archivos que Claude cambió con sus herramientas de edición de archivos. Anthropic enumera lo que no registra, incluidos los cambios hechos por comandos de shell. Los cambios hechos en Studio con las herramientas MCP no son ediciones de archivos, así que no esperes que /rewind los deshaga, y la página de MCP de Roblox no dice si entran en el historial de deshacer de Studio. Con Script Sync, un archivo que /rewind restaura se sincroniza de vuelta a Studio como cualquier otro cambio en disco. Para todo lo demás, tu versión guardada es el camino de vuelta.
Mantén los secretos y los datos en vivo fuera de su alcance
- No pegues claves de API, claves de Open Cloud, URLs de webhooks ni contraseñas en un prompt ni en
CLAUDE.md. Los dos son texto que Claude lee, yCLAUDE.mdnormalmente se sube a tu repositorio. - Tampoco los escribas fijos en los scripts. Roblox tiene un almacén de secretos para cada juego: crea los secretos en el Creator Dashboard y léelos en un script del servidor con
HttpService:GetSecret(). Para las pruebas locales, añade secretos locales en File > Experience Settings > Security. - Guarda tus ajustes personales en
.claude/settings.local.jsonyCLAUDE.local.md, que están pensados para quedarse fuera de Git. AñadeCLAUDE.local.mda.gitignoretú. - Activa Enable Studio Access to API Services solo en una copia de prueba aparte de tu juego. Roblox advierte que Studio usa los mismos data stores que el juego en vivo, así que una prueba de juego que Claude inicie ahí podría sobrescribir datos reales de jugadores.
- Lee una skill de terceros antes de instalarla. Los directorios de skills incluyen skills de Roblox para Claude Code, y Anthropic señala que una skill puede darse a sí misma un acceso amplio a herramientas con su campo
allowed-tools.
Cuánto cuesta Claude Code para trabajar en Roblox
El lado de Studio no tiene precio documentado: el servidor MCP es parte de Studio, y la página de MCP de Roblox no menciona ningún cobro. El costo es el de Claude Code, y Anthropic ofrece dos formas de pagar (al 9 de octubre de 2026):
- Una suscripción de Claude. Claude Code viene incluido en Pro, Max, Team y Enterprise, no en Free. Gasta del mismo uso que Claude en la web, el escritorio y el móvil. Los límites se reinician en una ventana móvil de cinco horas, y los planes de pago tienen además límites semanales. Cuando llegas a uno, puedes esperar, pasar a un plan superior o activar créditos de uso.
- Una cuenta de Claude Console. Pagas el uso de la API por unidad de texto procesado. La página de costos de Anthropic dice que el gasto varía mucho según el modelo que elijas, el tamaño del código y cómo lo uses.
Los precios actuales están en claude.com/pricing. Esta guía no los repite porque cambian. Dentro de Claude Code, /usage muestra barras de uso del plan a los suscriptores y un costo estimado de la sesión a quienes usan la API.
Qué hace que una sesión de Roblox gaste más
- El tamaño del contexto. El consumo de unidades de texto procesado crece con lo que Claude tiene en contexto. Usa
/clearentre tareas que no tengan relación. - Resultados de herramientas grandes. Recorrer todo el árbol de un juego grande o leer scripts largos completos devuelve mucho texto. Claude Code avisa cuando el resultado de una herramienta MCP pasa de 10,000 unidades de texto procesado y lo limita a 25,000 por defecto. Pide una sola carpeta, un límite de profundidad o un rango de líneas:
search_game_treeyscript_readadmiten eso. - El modelo que elijas. Anthropic dice que Sonnet resuelve bien la mayoría de las tareas de programación y cuesta menos que Opus. Cambia con
/model.
Solución de problemas de Claude Code y Studio
La lista de comprobación de Roblox es corta: reinicia Studio y el cliente, comprueba que la ruta del comando existe y revisa el JSON. Estos son los casos propios de Claude Code.
Claude Code no está en la lista de Quick connect
La lista solo muestra los clientes compatibles instalados en tu computadora. Instala Claude Code y luego reinicia Studio. Si lo instalaste con Studio abierto, reinicia Studio, Claude Code o los dos. El archivo .mcp.json del paso 2 funciona sin Quick connect.
/mcp no muestra el servidor de Roblox Studio
Reinicia Claude Code después de añadir el servidor. Luego comprueba dónde se añadió: un servidor añadido sin --scope se carga solo en la carpeta donde lo añadiste, así que inicia claude desde esa carpeta o añádelo otra vez con --scope user. En VS Code, empieza una conversación nueva, porque los cambios se aplican a las conversaciones que empiezan después.
El servidor dice Pending approval
Viene de un archivo .mcp.json, y Claude Code pregunta antes de usarlos. Ejecuta claude en esa carpeta, acepta el diálogo de confianza del espacio de trabajo y aprueba el servidor. claude mcp reset-project-choices borra las decisiones anteriores.
El servidor muestra Failed to connect
Ejecuta claude mcp get Roblox_Studio y lee la línea Issue:. Comprueba que el archivo existe: %LOCALAPPDATA%\Roblox\mcp.bat en Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP en macOS (cambia la ruta si Studio está instalado en otro sitio). Asegúrate de que Enable Studio as MCP server sigue activado, y luego reinicia Studio y Claude Code.
La terminal dice que no reconoce claude
Abre una ventana de terminal nueva después de instalar. Si sigue sin encontrarse, la carpeta de instalación no está en tu PATH; la página de solución de problemas de instalación de Anthropic tiene el arreglo. La extensión de VS Code no añade claude a tu PATH, así que instala la versión de terminal aparte para los comandos de esta guía.
Claude cambió el juego equivocado
Con varias ventanas de Studio abiertas, cada llamada a una herramienta indica su destino con un studio_id. Pídele a Claude que llame a list_roblox_studios y nombra el juego que quieres, cierra las ventanas que no estés usando, y restaura el juego que cambió desde Version History.
Claude Code está cobrando a mi clave de API en lugar de a mi plan
Una vez que la apruebas, una variable de entorno ANTHROPIC_API_KEY toma el lugar de tu suscripción. Quita la variable (o desactiva Use custom API key en /config), inicia Claude Code otra vez y ejecuta /status para comprobar qué inicio de sesión está activo. Si sigue siendo una cuenta de Console, ejecuta /login y elige tu cuenta de Claude.
Una sesión en la nube no ve Studio
Las sesiones en la nube se ejecutan en la infraestructura de Anthropic, no en tu computadora, así que no pueden llegar al servidor local de Studio. Usa la terminal, la extensión del editor o la app de escritorio con Local seleccionado.
O usa un agente por plugin: RoCode
Claude Code con MCP va bien para quienes se sienten cómodos en una terminal o un editor de código. RoCode (RoCode.app) es otra vía: un agente de IA independiente para Roblox Studio, con un chat web en rocode.app y un plugin gratis de la Creator Store que ejecuta los pasos en el juego que tienes abierto. No es un producto MCP y no usa el servidor MCP de Studio, así que no hay línea de comandos, archivo de configuración ni servidor MCP que configurar. El plugin se conecta solo cuando Studio tiene la sesión iniciada con la misma cuenta de Roblox que usas en RoCode; si no, emparejas el chat y el plugin una vez con el código de 8 caracteres que muestra el panel del plugin.
Qué conviene saber antes de cambiar. RoCode no puede conectar una suscripción de Claude o de Claude Code. Ejecuta modelos de terceros a través de OpenRouter, entre ellos Claude Sonnet 5.5 desde Pro y Claude Opus 5.5 desde Studio, y el plan gratis Starter da 1 crédito al día en GPT-6 Luna. Trabaja desde el modo edición. Con el plugin 3.9 o posterior, en modo Build, puede hacer una prueba corta y leer los errores, y con el plugin 3.9.11 o posterior controlar un personaje de prueba para comprobar que el juego funciona. Con el plugin 3.9.14 o posterior también toma capturas de lo que construyó, en modo edición, y puede corregir lo que se vea mal. No ejecuta código directamente ni genera meshes, dos cosas que sí pueden hacer las herramientas MCP de Studio. Puede buscar en la Creator Store con tus palabras modelos gratuitos (les quita los scripts que tengan dentro) o insertar un modelo, decal o mesh por su ID de asset, y diseña decorado, edificios y props nuevos para cada juego. Su modo Ask responde preguntas sobre tu juego con herramientas de solo lectura y no cambia nada. Las cuentas son para mayores de 13 años, con el permiso de tu madre, padre o tutor si tienes menos de 18.
Añade un RemoteEvent para que los jugadores puedan pedir una herramienta de ServerStorage.Tools. Comprueba todo en el servidor.
- Puede revisar primero el juego con Search Game y List Children, para encontrar la carpeta Tools y cualquier script que ya entregue herramientas
- Escribe el script del servidor con Create Script, y puede añadir el RemoteEvent con Create Instance
- Comprueba dentro de Studio con Check Script que el script compila antes de terminar. Es una comprobación de compilación, no de tipos ni una prueba de juego
- Envía sus cambios por grupos, y cada grupo es un punto para deshacer en el historial de Studio
Con el plugin 3.9 o posterior, RoCode puede hacer una prueba corta y leer los errores, y con el plugin 3.9.15 o posterior su personaje de prueba puede caminar, pulsar teclas y hacer clic en botones en pantalla, pero solo comprueba lo que decidió probar, así que pulsa Play tú para probar el resultado como jugador. El prompt es un ejemplo escrito por nosotros; los pasos usan los nombres reales de las herramientas. Cómo funcionan el plugin y el emparejamiento. RoCode es un producto independiente, no afiliado a Roblox Corporation ni respaldado o patrocinado por ella.
Preguntas frecuentes
¿Puedo usar Claude Desktop en lugar de Claude Code?
Sí. Claude Desktop está en la lista de Quick connect del panel Manage MCP Servers de Studio, así que se conecta con un interruptor, en Windows o Mac. Usa las mismas herramientas de Studio; Claude Code añade cosas que un agente de terminal hace bien, como trabajar con archivos de scripts y con Git. Los pasos para los dos están en la guía de configuración de Studio MCP.
¿Claude Code puede conectarse a Roblox Studio?
Sí. Roblox incluye Claude Code como cliente de Quick connect para el servidor MCP integrado en Studio. Activa Enable Studio as MCP server en Assistant > … > Manage MCP Servers, enciende Claude Code en Quick connect y reinicia Claude Code. También puede trabajar con tus scripts como archivos mediante Script Sync o Rojo.
¿Claude Code es gratis para usarlo con Roblox Studio?
El servidor MCP de Studio no tiene precio documentado, pero Claude Code no forma parte del plan Free de Anthropic (claude.com/pricing, comprobado el 9 de octubre de 2026). Necesitas un plan de pago de Claude, donde comparte los límites de uso de tu plan, o una cuenta de Claude Console a la que se cobra el uso de la API.
¿Necesito un plugin de Roblox o peticiones HTTP para usar Claude Code?
Para el servidor MCP integrado de Studio, no. Los pasos de configuración de Roblox son activar el servidor en Assistant y conectar el cliente; no incluyen ningún plugin que instalar ni ningún ajuste de HTTP que cambiar. Algunas guías más antiguas describen servidores MCP de la comunidad que funcionan de otra forma. Rojo, si lo eliges para los archivos, sí usa su propio plugin de Studio.
¿Claude Code puede probar mi juego de Roblox?
A través de las herramientas MCP de Studio, sí. start_stop_play inicia y detiene una prueba de juego, get_console_output lee el Output, screen_capture captura el viewport, y las herramientas de entradas mueven el personaje y envían teclas y clics. Revisa lo que reporta, y juega el juego tú antes de publicar.
¿Uso Claude Code o Codex con Roblox Studio?
Los dos están en la lista de Quick connect de Roblox y llegan a las mismas herramientas MCP de Studio, así que la diferencia es el modelo, la cuenta y el cliente que lo rodea. Roblox no publica ninguna comparación y nosotros no los hemos medido uno contra otro. Prueba cada uno en una copia de tu juego con las mismas reglas escritas, y quédate con el que haga cambios que necesiten menos arreglos.
¿Claude Code funciona con Roblox Studio en una Mac?
Sí. Claude Code es compatible con macOS 13.0 o posterior, y Roblox documenta una ruta del servidor para macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, para los clientes que configuras a mano.
Fuentes y lecturas
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (en inglés). activar el servidor, Quick connect, configuración JSON y CLI, las herramientas, varias ventanas de Studio y solución de problemas
- Roblox Creator Docs: Build with a coding harness (en inglés). Claude Code en VS Code, Script Sync, MCP y Git juntos
- Roblox Creator Docs: Script Sync (en inglés). qué se sincroniza, las reglas de nombres de archivo, los conflictos y el language server
- Roblox Creator Docs: Third-party tools (en inglés). Rojo con Rokit y control de versiones
- Roblox Creator Docs: Secrets stores (en inglés). mantener las claves de API fuera de los scripts
- Roblox Creator Docs: Data stores (en inglés). por qué el acceso de Studio a API Services va en una copia de prueba
- Rojo documentation (v7) (en inglés). la instalación y cómo los nombres de archivo se convierten en instancias
- Claude Code Docs: Overview (en inglés). las superficies comparten un mismo motor, y la app de escritorio necesita una suscripción de pago
- Claude Code Docs: Advanced setup (en inglés). los requisitos del sistema y los comandos de instalación
- Claude Code Docs: Authentication (en inglés). el inicio de sesión y los tipos de cuenta que sirven
- Claude Code Docs: Connect Claude Code to tools via MCP (en inglés). servidores stdio, .mcp.json, los scopes y el estado del servidor
- Claude Code Docs: Configure permissions (en inglés). las reglas allow, ask y deny, incluidas las herramientas MCP
- Claude Code Docs: Choose a permission mode (en inglés). el modo auto como modo inicial, el modo Manual y el modo plan
- Claude Code Docs: How Claude remembers your project (en inglés). CLAUDE.md, /init y AGENTS.md
- Claude Code Docs: Checkpointing (en inglés). qué restaura /rewind y qué no registra
- Claude Code Docs: Manage costs effectively (en inglés). /usage, el tamaño del contexto y la elección de modelo
- Claude Code Docs: Use Claude Code in the cloud (en inglés). por qué las sesiones en la nube no se ejecutan en tu máquina
- Claude Code Docs: Use Claude Code in VS Code (en inglés). los requisitos, la nota sobre el PATH, la configuración MCP compartida y el panel Problems
- Claude Code Docs: Extend Claude with skills (en inglés). qué concede el campo allowed-tools de una skill
- Claude pricing (en inglés). qué planes incluyen Claude Code, y los límites de uso
- Claude Help Center: Use Claude Code with your Pro or Max plan (en inglés). los límites compartidos y la advertencia sobre ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (en inglés). la edad mínima
Cómo se comprobó el código: cada script de esta página pasa el verificador de tipos estricto de Luau con las definiciones de la API de Roblox (luau-lsp, 13 de noviembre de 2026). Una verificación de tipos detecta APIs mal escritas y tipos incorrectos, no la lógica del juego, así que pruébalo en Studio antes de publicar.