Opas · Tekoäly Roblox Studiossa

Miten Claude Code yhdistetään Roblox Studioon

Claude Code on Anthropicin agenttinen koodaustyökalu. Roblox mainitsee sen quick connect -asiakkaana Studioon sisäänrakennetulle MCP-palvelimelle, joten se voi lukea paikkaasi, muokata skriptejä ja ajaa pelitestejä Studio-ikkunassa, joka sinulla on auki. Se voi myös käsitellä skriptejäsi tiedostoina Script Syncin tai Rojon kautta. Tämä opas käsittelee Claude Coden puolta: mitä tarvitset, miten yhdistät sen, luvat, CLAUDE.md Roblox-säännöillä, turvallinen työtapa ja mitä se maksaa. OpenAI:n agentista kertoo opas miten OpenAI Codexia käytetään Roblox Studion kanssa (englanniksi); Cursorista, Claude Desktopista ja muista asiakkaista kertoo Studio MCP:n asetusopas.

Päivitetty 20. marraskuuta 202617 min lukuaikaKirjoittaja:

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
  1. Mitä tarvitset
  2. 1. Asennus ja kirjautuminen
  3. 2. Yhdistäminen Studioon
  4. 3. Luvat
  5. 4. Ensimmäinen pyyntö
  6. 5. Script Sync tai Rojo
  7. 6. CLAUDE.md
  8. Turvallinen työ
  9. Hinta
  10. Ongelmien ratkaisu
  11. Lisäosa-agentti
  12. Usein kysytyt kysymykset
  13. Lähteet ja lisälukemista

Mitä tarvitset ennen aloittamista

Vaatimukset Robloxin ja Anthropicin dokumentaation mukaan, 9. lokakuuta 2026
Mitä tarvitaanTiedot
Roblox StudioUusin versio, Windowsissa tai macOS:ssä. MCP-palvelin on sisäänrakennettu Studioon, joten Robloxin puolelle ei tarvitse asentaa mitään muuta.
Tietokone, joka tukee Claude CodeamacOS 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ältyyMaksullinen 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.
HalutessasiGit 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.

Claude Coden vaihtoehdot ja Roblox Studio
VaihtoehtoYltääkö Studioon?Huomioita
Terminaali (komento claude)KylläAja se projektikansiossa. Sitä tarvitaan myös alla oleviin claude mcp -komentoihin.
VS Coden tai Cursorin laajennusKyllä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 valittunaKylläToimii tietokoneellasi. Anthropicin mukaan tarvitaan maksullinen tilaus.
Pilvi-istunnot (claude.ai/code tai Cloud työpöytäsovelluksessa)EiNe 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.

Terminaali · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. 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.
  2. Siirry projektikansioon ja aja claude. Ensimmäisellä käynnistyskerralla se avaa selainikkunan kirjautumista varten. Jos selain ei avautunut, paina c kopioidaksesi kirjautumislinkin.
  3. 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

  1. Avaa samassa paneelissa (Assistant Settings > MCP Servers) Quick connect -luettelo. Siinä ovat tuetut asiakkaat, jotka on asennettu tietokoneellesi.
  2. Ota käyttöön Claude Code. Jos sitä ei ole, asenna Claude Code ja käynnistä Studio uudelleen.
  3. Käynnistä Claude Code uudelleen: lopeta istunto ja aja claude uudelleen 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:

.mcp.json · Windows (Robloxin konfiguraatio)
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
.mcp.json · macOS (Robloxin konfiguraatio)
{
  "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.

Terminaali · macOS
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 list näyttää jokaisen palvelimen ja sen tilan. claude mcp get Roblox_Studio näyttää enemmän, myös Issue:-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.
.claude/settings.json · esimerkki
{
  "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:

Kehote
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 ja Rojo Robloxin Script Sync- ja kolmannen osapuolen työkalusivujen mukaan
Script SyncRojo
Mikä se onStudion toiminto, joka synkronoi paikan skriptit levyn tiedostoihin molempiin suuntiin.Kolmannen osapuolen työkalu: palvelin tietokoneellasi sekä Studio-lisäosa.
Mitä se synkronoiVain 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öönottoNapsauta 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 CreateToimii 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 neuvoSopii 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.

Script Syncin säännöt Robloxin Script Sync -sivulta (.luau-tiedostot). Rojon säännöt Rojo v7:n Sync Details -sivulta, jossa luetellaan .lua-tiedostot
Tiedostonimen pääteScript Sync luoRojo luo
.serverScript, jonka suorituskonteksti on ServerScript
.clientScript, jonka suorituskonteksti on ClientLocalScript
.localLocalScriptEi erityistä merkitystä (mikä tahansa muu .lua-tiedosto on ModuleScript)
Ei päätettäModuleScriptModuleScript
Kansio, jossa on init-tiedostoSkripti lapsiobjekteineen, jonka tyypin määrää init-tiedoston nimiKansiosta tulee skripti, jota kuvaa init.server.lua, init.client.lua tai init.lua

Script Syncin asetus Claude Codea varten

  1. Luo projektikansio, jossa on yksi kansio jokaista levyllä pidettävää palvelua kohden, esimerkiksi ServerScriptService, ReplicatedStorage ja StarterPlayerScripts, ja aja siinä git init.
  2. 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.
  3. 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.
  4. Aja claude tässä kansiossa. Nyt Claude muokkaa .luau-tiedostoja, ja Studio ottaa jokaisen muutoksen käyttöön.
  5. Tee commit ennen jokaista istuntoa, jotta sinulla on aina puhdas piste, johon palata.
Terminaali, projektikansiossa
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.

CLAUDE.md · esimerkki Script Synciä käyttävälle projektille
# 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.

Script kohteessa ServerScriptService nimeltä 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 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

  1. 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.
  2. Pyydä suunnitelma kaikkeen yhtä skriptiä suurempaan ja lue se ennen hyväksymistä.
  3. Tarkista diff. Tiedostoista lue git diff tai laajennuksen sisäänrakennetut diffit ennen hyväksymistä. Studiossa tehdyistä muutoksista lue skriptit, joihin Claude koski, ja tarkista Explorerista ilmestyneet tai kadonneet objektit.
  4. 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.
  5. 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, ja CLAUDE.md yleensä 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.json ja CLAUDE.local.md, jotka on tarkoitettu pysymään Gitin ulkopuolella. Lisää CLAUDE.local.md itse .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_tree että script_read tukevat 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.

Sinä kirjoitat

Lisää RemoteEvent, jotta pelaajat voivat pyytää työkalua ServerStorage.Toolsista. Tarkista kaikki palvelimella.

RoCode tekee
  • 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

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.

Kokeile RoCodea omassa pelissäsi.

Ilmaisia krediittejä joka päivä, ei korttia. Asenna lisäosa, kuvaile ominaisuus ja katso, mitä Studioon ilmestyi.