Guía · IA en Roblox Studio

Cómo conectar Claude a Roblox Studio con Claude Code

Claude Code es la herramienta de programación agéntica de Anthropic. Roblox lo incluye como cliente de Quick connect para el servidor MCP integrado en Studio, así que puede leer tu juego, editar scripts y hacer pruebas de juego en la ventana de Studio que tienes abierta. También puede trabajar con tus scripts como archivos mediante Script Sync o Rojo. Esta guía cubre la parte de Claude Code: qué necesitas, cómo conectarlo, los permisos, un CLAUDE.md con reglas de Roblox, una forma segura de trabajar y cuánto cuesta. Para el agente de OpenAI, lee cómo usar OpenAI Codex con Roblox Studio (en inglés); para Cursor, Claude Desktop y otros clientes, lee la guía de configuración de Studio MCP.

Actualizado el 13 de noviembre de 202625 min de lecturaEscrito por

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 /rewind de Claude Code no deshace los cambios hechos en Studio, así que guarda una versión antes.
En esta página
  1. Qué necesitas
  2. 1. Instalar e iniciar sesión
  3. 2. Conectar a Studio
  4. 3. Permisos
  5. 4. Primera petición
  6. 5. Script Sync o Rojo
  7. 6. CLAUDE.md
  8. Flujo seguro
  9. Costos
  10. Problemas
  11. Agente por plugin
  12. Preguntas frecuentes
  13. Fuentes y lecturas

Qué necesitas antes de empezar

Requisitos, según la documentación de Roblox y de Anthropic, 9 de octubre de 2026
NecesitasDetalles
Roblox StudioLa ú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 CodemacOS 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 CodeUn 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.
EdadLos 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.
OpcionalGit, 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.

Las superficies de Claude Code y Roblox Studio
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 CursorSí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 seleccionadoSí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)NoSe 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.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. 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.
  2. 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, pulsa c para copiar el enlace de inicio de sesión.
  3. 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

  1. En el mismo panel (Assistant Settings > MCP Servers), despliega Quick connect. Muestra los clientes compatibles instalados en tu computadora.
  2. Activa Claude Code. Si no aparece, instala Claude Code y reinicia Studio.
  3. Reinicia Claude Code: termina la sesión y ejecuta claude otra 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:

.mcp.json · Windows (la configuración de Roblox)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
.mcp.json · macOS (la configuración de Roblox)
{
  "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.

Terminal · macOS
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 list muestra cada servidor y su estado. claude mcp get Roblox_Studio muestra más, incluida una línea Issue: 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.
.claude/settings.json · ejemplo
{
  "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:

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.

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 y Rojo, según las páginas de Script Sync y de herramientas de terceros de Roblox
Script SyncRojo
Qué esUna 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é sincronizaSolo 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ónHaz 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 CreateFunciona 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 RobloxEncaja 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.

Reglas de Script Sync de la página de Script Sync de Roblox (archivos .luau). Reglas de Rojo de la página Sync Details de Rojo v7, que enumera archivos .lua
El nombre del archivo termina enScript Sync creaRojo crea
.serverScript con contexto de ejecución ServerScript
.clientScript con contexto de ejecución ClientLocalScript
.localLocalScriptSin significado especial (cualquier otro archivo .lua es un ModuleScript)
Sin sufijoModuleScriptModuleScript
Una carpeta con un archivo initUn script con hijos, cuyo tipo lo fija el nombre del archivo initLa carpeta se convierte en el script que describe init.server.lua, init.client.lua o init.lua

Configura Script Sync para Claude Code

  1. Crea una carpeta de proyecto con una carpeta por cada servicio que quieras en disco, por ejemplo ServerScriptService, ReplicatedStorage y StarterPlayerScripts, y ejecuta git init en ella.
  2. 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.
  3. 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.
  4. Ejecuta claude en esa carpeta. Ahora Claude edita archivos .luau, y Studio toma cada cambio.
  5. Haz commit antes de cada sesión, para tener siempre un punto limpio al que volver.
Terminal, en la carpeta de tu proyecto
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.

CLAUDE.md · ejemplo para un proyecto 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.

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.

Script en ServerScriptService llamado 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 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

  1. 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.
  2. Pide un plan para cualquier cosa más grande que un script, y léelo antes de aprobarlo.
  3. Revisa el diff. Para los archivos, lee git diff o 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.
  4. 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.
  5. 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, y CLAUDE.md normalmente 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.json y CLAUDE.local.md, que están pensados para quedarse fuera de Git. Añade CLAUDE.local.md a .gitignore tú.
  • 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 /clear entre 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_tree y script_read admiten 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.

Tú escribes

Añade un RemoteEvent para que los jugadores puedan pedir una herramienta de ServerStorage.Tools. Comprueba todo en el servidor.

RoCode hace
  • 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

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.

Prueba RoCode en tu propio juego.

Créditos gratis cada día, sin tarjeta. Instala el plugin, describe la función y revisa lo que aparece en Studio.