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
/rewindw Claude Code nie cofa zmian zrobionych w Studio, więc najpierw zapisz wersję.
Na tej stronie
Czego potrzebujesz na start
| Czego potrzebujesz | Szczegóły |
|---|---|
| Roblox Studio | Najnowsza 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 Code | macOS 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 Code | Pł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. |
| Wiek | W 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. |
| Opcjonalnie | Git, ż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.
| Wariant | Sięga do Studio? | Uwagi |
|---|---|---|
Terminal (komenda claude) | Tak | Uruchamiaj go w folderze projektu. Jest też potrzebny do komend claude mcp niżej. |
| Rozszerzenie do VS Code albo Cursor | Tak | Droga 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 Local | Tak | Działa na twoim komputerze. Anthropic pisze, że potrzebna jest płatna subskrypcja. |
| Sesje w chmurze (claude.ai/code albo Cloud w aplikacji desktopowej) | Nie | Dział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.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- 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ą. - 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śnijc, żeby skopiować link logowania. - 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
- W tym samym panelu (Assistant Settings > MCP Servers) rozwiń listę Quick connect. Są na niej obsługiwani klienci zainstalowani na twoim komputerze.
- Włącz Claude Code. Jeśli go nie ma, zainstaluj Claude Code i uruchom Studio ponownie.
- Uruchom Claude Code ponownie: zakończ sesję i znowu wykonaj
claudealbo 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:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"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.
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 listpokazuje każdy serwer i jego status.claude mcp get Roblox_Studiopokazuje 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.
{
"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ć:
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 | Rojo | |
|---|---|---|
| Co to jest | Funkcja 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 synchronizuje | Tylko 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. |
| Konfiguracja | Kliknij 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 Create | Dział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 Roblox | Dobrze 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.
| Nazwa pliku kończy się na | Script Sync tworzy | Rojo tworzy |
|---|---|---|
.server | Script z kontekstem wykonania Server | Script |
.client | Script z kontekstem wykonania Client | LocalScript |
.local | LocalScript | Bez szczególnego znaczenia (każdy inny plik .lua to ModuleScript) |
| Bez sufiksu | ModuleScript | ModuleScript |
Folder z plikiem init | Skrypt z dziećmi, którego typ ustala nazwa pliku init | Folder staje się skryptem, który opisuje init.server.lua, init.client.lua albo init.lua |
Konfiguracja Script Sync dla Claude Code
- Utwórz folder projektu z jednym folderem na każdy serwis, który chcesz trzymać na dysku, na przykład
ServerScriptService,ReplicatedStorageiStarterPlayerScripts, i wykonaj w nimgit init. - 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.
- 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.
- Wykonaj
claudew tym folderze. Teraz Claude edytuje pliki.luau, a Studio wczytuje każdą zmianę. - Rób commit przed każdą sesją, żeby zawsze był czysty punkt, do którego można wrócić.
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.
# 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.
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
- 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.
- Proś o plan przy wszystkim większym niż jeden skrypt i czytaj go, zanim zatwierdzisz.
- Sprawdzaj diff. Dla plików czytaj
git diffalbo 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. - 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.
- 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, aCLAUDE.mdzwykle 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.jsoniCLAUDE.local.md, które są pomyślane tak, żeby zostawać poza Gitem. DodajCLAUDE.local.mddo.gitignoresam. - 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
/clearmię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 iscript_readto 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.
Dodaj RemoteEvent, żeby gracze mogli poprosić o narzędzie z ServerStorage.Tools. Sprawdzaj wszystko na serwerze.
- 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
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (po angielsku). włączanie serwera, quick connect, konfiguracja przez JSON i CLI, narzędzia, kilka okien Studio i rozwiązywanie problemów
- Roblox Creator Docs: Build with a coding harness (po angielsku). Claude Code w VS Code, Script Sync, MCP i Git razem
- Roblox Creator Docs: Script Sync (po angielsku). co się synchronizuje, zasady nazw plików, konflikty i language server
- Roblox Creator Docs: Third-party tools (po angielsku). Rojo z Rokit i kontrola wersji
- Roblox Creator Docs: Secrets stores (po angielsku). jak trzymać klucze API poza skryptami
- Roblox Creator Docs: Data stores (po angielsku). dlaczego dostęp Studio do API services jest potrzebny tylko w kopii testowej
- Rojo documentation (v7) (po angielsku). instalacja i to, jak nazwy plików zamieniają się w obiekty
- Claude Code Docs: Overview (po angielsku). wszystkie warianty mają jeden silnik, a aplikacja desktopowa wymaga płatnej subskrypcji
- Claude Code Docs: Advanced setup (po angielsku). wymagania systemowe i komendy instalacji
- Claude Code Docs: Authentication (po angielsku). logowanie i pasujące typy kont
- Claude Code Docs: Connect Claude Code to tools via MCP (po angielsku). serwery stdio, .mcp.json, zakresy i status serwera
- Claude Code Docs: Configure permissions (po angielsku). reguły allow, ask i deny, łącznie z narzędziami MCP
- Claude Code Docs: Choose a permission mode (po angielsku). tryb auto jako startowy, tryb Manual i tryb plan
- Claude Code Docs: How Claude remembers your project (po angielsku). CLAUDE.md, /init i AGENTS.md
- Claude Code Docs: Checkpointing (po angielsku). co przywraca /rewind i czego nie śledzi
- Claude Code Docs: Manage costs effectively (po angielsku). /usage, rozmiar kontekstu i wybór modelu
- Claude Code Docs: Use Claude Code in the cloud (po angielsku). dlaczego sesje w chmurze nie działają na twoim komputerze
- Claude Code Docs: Use Claude Code in VS Code (po angielsku). wymagania, uwaga o PATH, wspólna konfiguracja MCP i panel Problems
- Claude Code Docs: Extend Claude with skills (po angielsku). co daje pole allowed-tools w skillu
- Claude pricing (po angielsku). w które plany wchodzi Claude Code i limity użycia
- Claude Help Center: Use Claude Code with your Pro or Max plan (po angielsku). wspólne limity i ostrzeżenie o ANTHROPIC_API_KEY
- Anthropic: Consumer Terms of Service (po angielsku). minimalny wiek
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ą.