Návod · AI v Roblox Studiu

Jak připojit Claude Code k Roblox Studiu

Claude Code je agentní nástroj Anthropic pro psaní kódu. Roblox ho uvádí jako klienta quick connect pro MCP server vestavěný ve Studiu, takže může číst váš place, upravovat skripty a spouštět playtesty ve vašem otevřeném okně Studia. Umí také pracovat s vašimi skripty jako se soubory přes Script Sync nebo Rojo. Tento návod je o straně Claude Code: co potřebujete, jak ho připojit, oprávnění, CLAUDE.md s pravidly pro Roblox, bezpečný způsob práce a kolik to stojí. Pro agenta od OpenAI viz návod jak používat OpenAI Codex s Roblox Studiem (anglicky); pro Cursor, Claude Desktop a další klienty viz návod k nastavení Studio MCP.

Aktualizováno 20. listopadu 202620 min čteníAutor:

Ve zkratce

Nainstalujte Claude Code a přihlaste se s placeným plánem Claude nebo účtem Claude Console. Ve Studiu otevřete Assistant, klikněte na … > Manage MCP Servers, zapněte Enable Studio as MCP server a pak zapněte Claude Code v seznamu Quick connect. Restartujte Claude Code, napište /mcp, abyste ověřili, že je server Studia připojený, a začněte požadavkem, který jen čte.

  • Claude Code není v plánu Free od Anthropic. Je součástí plánů Pro, Max, Team a Enterprise, nebo se platí podle využití API přes účet Claude Console (ověřeno 9. října 2026).
  • Používejte lokální relaci: terminál, rozšíření pro VS Code nebo Cursor, případně desktopovou aplikaci se zvoleným Local. Cloudové relace neběží na vašem počítači a ke Studiu nedosáhnou.
  • Od verze v2.1.283 začínají relace v terminálu a ve VS Code ve výchozím stavu v režimu auto, kde je dostupný, proto přidejte pravidla ask pro nástroje Studia, které mění place. Příkaz /rewind v Claude Code nevrací změny provedené ve Studiu, proto si nejdřív uložte verzi.
Na této stránce
  1. Co potřebujete
  2. 1. Instalace a přihlášení
  3. 2. Připojení ke Studiu
  4. 3. Oprávnění
  5. 4. První požadavek
  6. 5. Script Sync nebo Rojo
  7. 6. CLAUDE.md
  8. Bezpečná práce
  9. Cena
  10. Řešení problémů
  11. Agent v pluginu
  12. Časté otázky
  13. Zdroje a další čtení

Co potřebujete, než začnete

Požadavky podle dokumentace Robloxu a Anthropic, 9. října 2026
Co potřebujetePodrobnosti
Roblox StudioNejnovější verze, na Windows nebo macOS. MCP server je vestavěný ve Studiu, takže na straně Robloxu nic dalšího instalovat nemusíte.
Počítač, který Claude Code podporujemacOS 13.0 nebo novější, případně Windows 10 1809 nebo novější, alespoň 4 GB operační paměti, připojení k internetu a poloha v zemi, kterou Anthropic podporuje.
Účet Claude, který zahrnuje Claude CodePlacený plán Claude (Pro, Max, Team nebo Enterprise) nebo účet Claude Console. Na stránce s cenami Anthropic je uvedeno, že Claude Code není součástí plánu Free.
VěkConsumer Terms od Anthropic (platné od 8. října 2025) uvádějí, že vám musí být alespoň 18 let, nebo minimální věk pro souhlas ve vaší zemi, pokud je vyšší.
VolitelněGit pro uchování historie skriptů. Visual Studio Code 1.94.0 nebo novější, případně Cursor, pokud chcete Claude Code v panelu editoru, a ne v terminálu.

Který Claude Code použít

Claude Code běží na několika místech. Anthropic píše, že všechna mají stejné jádro, takže vaše CLAUDE.md, nastavení a MCP servery fungují všude. Pro Studio je důležité, kde relace běží: MCP server Robloxu je lokální proces na vašem počítači, takže i relace musí běžet na vašem počítači.

Varianty Claude Code a Roblox Studio
VariantaDosáhne ke Studiu?Poznámky
Terminál (příkaz claude)AnoSpouštějte ho ve složce projektu. Potřebujete ho také pro příkazy claude mcp níže.
Rozšíření pro VS Code nebo CursorAnoCesta z návodu Robloxu ke coding harness. Rozšíření obsahuje vlastní kopii Claude Code, ale nepřidává claude do PATH, takže pokud tyto příkazy potřebujete, nainstalujte i verzi pro terminál.
Desktopová aplikace, karta Code, se zvoleným LocalAnoBěží na vašem počítači. Anthropic píše, že je potřeba placené předplatné.
Cloudové relace (claude.ai/code nebo Cloud v desktopové aplikaci)NeBěží v cloudové infrastruktuře, ne na vašem počítači, takže nemohou spustit lokální server Studia.

Krok 1: nainstalujte Claude Code a přihlaste se

Anthropic doporučuje instalaci jedním příkazem v terminálu. Toto jsou příkazy, které byly na jeho stránce o instalaci 9. října 2026; aktuální najdete na stránce o instalaci od Anthropic.

Terminál · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Otevřete nové okno terminálu a spusťte claude --version. Číslo verze znamená, že se to povedlo. Pokud příkaz nebyl nalezen, instalační složka ještě není v PATH a řešení najdete na stránce Anthropic o problémech s instalací.
  2. Přejděte do složky projektu a spusťte claude. Při prvním spuštění otevře okno prohlížeče pro přihlášení. Pokud se prohlížeč neotevřel, stiskněte c a zkopírujete odkaz pro přihlášení.
  3. Přihlaste se do svého účtu Claude. Přihlášení s Pro nebo Max využívá limity zahrnuté ve vašem plánu.

Na Windows Anthropic doporučuje nainstalovat Git for Windows, aby Claude Code mohl používat svůj nástroj Bash; bez něj Claude Code spouští příkazy v PowerShellu. Pro toto nastavení instalujte Claude Code přímo do Windows, ne do WSL: konfigurace Robloxu pro Windows spouští cmd.exe s cestou %LOCALAPPDATA% a WSL Roblox nedokumentuje.

Dáváte přednost panelu v editoru? Ve VS Code nebo Cursoru otevřete Extensions (Ctrl+Shift+X nebo Cmd+Shift+X na Macu), najděte Claude Code, nainstalujte ho a přihlaste se z panelu Claude. Přesně toto nastavení používá návod Robloxu ke coding harness.

Krok 2: připojte Claude Code ke Studiu

Nejdřív zapněte server. Ve Studiu otevřete Assistant, klikněte na … > Manage MCP Servers a zapněte Enable Studio as MCP server. Návod ke Studio MCP tento krok rozebírá podrobněji. Nemáte tlačítko Assistant? Viz jak otevřít panel Assistant.

Quick connect

  1. Ve stejném panelu (Assistant Settings > MCP Servers) rozbalte seznam Quick connect. Jsou v něm podporovaní klienti nainstalovaní na vašem počítači.
  2. Zapněte Claude Code. Pokud tam není, nainstalujte Claude Code a restartujte Studio.
  3. Restartujte Claude Code: ukončete relaci a znovu spusťte claude, nebo v rozšíření začněte novou konverzaci. Roblox píše, že klient potřebuje restart, aby načetl novou konfiguraci.

Roblox neuvádí, do kterého souboru Claude Code quick connect zapisuje ani jak server pojmenuje. Napište v Claude Code /mcp a název uvidíte. Budete ho potřebovat pro pravidla oprávnění v kroku 3.

Používáte rozšíření Claude Code ve VS Code nebo Cursoru? I tady zapněte Claude Code. Návod Robloxu ke coding harness zapíná Cursor nebo Visual Studio Code, ale Anthropic dokumentuje, že rozšíření sdílí konfiguraci MCP s verzí Claude Code pro terminál, a neuvádí, že by četlo vlastní nastavení MCP editoru.

Ruční nastavení přes soubor .mcp.json

Pokud vám quick connect nefunguje, přidejte Studio sami. Claude Code čte MCP servery projektu ze souboru s názvem .mcp.json ve složce projektu, ve stejném formátu mcpServers, který dokumentuje Roblox, a záznam bez type považuje za lokální stdio server. Proto konfigurace Robloxu funguje tak, jak je. Uložte variantu pro svůj systém jako .mcp.json do složky, kde spouštíte claude:

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

Až příště spustíte claude v této složce, požádá vás o schválení serveru: Anthropic tento dotaz zobrazuje u každého serveru, který pochází ze souboru .mcp.json. Anthropic tento soubor navrhl tak, aby se commitoval a sdílel v celém týmu, ale cesty pro Windows a macOS se liší. Pokud váš tým používá oba systémy, držte soubor mimo repozitář a ať si každý přidá Studio sám.

Na macOS můžete Studio místo toho přidat jedním příkazem. --scope user ho zpřístupní v každém projektu na vašem počítači; bez něj se server načte jen v aktuální složce. -- odděluje vlastní parametry Claude Code od příkazu, který spouští server.

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

Na Windows je jednodušší cesta se souborem JSON, protože PowerShell a CMD zpracovávají %LOCALAPPDATA% v příkazovém řádku různě.

Ověřte připojení

  • V terminálu claude mcp list ukáže každý server a jeho stav. claude mcp get Roblox_Studio ukáže víc, včetně řádku Issue:, pokud se server nemohl připojit.
  • Uvnitř Claude Code napište /mcp. U připojených serverů je vedle názvu uvedený počet nástrojů.
  • Ve Studiu Assistant > … > Manage MCP Servers ukazuje zelený indikátor s počtem připojených klientů.

Krok 3: rozhodněte, co smí Claude dělat bez ptaní

Nastavte to dřív, než Claude sáhne na váš place. Podle stránky Anthropic o režimech oprávnění začínají od Claude Code v2.1.283 interaktivní relace v terminálu a ve VS Code ve výchozím stavu v režimu auto všude, kde je dostupný, a v režimu auto akce místo vás posuzuje klasifikátor na pozadí. Volání MCP, které upravuje skript nebo spouští Luau ve Studiu, pak může projít bez dotazu.

Každou změnu si můžete udržet pod kontrolou dvěma způsoby:

  • Spouštějte v režimu Manual. Spusťte claude --permission-mode default. V režimu Manual se bez ptaní provádí jen čtení. Během relace přepínáte režimy klávesami Shift+Tab.
  • Přidejte pravidla ask pro nástroje Studia, které něco mění. Anthropic píše, že žádný režim automaticky neschválí nástroj, na který se vztahuje výslovné pravidlo ask, ani režim bypass.
.claude/settings.json · příklad
{
  "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"
    ]
  }
}

Pravidla MCP mají tvar mcp__<server>__<tool>, s názvem serveru tak, jak ho zná Claude Code. Nahraďte Roblox_Studio názvem, který ukazuje /mcp. Pravidla allow v souboru projektu .claude/settings.json začnou platit až poté, co pro tuto složku přijmete dialog důvěry k pracovní složce. Pro pravidla, která potřebujete jen vy, použijte .claude/settings.local.json.

Seznam allow pokrývá nástroje, které jen čtou: strom hry, vlastnosti, skripty, Output a seznam otevřených oken Studia. Seznam ask pokrývá nástroje, které mění place, spouštějí kód, spouštějí playtesty, vkládají externí assety nebo posílají obrázky do Robloxu. Nástroje, které nejsou v žádném seznamu, například screen_capture a nástroje pro vstup, se řídí vaším režimem oprávnění. Úplný seznam nástrojů s popisem každého najdete v návodu ke Studio MCP.

Krok 4: začněte požadavkem, který jen čte

Otevřete place, se kterým chcete pracovat, a zavřete ty, se kterými nechcete. Pak dejte Claude první požadavek, který nemůže nic změnit:

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.

Na čerstvém Baseplate návod Robloxu ke coding harness očekává, že odpověď vyjmenuje standardní Camera, Terrain, Baseplate a SpawnLocation. Žádat nejdřív o list_roblox_studios je dobrý zvyk: jeden klient dosáhne ke každému vašemu otevřenému oknu Studia a každé volání nástroje určuje cílové okno přes studio_id.

U všeho, co je větší než jeden skript, si nejdřív řekněte o plán. V režimu plan (stiskněte Shift+Tab nebo začněte prompt /plan) Claude zkoumá a navrhuje, aniž by upravoval vaše soubory. Anthropic popisuje režim plan pomocí úprav souborů a příkazů shellu, proto pravidla ask pro nástroje Studia také ponechte.

Krok 5: pracujte se skripty jako se soubory přes Script Sync nebo Rojo

Claude Code je postavený kolem souborů ve složce. Upravuje je svými nástroji, Git uchovává jejich historii a /rewind je umí obnovit. Když skripty uložíte na disk, můžete tohle všechno využít a nástroje MCP zůstanou pro části place, které nejsou skripty, například GUI ve StarterGui, RemoteEvent a party. Roblox dokumentuje dva způsoby, jak to udělat.

Script Sync a Rojo podle stránek Robloxu o Script Sync a nástrojích třetích stran
Script SyncRojo
Co to jeFunkce Studia, která synchronizuje skripty v place se soubory na disku, oběma směry.Nástroj třetí strany: server na vašem počítači plus plugin pro Studio.
Co synchronizujeJen objekty Script, LocalScript, ModuleScript a Folder. Ostatní objekty v synchronizované složce ignoruje.Může vést celý projekt jako soubory, kde zdrojem pravdy je váš souborový systém.
NastaveníKlikněte pravým tlačítkem na službu nebo složku v Exploreru, vyberte Sync to… a zvolte složku. Návod Robloxu ke coding harness ho nejdřív zapíná v File > Beta Features.Nainstalujte ho přes Rokit (rokit add rojo-rbx/rojo, pak rokit install), přidejte plugin příkazem rojo plugin install, spusťte rojo serve a připojte se z pluginu.
Team CreateFunguje s ním. Vyhněte se situaci, kdy dva lidé současně upravují stejný synchronizovaný skript.Roblox upozorňuje, že nástroje třetích stran často nefungují s jeho vestavěnými nástroji pro spolupráci.
Rada RobloxuHodí se, pokud chcete vlastní editor a správu verzí pro kód a Studio pro všechno ostatní.Nejlepší volba, pokud chcete mít ve správě verzí celý projekt, ne jen kód.

Stejný název souboru může znamenat něco jiného

Oba nástroje určují typ skriptu podle názvu souboru a jejich přípony se neshodují. Soubor .client je v Rojo LocalScript, ale ve Script Sync je to Script s kontextem spuštění Client. Řekněte Claude, který nástroj váš projekt používá; příklad CLAUDE.md níže to dělá.

Pravidla Script Sync ze stránky Robloxu o Script Sync (soubory .luau). Pravidla Rojo ze stránky Sync Details pro Rojo v7, kde jsou uvedené soubory .lua
Název souboru končí naScript Sync vytvoříRojo vytvoří
.serverScript s kontextem spuštění ServerScript
.clientScript s kontextem spuštění ClientLocalScript
.localLocalScriptZvláštní význam nemá (každý jiný soubor .lua je ModuleScript)
Bez příponyModuleScriptModuleScript
Složka se souborem initSkript s podřízenými objekty, jehož typ určuje název souboru initSložka se stane skriptem, který popisuje init.server.lua, init.client.lua nebo init.lua

Nastavení Script Sync pro Claude Code

  1. Vytvořte složku projektu s jednou složkou pro každou službu, kterou chcete mít na disku, například ServerScriptService, ReplicatedStorage a StarterPlayerScripts, a spusťte v ní git init.
  2. Pokud se Script Sync po kliknutí pravým tlačítkem na službu neobjeví, zapněte ho v File > Beta Features, klikněte na Save a restartujte Studio.
  3. V Exploreru klikněte pravým tlačítkem na ServerScriptService, vyberte Script Sync > Sync to a zvolte složku projektu na nejvyšší úrovni, ne složku uvnitř ní. Zopakujte pro ostatní služby.
  4. Spusťte v této složce claude. Teď Claude upravuje soubory .luau a Studio každou změnu načte.
  5. Před každou relací udělejte commit, abyste vždy měli čistý bod, ke kterému se můžete vrátit.
Terminál, ve složce projektu
git add .
git commit -m "Before Claude session"

Dvě pravidla Script Sync jsou s agentem důležitější. Nesynchronizujte skripty, které mají atributy nebo tagy: Script Sync je ignoruje a Roblox varuje, že to může vést ke ztrátě dat. A pokud se soubory změní, když je Studio zavřené, Studio se při novém otevření place zeptá, jak konflikt vyřešit, a vypíše, co Keep Studio a Keep Disk přidají, změní nebo smažou. Než vyberete, ten seznam si přečtěte.

Se zapnutým Script Sync se úprava souboru dostane do Studia hned po uložení. Přijmout úpravu v Claude Code znamená přijmout ji do svého place, proto kontrolujte dřív, než přijmete, hlavně v režimech, které úpravy přijímají automaticky.

Pro automatické doplňování a chyby typů v editoru Roblox doporučuje rozšíření Luau Language Server s jeho doprovodným pluginem pro Studio. Ve VS Code umí rozšíření Claude Code číst panel Problems přes vestavěný nástroj, takže Claude vidí stejná varování jako vy.

Krok 6: dejte Claude svá pravidla pro Roblox v CLAUDE.md

Každá relace Claude Code začíná s čistým kontextem. Soubor CLAUDE.md ve složce projektu se čte na začátku každé relace, takže vaše konvence patří do něj. Spusťte /init a Claude ho načrtne, nebo ho napište sami. Anthropic radí držet ho kratší než 200 řádků, psát pravidla dost konkrétně, aby se dala ověřit, a spustit /context, abyste ověřili, že se načetl.

Tento příklad je napsaný pro tento návod, pro projekt se Script Sync. Změňte názvy podle své hry a odeberte, co nepotřebujete.

CLAUDE.md · příklad pro projekt se 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.

Některé řádky tam jsou kvůli tomu, jak nástroje fungují. Pravidla názvů souborů tam jsou proto, že .client.luau ve Script Sync není LocalScript. Řádek o list_roblox_studios tam je proto, že server dosáhne ke každému otevřenému oknu. Řádek o assetech tam je proto, že insert_asset vkládá do place externí obsah a upload_image posílá obrázky na server assetů Robloxu. Řádek o wait vychází z referenční příručky API Robloxu, která označuje wait, spawn a delay jako zastaralé ve prospěch knihovny task.

Pokud váš projekt už má AGENTS.md pro jiné agenty pro kód, Claude Code ho umí číst jako instrukce projektu, takže můžete mít jeden soubor pro oba. Stránka Anthropic o paměti vysvětluje, který soubor vyhrává, když existují oba.

Jak tato pravidla vypadají v kódu

Tady je serverový skript, který dodržuje pravidla Luau výše. Je napsaný ručně pro tento návod, ne vygenerovaný Claude. Používejte ho jako měřítko, když kontrolujete, co Claude vrací. LocalScript žádá o nástroj přes RequestTool:FireServer("Sword") a server všechno ověří.

Script v ServerScriptService s názvem 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 synchronizuje jen skripty a složky, proto si server svůj remote vytvoří sám.
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)
	-- Ignorujeme požadavek, který přišel poté, co hráč odešel.
	if player.Parent ~= Players then
		return
	end

	-- 1. Kontrolujeme argument: klient může poslat cokoli.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Omezujeme, jak často může jeden hráč žádat.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Rozhoduje server. Sem přidejte vlastní kontrolu vlastnictví (gamepass, záznam o nákupu).
	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. Úklid dat hráče.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Na disku se Script Sync: ServerScriptService/ToolRequests.server.luau. Objekty Tool dejte do Folder s názvem Tools v ServerStorage. Dokud nepřidáte kontrolu vlastnictví, každý hráč může dostat jakýkoli nástroj z této složky.

Totéž hledejte v každém handleru remote, který Claude napíše: ověřuje typ a velikost toho, co poslal klient, omezuje, jak často ho jeden hráč může volat, rozhodnutí dělá server a záznam hráče se smaže, když hráč odejde. Návod k RemoteEvent vysvětluje, proč je každý bod důležitý.

Bezpečný způsob práce: kontrolní bod, kontrola, playtest

  1. Udělejte kontrolní bod na obou stranách. Commitněte soubory do Gitu a uložte verzi place ve Studiu přes File > Save to Roblox with Notes. Návod ke Studio MCP ukazuje, jak ji obnovit z Version History.
  2. Žádejte o plán u všeho, co je větší než jeden skript, a přečtěte si ho, než ho schválíte.
  3. Kontrolujte diff. U souborů si před přijetím přečtěte git diff nebo vestavěné diffy v rozšíření. U změn provedených ve Studiu si přečtěte skripty, na které Claude sáhl, a zkontrolujte v Exploreru objekty, které se objevily nebo zmizely.
  4. Testujte sami. Claude umí spustit playtest a přečíst Output, ale kontroluje jen to, co se sám rozhodl kontrolovat. Než commitnete nebo publikujete, zahrajte si funkci tak, jak by ji hrál hráč.
  5. Udělejte commit, když všechno funguje, se zprávou o tom, co se změnilo.

Co /rewind vrátit umí a co ne

Claude Code uloží kontrolní bod před každým promptem a /rewind (nebo dvakrát Esc) obnoví soubory, které Claude změnil svými nástroji pro úpravu souborů. Anthropic uvádí, co nesleduje, včetně změn provedených příkazy shellu. Změny provedené ve Studiu přes nástroje MCP nejsou úpravy souborů, takže nečekejte, že je /rewind vrátí, a stránka Robloxu o MCP neuvádí, jestli se dostanou do historie vracení ve Studiu. Se Script Sync se soubor, který /rewind obnovil, synchronizuje zpět do Studia jako každá jiná změna na disku. Pro všechno ostatní je cestou zpět uložená verze.

Tajné údaje a živá data držte mimo dosah

  • Nevkládejte API klíče, klíče Open Cloud, URL webhooků ani hesla do promptu nebo do CLAUDE.md. Obojí je text, který Claude čte, a CLAUDE.md se obvykle commituje do repozitáře.
  • Ani je nezapisujte napevno do skriptů. Roblox má úložiště tajných údajů pro každou hru: vytvořte tajné údaje v Creator Dashboard a čtěte je v serverovém skriptu přes HttpService:GetSecret(). Pro lokální playtesty přidejte lokální tajné údaje v File > Experience Settings > Security.
  • Osobní nastavení držte v .claude/settings.local.json a CLAUDE.local.md, které jsou navržené tak, aby zůstaly mimo Git. CLAUDE.local.md si do .gitignore přidejte sami.
  • Zapínejte Enable Studio Access to API Services jen v samostatné testovací kopii hry. Roblox varuje, že Studio používá stejná úložiště dat jako živá hra, takže playtest, který tam Claude spustí, může přepsat skutečná data hráčů.
  • Než nainstalujete skill od třetí strany, přečtěte si ho. Katalogy skills obsahují skills pro Roblox pro Claude Code a Anthropic upozorňuje, že skill si může přes pole allowed-tools přidělit široký přístup k nástrojům.

Kolik stojí Claude Code pro práci s Robloxem

Strana Studia nemá zdokumentovanou cenu: MCP server je součástí Studia a stránka Robloxu o MCP žádný poplatek nezmiňuje. Cena je cena Claude Code a Anthropic nabízí dva způsoby placení (k 9. říjnu 2026):

  • Předplatné Claude. Claude Code je součástí Pro, Max, Team a Enterprise, ale ne Free. Spotřebovává stejný limit využití jako Claude na webu, na desktopu a v mobilu. Limity se obnovují v klouzavém pětihodinovém okně a placené plány mají navíc týdenní limity. Když jeden z nich vyčerpáte, můžete počkat, přejít na vyšší plán nebo zapnout kredity na využití.
  • Účet Claude Console. Platíte za využití API podle objemu zpracovaného textu. Stránka Anthropic o nákladech uvádí, že útrata silně závisí na volbě modelu, velikosti kódové základny a na tom, jak ho používáte.

Aktuální ceny najdete na claude.com/pricing. Tento návod je neopakuje, protože se mění. Uvnitř Claude Code příkaz /usage ukazuje předplatitelům ukazatele využití plánu a uživatelům API přibližnou cenu relace.

Co v relaci s Robloxem spotřebuje víc

  • Velikost kontextu. Spotřeba roste s tím, co má Claude v kontextu. Mezi nesouvisejícími úkoly používejte /clear.
  • Velké výsledky nástrojů. Procházení celého stromu hry ve velkém place nebo čtení dlouhých skriptů celých vrací hodně textu. Claude Code počítá text v jednotkách, kterými ho měří model: upozorní, když výsledek nástroje MCP přesáhne 10 000 takových jednotek, a ve výchozím stavu ho omezí na 25 000. Žádejte místo toho jednu složku, omezení hloubky nebo rozsah řádků: search_game_tree i script_read to podporují.
  • Volba modelu. Anthropic píše, že Sonnet zvládá většinu úkolů s kódem dobře a stojí méně než Opus. Přepínáte přes /model.

Řešení problémů s Claude Code a Studiem

Vlastní kontrolní seznam Robloxu je krátký: restartovat Studio i klienta, ověřit, že cesta k příkazu existuje, a zkontrolovat JSON. Tady jsou případy typické právě pro Claude Code.

Claude Code není v seznamu Quick connect

Seznam ukazuje jen podporované klienty nainstalované na vašem počítači. Nainstalujte Claude Code a pak restartujte Studio. Pokud jste ho instalovali s otevřeným Studiem, restartujte Studio, Claude Code nebo obojí. Soubor .mcp.json z kroku 2 funguje i bez quick connect.

/mcp neukazuje server Roblox Studio

Po přidání serveru restartujte Claude Code. Pak zkontrolujte, kam byl přidán: server přidaný bez --scope se načte jen ve složce, kde jste ho přidali, takže spouštějte claude z této složky, nebo ho přidejte znovu s --scope user. Ve VS Code začněte novou konverzaci, protože změny platí pro konverzace začaté po nich.

Server ukazuje Pending approval

Pochází ze souboru .mcp.json a Claude Code se před použitím takových serverů ptá. Spusťte v této složce claude, přijměte dialog důvěry k pracovní složce a server schvalte. claude mcp reset-project-choices vynuluje dřívější rozhodnutí.

Server ukazuje Failed to connect

Spusťte claude mcp get Roblox_Studio a přečtěte si řádek Issue:. Ověřte, že soubor existuje: %LOCALAPPDATA%\Roblox\mcp.bat na Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP na macOS (změňte cestu, pokud je Studio nainstalované jinde). Ujistěte se, že Enable Studio as MCP server je pořád zapnuté, a pak restartujte Studio i Claude Code.

Terminál hlásí, že claude nebyl rozpoznán

Po instalaci otevřete nové okno terminálu. Pokud příkaz pořád nebyl nalezen, instalační složka není v PATH; řešení najdete na stránce Anthropic o problémech s instalací. Rozšíření pro VS Code nepřidává claude do PATH, takže pro příkazy z tohoto návodu nainstalujte verzi pro terminál zvlášť.

Claude změnil jiný place

Při několika otevřených oknech Studia každé volání nástroje určuje cíl přes studio_id. Požádejte Claude, ať zavolá list_roblox_studios, a řekněte, který place chcete, zavřete okna, která nepoužíváte, a změněný place obnovte z Version History.

Claude Code účtuje z mého API klíče, a ne z plánu

Jakmile ji schválíte, proměnná prostředí ANTHROPIC_API_KEY má přednost před předplatným. Odstraňte proměnnou (nebo vypněte Use custom API key v /config), spusťte Claude Code znovu a spusťte /status, abyste ověřili, které přihlášení je aktivní. Pokud je to pořád účet Console, spusťte /login a vyberte svůj účet Claude.

Cloudová relace nevidí Studio

Cloudové relace běží v infrastruktuře Anthropic, ne na vašem počítači, takže k lokálnímu serveru Studia nedosáhnou. Použijte terminál, rozšíření pro editor nebo desktopovou aplikaci se zvoleným Local.

Nebo místo toho vezměte agenta v pluginu: RoCode

Claude Code s MCP se hodí těm, komu vyhovuje terminál nebo editor kódu. RoCode (RoCode.app) je jiná cesta: nezávislý AI agent pro Roblox Studio s webovým chatem na rocode.app a pluginem zdarma z Creator Store, který provádí kroky ve vašem otevřeném place. Není to produkt MCP a nepoužívá MCP server Studia, takže není co nastavovat: žádný příkazový řádek, konfigurační soubor ani MCP server. Plugin se připojí sám, pokud je Studio přihlášené do stejného účtu Roblox, který používáte v RoCode; jinak chat a plugin jednou propojíte 8místným kódem zobrazeným v panelu pluginu.

Co je dobré vědět před přechodem. RoCode nemůže připojit předplatné Claude ani Claude Code. Spouští modely třetích stran přes OpenRouter, včetně Claude Sonnet 5.5 na Pro a vyšších a Claude Opus 5.5 na Studio a vyšších, a plán zdarma Starter dává 1 kredit denně na GPT-6 Luna. Pracuje z režimu úprav. S pluginem 3.9 nebo novějším v režimu Build může spustit krátký playtest a přečíst chyby a s pluginem 3.9.11 nebo novějším ovládat testovací postavu, aby ověřil, že hra funguje. S pluginem 3.9.14 nebo novějším navíc pořizuje snímky toho, co postavil, v režimu úprav, a může opravit to, co vypadá špatně. Nespouští kód přímo a negeneruje meshe, zatímco nástroje Studio MCP umí obojí. Umí hledat modely zdarma v Creator Store podle vašich slov (skripty uvnitř se odstraní) nebo vložit model, decal či mesh podle ID assetu a dekorace, budovy a rekvizity vymýšlí pro každou hru znovu. Jeho režim Ask odpovídá na otázky o vašem place nástroji jen pro čtení a nic nemění. Účty jsou pro lidi od 13 let, do 18 let se svolením rodiče nebo zákonného zástupce.

Napíšete

Přidej RemoteEvent, aby si hráči mohli vyžádat nástroj z ServerStorage.Tools. Všechno kontroluj na serveru.

RoCode udělá
  • Může si nejdřív prohlédnout place přes Search Game a List Children, aby našel složku Tools a skripty, které už nástroje rozdávají
  • Napíše serverový skript přes Create Script a může přidat RemoteEvent přes Create Instance
  • Před dokončením ověří kompilaci skriptu ve Studiu přes Check Script. Je to kontrola kompilace, ne kontrola typů ani playtest
  • Posílá změny po dávkách a každá dávka je bod pro vrácení v historii samotného Studia

S pluginem 3.9 nebo novějším může RoCode spustit krátký playtest a přečíst chyby a s pluginem 3.9.15 nebo novějším jeho testovací postava umí chodit, mačkat klávesy a klikat na tlačítka na obrazovce, ale kontroluje jen to, co se sám rozhodl kontrolovat, proto klikněte na Play sami a ověřte výsledek jako hráč. Prompt je ukázka, kterou jsme napsali my; v krocích jsou skutečné názvy nástrojů. Jak fungují plugin a párování. RoCode je nezávislý produkt, není spojen se společností Roblox Corporation, není jí schválen ani sponzorován.

Časté otázky

Můžu místo Claude Code použít Claude Desktop?

Ano. Claude Desktop je v seznamu Quick connect v panelu Manage MCP Servers ve Studiu, takže se připojí jedním přepínačem, na Windows i Macu. Používá stejné nástroje Studia; Claude Code přidává to, co dobře umí agent v terminálu, například práci se soubory skriptů a Gitem. Kroky pro oba najdete v návodu k nastavení Studio MCP.

Může se Claude Code připojit k Roblox Studiu?

Ano. Roblox uvádí Claude Code jako klienta quick connect pro MCP server vestavěný ve Studiu. Zapněte Enable Studio as MCP server v Assistant > … > Manage MCP Servers, zapněte Claude Code v seznamu Quick connect a restartujte Claude Code. Umí také pracovat s vašimi skripty jako se soubory přes Script Sync nebo Rojo.

Je Claude Code pro práci s Roblox Studiem zdarma?

MCP server Studia nemá zdokumentovanou cenu, ale Claude Code není součástí plánu Free od Anthropic (claude.com/pricing, ověřeno 9. října 2026). Potřebujete placený plán Claude, kde sdílí limity využití vašeho plánu, nebo účet Claude Console s platbou za využití API.

Potřebuju k používání Claude Code plugin Robloxu nebo HTTP požadavky?

Pro vestavěný MCP server Studia ne. Kroky nastavení od Robloxu jsou zapnout server v Assistant a připojit klienta; nemají žádný plugin k instalaci ani nastavení HTTP, které by se muselo měnit. Některé starší návody popisují MCP servery od komunity, které fungují jinak. Rojo, pokud si ho zvolíte pro soubory, používá vlastní plugin pro Studio.

Může Claude Code testovat moji hru v Robloxu?

Přes nástroje Studio MCP ano. start_stop_play spouští a zastavuje playtest, get_console_output čte Output, screen_capture snímá viewport a nástroje pro vstup hýbou postavou a posílají klávesy a kliknutí. Kontrolujte, o čem podává zprávu, a před publikováním si hru zahrajte sami.

Co vybrat pro Roblox Studio: Claude Code, nebo Codex?

Oba jsou v seznamu quick connect od Robloxu a dosáhnou ke stejným nástrojům Studio MCP, takže rozdíl je v modelu, účtu a klientovi kolem něj. Roblox srovnání nezveřejňuje a my jsme jejich srovnávací testy nedělali. Vyzkoušejte každý na kopii svého place se stejnými písemnými pravidly a nechte si ten, jehož změny potřebují méně oprav.

Funguje Claude Code s Roblox Studiem na Macu?

Ano. Claude Code podporuje macOS 13.0 nebo novější a Roblox dokumentuje cestu k serveru pro macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, pro klienty, které nastavujete ručně.

Zdroje a další čtení

Jak byl kód ověřen: každý skript na této stránce prochází přísnou kontrolou typů Luau s definicemi Roblox API (luau-lsp, 20. listopadu 2026). Kontrola typů zachytí chyby v názvech API a špatné typy, ale ne chyby v herní logice, proto vše otestujte ve Studiu před publikováním.

Vyzkoušejte RoCode ve své hře.

Kredity zdarma každý den, bez karty. Nainstalujte plugin, popište funkci a podívejte se, co se objeví ve Studiu.