Lyhyesti
Asenna Claude Code ja kirjaudu maksullisella Claude-paketilla tai Claude Console -tilillä. Avaa Studiossa Assistant, paina … > Manage MCP Servers, ota käyttöön Enable Studio as MCP server ja ota sitten Claude Code käyttöön Quick connect -luettelossa. Käynnistä Claude Code uudelleen, kirjoita /mcp varmistaaksesi, että Studion palvelin on yhdistetty, ja aloita pyynnöllä, joka vain lukee.
- Claude Code ei kuulu Anthropicin Free-pakettiin. Se sisältyy Pro-, Max-, Team- ja Enterprise-paketteihin tai maksetaan API-käytön mukaan Claude Console -tilin kautta (tarkistettu 9. lokakuuta 2026).
- Käytä paikallista istuntoa: terminaalia, VS Coden tai Cursorin laajennusta tai työpöytäsovellusta, jossa Local on valittuna. Pilvi-istunnot eivät toimi tietokoneellasi eivätkä ylety Studioon.
- Versiosta v2.1.283 alkaen terminaalin ja VS Coden istunnot alkavat oletuksena auto-tilassa siellä, missä se on saatavilla, joten lisää ask-säännöt Studion työkaluille, jotka muuttavat paikkaa. Claude Coden
/rewind-komento ei kumoa Studiossa tehtyjä muutoksia, joten tallenna ensin versio.
Tällä sivulla
Mitä tarvitset ennen aloittamista
| Mitä tarvitaan | Tiedot |
|---|---|
| Roblox Studio | Uusin versio, Windowsissa tai macOS:ssä. MCP-palvelin on sisäänrakennettu Studioon, joten Robloxin puolelle ei tarvitse asentaa mitään muuta. |
| Tietokone, joka tukee Claude Codea | macOS 13.0 tai uudempi tai Windows 10 1809 tai uudempi, vähintään 4 Gt keskusmuistia, internetyhteys ja sijainti maassa, jota Anthropic tukee. |
| Claude-tili, johon Claude Code sisältyy | Maksullinen Claude-paketti (Pro, Max, Team tai Enterprise) tai Claude Console -tili. Anthropicin hintasivun mukaan Claude Code ei sisälly Free-pakettiin. |
| Ikä | Anthropicin Consumer Termsin (voimassa 8. lokakuuta 2025 alkaen) mukaan sinun on oltava vähintään 18-vuotias tai maasi suostumusikäraja, jos se on korkeampi. |
| Halutessasi | Git skriptien historian säilyttämiseen. Visual Studio Code 1.94.0 tai uudempi tai Cursor, jos haluat Claude Coden editorin paneeliin etkä terminaaliin. |
Mitä Claude Codea käyttää
Claude Code toimii useassa paikassa. Anthropicin mukaan kaikissa on sama moottori, joten CLAUDE.md, asetukset ja MCP-palvelimet toimivat kaikkialla. Studion kannalta on tärkeää, missä istunto toimii: Robloxin MCP-palvelin on paikallinen prosessi tietokoneellasi, joten myös istunnon täytyy olla tietokoneellasi.
| Vaihtoehto | Yltääkö Studioon? | Huomioita |
|---|---|---|
Terminaali (komento claude) | Kyllä | Aja se projektikansiossa. Sitä tarvitaan myös alla oleviin claude mcp -komentoihin. |
| VS Coden tai Cursorin laajennus | Kyllä | Robloxin coding harness -oppaan polku. Laajennuksessa on oma kopio Claude Codesta, mutta se ei lisää claude-komentoa PATHiin, joten jos tarvitset näitä komentoja, asenna myös terminaaliversio. |
| Työpöytäsovellus, Code-välilehti, Local valittuna | Kyllä | Toimii tietokoneellasi. Anthropicin mukaan tarvitaan maksullinen tilaus. |
| Pilvi-istunnot (claude.ai/code tai Cloud työpöytäsovelluksessa) | Ei | Ne toimivat pilvi-infrastruktuurissa eivätkä tietokoneellasi, joten ne eivät voi käynnistää Studion paikallista palvelinta. |
Vaihe 1: asenna Claude Code ja kirjaudu
Anthropic suosittelee asennusta yhdellä terminaalikomennolla. Nämä ovat komennot, jotka olivat sen asennussivulla 9. lokakuuta 2026; ajantasaiset löydät Anthropicin asennussivulta.
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- Avaa uusi terminaali-ikkuna ja aja
claude --version. Versionumero tarkoittaa, että kaikki onnistui. Jos komentoa ei löydy, asennuskansio ei ole vielä PATHissa, ja ratkaisu löytyy Anthropicin asennusongelmia käsittelevältä sivulta. - Siirry projektikansioon ja aja
claude. Ensimmäisellä käynnistyskerralla se avaa selainikkunan kirjautumista varten. Jos selain ei avautunut, painackopioidaksesi kirjautumislinkin. - Kirjaudu Claude-tilillesi. Kirjautuminen Prolla tai Maxilla käyttää pakettiisi sisältyviä rajoja.
Windowsissa Anthropic suosittelee asentamaan Git for Windowsin, jotta Claude Code voi käyttää Bash-työkaluaan; ilman sitä Claude Code ajaa komennot PowerShellissä. Tätä asetusta varten asenna Claude Code itse Windowsiin, ei WSL:n sisään: Robloxin Windows-konfiguraatio käynnistää cmd.exe:n polulla %LOCALAPPDATA%, eikä Roblox dokumentoi WSL:ää.
Haluatko mieluummin paneelin editorissa? Avaa VS Codessa tai Cursorissa Extensions (Ctrl+Shift+X tai Macilla Cmd+Shift+X), hae Claude Code, asenna se ja kirjaudu Claude-paneelista. Juuri tätä asetusta Robloxin coding harness -opas käyttää.
Vaihe 2: yhdistä Claude Code Studioon
Ota ensin palvelin käyttöön. Avaa Studiossa Assistant, paina … > Manage MCP Servers ja ota käyttöön Enable Studio as MCP server. Studio MCP -opas käy tämän vaiheen läpi tarkemmin. Eikö Assistant-painiketta ole? Katso miten Assistant-paneeli avataan.
Quick connect
- Avaa samassa paneelissa (Assistant Settings > MCP Servers) Quick connect -luettelo. Siinä ovat tuetut asiakkaat, jotka on asennettu tietokoneellesi.
- Ota käyttöön Claude Code. Jos sitä ei ole, asenna Claude Code ja käynnistä Studio uudelleen.
- Käynnistä Claude Code uudelleen: lopeta istunto ja aja
claudeuudelleen tai aloita laajennuksessa uusi keskustelu. Robloxin mukaan asiakas tarvitsee uudelleenkäynnistyksen ottaakseen uuden konfiguraation käyttöön.
Roblox ei kerro, mihin tiedostoon Claude Code kirjoittaa quick connectin eikä millä nimellä se kutsuu palvelinta. Kirjoita Claude Codeen /mcp nähdäksesi nimen. Tarvitset sitä vaiheen 3 lupasääntöihin.
Käytätkö Claude Code -laajennusta VS Codessa tai Cursorissa? Ota myös tässä käyttöön Claude Code. Robloxin coding harness -opas ottaa käyttöön Cursorin tai Visual Studio Coden, mutta Anthropic dokumentoi, että laajennus jakaa MCP-konfiguraation Claude Coden terminaaliversion kanssa, eikä se kerro laajennuksen lukevan editorin omia MCP-asetuksia.
Manuaalinen asetus .mcp.json-tiedostolla
Jos quick connect ei toimi sinulla, lisää Studio itse. Claude Code lukee projektin MCP-palvelimet projektikansion tiedostosta nimeltä .mcp.json samassa mcpServers-muodossa, jonka Roblox dokumentoi, ja pitää merkintää ilman type-kenttää paikallisena stdio-palvelimena. Siksi Robloxin konfiguraatio toimii sellaisenaan. Tallenna järjestelmäsi versio nimellä .mcp.json kansioon, jossa ajat claude:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Kun seuraavan kerran ajat claude tässä kansiossa, se pyytää hyväksymään palvelimen: Anthropic näyttää tämän pyynnön jokaiselle palvelimelle, joka tulee .mcp.json-tiedostosta. Anthropic on tarkoittanut tiedoston commitoitavaksi ja koko tiimin jaettavaksi, mutta Windowsin ja macOS:n polut ovat erilaiset. Jos tiimissäsi on molempia järjestelmiä, pidä tiedosto repositorion ulkopuolella, ja jokainen lisää Studion itselleen.
macOS:ssä Studion voi sen sijaan lisätä yhdellä komennolla. --scope user tekee siitä käytettävissä jokaisessa tietokoneesi projektissa; ilman sitä palvelin latautuu vain nykyisessä kansiossa. -- erottaa Claude Coden omat parametrit komennosta, joka käynnistää palvelimen.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Windowsissa JSON-tiedoston polku on helpompi, koska PowerShell ja CMD käsittelevät %LOCALAPPDATA%:n komentorivillä eri tavoin.
Tarkista yhteys
- Terminaalissa
claude mcp listnäyttää jokaisen palvelimen ja sen tilan.claude mcp get Roblox_Studionäyttää enemmän, myösIssue:-rivin, jos palvelin ei pystynyt yhdistämään. - Kirjoita Claude Coden sisällä
/mcp. Yhdistettyjen palvelinten nimen vieressä näkyy työkalujen määrä. - Studiossa Assistant > … > Manage MCP Servers näyttää vihreän merkkivalon ja yhdistettyjen asiakkaiden määrän.
Vaihe 3: päätä, mitä Claude saa tehdä kysymättä
Määritä tämä ennen kuin Claude koskee paikkaasi. Anthropicin lupatiloja käsittelevän sivun mukaan Claude Code v2.1.283:sta alkaen interaktiiviset istunnot terminaalissa ja VS Codessa alkavat oletuksena auto-tilassa kaikkialla, missä se on saatavilla, ja auto-tilassa toimenpiteet tarkistaa puolestasi taustaluokittelija. Silloin MCP-kutsu, joka muokkaa skriptiä tai ajaa Luauta Studiossa, voi mennä läpi kysymättä.
Jokaisen muutoksen voi pitää omissa käsissään kahdella tavalla:
- Käynnistä Manual-tilassa. Aja
claude --permission-mode default. Manual-tilassa kysymättä suoritetaan vain lukeminen. Paina istunnon aikana Shift+Tab vaihtaaksesi tilaa. - Lisää ask-säännöt Studion työkaluille, jotka muuttavat jotain. Anthropicin mukaan mikään tila ei hyväksy automaattisesti työkalua, johon kohdistuu nimenomainen ask-sääntö, ei edes bypass-tila.
{
"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"
]
}
}
MCP-säännöt ovat muotoa mcp__<server>__<tool>, ja palvelimen nimi on se, jolla Claude Code sen tuntee. Korvaa Roblox_Studio nimellä, jonka /mcp näyttää. Projektitiedoston .claude/settings.json allow-säännöt tulevat voimaan vasta, kun hyväksyt työkansion luottamusvalintaikkunan tälle kansiolle. Vain itsellesi tarkoitettuihin sääntöihin käytä tiedostoa .claude/settings.local.json.
Allow-luettelo kattaa työkalut, jotka vain lukevat: pelipuun, ominaisuudet, skriptit, Outputin ja luettelon avoimista Studio-ikkunoista. Ask-luettelo kattaa työkalut, jotka muuttavat paikkaa, ajavat koodia, käynnistävät pelitestejä, tuovat ulkoisia assetteja tai lähettävät kuvia Robloxiin. Työkalut, joita ei ole kummassakaan luettelossa, esimerkiksi screen_capture ja syötetyökalut, noudattavat lupatilaasi. Työkalujen täysi luettelo kuvauksineen on Studio MCP -oppaassa.
Vaihe 4: aloita pyynnöllä, joka vain lukee
Avaa paikka, jonka kanssa haluat työskennellä, ja sulje ne, joiden kanssa et halua. Anna sitten Claudelle ensimmäinen pyyntö, joka ei voi muuttaa mitään:
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.
Tuoreessa Baseplatessa Robloxin coding harness -opas odottaa vastauksen luettelevan vakio-objektit Camera, Terrain, Baseplate ja SpawnLocation. list_roblox_studios-kutsun pyytäminen ensin on hyvä tapa: yksi asiakas ylettyy jokaiseen avoimeen Studio-ikkunaasi, ja jokainen työkalukutsu nimeää kohdeikkunan studio_id:llä.
Kaikkeen yhtä skriptiä suurempaan pyydä ensin suunnitelma. Plan-tilassa (paina Shift+Tab tai aloita kehote sanalla /plan) Claude tutkii ja ehdottaa muokkaamatta tiedostojasi. Anthropic kuvaa plan-tilan tiedostomuokkausten ja komentotulkin komentojen kautta, joten pidä myös Studion työkalujen ask-säännöt.
Vaihe 5: käsittele skriptejä tiedostoina Script Syncillä tai Rojolla
Claude Code on rakennettu kansion tiedostojen ympärille. Se muokkaa niitä työkaluillaan, Git säilyttää niiden historian, ja /rewind voi palauttaa ne. Kun skriptit ovat levyllä, kaikkea tätä voi hyödyntää, ja MCP-työkalut jäävät niihin paikan osiin, jotka eivät ole skriptejä, kuten StarterGuin GUI:hin, RemoteEventeihin ja partteihin. Roblox dokumentoi tähän kaksi tapaa.
| Script Sync | Rojo | |
|---|---|---|
| Mikä se on | Studion toiminto, joka synkronoi paikan skriptit levyn tiedostoihin molempiin suuntiin. | Kolmannen osapuolen työkalu: palvelin tietokoneellasi sekä Studio-lisäosa. |
| Mitä se synkronoi | Vain Script-, LocalScript-, ModuleScript- ja Folder-objektit. Synkronoidun kansion muut objektit ohitetaan. | Voi hallita koko projektia tiedostoina, ja totuuden lähteenä on tiedostojärjestelmäsi. |
| Käyttöönotto | Napsauta Explorerissa palvelua tai kansiota hiiren oikealla, valitse Sync to… ja osoita kansio. Robloxin coding harness -opas ottaa sen ensin käyttöön kohdassa File > Beta Features. | Asenna se Rokitilla (rokit add rojo-rbx/rojo, sitten rokit install), lisää lisäosa komennolla rojo plugin install, aja rojo serve ja yhdistä lisäosasta. |
| Team Create | Toimii sen kanssa. Vältä tilannetta, jossa kaksi ihmistä muokkaa samaa synkronoitua skriptiä yhtä aikaa. | Roblox huomauttaa, että kolmannen osapuolen työkalut eivät usein toimi sen sisäänrakennettujen yhteistyötyökalujen kanssa. |
| Robloxin neuvo | Sopii hyvin, jos haluat oman editorin ja versionhallinnan koodille ja Studion kaikelle muulle. | Paras valinta, jos haluat pitää koko projektin versionhallinnassa etkä vain koodia. |
Sama tiedostonimi voi tarkoittaa eri asioita
Molemmat työkalut valitsevat skriptin tyypin tiedostonimen perusteella, eivätkä niiden päätteet täsmää. Tiedosto .client on Rojossa LocalScript, mutta Script Syncissä Script, jonka suorituskonteksti on Client. Kerro Claudelle, mitä työkalua projektisi käyttää; alla oleva CLAUDE.md-esimerkki tekee sen.
| Tiedostonimen pääte | Script Sync luo | Rojo luo |
|---|---|---|
.server | Script, jonka suorituskonteksti on Server | Script |
.client | Script, jonka suorituskonteksti on Client | LocalScript |
.local | LocalScript | Ei erityistä merkitystä (mikä tahansa muu .lua-tiedosto on ModuleScript) |
| Ei päätettä | ModuleScript | ModuleScript |
Kansio, jossa on init-tiedosto | Skripti lapsiobjekteineen, jonka tyypin määrää init-tiedoston nimi | Kansiosta tulee skripti, jota kuvaa init.server.lua, init.client.lua tai init.lua |
Script Syncin asetus Claude Codea varten
- Luo projektikansio, jossa on yksi kansio jokaista levyllä pidettävää palvelua kohden, esimerkiksi
ServerScriptService,ReplicatedStoragejaStarterPlayerScripts, ja aja siinägit init. - Jos Script Sync ei näy, kun napsautat palvelua hiiren oikealla, ota se käyttöön kohdassa File > Beta Features, paina Save ja käynnistä Studio uudelleen.
- Napsauta Explorerissa hiiren oikealla ServerScriptServiceä, valitse Script Sync > Sync to ja osoita ylimmän tason projektikansio, ei sen sisällä olevaa kansiota. Toista muille palveluille.
- Aja
claudetässä kansiossa. Nyt Claude muokkaa.luau-tiedostoja, ja Studio ottaa jokaisen muutoksen käyttöön. - Tee commit ennen jokaista istuntoa, jotta sinulla on aina puhdas piste, johon palata.
git add .
git commit -m "Before Claude session"
Kaksi Script Syncin sääntöä korostuu agentin kanssa. Älä synkronoi skriptejä, joilla on attribuutteja tai tageja: Script Sync ohittaa ne, ja Roblox varoittaa, että tämä voi johtaa tietojen menetykseen. Ja jos tiedostot muuttuvat, kun Studio on suljettuna, paikan uudelleen avaamisen yhteydessä Studio kysyy, miten tilanne ratkaistaan, ja luettelee, mitä Keep Studio ja Keep Disk lisäävät, muuttavat tai poistavat. Lue tämä luettelo ennen valintaa.
Kun Script Sync on käytössä, tiedoston muokkaus siirtyy Studioon heti tallennuksen jälkeen. Muokkauksen hyväksyminen Claude Codessa tarkoittaa sen hyväksymistä paikkaasi, joten tarkista ennen hyväksymistä, erityisesti tiloissa, jotka hyväksyvät muokkaukset automaattisesti.
Automaattiseen täydennykseen ja tyyppivirheisiin editorissa Roblox suosittelee Luau Language Server -laajennusta ja sen Studio-kumppanilisäosaa. VS Codessa Claude Code -laajennus voi lukea Problems-paneelia sisäänrakennetulla työkalulla, joten Claude näkee samat varoitukset kuin sinä.
Vaihe 6: anna Claudelle Roblox-sääntösi CLAUDE.md-tiedostossa
Jokainen Claude Code -istunto alkaa tuoreesta kontekstista. Projektikansion CLAUDE.md-tiedosto luetaan jokaisen istunnon alussa, joten käytäntöjesi kuuluu olla siinä. Aja /init, niin Claude luonnostelee sen, tai kirjoita se itse. Anthropic neuvoo pitämään sen alle 200 rivin pituisena, kirjoittamaan säännöt niin tarkasti, että ne voi tarkistaa, ja ajamaan /context varmistaaksesi, että se latautui.
Tämä esimerkki on kirjoitettu tätä opasta varten, Script Synciä käyttävälle projektille. Vaihda nimet pelisi mukaisiksi ja poista se, mitä et tarvitse.
# 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.
Jotkin rivit ovat mukana työkalujen toimintatavan vuoksi. Tiedostonimisäännöt ovat mukana, koska .client.luau ei Script Syncissä ole LocalScript. Rivi list_roblox_studios-kutsusta on mukana, koska palvelin ylettyy jokaiseen avoimeen ikkunaan. Assetteja koskeva rivi on mukana, koska insert_asset tuo paikkaan ulkoista sisältöä ja upload_image lähettää kuvia Robloxin assettipalvelimelle. Rivi wait-kutsusta noudattaa Robloxin API-viitettä, joka merkitsee wait-, spawn- ja delay-funktiot vanhentuneiksi task-kirjaston hyväksi.
Jos projektissasi on jo AGENTS.md muille koodausagenteille, Claude Code voi lukea sen projektin ohjeina, joten voit pitää yhden tiedoston molemmille. Anthropicin muistia käsittelevä sivu selittää, kumpi tiedosto voittaa, kun molemmat ovat olemassa.
Miltä nämä säännöt näyttävät koodissa
Tässä on palvelinskripti, joka noudattaa yllä olevia Luau-sääntöjä. Se on kirjoitettu käsin tätä opasta varten, eikä Claude ole generoinut sitä. Käytä sitä mittapuuna, kun tarkistat, mitä Claude palauttaa. LocalScript pyytää työkalua kutsulla RequestTool:FireServer("Sword"), ja palvelin tarkistaa kaiken.
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 synkronoi vain skriptit ja kansiot, joten palvelin luo oman remotensa itse.
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)
-- Ohitetaan pyyntö, joka tuli pelaajan poistuttua.
if player.Parent ~= Players then
return
end
-- 1. Tarkistetaan argumentti: asiakas voi lähettää mitä tahansa.
if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
return
end
-- 2. Rajoitetaan, kuinka usein yksi pelaaja voi pyytää.
local now = os.clock()
local last = lastRequest[player]
if last ~= nil and now - last < COOLDOWN_SECONDS then
return
end
lastRequest[player] = now
-- 3. Palvelin päättää. Lisää tähän oma omistustarkistuksesi (pelipassi, ostotieto).
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. Pelaajan tietojen siivous.
Players.PlayerRemoving:Connect(function(player: Player)
lastRequest[player] = nil
end)
Levyllä Script Syncillä: ServerScriptService/ToolRequests.server.luau. Laita Tool-objektit ServerStoragessa olevaan Folderiin nimeltä Tools. Ennen kuin lisäät omistustarkistuksen, jokainen pelaaja voi saada minkä tahansa työkalun tästä kansiosta.
Etsi samoja asioita jokaisesta remote-käsittelijästä, jonka Claude kirjoittaa: se tarkistaa asiakkaan lähettämän tiedon tyypin ja koon, rajoittaa, kuinka usein yksi pelaaja voi kutsua sitä, päätöksen tekee palvelin, ja pelaajan merkintä poistetaan, kun hän poistuu. RemoteEvent-opas selittää, miksi jokainen kohta on tärkeä.
Turvallinen työtapa: tarkistuspiste, tarkistus, pelitesti
- Tee tarkistuspiste molemmille puolille. Commitoi tiedostot Gitiin ja tallenna paikan versio Studiossa kohdasta File > Save to Roblox with Notes. Studio MCP -opas näyttää, miten se palautetaan Version Historysta.
- Pyydä suunnitelma kaikkeen yhtä skriptiä suurempaan ja lue se ennen hyväksymistä.
- Tarkista diff. Tiedostoista lue
git difftai laajennuksen sisäänrakennetut diffit ennen hyväksymistä. Studiossa tehdyistä muutoksista lue skriptit, joihin Claude koski, ja tarkista Explorerista ilmestyneet tai kadonneet objektit. - Testaa itse. Claude voi ajaa pelitestin ja lukea Outputin, mutta se tarkistaa vain sen, mitä se itse päätti tarkistaa. Pelaa ominaisuutta kuten pelaaja pelaisi, ennen kuin commitoit tai julkaiset.
- Tee commit, kun kaikki toimii, viestillä siitä, mikä muuttui.
Mitä /rewind voi kumota ja mitä ei
Claude Code tallentaa tarkistuspisteen ennen jokaista kehotetta, ja /rewind (tai Esc kahdesti) palauttaa tiedostot, joita Claude muutti tiedostonmuokkaustyökaluillaan. Anthropic luettelee, mitä se ei seuraa, mukaan lukien komentotulkin komennoilla tehdyt muutokset. Studiossa MCP-työkaluilla tehdyt muutokset eivät ole tiedostomuokkauksia, joten älä odota /rewind-komennon kumoavan niitä, eikä Robloxin MCP-sivu kerro, päätyvätkö ne Studion kumoushistoriaan. Script Syncin kanssa /rewind-komennon palauttama tiedosto synkronoituu takaisin Studioon kuten mikä tahansa muu levyn muutos. Kaikessa muussa tie takaisin on tallennettu versio.
Pidä salaisuudet ja oikeat tiedot ulottumattomissa
- Älä liitä API-avaimia, Open Cloud -avaimia, webhook-osoitteita tai salasanoja kehotteeseen tai
CLAUDE.md-tiedostoon. Molemmat ovat tekstiä, jota Claude lukee, jaCLAUDE.mdyleensä commitoidaan repositorioon. - Älä myöskään kovakoodaa niitä skripteihin. Robloxilla on salaisuuksien säilö jokaiselle pelille: luo salaisuudet Creator Dashboardissa ja lue ne palvelinskriptissä kutsulla
HttpService:GetSecret(). Paikallisia pelitestejä varten lisää paikalliset salaisuudet kohdassa File > Experience Settings > Security. - Pidä henkilökohtaiset asetukset tiedostoissa
.claude/settings.local.jsonjaCLAUDE.local.md, jotka on tarkoitettu pysymään Gitin ulkopuolella. LisääCLAUDE.local.mditse.gitignore-tiedostoon. - Ota Enable Studio Access to API Services käyttöön vain pelin erillisessä testikopiossa. Roblox varoittaa, että Studio käyttää samoja tietovarastoja kuin julkaistu peli, joten Clauden siellä ajama pelitesti voi korvata pelaajien oikeat tiedot.
- Lue kolmannen osapuolen skill ennen sen asentamista. Skill-luetteloissa on Roblox-skillejä Claude Codelle, ja Anthropic huomauttaa, että skill voi antaa itselleen laajan pääsyn työkaluihin
allowed-tools-kentän kautta.
Mitä Claude Code maksaa Roblox-työssä
Studion puolella ei ole dokumentoitua hintaa: MCP-palvelin on osa Studiota, eikä Robloxin MCP-sivu mainitse maksuja. Kustannus on Claude Coden kustannus, ja Anthropic tarjoaa kaksi maksutapaa (9. lokakuuta 2026):
- Claude-tilaus. Claude Code sisältyy Pro-, Max-, Team- ja Enterprise-paketteihin, mutta ei Freehen. Se kuluttaa samaa käyttörajaa kuin Claude verkossa, työpöydällä ja mobiilissa. Rajat nollautuvat liukuvan viiden tunnin ikkunan mukaan, ja maksullisissa paketeissa sen päällä on viikkorajat. Kun saavutat jonkin niistä, voit odottaa, siirtyä ylempään pakettiin tai ottaa käyttökrediitit käyttöön.
- Claude Console -tili. Maksat API-käytöstä käsitellyn tekstin määrän mukaan. Anthropicin kustannussivun mukaan kulut riippuvat paljon mallin valinnasta, koodikannan koosta ja siitä, miten sitä käytät.
Ajantasaiset hinnat ovat osoitteessa claude.com/pricing. Tämä opas ei toista niitä, koska ne muuttuvat. Claude Coden sisällä komento /usage näyttää tilaajille paketin käyttömittarit ja API-käyttäjille istunnon arvioidun hinnan.
Mikä saa Roblox-istunnon kuluttamaan enemmän
- Kontekstin koko. Kulutus kasvaa sen mukana, mitä Claudella on kontekstissa. Käytä
/clear-komentoa toisiinsa liittymättömien tehtävien välillä. - Suuret työkalutulokset. Koko pelipuun läpikäynti suuressa paikassa tai pitkien skriptien lukeminen kokonaan palauttaa paljon tekstiä. Claude Code laskee tekstin yksiköissä, joilla malli sitä mittaa: se varoittaa, kun MCP-työkalun tulos ylittää 10 000 tällaista yksikköä, ja rajaa sen oletuksena 25 000:een. Pyydä sen sijaan yksi kansio, syvyysrajoitus tai rivialue: sekä
search_game_treeettäscript_readtukevat tätä. - Mallin valinta. Anthropicin mukaan Sonnet selviää hyvin useimmista koodaustehtävistä ja maksaa vähemmän kuin Opus. Vaihda komennolla
/model.
Claude Coden ja Studion ongelmien ratkaisu
Robloxin oma tarkistuslista on lyhyt: käynnistä Studio ja asiakas uudelleen, tarkista, että komennon polku on olemassa, ja tarkista JSON. Tässä ovat nimenomaan Claude Codelle tyypilliset tapaukset.
Claude Code ei näy Quick connect -luettelossa
Luettelo näyttää vain tuetut asiakkaat, jotka on asennettu tietokoneellesi. Asenna Claude Code ja käynnistä sitten Studio uudelleen. Jos asensit sen Studion ollessa auki, käynnistä uudelleen Studio, Claude Code tai molemmat. Vaiheen 2 .mcp.json-tiedosto toimii ilman quick connectia.
/mcp ei näytä Roblox Studio -palvelinta
Käynnistä Claude Code uudelleen palvelimen lisäämisen jälkeen. Tarkista sitten, mihin se lisättiin: ilman --scope-parametria lisätty palvelin latautuu vain kansiossa, jossa lisäsit sen, joten aja claude siinä kansiossa tai lisää se uudelleen parametrilla --scope user. VS Codessa aloita uusi keskustelu, koska muutokset koskevat niiden jälkeen aloitettuja keskusteluja.
Palvelin näyttää Pending approval
Se tuli .mcp.json-tiedostosta, ja Claude Code kysyy ennen tällaisten palvelinten käyttämistä. Aja claude siinä kansiossa, hyväksy työkansion luottamusvalintaikkuna ja hyväksy palvelin. claude mcp reset-project-choices nollaa aiemmat päätökset.
Palvelin näyttää Failed to connect
Aja claude mcp get Roblox_Studio ja lue Issue:-rivi. Tarkista, että tiedosto on olemassa: %LOCALAPPDATA%\Roblox\mcp.bat Windowsissa, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP macOS:ssä (muuta polkua, jos Studio on asennettu muualle). Varmista, että Enable Studio as MCP server on yhä päällä, ja käynnistä sitten Studio ja Claude Code uudelleen.
Terminaali sanoo, ettei claude-komentoa tunnisteta
Avaa asennuksen jälkeen uusi terminaali-ikkuna. Jos komentoa ei vieläkään löydy, asennuskansio ei ole PATHissa; ratkaisu on Anthropicin asennusongelmia käsittelevällä sivulla. VS Coden laajennus ei lisää claude-komentoa PATHiin, joten tämän oppaan komentoja varten asenna terminaaliversio erikseen.
Claude muutti väärää paikkaa
Kun Studio-ikkunoita on auki useita, jokainen työkalukutsu nimeää kohteen studio_id:llä. Pyydä Claudea kutsumaan list_roblox_studios ja nimeä oikea paikka, sulje ikkunat, joita et käytä, ja palauta muutettu paikka Version Historysta.
Claude Code veloittaa API-avaimeltani eikä paketista
Kun olet hyväksynyt sen, ympäristömuuttuja ANTHROPIC_API_KEY menee tilauksen edelle. Poista muuttuja (tai kytke Use custom API key pois päältä kohdassa /config), käynnistä Claude Code uudelleen ja aja /status tarkistaaksesi, mikä kirjautuminen on aktiivinen. Jos se on edelleen Console-tili, aja /login ja valitse Claude-tilisi.
Pilvi-istunto ei näe Studiota
Pilvi-istunnot toimivat Anthropicin infrastruktuurissa eivätkä tietokoneellasi, joten ne eivät ylety Studion paikalliseen palvelimeen. Käytä terminaalia, editorin laajennusta tai työpöytäsovellusta, jossa Local on valittuna.
Tai ota sen sijaan lisäosana toimiva agentti: RoCode
Claude Code MCP:n kanssa sopii niille, joille terminaali tai koodieditori on tuttu. RoCode (RoCode.app) on toinen tie: itsenäinen tekoälyagentti Roblox Studioon, jossa on verkkochat osoitteessa rocode.app ja ilmainen Creator Storen lisäosa, joka suorittaa vaiheet paikassa, joka sinulla on auki. Se ei ole MCP-tuote eikä käytä Studion MCP-palvelinta, joten komentoriviä, konfiguraatiotiedostoa tai MCP-palvelinta ei tarvitse määrittää. Lisäosa yhdistyy itse, jos Studio on kirjautunut samalle Roblox-tilille, jota käytät RoCodessa; muuten yhdistät chatin ja lisäosan kerran lisäosan paneelissa näkyvällä 8 merkin koodilla.
Mitä kannattaa tietää ennen vaihtoa. RoCode ei voi yhdistää Claude- tai Claude Code -tilausta. Se ajaa kolmansien osapuolten malleja OpenRouterin kautta, mukaan lukien Claude Sonnet 5.5 Prossa ja ylemmissä sekä Claude Opus 5.5 Studiossa ja ylemmissä, ja ilmainen Starter-paketti antaa 1 krediitin päivässä GPT-6 Lunalle. Se toimii muokkaustilasta. Lisäosalla 3.9 tai uudemmalla Build-tilassa se voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.11 tai uudemmalla ohjata testihahmoa tarkistaakseen, että peli toimii. Lisäosalla 3.9.14 tai uudemmalla se myös ottaa kuvia rakentamastaan muokkaustilassa ja voi korjata sen, mikä näyttää väärältä. Se ei aja koodia suoraan eikä luo meshejä, kun taas Studio MCP:n työkalut osaavat molemmat. Se voi hakea Creator Storesta ilmaisia malleja sanoillasi (sisällä olevat skriptit poistetaan) tai lisätä mallin, decalin tai meshin assetin ID:llä, ja sisustuksen, rakennukset ja rekvisiitan se suunnittelee uudelleen jokaiselle pelille. Sen Ask-tila vastaa paikkaasi koskeviin kysymyksiin pelkillä lukutyökaluilla eikä muuta mitään. Tilit ovat 13-vuotiaille ja vanhemmille, ja alle 18-vuotiaille vanhemman tai huoltajan luvalla.
Lisää RemoteEvent, jotta pelaajat voivat pyytää työkalua ServerStorage.Toolsista. Tarkista kaikki palvelimella.
- Voi ensin tutkia paikan Search Gamella ja List Childrenillä löytääkseen Tools-kansion ja skriptit, jotka jo jakavat työkaluja
- Kirjoittaa palvelinskriptin Create Scriptillä ja voi lisätä RemoteEventin Create Instancella
- Tarkistaa skriptin kääntymisen Studiossa Check Scriptillä ennen lopettamista. Tämä on käännöstarkistus, ei tyyppitarkistus eikä pelitesti
- Lähettää muutokset erinä, ja jokainen erä on kumouspiste Studion omassa historiassa
Lisäosalla 3.9 tai uudemmalla RoCode voi ajaa lyhyen pelitestin ja lukea virheet, ja lisäosalla 3.9.15 tai uudemmalla sen testihahmo osaa kävellä, painaa näppäimiä ja klikata näytön painikkeita, mutta se tarkistaa vain sen, mitä se itse päätti tarkistaa, joten paina Play itse tarkistaaksesi tuloksen pelaajana. Kehote on meidän kirjoittamamme esimerkki; vaiheissa ovat työkalujen oikeat nimet. Miten lisäosa ja paritus toimivat. RoCode on itsenäinen tuote, joka ei ole sidoksissa Roblox Corporationiin eikä sen hyväksymä tai sponsoroima.
Usein kysytyt kysymykset
Voiko Claude Coden sijaan käyttää Claude Desktopia?
Kyllä. Claude Desktop on Studion Manage MCP Servers -paneelin Quick connect -luettelossa, joten se yhdistyy yhdellä kytkimellä Windowsissa tai Macissa. Se käyttää samoja Studion työkaluja; Claude Code lisää sen, missä terminaaliagentti on hyvä, kuten skriptitiedostojen ja Gitin käsittelyn. Molempien vaiheet ovat Studio MCP:n asetusoppaassa.
Voiko Claude Code yhdistää Roblox Studioon?
Kyllä. Roblox mainitsee Claude Coden quick connect -asiakkaana Studioon sisäänrakennetulle MCP-palvelimelle. Ota käyttöön Enable Studio as MCP server kohdassa Assistant > … > Manage MCP Servers, ota Claude Code käyttöön Quick connect -luettelossa ja käynnistä Claude Code uudelleen. Se voi myös käsitellä skriptejäsi tiedostoina Script Syncin tai Rojon kautta.
Onko Claude Code ilmainen Roblox Studio -työhön?
Studion MCP-palvelimella ei ole dokumentoitua hintaa, mutta Claude Code ei kuulu Anthropicin Free-pakettiin (claude.com/pricing, tarkistettu 9. lokakuuta 2026). Tarvitset maksullisen Claude-paketin, jossa se jakaa pakettisi käyttörajat, tai Claude Console -tilin, jossa maksat API-käytöstä.
Tarvitaanko Claude Coden käyttöön Roblox-lisäosaa tai HTTP-pyyntöjä?
Studion sisäänrakennetulle MCP-palvelimelle ei. Robloxin asetusvaiheet ovat palvelimen käyttöönotto Assistantissa ja asiakkaan yhdistäminen; niissä ei ole asennettavaa lisäosaa eikä muutettavaa HTTP-asetusta. Jotkin vanhemmat oppaat kuvaavat yhteisön MCP-palvelimia, jotka toimivat eri tavalla. Rojo, jos valitset sen tiedostoja varten, käyttää omaa Studio-lisäosaansa.
Voiko Claude Code testata Roblox-peliäni?
Studio MCP:n työkaluilla kyllä. start_stop_play käynnistää ja pysäyttää pelitestin, get_console_output lukee Outputin, screen_capture kuvaa näkymän, ja syötetyökalut liikuttavat hahmoa ja lähettävät näppäimiä ja klikkauksia. Tarkista se, mistä se raportoi, ja pelaa peliä itse ennen julkaisua.
Kumpi Roblox Studioon: Claude Code vai Codex?
Molemmat ovat Robloxin quick connect -luettelossa ja ylettyvät samoihin Studio MCP:n työkaluihin, joten ero on mallissa, tilissä ja sitä ympäröivässä asiakkaassa. Roblox ei julkaise vertailuja, emmekä ole tehneet niistä vertailutestejä. Kokeile kumpaakin paikkasi kopiolla samoilla kirjallisilla säännöillä ja pidä se, jonka muutokset vaativat vähemmän korjauksia.
Toimiiko Claude Code Roblox Studion kanssa Macilla?
Kyllä. Claude Code tukee macOS 13.0:aa tai uudempaa, ja Roblox dokumentoi macOS:n palvelinpolun /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP asiakkaille, jotka määrität käsin.
Lähteet ja lisälukemista
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (englanniksi). palvelimen käyttöönotto, quick connect, asetus JSONilla ja CLI:llä, työkalut, useat Studio-ikkunat ja ongelmien ratkaisu
- Roblox Creator Docs: Build with a coding harness (englanniksi). Claude Code VS Codessa, Script Sync, MCP ja Git yhdessä
- Roblox Creator Docs: Script Sync (englanniksi). mitä synkronoidaan, tiedostonimisäännöt, ristiriidat ja language server
- Roblox Creator Docs: Third-party tools (englanniksi). Rojo ja Rokit sekä versionhallinta
- Roblox Creator Docs: Secrets stores (englanniksi). miten API-avaimet pidetään skriptien ulkopuolella
- Roblox Creator Docs: Data stores (englanniksi). miksi Studion pääsy API servicesiin kuuluu vain testikopioon
- Rojo documentation (v7) (englanniksi). asennus ja se, miten tiedostonimistä tulee objekteja
- Claude Code Docs: Overview (englanniksi). kaikilla vaihtoehdoilla on sama moottori, ja työpöytäsovellus vaatii maksullisen tilauksen
- Claude Code Docs: Advanced setup (englanniksi). järjestelmävaatimukset ja asennuskomennot
- Claude Code Docs: Authentication (englanniksi). kirjautuminen ja sopivat tilityypit
- Claude Code Docs: Connect Claude Code to tools via MCP (englanniksi). stdio-palvelimet, .mcp.json, laajuudet ja palvelimen tila
- Claude Code Docs: Configure permissions (englanniksi). allow-, ask- ja deny-säännöt, myös MCP-työkaluille
- Claude Code Docs: Choose a permission mode (englanniksi). auto-tila aloitustilana, Manual-tila ja plan-tila
- Claude Code Docs: How Claude remembers your project (englanniksi). CLAUDE.md, /init ja AGENTS.md
- Claude Code Docs: Checkpointing (englanniksi). mitä /rewind palauttaa ja mitä se ei seuraa
- Claude Code Docs: Manage costs effectively (englanniksi). /usage, kontekstin koko ja mallin valinta
- Claude Code Docs: Use Claude Code in the cloud (englanniksi). miksi pilvi-istunnot eivät toimi tietokoneellasi
- Claude Code Docs: Use Claude Code in VS Code (englanniksi). vaatimukset, huomio PATHista, yhteinen MCP-konfiguraatio ja Problems-paneeli
- Claude Code Docs: Extend Claude with skills (englanniksi). mitä skillin allowed-tools-kenttä antaa
- Claude pricing (englanniksi). mihin paketteihin Claude Code sisältyy ja käyttörajat
- Claude Help Center: Use Claude Code with your Pro or Max plan (englanniksi). yhteiset rajat ja varoitus ANTHROPIC_API_KEY-muuttujasta
- Anthropic: Consumer Terms of Service (englanniksi). vähimmäisikä
Miten koodi tarkistettiin: jokainen tämän sivun skripti läpäisee Luaun tiukan tyyppitarkistuksen Roblox API:n määrittelyillä (luau-lsp, 20. marraskuuta 2026). Tyyppitarkistus löytää virheet API-nimissä ja väärät tyypit, mutta ei pelilogiikan virheitä, joten testaa kaikki Studiossa ennen julkaisua.