Guia · IA no Roblox Studio

Como conectar o Claude ao Roblox Studio com o Claude Code

O Claude Code é a ferramenta de programação com agente da Anthropic. A Roblox lista ele como cliente de Quick connect do servidor MCP integrado ao Studio, então ele pode ler o seu place, editar scripts e rodar testes na janela do Studio que você tem aberta. Ele também pode trabalhar nos seus scripts como arquivos, pelo Script Sync ou pelo Rojo. Este guia cobre o lado do Claude Code: do que você precisa, como conectar, permissões, um CLAUDE.md com regras de Roblox, um jeito seguro de trabalhar e quanto custa. Para o agente da OpenAI, veja como usar o OpenAI Codex com o Roblox Studio (em inglês); para Cursor, Claude Desktop e outros clientes, veja o guia de configuração do MCP do Studio.

Atualizado em 13 de novembro de 202625 min de leituraEscrito por

Resumo

Instale o Claude Code e entre com um plano pago do Claude ou uma conta do Claude Console. No Studio, abra o Assistant, clique em … > Manage MCP Servers, ative Enable Studio as MCP server e depois ligue o Claude Code em Quick connect. Reinicie o Claude Code, digite /mcp para conferir se o servidor do Studio está conectado e comece com um pedido que só lê.

  • O Claude Code não está no plano Free da Anthropic. Ele vem incluído nos planos Pro, Max, Team e Enterprise, ou é cobrado pelo volume de texto processado por meio de uma conta do Claude Console (conferido em 9 de outubro de 2026).
  • Use uma sessão local: o terminal, a extensão do VS Code ou do Cursor, ou o app de computador com Local selecionado. Sessões na nuvem rodam fora do seu computador e não alcançam o Studio.
  • Desde a v2.1.283, as sessões do terminal e do VS Code começam no modo auto por padrão onde ele está disponível, então adicione regras ask para as ferramentas do Studio que mudam o seu place. O /rewind do Claude Code não desfaz mudanças feitas no Studio, então salve uma versão antes.
Nesta página
  1. Do que você precisa
  2. 1. Instalar e entrar
  3. 2. Conectar ao Studio
  4. 3. Permissões
  5. 4. Primeiro pedido
  6. 5. Script Sync ou Rojo
  7. 6. CLAUDE.md
  8. Fluxo seguro
  9. Custos
  10. Solução de problemas
  11. Opção de agente em plugin
  12. Perguntas frequentes
  13. Fontes e leitura extra

Do que você precisa antes de começar

Requisitos, da documentação da Roblox e da Anthropic, 9 de outubro de 2026
Você precisa deDetalhes
Roblox StudioA versão mais recente, no Windows ou no macOS. O servidor MCP vem integrado ao Studio, então não há mais nada para instalar do lado da Roblox.
Um computador que o Claude Code suportamacOS 13.0 ou mais recente, ou Windows 10 1809 ou mais recente, com 4 GB de RAM ou mais, conexão com a internet e localização em um país que a Anthropic atende.
Uma conta do Claude que inclui o Claude CodeUm plano pago do Claude (Pro, Max, Team ou Enterprise) ou uma conta do Claude Console. A página de preços da Anthropic lista o Claude Code como não incluído no plano Free.
IdadeOs Consumer Terms da Anthropic (em vigor desde 8 de outubro de 2025) dizem que você precisa ter pelo menos 18 anos, ou a idade mínima para consentir onde você mora, se ela for maior.
OpcionalGit, para manter um histórico dos seus scripts. Visual Studio Code 1.94.0 ou mais recente, ou Cursor, se você quer o Claude Code em um painel do editor em vez de um terminal.

Qual Claude Code usar

O Claude Code roda em vários lugares. A Anthropic diz que todos compartilham o mesmo motor, então o seu CLAUDE.md, as configurações e os servidores MCP funcionam em todos eles. O que importa para o Studio é onde a sessão roda: o servidor MCP da Roblox é um processo local no seu computador, então a sessão também precisa estar no seu computador.

Onde o Claude Code roda e o Roblox Studio
Onde rodaAlcança o Studio?Observações
Terminal (o comando claude)SimRode na pasta do seu projeto. Você também precisa dele para os comandos claude mcp abaixo.
Extensão do VS Code ou do CursorSimO caminho do guia de coding harness da Roblox. A extensão traz a própria cópia do Claude Code, mas não adiciona o claude ao seu PATH, então instale também a versão de terminal se quiser esses comandos.
App de computador, aba Code, com Local selecionadoSimRoda na sua máquina. A Anthropic diz que é necessária uma assinatura paga.
Sessões na nuvem (claude.ai/code, ou Cloud no app de computador)NãoElas rodam em infraestrutura de nuvem e não na sua máquina, então não conseguem iniciar o servidor local do Studio.

Passo 1: Instale o Claude Code e entre na conta

A instalação que a Anthropic recomenda é um comando só, em um terminal. Estes são os comandos que a página de instalação dela mostrava em 9 de outubro de 2026; confira a página de instalação da Anthropic (em inglês) para ver os atuais.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Abra uma janela nova do terminal e rode claude --version. Um número de versão quer dizer que deu certo. Se o comando não for encontrado, a pasta de instalação ainda não está no seu PATH, e a página de solução de problemas de instalação da Anthropic traz a correção.
  2. Vá até a pasta do seu projeto e rode claude. Na primeira vez ele abre uma janela do navegador para você entrar na conta. Se o navegador não abrir, aperte c para copiar o link de login.
  3. Entre com a sua conta do Claude. Um login Pro ou Max usa o uso incluído no seu plano.

No Windows, a Anthropic recomenda instalar o Git for Windows para o Claude Code poder usar a ferramenta Bash dele; sem isso, o Claude Code roda comandos no PowerShell. Para esta configuração, instale o Claude Code no próprio Windows e não dentro do WSL: a configuração da Roblox para Windows roda o cmd.exe com um caminho em %LOCALAPPDATA%, e a Roblox não documenta o WSL.

Prefere um painel no editor? No VS Code ou no Cursor, abra Extensions (Ctrl+Shift+X, ou Cmd+Shift+X no Mac), procure Claude Code, instale e entre na conta pelo painel do Claude. Esta é a configuração que o guia de coding harness da Roblox usa.

Passo 2: Conecte o Claude Code ao Studio

Ligue o servidor primeiro. No Studio, abra o Assistant, clique em … > Manage MCP Servers e ative Enable Studio as MCP server. O guia do MCP do Studio cobre este passo com mais detalhes. Sem o botão do Assistant? Veja como abrir o painel do Assistant.

Quick connect

  1. No mesmo painel (Assistant Settings > MCP Servers), abra o menu Quick connect. Ele lista os clientes suportados que estão instalados no seu computador.
  2. Ative o Claude Code. Se ele não aparecer, instale o Claude Code e reinicie o Studio.
  3. Reinicie o Claude Code: encerre a sessão e rode claude de novo, ou comece uma conversa nova na extensão. A Roblox diz que um cliente precisa reiniciar para pegar uma configuração nova.

A Roblox não diz em qual arquivo do Claude Code o Quick connect escreve, nem que nome ele dá ao servidor. Digite /mcp no Claude Code para ver o nome. Você precisa dele para as regras de permissão do Passo 3.

Usa a extensão do Claude Code no VS Code ou no Cursor? Ative o Claude Code aqui também. O guia de coding harness da Roblox liga o Cursor ou o Visual Studio Code, mas a Anthropic documenta que a extensão compartilha a configuração de MCP com a versão de terminal do Claude Code, e não diz que ela lê as configurações de MCP do próprio editor.

Configuração manual com um arquivo .mcp.json

Se o Quick connect não funcionar para você, adicione o Studio você mesmo. O Claude Code lê os servidores MCP do projeto em um arquivo chamado .mcp.json na pasta do seu projeto, no mesmo formato mcpServers que a Roblox documenta, e trata uma entrada sem type como um servidor stdio local. Então a configuração da Roblox funciona do jeito que está. Salve a do seu sistema como .mcp.json na pasta onde você roda o claude:

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

Na próxima vez que você rodar o claude nessa pasta, ele pede que você aprove o servidor: a Anthropic mostra esse pedido para todo servidor que vem de um arquivo .mcp.json. A Anthropic pensou o arquivo para entrar no repositório e ser compartilhado pela equipe, mas os caminhos do Windows e do macOS são diferentes. Se a sua equipe usa os dois, deixe o arquivo fora do repositório e deixe cada pessoa adicionar o Studio por conta própria.

No macOS, você pode adicionar o Studio com um comando só. O --scope user deixa o servidor disponível em todos os projetos do seu computador; sem ele, o servidor carrega só na pasta atual. O -- separa as opções do próprio Claude Code do comando que inicia o servidor.

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

No Windows, o arquivo JSON é o caminho mais simples, porque o PowerShell e o CMD tratam o %LOCALAPPDATA% de formas diferentes em uma linha de comando.

Confira a conexão

  • Em um terminal, claude mcp list mostra cada servidor e o status dele. claude mcp get Roblox_Studio mostra mais, incluindo uma linha Issue: se o servidor não conseguiu conectar.
  • Dentro do Claude Code, digite /mcp. Os servidores conectados mostram uma contagem de ferramentas ao lado do nome.
  • No Studio, Assistant > … > Manage MCP Servers mostra um indicador verde com o número de clientes conectados.

Passo 3: Decida o que o Claude pode fazer sem perguntar

Defina isso antes de o Claude tocar no seu place. Segundo a página de modos de permissão da Anthropic, desde o Claude Code v2.1.283 as sessões interativas do terminal e do VS Code começam no modo auto por padrão sempre que ele está disponível, e no modo auto um classificador em segundo plano revisa as ações no seu lugar. Uma chamada MCP que edita um script ou roda Luau no Studio pode então seguir em frente sem pedir confirmação.

Você tem dois jeitos de manter cada mudança nas suas mãos:

  • Comece no modo Manual. Rode claude --permission-mode default. No modo Manual, só leituras rodam sem perguntar. Aperte Shift+Tab durante uma sessão para alternar entre os modos.
  • Adicione regras ask para as ferramentas do Studio que mudam coisas. A Anthropic diz que nenhum modo aprova sozinho uma ferramenta que casa com uma regra ask explícita, nem mesmo o modo bypass.
.claude/settings.json · exemplo
{
  "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"
    ]
  }
}

As regras de MCP têm a forma mcp__<server>__<tool>, usando o nome do servidor como o Claude Code o registra. Troque Roblox_Studio pelo nome que o /mcp mostra. As regras allow no .claude/settings.json de um projeto só valem depois que você aceita o diálogo de confiança do workspace para aquela pasta. Para regras que são só suas, use .claude/settings.local.json.

A lista allow cobre ferramentas que só leem: a árvore do jogo, propriedades, scripts, o Output e a lista de janelas do Studio abertas. A lista ask cobre ferramentas que mudam o seu place, rodam código, iniciam testes, trazem assets de fora ou enviam imagens para a Roblox. Ferramentas que não estão em nenhuma das duas listas, como screen_capture e as ferramentas de entrada, seguem o seu modo de permissão. A lista completa de ferramentas, com o que cada uma faz, está no guia do MCP do Studio.

Passo 4: Comece com um pedido que só lê

Abra o place em que você quer trabalhar e feche os que você não quer. Depois dê ao Claude um primeiro pedido que não tem como mudar nada:

Prompt (em inglês)
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.

Em uma Baseplate nova, o guia de coding harness da Roblox espera que a resposta liste os padrões Camera, Terrain, Baseplate e SpawnLocation. Pedir o list_roblox_studios primeiro é um bom hábito: um cliente alcança todas as janelas do Studio que você tem abertas, e toda chamada de ferramenta indica a janela alvo com um studio_id.

Para qualquer coisa maior que um script, peça um plano primeiro. No modo plan (aperte Shift+Tab, ou comece um prompt com /plan), o Claude pesquisa e propõe sem editar os seus arquivos. A Anthropic descreve o modo plan em termos de edições de arquivos e comandos de shell, então mantenha também as suas regras ask para as ferramentas do Studio.

Passo 5: Trabalhe nos scripts como arquivos com Script Sync ou Rojo

O Claude Code é feito em torno de arquivos em uma pasta. Ele edita esses arquivos com as próprias ferramentas, o Git guarda o histórico deles, e o /rewind consegue restaurá-los. Colocar os seus scripts no disco deixa você usar tudo isso, e deixa as ferramentas MCP para as partes de um place que não são scripts, como GUIs no StarterGui, RemoteEvents e parts. A Roblox documenta dois jeitos de fazer isso.

Script Sync e Rojo, das páginas de Script Sync e de ferramentas de terceiros da Roblox
Script SyncRojo
O que éUm recurso do Studio que sincroniza os scripts do seu place com arquivos no disco, nas duas direções.Uma ferramenta de terceiros: um servidor no seu computador mais um plugin do Studio.
O que sincronizaSó instâncias Script, LocalScript, ModuleScript e Folder. Outras instâncias em uma pasta sincronizada são ignoradas.Pode gerenciar o projeto inteiro como arquivos, com o seu sistema de arquivos como fonte da verdade.
ConfiguraçãoClique com o botão direito em um serviço ou pasta no Explorer, escolha Sync to… e selecione uma pasta. O guia de coding harness da Roblox primeiro ativa o recurso em File > Beta Features.Instale com o Rokit (rokit add rojo-rbx/rojo, depois rokit install), adicione o plugin com rojo plugin install, rode rojo serve e conecte pelo plugin.
Team CreateFunciona com ele. Evite duas pessoas editando o mesmo script sincronizado ao mesmo tempo.A Roblox observa que ferramentas de terceiros muitas vezes não funcionam com as ferramentas de colaboração integradas dela.
Conselho da RobloxUma boa escolha se você quer o seu próprio editor e controle de versão para o código, e o Studio para todo o resto.Uma escolha melhor se você quer o projeto inteiro, não só o código, no controle de versão.

O mesmo nome de arquivo pode significar coisas diferentes

As duas ferramentas escolhem o tipo do script pelo nome do arquivo, e os sufixos não batem. Um arquivo .client é um LocalScript no Rojo, mas um Script com run context Client no Script Sync. Diga ao Claude qual ferramenta o seu projeto usa; o exemplo de CLAUDE.md abaixo faz isso.

Regras do Script Sync da página de Script Sync da Roblox (arquivos .luau). Regras do Rojo da página Sync Details do Rojo v7, que lista arquivos .lua
O nome do arquivo termina emO Script Sync criaO Rojo cria
.serverScript com run context ServerScript
.clientScript com run context ClientLocalScript
.localLocalScriptSem significado especial (qualquer outro arquivo .lua é um ModuleScript)
Sem sufixoModuleScriptModuleScript
Uma pasta com um arquivo initUm script com filhos, com o tipo definido pelo nome do arquivo initA pasta vira o script que init.server.lua, init.client.lua ou init.lua descreve

Configure o Script Sync para o Claude Code

  1. Crie uma pasta de projeto com uma pasta para cada serviço que você quer no disco, por exemplo ServerScriptService, ReplicatedStorage e StarterPlayerScripts, e rode git init nela.
  2. Se o Script Sync não aparecer quando você clica com o botão direito em um serviço, ative em File > Beta Features, clique em Save e reinicie o Studio.
  3. No Explorer, clique com o botão direito em ServerScriptService, escolha Script Sync > Sync to e selecione a pasta principal do projeto, não uma pasta dentro dela. Repita para os outros serviços.
  4. Rode o claude nessa pasta. Agora o Claude edita arquivos .luau, e o Studio pega cada mudança.
  5. Faça um commit antes de cada sessão, para ter sempre um ponto limpo para onde voltar.
Terminal, na pasta do seu projeto
git add .
git commit -m "Before Claude session"

Duas regras do Script Sync pesam mais quando há um agente. Não sincronize scripts que têm atributos ou tags: o Script Sync os ignora, e a Roblox avisa que isso pode levar a perda de dados. E se os arquivos mudarem com o Studio fechado, o Studio pergunta como resolver quando você reabre o place, listando o que Keep Studio e Keep Disk adicionariam, mudariam ou apagariam. Leia essa lista antes de escolher.

Com o Script Sync ligado, uma edição de arquivo chega ao Studio assim que é salva. Aceitar uma edição no Claude Code é aceitá-la no seu place, então revise antes de aceitar, principalmente nos modos que aceitam edições automaticamente.

Para autocompletar e erros de tipo no seu editor, a Roblox recomenda a extensão Luau Language Server com o plugin do Studio que a acompanha. No VS Code, a extensão do Claude Code consegue ler o painel Problems por uma ferramenta embutida, então o Claude vê os mesmos avisos que você.

Passo 6: Passe ao Claude as suas regras de Roblox no CLAUDE.md

Toda sessão do Claude Code começa com um contexto novo. Um arquivo CLAUDE.md na pasta do seu projeto é lido no começo de cada sessão, então é ali que ficam as suas convenções. Rode /init para o Claude escrever um rascunho, ou escreva você mesmo. O conselho da Anthropic é manter o arquivo com menos de 200 linhas, escrever regras específicas o bastante para serem conferidas e rodar /context para confirmar que ele carregou.

Este exemplo foi escrito para este guia, para um projeto que usa o Script Sync. Troque os nomes para bater com o seu jogo e corte o que você não precisa.

CLAUDE.md · exemplo para um projeto com Script Sync (em inglês)
# 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.

Algumas linhas estão ali por causa de como as ferramentas funcionam. As regras de nome de arquivo existem porque .client.luau não é um LocalScript no Script Sync. A linha do list_roblox_studios existe porque o servidor alcança todas as janelas abertas. A linha dos assets existe porque o insert_asset traz conteúdo de fora para o seu place e o upload_image envia imagens ao servidor de assets da Roblox. A linha do wait segue a referência da API da Roblox, que marca wait, spawn e delay como obsoletos em favor da biblioteca task.

Se o seu projeto já tem um AGENTS.md para outros agentes de programação, o Claude Code pode ler esse arquivo como as instruções do projeto, então você pode manter um arquivo só para os dois. A página de memória da Anthropic explica qual arquivo vence quando os dois existem.

Como essas regras ficam no código

Aqui está um script de servidor que segue as regras de Luau acima. Ele foi escrito à mão para este guia, não gerado pelo Claude. Use como régua quando for revisar o que o Claude entregar. Um LocalScript pede uma ferramenta com RequestTool:FireServer("Sword"), e o servidor confere tudo.

Script em ServerScriptService chamado 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")

-- O Script Sync só sincroniza scripts e pastas, então o servidor cria o próprio 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 um pedido que chega depois que o jogador saiu.
	if player.Parent ~= Players then
		return
	end

	-- 1. Confere o argumento: um cliente pode enviar qualquer coisa.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Limita a frequência com que um jogador pode pedir.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. O servidor decide. Adicione aqui a sua própria verificação de posse (um game pass, um 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. Limpeza por jogador.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

No disco com o Script Sync: ServerScriptService/ToolRequests.server.luau. Coloque os seus objetos Tool em uma Folder chamada Tools no ServerStorage. Até você adicionar uma verificação de posse, todo jogador consegue pegar todas as ferramentas dessa pasta.

Procure as mesmas coisas em qualquer handler de remote que o Claude escrever: ele confere o tipo e o tamanho do que o cliente enviou, limita a frequência com que um jogador pode chamá-lo, o servidor toma a decisão, e ele remove a entrada do jogador quando ele sai. O guia de RemoteEvents explica por que cada uma importa.

Um jeito seguro de trabalhar: ponto de restauração, revisão, teste

  1. Crie um ponto de restauração dos dois lados. Faça um commit dos seus arquivos no Git e salve uma versão do place no Studio com File > Save to Roblox with Notes. O guia do MCP do Studio mostra como restaurar uma versão pelo Version History.
  2. Peça um plano para qualquer coisa maior que um script, e leia antes de aprovar.
  3. Revise o diff. Para arquivos, leia o git diff ou os diffs embutidos da extensão antes de aceitar. Para mudanças feitas no Studio, leia os scripts em que o Claude mexeu e confira o Explorer em busca de objetos que apareceram ou sumiram.
  4. Teste você mesmo. O Claude pode iniciar um teste e ler o Output, mas ele só confere o que escolheu conferir. Jogue o recurso como um jogador jogaria antes de fazer o commit ou publicar.
  5. Faça o commit quando funcionar, com uma mensagem que diga o que mudou.

O que o /rewind consegue e não consegue desfazer

O Claude Code salva um checkpoint antes de cada prompt, e o /rewind (ou Esc duas vezes) restaura os arquivos que o Claude mudou com as ferramentas de edição de arquivos dele. A Anthropic lista o que ele não acompanha, incluindo mudanças feitas por comandos de shell. Mudanças feitas no Studio pelas ferramentas MCP não são edições de arquivo, então não espere que o /rewind as desfaça, e a página de MCP da Roblox não diz se elas entram no histórico de desfazer do Studio. Com o Script Sync, um arquivo que o /rewind restaura sincroniza de volta para o Studio como qualquer outra mudança no disco. Para todo o resto, a sua versão salva é o caminho de volta.

Mantenha segredos e dados reais fora de alcance

  • Não cole chaves de API, chaves do Open Cloud, URLs de webhook ou senhas em um prompt nem no CLAUDE.md. Os dois são texto que o Claude lê, e o CLAUDE.md normalmente vai para o seu repositório.
  • Também não deixe esses valores fixos nos scripts. A Roblox tem um cofre de segredos para cada jogo: crie os segredos no Creator Dashboard e leia em um script de servidor com HttpService:GetSecret(). Para testes locais, adicione segredos locais em File > Experience Settings > Security.
  • Guarde as configurações pessoais em .claude/settings.local.json e CLAUDE.local.md, que foram pensados para ficar fora do Git. Adicione o CLAUDE.local.md ao .gitignore você mesmo.
  • Ligue Enable Studio Access to API Services só em uma cópia de teste separada do seu jogo. A Roblox avisa que o Studio usa os mesmos data stores do jogo ao vivo, então um teste que o Claude iniciar ali poderia sobrescrever dados reais de jogadores.
  • Leia uma skill de terceiros antes de instalar. Diretórios de skills listam skills de Roblox para o Claude Code, e a Anthropic observa que uma skill pode dar a si mesma acesso amplo a ferramentas pelo campo allowed-tools.

Quanto custa o Claude Code para trabalhar com Roblox

O lado do Studio não tem preço documentado: o servidor MCP faz parte do Studio, e a página de MCP da Roblox não cita cobrança. O custo é o do Claude Code, e a Anthropic oferece dois jeitos de pagar (em 9 de outubro de 2026):

  • Uma assinatura do Claude. O Claude Code vem incluído nos planos Pro, Max, Team e Enterprise, não no Free. Ele consome o mesmo uso do Claude na web, no computador e no celular. Os limites se renovam em uma janela móvel de cinco horas, e os planos pagos ainda têm limites semanais por cima. Quando você chega a um deles, pode esperar, passar para um plano maior ou ativar os créditos de uso.
  • Uma conta do Claude Console. Você paga pelo uso da API conforme o volume de texto processado. A página de custos da Anthropic diz que o gasto varia muito com a escolha do modelo, o tamanho da base de código e o jeito como você usa.

Os preços atuais estão em claude.com/pricing (em inglês). Este guia não repete os preços porque eles mudam. Dentro do Claude Code, o /usage mostra barras de uso do plano para assinantes e um custo estimado da sessão para quem usa a API.

O que faz uma sessão de Roblox gastar mais

  • Tamanho do contexto. O consumo cresce com o que o Claude tem no contexto. Use /clear entre tarefas sem relação.
  • Resultados grandes de ferramentas. Percorrer a árvore inteira de um place grande ou ler scripts longos por completo devolve muito texto. O Claude Code avisa quando o resultado de uma ferramenta MCP passa de 10.000 unidades de texto (a medida em que o uso do modelo é contado) e o limita a 25.000 por padrão. Peça uma pasta só, um limite de profundidade ou um intervalo de linhas: search_game_tree e script_read aceitam isso.
  • Escolha do modelo. A Anthropic diz que o Sonnet dá conta bem da maioria das tarefas de programação e custa menos que o Opus. Troque com /model.

Solução de problemas do Claude Code com o Studio

A lista de verificação da própria Roblox é curta: reinicie o Studio e o cliente, confira se o caminho do comando existe e confira o JSON. Estes são os casos específicos do Claude Code.

O Claude Code não está na lista de Quick connect

A lista mostra só clientes suportados que estão instalados no seu computador. Instale o Claude Code e reinicie o Studio. Se você instalou com o Studio aberto, reinicie o Studio, o Claude Code ou os dois. O arquivo .mcp.json do Passo 2 funciona sem o Quick connect.

O /mcp não mostra o servidor do Roblox Studio

Reinicie o Claude Code depois de adicionar o servidor. Depois confira onde ele foi adicionado: um servidor adicionado sem --scope carrega só na pasta onde você o adicionou, então inicie o claude a partir dessa pasta ou adicione de novo com --scope user. No VS Code, comece uma conversa nova, porque as mudanças valem para conversas iniciadas depois.

O servidor mostra Pending approval

Ele vem de um arquivo .mcp.json, e o Claude Code pergunta antes de usar esses servidores. Rode o claude nessa pasta, aceite o diálogo de confiança do workspace e aprove o servidor. O claude mcp reset-project-choices limpa as escolhas anteriores.

O servidor mostra Failed to connect

Rode claude mcp get Roblox_Studio e leia a linha Issue:. Confira se o arquivo existe: %LOCALAPPDATA%\Roblox\mcp.bat no Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP no macOS (mude o caminho se o Studio estiver instalado em outro lugar). Veja se Enable Studio as MCP server continua ligado, depois reinicie o Studio e o Claude Code.

O terminal diz que claude não é reconhecido

Abra uma janela nova do terminal depois de instalar. Se ele ainda não for encontrado, a pasta de instalação não está no seu PATH; a página de solução de problemas de instalação da Anthropic traz a correção. A extensão do VS Code não adiciona o claude ao seu PATH, então instale a versão de terminal à parte para os comandos deste guia.

O Claude mudou o place errado

Com várias janelas do Studio abertas, toda chamada de ferramenta indica o alvo com um studio_id. Peça ao Claude para chamar list_roblox_studios e cite o place que você quer, feche as janelas que não está usando e restaure o place alterado pelo Version History.

O Claude Code está cobrando na minha chave de API em vez do meu plano

Depois que você aprova, uma variável de ambiente ANTHROPIC_API_KEY assume o lugar da sua assinatura. Remova a variável (ou desligue Use custom API key em /config), inicie o Claude Code de novo e rode /status para conferir qual login está ativo. Se ainda for uma conta do Console, rode /login e escolha a sua conta do Claude.

Uma sessão na nuvem não enxerga o Studio

As sessões na nuvem rodam na infraestrutura da Anthropic, não no seu computador, então não alcançam o servidor local do Studio. Use o terminal, a extensão do editor ou o app de computador com Local selecionado.

Ou use um agente em plugin: RoCode

O Claude Code com MCP serve para quem fica à vontade em um terminal ou editor de código. O RoCode (RoCode.app) é outro caminho: um agente de IA independente para o Roblox Studio, com um chat na web em rocode.app e um plugin grátis da Creator Store que executa os passos no place que você tem aberto. Ele não é um produto MCP e não usa o servidor MCP do Studio, então não há linha de comando, arquivo de configuração nem servidor MCP para configurar. O plugin se conecta sozinho quando o Studio está na mesma conta do Roblox que você usa no RoCode; se não, você pareia o chat e o plugin uma vez com o código de 8 caracteres mostrado no painel do plugin.

O que saber antes de trocar. O RoCode não conecta uma assinatura do Claude nem do Claude Code. Ele roda modelos de terceiros pela OpenRouter, incluindo o Claude Sonnet 5.5 a partir do Pro e o Claude Opus 5.5 a partir do Studio, e o plano Starter grátis dá 1 crédito por dia no GPT-6 Luna. Ele trabalha a partir do modo de edição. Com o plugin 3.9 ou mais recente, no modo Build, ele pode rodar um teste curto e ler os erros, e com o plugin 3.9.11 ou mais recente controlar um personagem de teste para conferir se o jogo funciona. Com o plugin 3.9.14 ou mais recente ele também tira capturas de tela do que construiu, no modo de edição, e pode corrigir o que parecer errado. Ele não roda código diretamente nem gera malhas, duas coisas que as ferramentas MCP do Studio fazem. Ele pode buscar na Creator Store com as suas palavras modelos gratuitos (com os scripts de dentro removidos) ou inserir um modelo, decal ou malha pelo ID do asset, e cria cenário, construções e objetos novos para cada jogo. O modo Ask dele responde perguntas sobre o seu place com ferramentas só de leitura e não muda nada. As contas são para maiores de 13 anos, com permissão de um dos pais ou responsável para menores de 18.

Você digita

Adicione um RemoteEvent para os jogadores poderem pedir uma ferramenta de ServerStorage.Tools. Confira tudo no servidor.

O RoCode faz
  • Pode olhar o place antes com Search Game e List Children, para achar a pasta Tools e qualquer script que já entregue ferramentas
  • Escreve o script de servidor com Create Script, e pode adicionar o RemoteEvent com Create Instance
  • Confere se o script compila dentro do Studio com Check Script antes de terminar. É uma verificação de compilação, não de tipos nem um teste
  • Envia as alterações em lotes, e cada lote é um ponto de desfazer no histórico do próprio Studio

Com o plugin 3.9 ou mais recente, o RoCode pode rodar um teste curto e ler os erros, e com o plugin 3.9.15 ou mais recente o personagem de teste dele pode andar, apertar teclas e clicar em botões na tela, mas ele só confere o que escolheu testar, então aperte Play você mesmo para testar o resultado como jogador. O prompt é um exemplo escrito por nós; os passos usam os nomes reais das ferramentas. Como funcionam o plugin e o pareamento. O RoCode é um produto independente, sem afiliação, endosso ou patrocínio da Roblox Corporation.

Perguntas frequentes

Posso usar o Claude Desktop em vez do Claude Code?

Sim. O Claude Desktop está na lista de Quick connect do painel Manage MCP Servers do Studio, então ele conecta com um interruptor, no Windows ou no Mac. Ele usa as mesmas ferramentas do Studio; o Claude Code acrescenta coisas que um agente de terminal faz bem, como trabalhar em arquivos de script e com Git. Os passos para os dois estão no guia de configuração do MCP do Studio.

O Claude Code consegue se conectar ao Roblox Studio?

Sim. A Roblox lista o Claude Code como cliente de Quick connect do servidor MCP integrado ao Studio. Ative Enable Studio as MCP server em Assistant > … > Manage MCP Servers, ligue o Claude Code em Quick connect e reinicie o Claude Code. Ele também pode trabalhar nos seus scripts como arquivos, pelo Script Sync ou pelo Rojo.

O Claude Code é grátis para usar com o Roblox Studio?

O servidor MCP do Studio não tem preço documentado, mas o Claude Code não faz parte do plano Free da Anthropic (claude.com/pricing, conferido em 9 de outubro de 2026). Você precisa de um plano pago do Claude, em que ele divide os limites de uso do seu plano, ou de uma conta do Claude Console cobrada pelo uso da API.

Preciso de um plugin do Roblox ou de requisições HTTP para usar o Claude Code?

Não para o servidor MCP integrado ao Studio. Os passos de configuração da Roblox são ligar o servidor no Assistant e conectar o cliente; eles não incluem plugin para instalar nem configuração de HTTP para mudar. Alguns guias mais antigos descrevem servidores MCP da comunidade que funcionam de outro jeito. O Rojo, se você escolher ele para os arquivos, usa sim o próprio plugin do Studio.

O Claude Code consegue testar o meu jogo do Roblox?

Pelas ferramentas MCP do Studio, sim. start_stop_play inicia e para um teste, get_console_output lê o Output, screen_capture captura o viewport, e as ferramentas de entrada movem o personagem e enviam teclas e cliques. Confira o que ele relatar, e jogue você mesmo antes de publicar.

Devo usar o Claude Code ou o Codex com o Roblox Studio?

Os dois estão na lista de Quick connect da Roblox e alcançam as mesmas ferramentas MCP do Studio, então a diferença é o modelo, a conta e o cliente em volta dele. A Roblox não publica nenhuma comparação e nós não fizemos benchmark dos dois. Teste cada um em uma cópia do seu place com as mesmas regras escritas, e fique com aquele cujas mudanças precisam de menos correção.

O Claude Code funciona com o Roblox Studio no Mac?

Sim. O Claude Code suporta o macOS 13.0 ou mais recente, e a Roblox documenta um caminho do servidor no macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, para clientes que você configura à mão.

Fontes e leitura extra

Como o código foi verificado: todo script desta página passa no verificador de tipos estrito do Luau com as definições da API do Roblox (luau-lsp, 13 de novembro de 2026). A verificação de tipos pega APIs com nome errado e tipos incorretos, não a lógica do jogo, então teste no Studio antes de publicar.

Teste o RoCode no seu próprio jogo.

Créditos grátis todo dia, sem cartão. Instale o plugin, descreva o recurso e confira o que aparece no Studio.