Poradnik · AI w Roblox Studio

Jak podłączyć Claude Code do Roblox Studio

Claude Code to agentowe narzędzie Anthropic do pisania kodu. Roblox wymienia je jako klienta quick connect dla serwera MCP wbudowanego w Studio, więc może czytać twoją grę, edytować skrypty i uruchamiać playtesty w otwartym oknie Studio. Może też pracować z twoimi skryptami jak z plikami przez Script Sync albo Rojo. Ten poradnik dotyczy strony Claude Code: czego potrzebujesz, jak go podłączyć, uprawnienia, CLAUDE.md z zasadami dla Roblox, bezpieczny sposób pracy i ile to kosztuje. O agencie OpenAI zobacz poradnik jak używać OpenAI Codex z Roblox Studio (po angielsku); o Cursor, Claude Desktop i innych klientach zobacz poradnik o konfiguracji Studio MCP.

Zaktualizowano 20 listopada 202620 min czytaniaAutor:

W skrócie

Zainstaluj Claude Code i zaloguj się płatnym planem Claude albo kontem Claude Console. W Studio otwórz Assistant, kliknij … > Manage MCP Servers, włącz Enable Studio as MCP server, potem włącz Claude Code na liście Quick connect. Uruchom Claude Code ponownie, wpisz /mcp, żeby sprawdzić, czy serwer Studio jest podłączony, i zacznij od zapytania, które tylko czyta.

  • Claude Code nie ma w planie Free od Anthropic. Wchodzi w Pro, Max, Team i Enterprise albo jest opłacany według użycia API przez konto Claude Console (sprawdzone 9 października 2026 roku).
  • Używaj sesji lokalnej: terminala, rozszerzenia do VS Code albo Cursor albo aplikacji desktopowej z wybranym Local. Sesje w chmurze nie działają na twoim komputerze i nie sięgają do Studio.
  • Od v2.1.283 sesje w terminalu i VS Code domyślnie startują w trybie auto tam, gdzie jest dostępny, więc dodaj reguły ask dla narzędzi Studio, które zmieniają grę. Komenda /rewind w Claude Code nie cofa zmian zrobionych w Studio, więc najpierw zapisz wersję.
Na tej stronie
  1. Czego potrzebujesz
  2. 1. Instalacja i logowanie
  3. 2. Podłączenie do Studio
  4. 3. Uprawnienia
  5. 4. Pierwsze zapytanie
  6. 5. Script Sync albo Rojo
  7. 6. CLAUDE.md
  8. Bezpieczna praca
  9. Koszt
  10. Rozwiązywanie problemów
  11. Agent-plugin
  12. Najczęstsze pytania
  13. Źródła i dalsza lektura

Czego potrzebujesz na start

Wymagania według dokumentacji Roblox i Anthropic, 9 października 2026 roku
Czego potrzebujeszSzczegóły
Roblox StudioNajnowsza wersja, na Windowsie albo macOS. Serwer MCP jest wbudowany w Studio, więc po stronie Roblox nie trzeba niczego więcej instalować.
Komputer, który obsługuje Claude CodemacOS 13.0 lub nowszy albo Windows 10 1809 lub nowszy, od 4 GB pamięci RAM, połączenie z internetem i lokalizacja w kraju, który obsługuje Anthropic.
Konto Claude, w które wchodzi Claude CodePłatny plan Claude (Pro, Max, Team albo Enterprise) albo konto Claude Console. Na stronie cennika Anthropic podano, że Claude Code nie wchodzi w plan Free.
WiekW Consumer Terms od Anthropic (obowiązują od 8 października 2025 roku) napisano, że musisz mieć co najmniej 18 lat albo minimalny wiek zgody w twoim kraju, jeśli jest wyższy.
OpcjonalnieGit, żeby przechowywać historię skryptów. Visual Studio Code 1.94.0 lub nowszy albo Cursor, jeśli chcesz mieć Claude Code w panelu edytora, a nie w terminalu.

Którego Claude Code użyć

Claude Code działa w kilku miejscach. Anthropic pisze, że wszystkie mają ten sam silnik, więc twoje CLAUDE.md, ustawienia i serwery MCP działają wszędzie. Dla Studio ważne jest, gdzie działa sesja: serwer MCP Roblox to lokalny proces na twoim komputerze, więc i sesja musi być na twoim komputerze.

Warianty Claude Code i Roblox Studio
WariantSięga do Studio?Uwagi
Terminal (komenda claude)TakUruchamiaj go w folderze projektu. Jest też potrzebny do komend claude mcp niżej.
Rozszerzenie do VS Code albo CursorTakDroga z poradnika Roblox o coding harness. Rozszerzenie ma własną kopię Claude Code, ale nie dodaje claude do PATH, więc jeśli tych komend potrzebujesz, zainstaluj też wersję terminalową.
Aplikacja desktopowa, karta Code, z wybranym LocalTakDziała na twoim komputerze. Anthropic pisze, że potrzebna jest płatna subskrypcja.
Sesje w chmurze (claude.ai/code albo Cloud w aplikacji desktopowej)NieDziałają w infrastrukturze chmurowej, a nie na twoim komputerze, więc nie mogą uruchomić lokalnego serwera Studio.

Krok 1: zainstaluj Claude Code i zaloguj się

Anthropic zaleca instalację jedną komendą w terminalu. To komendy, które były na jego stronie instalacji 9 października 2026 roku; aktualne znajdziesz na stronie instalacji Anthropic.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Otwórz nowe okno terminala i wykonaj claude --version. Numer wersji oznacza, że wszystko się udało. Jeśli komenda nie została znaleziona, folder instalacji nie jest jeszcze w PATH, a rozwiązanie jest na stronie Anthropic o problemach z instalacją.
  2. Przejdź do folderu projektu i wykonaj claude. Przy pierwszym uruchomieniu otwiera okno przeglądarki do logowania. Jeśli przeglądarka się nie otworzyła, naciśnij c, żeby skopiować link logowania.
  3. Zaloguj się na swoje konto Claude. Logowanie z Pro albo Max korzysta z limitów zawartych w twoim planie.

Na Windowsie Anthropic zaleca zainstalowanie Git for Windows, żeby Claude Code mógł używać swojego narzędzia Bash; bez niego Claude Code wykonuje komendy w PowerShell. Do tej konfiguracji instaluj Claude Code w samym Windowsie, a nie w WSL: konfiguracja Roblox dla Windowsa uruchamia cmd.exe ze ścieżką %LOCALAPPDATA%, a WSL Roblox nie dokumentuje.

Wolisz panel w edytorze? W VS Code albo Cursor otwórz Extensions (Ctrl+Shift+X albo Cmd+Shift+X na Macu), znajdź Claude Code, zainstaluj go i zaloguj się z panelu Claude. Właśnie takiej konfiguracji używa poradnik Roblox o coding harness.

Krok 2: podłącz Claude Code do Studio

Najpierw włącz serwer. W Studio otwórz Assistant, kliknij … > Manage MCP Servers i włącz Enable Studio as MCP server. Poradnik o Studio MCP omawia ten krok dokładniej. Nie ma przycisku Assistant? Zobacz jak otworzyć panel Assistant.

Quick connect

  1. W tym samym panelu (Assistant Settings > MCP Servers) rozwiń listę Quick connect. Są na niej obsługiwani klienci zainstalowani na twoim komputerze.
  2. Włącz Claude Code. Jeśli go nie ma, zainstaluj Claude Code i uruchom Studio ponownie.
  3. Uruchom Claude Code ponownie: zakończ sesję i znowu wykonaj claude albo zacznij nową rozmowę w rozszerzeniu. Roblox pisze, że klient musi się zrestartować, żeby wczytać nową konfigurację.

Roblox nie mówi, do którego pliku Claude Code zapisuje quick connect ani jak nazywa serwer. Wpisz /mcp w Claude Code, żeby zobaczyć nazwę. Będzie potrzebna do reguł uprawnień w kroku 3.

Korzystasz z rozszerzenia Claude Code w VS Code albo Cursor? Tutaj też włącz Claude Code. Poradnik Roblox o coding harness włącza Cursor albo Visual Studio Code, ale Anthropic dokumentuje, że rozszerzenie dzieli konfigurację MCP z terminalową wersją Claude Code, i nie mówi, że czyta własne ustawienia MCP edytora.

Ręczna konfiguracja przez plik .mcp.json

Jeśli quick connect u ciebie nie działa, dodaj Studio sam. Claude Code czyta serwery MCP projektu z pliku o nazwie .mcp.json w folderze projektu, w tym samym formacie mcpServers, który dokumentuje Roblox, i traktuje wpis bez type jako lokalny serwer stdio. Dlatego konfiguracja Roblox działa bez zmian. Zapisz wariant dla swojego systemu jako .mcp.json w folderze, w którym uruchamiasz claude:

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

Gdy następnym razem uruchomisz claude w tym folderze, poprosi o zatwierdzenie serwera: Anthropic pokazuje to pytanie dla każdego serwera, który pochodzi z pliku .mcp.json. Anthropic pomyślał ten plik tak, żeby commitował go i dzielił cały zespół, ale ścieżki dla Windowsa i macOS są różne. Jeśli w twoim zespole są oba systemy, trzymaj plik poza repozytorium i niech każdy doda Studio sobie sam.

Na macOS możesz zamiast tego dodać Studio jedną komendą. --scope user udostępnia go w każdym projekcie na twoim komputerze; bez tego serwer wczytuje się tylko w bieżącym folderze. -- oddziela własne parametry Claude Code od komendy, która uruchamia serwer.

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

Na Windowsie prostsza jest droga z plikiem JSON, bo PowerShell i CMD inaczej obsługują %LOCALAPPDATA% w linii komend.

Sprawdź połączenie

  • W terminalu claude mcp list pokazuje każdy serwer i jego status. claude mcp get Roblox_Studio pokazuje więcej, łącznie z linią Issue:, jeśli serwer nie mógł się połączyć.
  • W Claude Code wpisz /mcp. Przy podłączonych serwerach obok nazwy jest pokazana liczba narzędzi.
  • W Studio Assistant > … > Manage MCP Servers pokazuje zielony wskaźnik z liczbą podłączonych klientów.

Krok 3: zdecyduj, co Claude może robić bez pytania

Ustaw to, zanim Claude dotknie twojej gry. Według strony Anthropic o trybach uprawnień od Claude Code v2.1.283 interaktywne sesje w terminalu i VS Code domyślnie startują w trybie auto wszędzie, gdzie jest dostępny, a w trybie auto działania zamiast ciebie sprawdza klasyfikator w tle. Wtedy wywołanie MCP, które edytuje skrypt albo wykonuje Luau w Studio, może przejść bez pytania.

Są dwa sposoby, żeby każda zmiana została w twoich rękach:

  • Uruchamiaj w trybie Manual. Wykonaj claude --permission-mode default. W trybie Manual bez pytania wykonuje się tylko czytanie. Naciskaj Shift+Tab w trakcie sesji, żeby przełączać tryby.
  • Dodaj reguły ask dla narzędzi Studio, które coś zmieniają. Anthropic pisze, że żaden tryb nie zatwierdza automatycznie narzędzia objętego jawną regułą ask, nawet tryb bypass.
.claude/settings.json · przykład
{
  "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"
    ]
  }
}

Reguły MCP mają postać mcp__<server>__<tool>, z nazwą serwera taką, jaką zna Claude Code. Zamień Roblox_Studio na nazwę, którą pokazuje /mcp. Reguły allow w pliku projektu .claude/settings.json zaczynają działać dopiero po zaakceptowaniu okna zaufania do folderu roboczego dla tego folderu. Dla reguł, które są potrzebne tylko tobie, używaj .claude/settings.local.json.

Lista allow obejmuje narzędzia, które tylko czytają: drzewo gry, właściwości, skrypty, Output i listę otwartych okien Studio. Lista ask obejmuje narzędzia, które zmieniają grę, wykonują kod, uruchamiają playtesty, wnoszą zewnętrzne assety albo wysyłają obrazy do Roblox. Narzędzia, których nie ma na żadnej liście, na przykład screen_capture i narzędzia wejścia, podlegają twojemu trybowi uprawnień. Pełna lista narzędzi z opisem każdego jest w poradniku o Studio MCP.

Krok 4: zacznij od zapytania, które tylko czyta

Otwórz grę, z którą chcesz pracować, i zamknij te, z którymi nie chcesz. Potem daj Claude pierwsze zapytanie, które niczego nie może zmienić:

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 świeżym Baseplate poradnik Roblox o coding harness oczekuje, że odpowiedź wymieni standardowe Camera, Terrain, Baseplate i SpawnLocation. Proszenie najpierw o list_roblox_studios to dobry nawyk: jeden klient sięga do każdego otwartego okna Studio, a każde wywołanie narzędzia wskazuje okno docelowe przez studio_id.

Przy wszystkim większym niż jeden skrypt najpierw poproś o plan. W trybie plan (naciśnij Shift+Tab albo zacznij prompt od /plan) Claude bada i proponuje, nie edytując twoich plików. Anthropic opisuje tryb plan w kategoriach edycji plików i komend powłoki, więc reguły ask dla narzędzi Studio też zostaw.

Krok 5: pracuj ze skryptami jak z plikami przez Script Sync albo Rojo

Claude Code jest zbudowany wokół plików w folderze. Edytuje je swoimi narzędziami, Git przechowuje ich historię, a /rewind może je przywrócić. Jeśli położysz skrypty na dysku, możesz z tego wszystkiego korzystać, a narzędzia MCP zostają dla tych części gry, które nie są skryptami, na przykład GUI w StarterGui, RemoteEvent i partów. Roblox dokumentuje dwa sposoby, żeby to zrobić.

Script Sync i Rojo według stron Roblox o Script Sync i narzędziach zewnętrznych
Script SyncRojo
Co to jestFunkcja Studio, która synchronizuje skrypty w grze z plikami na dysku, w obie strony.Zewnętrzne narzędzie: serwer na twoim komputerze plus plugin do Studio.
Co synchronizujeTylko obiekty Script, LocalScript, ModuleScript i Folder. Pozostałe obiekty w synchronizowanym folderze są ignorowane.Może prowadzić cały projekt jako pliki, gdzie źródłem prawdy jest twój system plików.
KonfiguracjaKliknij prawym przyciskiem serwis albo folder w Explorerze, wybierz Sync to… i wskaż folder. Poradnik Roblox o coding harness najpierw włącza go w File > Beta Features.Zainstaluj go przez Rokit (rokit add rojo-rbx/rojo, potem rokit install), dodaj plugin komendą rojo plugin install, wykonaj rojo serve i połącz się z pluginu.
Team CreateDziała z nim. Unikaj sytuacji, w której dwie osoby naraz edytują ten sam synchronizowany skrypt.Roblox zaznacza, że zewnętrzne narzędzia często nie działają z jego wbudowanymi narzędziami do współpracy.
Rada RobloxDobrze pasuje, jeśli chcesz własnego edytora i kontroli wersji dla kodu, a Studio do wszystkiego innego.Najlepszy wybór, jeśli chcesz trzymać w kontroli wersji cały projekt, a nie tylko kod.

Ta sama nazwa pliku może znaczyć co innego

Oba narzędzia wybierają typ skryptu według nazwy pliku, a ich sufiksy się nie pokrywają. Plik .client to LocalScript w Rojo, ale Script z kontekstem wykonania Client w Script Sync. Powiedz Claude, którego narzędzia używa twój projekt; przykładowy CLAUDE.md niżej to robi.

Zasady Script Sync ze strony Roblox o Script Sync (pliki .luau). Zasady Rojo ze strony Sync Details dla Rojo v7, gdzie wymienione są pliki .lua
Nazwa pliku kończy się naScript Sync tworzyRojo tworzy
.serverScript z kontekstem wykonania ServerScript
.clientScript z kontekstem wykonania ClientLocalScript
.localLocalScriptBez szczególnego znaczenia (każdy inny plik .lua to ModuleScript)
Bez sufiksuModuleScriptModuleScript
Folder z plikiem initSkrypt z dziećmi, którego typ ustala nazwa pliku initFolder staje się skryptem, który opisuje init.server.lua, init.client.lua albo init.lua

Konfiguracja Script Sync dla Claude Code

  1. Utwórz folder projektu z jednym folderem na każdy serwis, który chcesz trzymać na dysku, na przykład ServerScriptService, ReplicatedStorage i StarterPlayerScripts, i wykonaj w nim git init.
  2. Jeśli Script Sync nie pojawia się, gdy klikasz prawym przyciskiem serwis, włącz go w File > Beta Features, kliknij Save i uruchom Studio ponownie.
  3. W Explorerze kliknij prawym przyciskiem ServerScriptService, wybierz Script Sync > Sync to i wskaż folder projektu najwyższego poziomu, a nie folder w nim. Powtórz dla pozostałych serwisów.
  4. Wykonaj claude w tym folderze. Teraz Claude edytuje pliki .luau, a Studio wczytuje każdą zmianę.
  5. Rób commit przed każdą sesją, żeby zawsze był czysty punkt, do którego można wrócić.
Terminal, w folderze projektu
git add .
git commit -m "Before Claude session"

Dwie zasady Script Sync z agentem stają się ważniejsze. Nie synchronizuj skryptów, które mają atrybuty albo tagi: Script Sync je ignoruje, a Roblox ostrzega, że może to doprowadzić do utraty danych. A jeśli pliki zmieniają się, gdy Studio jest zamknięte, przy ponownym otwarciu gry Studio pyta, jak to rozwiązać, i wymienia, co Keep Studio i Keep Disk dodadzą, zmienią albo usuną. Przeczytaj tę listę, zanim wybierzesz.

Z włączonym Script Sync edycja pliku trafia do Studio zaraz po zapisaniu. Zaakceptowanie edycji w Claude Code oznacza zaakceptowanie jej w swojej grze, więc sprawdzaj, zanim zaakceptujesz, zwłaszcza w trybach, które akceptują edycje automatycznie.

Do autouzupełniania i błędów typów w edytorze Roblox zaleca rozszerzenie Luau Language Server z jego pluginem-towarzyszem do Studio. W VS Code rozszerzenie Claude Code może czytać panel Problems przez wbudowane narzędzie, więc Claude widzi te same ostrzeżenia co ty.

Krok 6: daj Claude swoje zasady dla Roblox w CLAUDE.md

Każda sesja Claude Code zaczyna się od świeżego kontekstu. Plik CLAUDE.md w folderze projektu jest czytany na początku każdej sesji, więc twoje konwencje powinny w nim leżeć. Wykonaj /init, żeby Claude go naszkicował, albo napisz sam. Anthropic radzi trzymać go poniżej 200 linii, pisać zasady na tyle konkretnie, żeby dało się je sprawdzić, i wykonać /context, żeby upewnić się, że się wczytał.

Ten przykład jest napisany dla tego poradnika, dla projektu ze Script Sync. Zmień nazwy pod swoją grę i usuń to, czego nie potrzebujesz.

CLAUDE.md · przykład dla projektu ze 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.

Niektóre linie pojawiły się z powodu tego, jak działają narzędzia. Zasady nazw plików są dlatego, że .client.luau w Script Sync to nie LocalScript. Linia o list_roblox_studios jest dlatego, że serwer sięga do każdego otwartego okna. Linia o assetach jest dlatego, że insert_asset wnosi do gry zewnętrzną zawartość, a upload_image wysyła obrazy na serwer assetów Roblox. Linia o wait idzie za dokumentacją API Roblox, która oznacza wait, spawn i delay jako przestarzałe na rzecz biblioteki task.

Jeśli w twoim projekcie jest już AGENTS.md dla innych agentów do kodu, Claude Code może czytać go jako instrukcje projektu, więc możesz trzymać jeden plik dla obu. Strona Anthropic o pamięci wyjaśnia, który plik wygrywa, gdy są oba.

Jak te zasady wyglądają w kodzie

Oto skrypt serwerowy, który trzyma się zasad Luau wyżej. Jest napisany ręcznie dla tego poradnika, a nie wygenerowany przez Claude. Używaj go jako miary, gdy sprawdzasz to, co oddaje Claude. LocalScript prosi o narzędzie przez RequestTool:FireServer("Sword"), a serwer sprawdza wszystko.

Script w ServerScriptService o nazwie 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 tylko skrypty i foldery, więc serwer tworzy swój remote sam.
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)
	-- Ignorujemy żądanie, które przyszło po tym, jak gracz wyszedł.
	if player.Parent ~= Players then
		return
	end

	-- 1. Sprawdzamy argument: klient może przysłać cokolwiek.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Ograniczamy, jak często jeden gracz może prosić.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Decyduje serwer. Dodaj tu własne sprawdzenie posiadania (game pass, zapis zakupu).
	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. Czyszczenie danych gracza.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Na dysku ze Script Sync: ServerScriptService/ToolRequests.server.luau. Włóż obiekty Tool do Folder o nazwie Tools w ServerStorage. Dopóki nie dodasz sprawdzenia posiadania, każdy gracz może dostać dowolne narzędzie z tego folderu.

Szukaj tego samego w każdym handlerze remote, który pisze Claude: sprawdza typ i rozmiar tego, co przysłał klient, ogranicza, jak często jeden gracz może go wywoływać, decyzję podejmuje serwer, a wpis gracza jest usuwany, gdy ten wychodzi. Poradnik o RemoteEvent wyjaśnia, dlaczego ważny jest każdy punkt.

Bezpieczny sposób pracy: punkt kontrolny, sprawdzenie, playtest

  1. Zrób punkt kontrolny po obu stronach. Zcommituj pliki w Git i zapisz wersję gry w Studio przez File > Save to Roblox with Notes. Poradnik o Studio MCP pokazuje, jak przywrócić ją z Version History.
  2. Proś o plan przy wszystkim większym niż jeden skrypt i czytaj go, zanim zatwierdzisz.
  3. Sprawdzaj diff. Dla plików czytaj git diff albo wbudowane diffy w rozszerzeniu, zanim zaakceptujesz. Dla zmian zrobionych w Studio czytaj skrypty, których dotykał Claude, i sprawdzaj w Explorerze obiekty, które się pojawiły albo zniknęły.
  4. Testuj sam. Claude może uruchomić playtest i przeczytać Output, ale sprawdza tylko to, co sam postanowił sprawdzić. Zagraj w funkcję tak, jak zagrałby gracz, zanim zcommitujesz albo opublikujesz.
  5. Rób commit, gdy wszystko działa, z wiadomością o tym, co się zmieniło.

Co /rewind może cofnąć, a czego nie

Claude Code zapisuje punkt kontrolny przed każdym promptem, a /rewind (albo dwa razy Esc) przywraca pliki, które Claude zmienił swoimi narzędziami do edycji plików. Anthropic wymienia, czego nie śledzi, łącznie ze zmianami zrobionymi komendami powłoki. Zmiany zrobione w Studio przez narzędzia MCP to nie edycje plików, więc nie oczekuj, że /rewind je cofnie, a strona MCP od Roblox nie mówi, czy trafiają do historii cofania Studio. Ze Script Sync plik przywrócony przez /rewind synchronizuje się z powrotem do Studio, jak każda inna zmiana na dysku. Dla całej reszty drogą powrotu jest zapisana wersja.

Trzymaj sekrety i prawdziwe dane poza zasięgiem

  • Nie wklejaj kluczy API, kluczy Open Cloud, URL webhooków ani haseł do promptu albo do CLAUDE.md. Jedno i drugie to tekst, który czyta Claude, a CLAUDE.md zwykle commituje się do repozytorium.
  • Nie wpisuj ich też na sztywno w skrypty. Roblox ma magazyn sekretów dla każdej gry: utwórz sekrety w Creator Dashboard i czytaj je w serwerowym skrypcie przez HttpService:GetSecret(). Do lokalnych playtestów dodaj lokalne sekrety w File > Experience Settings > Security.
  • Osobiste ustawienia trzymaj w .claude/settings.local.json i CLAUDE.local.md, które są pomyślane tak, żeby zostawać poza Gitem. Dodaj CLAUDE.local.md do .gitignore sam.
  • Włączaj Enable Studio Access to API Services tylko w osobnej kopii testowej gry. Roblox ostrzega, że Studio używa tych samych magazynów danych co opublikowana gra, więc playtest, który Claude tam uruchomi, może nadpisać prawdziwe dane graczy.
  • Przeczytaj zewnętrzny skill, zanim go zainstalujesz. W katalogach skilli są skille do Roblox dla Claude Code, a Anthropic zaznacza, że skill może dać sobie szeroki dostęp do narzędzi przez pole allowed-tools.

Ile kosztuje Claude Code do pracy z Roblox

Strona Studio nie ma udokumentowanej ceny: serwer MCP to część Studio, a strona MCP od Roblox nie wspomina o opłatach. Koszt to koszt Claude Code, a Anthropic oferuje dwa sposoby płacenia (na 9 października 2026 roku):

  • Subskrypcja Claude. Claude Code wchodzi w Pro, Max, Team i Enterprise, ale nie w Free. Zużywa ten sam limit użycia co Claude w przeglądarce, na desktopie i na telefonie. Limity resetują się w ruchomym pięciogodzinnym oknie, a płatne plany mają ponad tym limity tygodniowe. Gdy dojdziesz do jednego z nich, możesz poczekać, przejść na wyższy plan albo włączyć kredyty na użycie.
  • Konto Claude Console. Płacisz za użycie API według ilości przetworzonego tekstu. Strona Anthropic o kosztach mówi, że wydatki mocno zależą od wyboru modelu, rozmiaru bazy kodu i tego, jak go używasz.

Aktualne ceny są na claude.com/pricing. Ten poradnik ich nie powtarza, bo się zmieniają. W Claude Code komenda /usage pokazuje subskrybentom paski użycia planu, a użytkownikom API przybliżony koszt sesji.

Co sprawia, że sesja z Roblox zużywa więcej

  • Rozmiar kontekstu. Zużycie rośnie razem z tym, co Claude ma w kontekście. Używaj /clear między niezwiązanymi zadaniami.
  • Duże wyniki narzędzi. Przejście całego drzewa gry w dużej grze albo czytanie długich skryptów w całości zwraca dużo tekstu. Claude Code liczy tekst w jednostkach, którymi mierzy go model: ostrzega, gdy wynik narzędzia MCP przekracza 10 000 takich jednostek, i domyślnie ogranicza go do 25 000. Proś zamiast tego o jeden folder, limit głębokości albo zakres linii: zarówno search_game_tree, jak i script_read to obsługują.
  • Wybór modelu. Anthropic pisze, że Sonnet dobrze radzi sobie z większością zadań z kodem i kosztuje mniej niż Opus. Przełączaj przez /model.

Rozwiązywanie problemów z Claude Code i Studio

Własna lista kontrolna Roblox jest krótka: uruchomić ponownie Studio i klienta, sprawdzić, czy ścieżka do komendy istnieje, i sprawdzić JSON. Oto przypadki typowe właśnie dla Claude Code.

Claude Code nie ma na liście Quick connect

Lista pokazuje tylko obsługiwanych klientów zainstalowanych na twoim komputerze. Zainstaluj Claude Code, potem uruchom Studio ponownie. Jeśli zainstalowałeś go przy otwartym Studio, uruchom ponownie Studio, Claude Code albo oba. Plik .mcp.json z kroku 2 działa bez quick connect.

/mcp nie pokazuje serwera Roblox Studio

Uruchom Claude Code ponownie po dodaniu serwera. Potem sprawdź, gdzie został dodany: serwer dodany bez --scope wczytuje się tylko w folderze, w którym go dodałeś, więc uruchamiaj claude z tego folderu albo dodaj go ponownie z --scope user. W VS Code zacznij nową rozmowę, bo zmiany dotyczą rozmów zaczętych po nich.

Serwer pokazuje Pending approval

Pochodzi z pliku .mcp.json, a Claude Code pyta, zanim użyje takich serwerów. Wykonaj claude w tym folderze, zaakceptuj okno zaufania do folderu roboczego i zatwierdź serwer. claude mcp reset-project-choices resetuje wcześniejsze decyzje.

Serwer pokazuje Failed to connect

Wykonaj claude mcp get Roblox_Studio i przeczytaj linię Issue:. Sprawdź, czy plik istnieje: %LOCALAPPDATA%\Roblox\mcp.bat na Windowsie, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP na macOS (zmień ścieżkę, jeśli Studio jest zainstalowane gdzie indziej). Upewnij się, że Enable Studio as MCP server jest nadal włączone, potem uruchom ponownie Studio i Claude Code.

Terminal pisze, że claude nie jest rozpoznany

Po instalacji otwórz nowe okno terminala. Jeśli komenda nadal nie jest znaleziona, folder instalacji nie jest w PATH; rozwiązanie jest na stronie Anthropic o problemach z instalacją. Rozszerzenie do VS Code nie dodaje claude do PATH, więc do komend z tego poradnika zainstaluj wersję terminalową osobno.

Claude zmienił nie tę grę

Przy kilku otwartych oknach Studio każde wywołanie narzędzia wskazuje cel przez studio_id. Poproś Claude, żeby wywołał list_roblox_studios, i nazwij właściwą grę, zamknij okna, których nie używasz, i przywróć zmienioną grę z Version History.

Claude Code pobiera opłaty z mojego klucza API, a nie z planu

Gdy tylko ją zatwierdziłeś, zmienna środowiskowa ANTHROPIC_API_KEY bierze górę nad subskrypcją. Usuń zmienną (albo wyłącz Use custom API key w /config), uruchom Claude Code od nowa i wykonaj /status, żeby sprawdzić, które logowanie jest aktywne. Jeśli to nadal konto Console, wykonaj /login i wybierz swoje konto Claude.

Sesja w chmurze nie widzi Studio

Sesje w chmurze działają w infrastrukturze Anthropic, a nie na twoim komputerze, więc nie sięgają do lokalnego serwera Studio. Użyj terminala, rozszerzenia do edytora albo aplikacji desktopowej z wybranym Local.

Albo weź zamiast tego agent-plugin: RoCode

Claude Code z MCP pasuje tym, którym wygodnie w terminalu albo edytorze kodu. RoCode (RoCode.app) to inna droga: niezależny agent AI do Roblox Studio z czatem w przeglądarce na rocode.app i darmowym pluginem z Creator Store, który wykonuje kroki w grze, którą masz otwartą. To nie jest produkt MCP i nie używa serwera MCP Studio, więc nie ma linii komend, pliku konfiguracyjnego ani serwera MCP do ustawienia. Plugin łączy się sam, jeśli Studio jest zalogowane na to samo konto Roblox, którego używasz w RoCode; w przeciwnym razie raz łączysz czat i plugin kodem z 8 znaków pokazanym w panelu pluginu.

Co warto wiedzieć przed przejściem. RoCode nie może podłączyć subskrypcji Claude ani Claude Code. Uruchamia zewnętrzne modele przez OpenRouter, łącznie z Claude Sonnet 5.5 na Pro i wyżej i Claude Opus 5.5 na Studio i wyżej, a darmowy plan Starter daje 1 kredyt dziennie na GPT-6 Luna. Działa z trybu edycji. Z pluginem 3.9 lub nowszym, w trybie Build, może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.11 lub nowszym sterować testową postacią, żeby sprawdzić, czy gra działa. Z pluginem 3.9.14 lub nowszym robi też zrzuty tego, co zbudował, w trybie edycji, i może poprawić to, co wygląda źle. Nie wykonuje kodu bezpośrednio i nie generuje meshy, a narzędzia Studio MCP umieją jedno i drugie. Może szukać darmowych modeli w Creator Store według twoich słów (skrypty w środku są usuwane) albo wstawić model, decal albo mesh po ID assetu, a dekoracje, budynki i rekwizyty wymyśla od nowa dla każdej gry. Jego tryb Ask odpowiada na pytania o twoją grę narzędziami tylko do odczytu i niczego nie zmienia. Konta są dla osób od 13 lat, a poniżej 18 lat za zgodą rodzica albo opiekuna.

Ty piszesz

Dodaj RemoteEvent, żeby gracze mogli poprosić o narzędzie z ServerStorage.Tools. Sprawdzaj wszystko na serwerze.

RoCode robi
  • Może najpierw obejrzeć grę przez Search Game i List Children, żeby znaleźć folder Tools i skrypty, które już wydają narzędzia
  • Pisze serwerowy skrypt przez Create Script i może dodać RemoteEvent przez Create Instance
  • Sprawdza kompilację skryptu w Studio przez Check Script przed zakończeniem. To sprawdzenie kompilacji, a nie sprawdzanie typów ani playtest
  • Wysyła zmiany paczkami, a każda paczka to punkt cofania w historii samego Studio

Z pluginem 3.9 lub nowszym RoCode może uruchomić krótki playtest i przeczytać błędy, a z pluginem 3.9.15 lub nowszym jego testowa postać umie chodzić, naciskać klawisze i klikać przyciski na ekranie, ale sprawdza tylko to, co sam postanowił sprawdzić, więc kliknij Play sam, żeby sprawdzić wynik jak gracz. Prompt to przykład napisany przez nas; w krokach są prawdziwe nazwy narzędzi. Jak działa plugin i parowanie. RoCode to niezależny produkt, niezwiązany z Roblox Corporation, przez nią niezatwierdzony ani niesponsorowany.

Najczęstsze pytania

Czy mogę użyć Claude Desktop zamiast Claude Code?

Tak. Claude Desktop jest na liście Quick connect w panelu Manage MCP Servers w Studio, więc łączy się jednym przełącznikiem, na Windowsie albo Macu. Używa tych samych narzędzi Studio; Claude Code dodaje to, co dobrze umie agent w terminalu, na przykład pracę z plikami skryptów i Gitem. Kroki dla obu są w poradniku o konfiguracji Studio MCP.

Czy Claude Code może połączyć się z Roblox Studio?

Tak. Roblox wymienia Claude Code jako klienta quick connect dla serwera MCP wbudowanego w Studio. Włącz Enable Studio as MCP server w Assistant > … > Manage MCP Servers, włącz Claude Code na liście Quick connect i uruchom Claude Code ponownie. Może też pracować z twoimi skryptami jak z plikami przez Script Sync albo Rojo.

Czy Claude Code jest darmowy do pracy z Roblox Studio?

Serwer MCP Studio nie ma udokumentowanej ceny, ale Claude Code nie wchodzi w plan Free od Anthropic (claude.com/pricing, sprawdzone 9 października 2026 roku). Potrzebny jest płatny plan Claude, gdzie dzieli limity użycia twojego planu, albo konto Claude Console z płatnością za użycie API.

Czy potrzebuję pluginu Roblox albo zapytań HTTP, żeby używać Claude Code?

Dla wbudowanego serwera MCP Studio nie. Kroki konfiguracji Roblox to włączyć serwer w Assistant i podłączyć klienta; nie ma w nich ani pluginu do instalacji, ani ustawień HTTP do zmiany. Niektóre stare poradniki opisują serwery MCP od społeczności, które działają inaczej. Rojo, jeśli wybierzesz go do plików, używa własnego pluginu do Studio.

Czy Claude Code może testować moją grę Roblox?

Przez narzędzia Studio MCP tak. start_stop_play uruchamia i zatrzymuje playtest, get_console_output czyta Output, screen_capture robi zrzut widoku, a narzędzia wejścia ruszają postacią i wysyłają klawisze i kliknięcia. Sprawdzaj to, co raportuje, i zagraj w grę sam przed publikacją.

Co wybrać do Roblox Studio: Claude Code czy Codex?

Oba są na liście quick connect od Roblox i sięgają do tych samych narzędzi Studio MCP, więc różnica jest w modelu, koncie i kliencie wokół niego. Roblox nie publikuje porównania, a my nie robiliśmy ich testów porównawczych. Wypróbuj każdy na kopii swojej gry z tymi samymi spisanymi zasadami i zostaw ten, którego zmiany wymagają mniej poprawek.

Czy Claude Code działa z Roblox Studio na Macu?

Tak. Claude Code obsługuje macOS 13.0 lub nowszy, a Roblox dokumentuje ścieżkę do serwera dla macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, dla klientów, których konfigurujesz ręcznie.

Źródła i dalsza lektura

Jak sprawdziliśmy kod: każdy skrypt na tej stronie przechodzi ścisłe sprawdzanie typów Luau z definicjami API Robloxa (luau-lsp, 20 listopada 2026). Sprawdzanie typów wyłapuje źle wpisane API i błędne typy, ale nie logikę gry, więc przetestuj go w Studio przed publikacją.

Wypróbuj RoCode we własnej grze.

Darmowe kredyty codziennie, bez karty. Zainstaluj plugin, opisz funkcję i sprawdź, co pojawi się w Studio.