Rehber · Roblox Studio'da yapay zeka

Claude Code ile Claude'u Roblox Studio'ya nasıl bağlarsın

Claude Code, Anthropic'in ajan tabanlı kodlama aracı. Roblox onu Studio'nun yerleşik MCP sunucusu için bir Quick connect istemcisi olarak listeliyor; yani açık olan Studio pencerende oyununu okuyabilir, scriptleri düzenleyebilir ve oyun testleri yapabilir. Script Sync ya da Rojo ile scriptlerinle dosya olarak da çalışabilir. Bu rehber işin Claude Code tarafını anlatıyor: ne gerekiyor, nasıl bağlanır, izinler, Roblox kurallarıyla bir CLAUDE.md, güvenli bir çalışma şekli ve ne kadar tuttuğu. OpenAI'nin ajanı için OpenAI Codex'i Roblox Studio ile kullanma rehberini (İngilizce) oku; Cursor, Claude Desktop ve diğer istemciler için Studio MCP kurulum rehberine bak.

Güncellendi: 20 Kasım 202618 dk okumaYazan:

Kısaca

Claude Code'u kur ve ücretli bir Claude planıyla ya da bir Claude Console hesabıyla giriş yap. Studio'da Assistant'ı aç, … > Manage MCP Servers'a tıkla, Enable Studio as MCP server'ı aç, sonra Quick connect altında Claude Code'u aç. Claude Code'u yeniden başlat, Studio sunucusunun bağlı olduğunu kontrol etmek için /mcp yaz ve sadece okuyan bir istekle başla.

  • Claude Code, Anthropic'in Free planında yok. Pro, Max, Team ve Enterprise'a dahil, ya da bir Claude Console hesabı üzerinden işlenen metin birimi başına ücretlendiriliyor (9 Ekim 2026'da kontrol edildi).
  • Yerel bir oturum kullan: terminal, VS Code ya da Cursor eklentisi veya Local seçili masaüstü uygulaması. Bulut oturumları bilgisayarının dışında çalışır ve Studio'ya ulaşamaz.
  • v2.1.283'ten beri terminal ve VS Code oturumları, mevcut olduğu yerde varsayılan olarak auto modunda başlıyor; bu yüzden oyununu değiştiren Studio araçları için ask kuralları ekle. Claude Code'un /rewind'ı Studio'da yapılan değişiklikleri geri almaz, o yüzden önce bir sürüm kaydet.
Bu sayfada
  1. Neler gerekiyor
  2. 1. Kur ve giriş yap
  3. 2. Studio'ya bağla
  4. 3. İzinler
  5. 4. İlk istek
  6. 5. Script Sync ya da Rojo
  7. 6. CLAUDE.md
  8. Güvenli akış
  9. Maliyet
  10. Sorunlar
  11. Plugin ajanı
  12. Sık sorulan sorular
  13. Kaynaklar ve ek okumalar

Başlamadan önce neler gerekiyor

Gereksinimler, Roblox ve Anthropic dokümantasyonuna göre, 9 Ekim 2026
GerekenAyrıntılar
Roblox StudioWindows ya da macOS'ta en son sürüm. MCP sunucusu Studio'nun içinde yerleşik, yani Roblox tarafında kurulacak başka bir şey yok.
Claude Code'u destekleyen bir bilgisayarmacOS 13.0 ya da üstü veya Windows 10 1809 ya da üstü, 4 GB ya da daha fazla RAM, internet bağlantısı ve Anthropic'in desteklediği bir ülkede bulunmak.
Claude Code'u içeren bir Claude hesabıÜcretli bir Claude planı (Pro, Max, Team ya da Enterprise) veya bir Claude Console hesabı. Anthropic'in fiyat sayfası Claude Code'un Free plana dahil olmadığını belirtiyor.
YaşAnthropic'in Consumer Terms'i (8 Ekim 2025'ten beri geçerli) en az 18 yaşında olman gerektiğini, ya da bulunduğun yerde rıza verme yaşı daha yüksekse o yaşta olman gerektiğini söylüyor.
İsteğe bağlıScriptlerinin geçmişini tutmak için Git. Claude Code'u terminal yerine bir editör panelinde istiyorsan Visual Studio Code 1.94.0 ya da üstü, veya Cursor.

Hangi Claude Code'u kullanmalı

Claude Code birkaç yerde çalışıyor. Anthropic hepsinin aynı motoru paylaştığını söylüyor, yani CLAUDE.md'n, ayarların ve MCP sunucuların hepsinde çalışır. Studio için önemli olan oturumun nerede çalıştığı: Roblox'un MCP sunucusu bilgisayarındaki yerel bir işlem, yani oturumun da bilgisayarında olması gerekiyor.

Claude Code arayüzleri ve Roblox Studio
ArayüzStudio'ya ulaşır mı?Notlar
Terminal (claude komutu)EvetProje klasöründe çalıştır. Aşağıdaki claude mcp komutları için de buna ihtiyacın var.
VS Code ya da Cursor eklentisiEvetRoblox'un coding harness rehberinin yolu. Eklenti kendi Claude Code kopyasıyla gelir ama PATH'ine claude eklemez; o komutları istiyorsan terminal sürümünü de kur.
Masaüstü uygulaması, Code sekmesi, Local seçiliEvetSenin makinende çalışır. Anthropic ücretli bir abonelik gerektiğini söylüyor.
Bulut oturumları (claude.ai/code ya da masaüstü uygulamasında Cloud)HayırSenin makinende değil bulut altyapısında çalışırlar, yani Studio'nun yerel sunucusunu başlatamazlar.

1. adım: Claude Code'u kur ve giriş yap

Anthropic'in önerdiği kurulum, terminalde tek bir komut. Bunlar kurulum sayfasının 9 Ekim 2026'da verdiği komutlar; güncel olanlar için Anthropic'in kurulum sayfasına (İngilizce) bak.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Yeni bir terminal penceresi aç ve claude --version çalıştır. Bir sürüm numarası çıkıyorsa çalışmış demektir. Komut bulunamıyorsa kurulum klasörü henüz PATH'inde değil; Anthropic'in kurulum sorunları sayfasında çözümü var.
  2. Proje klasörüne git ve claude çalıştır. İlk seferde giriş için bir tarayıcı penceresi açar. Tarayıcı açılmazsa giriş linkini kopyalamak için c'ye bas.
  3. Claude hesabınla giriş yap. Pro ya da Max girişi, planına dahil olan kullanımı harcar.

Windows'ta Anthropic, Claude Code'un Bash aracını kullanabilmesi için Git for Windows kurmanı öneriyor; o olmadan Claude Code komutları PowerShell'de çalıştırır. Bu kurulum için Claude Code'u WSL içine değil, doğrudan Windows'a kur: Roblox'un Windows yapılandırması %LOCALAPPDATA% yoluyla cmd.exe çalıştırıyor ve Roblox WSL'i belgelemiyor.

Editörde bir panel mi tercih edersin? VS Code ya da Cursor'da Extensions'ı aç (Ctrl+Shift+X, Mac'te Cmd+Shift+X), Claude Code'u ara, kur ve Claude panelinden giriş yap. Roblox'un coding harness rehberinin kullandığı kurulum bu.

2. adım: Claude Code'u Studio'ya bağla

Önce sunucuyu aç. Studio'da Assistant'ı aç, … > Manage MCP Servers'a tıkla ve Enable Studio as MCP server'ı aç. Studio MCP rehberi bu adımı daha ayrıntılı anlatıyor. Assistant butonunu görmüyor musun? Assistant panelini nasıl açacağına bak.

Quick connect

  1. Aynı panelde (Assistant Settings > MCP Servers) Quick connect'i aç. Bilgisayarında kurulu desteklenen istemcileri gösterir.
  2. Claude Code'u aç. Listede yoksa Claude Code'u kur ve Studio'yu yeniden başlat.
  3. Claude Code'u yeniden başlat: oturumu bitir ve claude'u tekrar çalıştır ya da eklentide yeni bir konuşma başlat. Roblox, bir istemcinin yeni bir yapılandırmayı alması için yeniden başlatılması gerektiğini söylüyor.

Roblox, Quick connect'in Claude Code'un hangi dosyasına yazdığını ya da sunucuya hangi adı verdiğini söylemiyor. Adı görmek için Claude Code'da /mcp yaz. 3. adımdaki izin kuralları için buna ihtiyacın var.

VS Code ya da Cursor'da Claude Code eklentisini mi kullanıyorsun? Burada da Claude Code'u aç. Roblox'un coding harness rehberi Cursor'u ya da Visual Studio Code'u açıyor, ama Anthropic eklentinin MCP yapılandırmasını Claude Code'un terminal sürümüyle paylaştığını belgeliyor ve editörün kendi MCP ayarlarını okuduğunu söylemiyor.

.mcp.json dosyasıyla elle yapılandırma

Quick connect işine yaramıyorsa Studio'yu kendin ekle. Claude Code projenin MCP sunucularını proje klasöründeki .mcp.json adlı bir dosyadan, Roblox'un belgelediği aynı mcpServers biçiminde okur ve type olmayan bir girdiyi yerel bir stdio sunucusu olarak ele alır. Yani Roblox'un yapılandırması olduğu gibi çalışır. Sistemine uygun olanı, claude'u çalıştırdığın klasöre .mcp.json olarak kaydet:

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

O klasörde claude'u bir sonraki çalıştırışında sunucuyu onaylamanı ister: Anthropic bu uyarıyı bir .mcp.json dosyasından gelen her sunucu için gösterir. Anthropic dosyayı depoya eklenip bir ekiple paylaşılsın diye tasarladı, ama Windows ve macOS yolları farklı. Ekibin ikisini de kullanıyorsa dosyayı depo dışında tut ve herkes Studio'yu kendisi eklesin.

macOS'ta Studio'yu tek bir komutla ekleyebilirsin. --scope user onu bilgisayarındaki tüm projelerde kullanılabilir yapar; bunu atlarsan sunucu sadece mevcut klasörde yüklenir. --, Claude Code'un kendi seçeneklerini sunucuyu başlatan komuttan ayırır.

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

Windows'ta JSON dosyası en basit yol, çünkü PowerShell ve CMD bir komut satırında %LOCALAPPDATA%'yı farklı ele alır.

Bağlantıyı kontrol et

  • Bir terminalde claude mcp list her sunucuyu ve durumunu gösterir. claude mcp get Roblox_Studio daha fazlasını gösterir; sunucu bağlanamadıysa bir Issue: satırı da dahil.
  • Claude Code içinde /mcp yaz. Bağlı sunucuların adının yanında bir araç sayısı görünür.
  • Studio'da Assistant > … > Manage MCP Servers, bağlı istemci sayısıyla yeşil bir gösterge gösterir.

3. adım: Claude'un sormadan ne yapabileceğine karar ver

Bunu Claude oyununa dokunmadan önce ayarla. Anthropic'in izin modları sayfasına göre Claude Code v2.1.283'ten beri etkileşimli terminal ve VS Code oturumları, mevcut olduğu her yerde varsayılan olarak auto modunda başlıyor ve auto modunda eylemleri senin yerine arka planda bir sınıflandırıcı kontrol ediyor. O zaman Studio'da bir scripti düzenleyen ya da Luau çalıştıran bir MCP çağrısı sormadan ilerleyebilir.

Her değişikliği kendi elinde tutmanın iki yolu var:

  • Manual modunda başla. claude --permission-mode default çalıştır. Manual modunda sadece okumalar sormadan çalışır. Oturum sırasında modlar arasında geçmek için Shift+Tab'e bas.
  • Bir şeyleri değiştiren Studio araçları için ask kuralları ekle. Anthropic hiçbir modun, açık bir ask kuralına uyan bir aracı otomatik onaylamadığını söylüyor, bypass modu bile.
.claude/settings.json · örnek
{
  "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 kuralları mcp__<server>__<tool> biçimindedir; sunucu adı Claude Code'daki haliyle yazılır. Roblox_Studio'yu /mcp'nin gösterdiği adla değiştir. Bir projenin .claude/settings.json dosyasındaki allow kuralları, o klasör için çalışma alanı güven diyaloğunu kabul ettikten sonra uygulanır. Sadece sana özel kurallar için .claude/settings.local.json kullan.

allow listesi sadece okuyan araçları kapsar: oyun ağacı, özellikler, scriptler, Output ve açık Studio pencerelerinin listesi. ask listesi oyununu değiştiren, kod çalıştıran, oyun testi başlatan, dışarıdan asset getiren ya da Roblox'a resim gönderen araçları kapsar. screen_capture ve girdi araçları gibi iki listede de olmayan araçlar izin modunu izler. Her birinin ne yaptığıyla birlikte araçların tam listesi Studio MCP rehberinde.

4. adım: sadece okuyan bir istekle başla

Üzerinde çalışmak istediğin oyunu aç ve diğerlerini kapat. Sonra Claude'a hiçbir şeyi değiştiremeyecek bir ilk istek ver:

Prompt
Use the Roblox Studio MCP tools. Call list_roblox_studios and tell me which place you are connected to, then list what is in Workspace. Do not change anything.

Yeni bir Baseplate'te Roblox'un coding harness rehberi, cevabın varsayılan Camera, Terrain, Baseplate ve SpawnLocation nesnelerini içermesini bekliyor. Önce list_roblox_studios istemek iyi bir alışkanlık: bir istemci açık olan tüm Studio pencerelerine ulaşabilir ve her araç çağrısı hedef penceresini bir studio_id ile belirtir.

Tek bir scriptten büyük her şey için önce bir plan iste. Plan modunda (Shift+Tab'e bas ya da prompt'a /plan ile başla) Claude dosyalarını düzenlemeden araştırır ve önerir. Anthropic plan modunu dosya düzenlemeleri ve shell komutları açısından tarif ediyor, bu yüzden Studio araçları için ask kurallarını da koru.

5. adım: Script Sync ya da Rojo ile scriptlerle dosya olarak çalış

Claude Code bir klasördeki dosyalarla çalışmak için tasarlandı. Onları kendi araçlarıyla düzenler, Git geçmişlerini tutar ve /rewind onları geri yükleyebilir. Scriptlerinin diskte olması bunların hepsini kullanmanı sağlar ve MCP araçlarını oyunun script olmayan kısımlarına bırakır; StarterGui'deki GUI'ler, RemoteEvent'ler ve parçalar gibi. Roblox bunu yapmanın iki yolunu belgeliyor.

Script Sync ve Rojo, Roblox'un Script Sync ve üçüncü taraf araçlar sayfalarına göre
Script SyncRojo
NedirOyunundaki scriptleri diskteki dosyalarla iki yönlü senkronize eden bir Studio özelliği.Üçüncü taraf bir araç: bilgisayarında bir sunucu artı bir Studio plugin'i.
Neyi senkronize ederSadece Script, LocalScript, ModuleScript ve Folder instance'larını. Senkronize edilen bir klasördeki diğer instance'lar yok sayılır.Bütün projeyi dosya olarak yönetebilir, doğruluk kaynağı olarak dosya sistemin kullanılır.
KurulumExplorer'da bir servise ya da klasöre sağ tıkla, Sync to…'yu seç ve bir klasör seç. Roblox'un coding harness rehberi önce onu File > Beta Features'ta açıyor.Rokit ile kur (rokit add rojo-rbx/rojo, sonra rokit install), plugin'i rojo plugin install ile ekle, rojo serve çalıştır ve plugin'den bağlan.
Team CreateOnunla çalışır. İki kişinin aynı senkronize scripti aynı anda düzenlemesinden kaçın.Roblox, üçüncü taraf araçların çoğu zaman yerleşik ortak çalışma araçlarıyla çalışmadığını belirtiyor.
Roblox'un tavsiyesiKod için kendi editörünü ve sürüm kontrolünü, geri kalan her şey için Studio'yu istiyorsan iyi uyar.Sadece kodu değil bütün projeni sürüm kontrolünde istiyorsan daha iyi bir seçenek.

Aynı dosya adı farklı şeyler anlamına gelebilir

İki araç da script türünü dosya adına göre seçer ve son ekler uyuşmaz. Bir .client dosyası Rojo'da bir LocalScript, ama Script Sync'te Client çalışma bağlamına sahip bir Script. Claude'a projenin hangi aracı kullandığını söyle; aşağıdaki CLAUDE.md örneği bunu yapıyor.

Script Sync kuralları Roblox'un Script Sync sayfasından (.luau dosyaları). Rojo kuralları Rojo v7'nin .lua dosyalarını listeleyen Sync Details sayfasından
Dosya adının sonuScript Sync şunu oluştururRojo şunu oluşturur
.serverServer çalışma bağlamına sahip ScriptScript
.clientClient çalışma bağlamına sahip ScriptLocalScript
.localLocalScriptÖzel bir anlamı yok (diğer her .lua dosyası bir ModuleScript)
Son ek yokModuleScriptModuleScript
init dosyası olan bir klasörChild'ları olan bir script; türünü init dosyasının adı belirlerKlasör, init.server.lua, init.client.lua ya da init.lua'nın tarif ettiği script olur

Script Sync'i Claude Code için ayarla

  1. Diskte istediğin her servis için bir klasör olan bir proje klasörü oluştur, örneğin ServerScriptService, ReplicatedStorage ve StarterPlayerScripts, ve içinde git init çalıştır.
  2. Bir servise sağ tıkladığında Script Sync görünmüyorsa onu File > Beta Features'ta aç, Save'e tıkla ve Studio'yu yeniden başlat.
  3. Explorer'da ServerScriptService'e sağ tıkla, Script Sync > Sync to'yu seç ve içindeki bir klasörü değil, ana proje klasörünü seç. Diğer servisler için tekrarla.
  4. O klasörde claude çalıştır. Artık Claude .luau dosyalarını düzenliyor ve Studio her değişikliği alıyor.
  5. Her oturumdan önce commit at, böylece geri dönebileceğin temiz bir noktan her zaman olur.
Terminal, proje klasöründe
git add .
git commit -m "Before Claude session"

Bir ajanla çalışırken Script Sync'in iki kuralı daha da önemli. Attribute ya da tag'i olan scriptleri senkronize etme: Script Sync onları yok sayar ve Roblox bunun veri kaybına yol açabileceği konusunda uyarıyor. Ve Studio kapalıyken dosyalar değişirse, oyunu tekrar açtığında Studio bunun nasıl çözüleceğini sorar ve Keep Studio ile Keep Disk'in neyi ekleyeceğini, değiştireceğini ya da sileceğini listeler. Seçmeden önce o listeyi oku.

Script Sync açıkken bir dosya düzenlemesi kaydedildiği anda Studio'ya ulaşır. Claude Code'da bir düzenlemeyi kabul etmek onu oyununda kabul etmek demek, bu yüzden kabul etmeden önce gözden geçir, özellikle düzenlemeleri otomatik kabul eden modlarda.

Editöründe otomatik tamamlama ve tip hataları için Roblox, tamamlayıcı Studio plugin'iyle birlikte Luau Language Server eklentisini öneriyor. VS Code'da Claude Code eklentisi Problems panelini yerleşik bir araçla okuyabilir, yani Claude senin gördüğün uyarıların aynısını görür.

6. adım: Roblox kurallarını Claude'a CLAUDE.md ile ver

Her Claude Code oturumu taze bir bağlamla başlar. Proje klasöründeki bir CLAUDE.md dosyası her oturumun başında okunur, yani kuralların oraya gider. Claude'un bir taslak yazması için /init çalıştır ya da kendin yaz. Anthropic'in tavsiyesi onu 200 satırın altında tutmak, kontrol edilebilecek kadar somut kurallar yazmak ve yüklendiğini doğrulamak için /context çalıştırmak.

Bu örnek bu rehber için, Script Sync kullanan bir proje için yazıldı. Adları oyununa uyacak şekilde değiştir ve ihtiyacın olmayanı sil.

CLAUDE.md · Script Sync kullanan bir proje için örnek
# 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.

Bazı satırlar araçların çalışma şekli yüzünden orada. Dosya adı kuralları, .client.luau Script Sync'te bir LocalScript olmadığı için var. list_roblox_studios satırı, sunucu tüm açık pencerelere ulaşabildiği için var. Asset satırı, insert_asset oyununa dışarıdan içerik getirdiği ve upload_image Roblox'un asset sunucusuna resim gönderdiği için var. wait satırı, wait, spawn ve delay'i task kütüphanesi lehine kullanımdan kalkmış olarak işaretleyen Roblox API referansını izliyor.

Projende diğer kodlama ajanları için zaten bir AGENTS.md varsa Claude Code onu proje talimatları olarak okuyabilir, yani ikisi için tek bir dosya tutabilirsin. Anthropic'in memory sayfası ikisi birden varsa hangisinin geçerli olduğunu açıklıyor.

Bu kurallar kodda nasıl görünür

Bu, yukarıdaki Luau kurallarına uyan bir sunucu scripti. Bu rehber için elle yazıldı, Claude üretmedi. Claude'un sana verdiklerini gözden geçirirken onu ölçüt olarak kullan. Bir LocalScript RequestTool:FireServer("Sword") ile bir araç ister ve her şeyi sunucu kontrol eder.

Script konum: ServerScriptService adı: 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 sadece scriptleri ve klasörleri senkronize eder, bu yüzden sunucu kendi remote'unu oluşturur.
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)
	-- Oyuncu çıktıktan sonra gelen bir isteği yok say.
	if player.Parent ~= Players then
		return
	end

	-- 1. Argümanı kontrol et: bir istemci her şeyi gönderebilir.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Bir oyuncunun ne sıklıkla isteyebileceğini sınırla.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Sunucu karar verir. Kendi sahiplik kontrolünü buraya ekle (bir game pass, bir satın alma kaydı).
	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. Oyuncu başına temizlik.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Script Sync ile diskte: ServerScriptService/ToolRequests.server.luau. Tool nesnelerini ServerStorage'da Tools adlı bir Folder'a koy. Bir sahiplik kontrolü ekleyene kadar her oyuncu o klasördeki her aracı alabilir.

Claude'un yazdığı her remote handler'da aynı şeylere bak: istemcinin gönderdiğinin türünü ve boyutunu kontrol ediyor mu, bir oyuncunun onu ne sıklıkla çağırabileceğini sınırlıyor mu, kararı sunucu mu veriyor, oyuncu çıkınca onun girdisini siliyor mu. RemoteEvents rehberi her birinin neden önemli olduğunu açıklıyor.

Güvenli bir çalışma şekli: kontrol noktası, gözden geçirme, test

  1. İki tarafta da bir kontrol noktası oluştur. Dosyalarını Git'e commit et ve Studio'da oyunun bir sürümünü File > Save to Roblox with Notes ile kaydet. Studio MCP rehberi Version History'den bir sürümü nasıl geri yükleyeceğini gösteriyor.
  2. Tek bir scriptten büyük her şey için bir plan iste ve onaylamadan önce oku.
  3. Diff'i gözden geçir. Dosyalar için kabul etmeden önce git diff'i ya da eklentinin satır içi diff'lerini oku. Studio'da yapılan değişiklikler için Claude'un dokunduğu scriptleri oku ve Explorer'da ortaya çıkan ya da kaybolan nesnelere bak.
  4. Kendin test et. Claude bir oyun testi başlatıp Output'u okuyabilir, ama sadece kontrol etmeye karar verdiği şeyi kontrol eder. Commit atmadan ya da yayınlamadan önce özelliği bir oyuncu gibi oyna.
  5. Çalıştığında neyin değiştiğini söyleyen bir mesajla commit at.

/rewind neyi geri alabilir, neyi alamaz

Claude Code her prompt'tan önce bir kontrol noktası kaydeder ve /rewind (ya da iki kez Esc) Claude'un dosya düzenleme araçlarıyla değiştirdiği dosyaları geri yükler. Anthropic, shell komutlarıyla yapılan değişiklikler dahil, neyi kaydetmediğini listeliyor. MCP araçlarıyla Studio'da yapılan değişiklikler dosya düzenlemesi değil, yani /rewind'ın onları geri almasını bekleme; Roblox'un MCP sayfası da bunların Studio'nun geri alma geçmişine girip girmediğini söylemiyor. Script Sync ile /rewind'ın geri yüklediği bir dosya, diskteki diğer her değişiklik gibi Studio'ya geri senkronize edilir. Geri kalan her şey için dönüş yolun kaydettiğin sürüm.

Gizli bilgileri ve canlı verileri onun erişiminden uzak tut

  • API anahtarlarını, Open Cloud anahtarlarını, webhook URL'lerini ya da şifreleri bir prompt'a veya CLAUDE.md'ye yapıştırma. İkisi de Claude'un okuduğu metin ve CLAUDE.md genelde deponuza eklenir.
  • Onları scriptlere de sabit olarak yazma. Roblox'un her oyun için bir gizli bilgi deposu var: gizli bilgileri Creator Dashboard'da oluştur ve bir sunucu scriptinde HttpService:GetSecret() ile oku. Yerel testler için File > Experience Settings > Security'de yerel gizli bilgiler ekle.
  • Kişisel ayarlarını Git dışında kalmak üzere tasarlanmış .claude/settings.local.json ve CLAUDE.local.md içinde tut. CLAUDE.local.md'yi .gitignore'a kendin ekle.
  • Enable Studio Access to API Services'ı sadece oyununun ayrı bir test kopyasında aç. Roblox, Studio'nun canlı oyunla aynı data store'ları kullandığı konusunda uyarıyor, yani Claude'un orada başlattığı bir oyun testi gerçek oyuncu verilerinin üzerine yazabilir.
  • Üçüncü taraf bir skill'i kurmadan önce oku. Skill dizinlerinde Claude Code için Roblox skill'leri var ve Anthropic bir skill'in allowed-tools alanıyla kendine geniş araç erişimi verebileceğini belirtiyor.

Roblox üzerinde çalışmak için Claude Code ne kadar tutar

Studio tarafının belgelenmiş bir fiyatı yok: MCP sunucusu Studio'nun parçası ve Roblox'un MCP sayfası herhangi bir ücretten bahsetmiyor. Maliyet Claude Code'un maliyeti ve Anthropic iki ödeme yolu sunuyor (9 Ekim 2026 itibarıyla):

  • Bir Claude aboneliği. Claude Code Pro, Max, Team ve Enterprise'a dahil, Free'ye değil. Web, masaüstü ve mobildeki Claude ile aynı kullanımdan harcar. Limitler beş saatlik kayan bir pencerede sıfırlanır ve ücretli planların ayrıca haftalık limitleri var. Birine ulaştığında bekleyebilir, daha yüksek bir plana geçebilir ya da kullanım kredilerini açabilirsin.
  • Bir Claude Console hesabı. API kullanımını işlenen metin birimi başına ödersin. Anthropic'in maliyet sayfası harcamanın seçtiğin modele, kod tabanının boyutuna ve nasıl kullandığına göre çok değiştiğini söylüyor.

Güncel fiyatlar claude.com/pricing adresinde. Bu rehber onları tekrarlamıyor çünkü değişiyorlar. Claude Code içinde /usage abonelere plan kullanım çubuklarını, API kullananlara da oturumun tahmini maliyetini gösterir.

Bir Roblox oturumunun daha fazla harcamasına ne yol açar

  • Bağlamın boyutu. Harcama, Claude'un bağlamında tuttuklarıyla büyür. Birbiriyle ilgisi olmayan görevler arasında /clear kullan.
  • Büyük araç sonuçları. Büyük bir oyunun bütün ağacını gezmek ya da uzun scriptleri baştan sona okumak çok metin döndürür. Claude Code metni modelin ölçtüğü birimlerle sayar: bir MCP aracının sonucu bu birimlerden 10.000'i geçtiğinde uyarır ve varsayılan olarak 25.000 ile sınırlar. Tek bir klasör, bir derinlik sınırı ya da bir satır aralığı iste: search_game_tree ve script_read bunları destekliyor.
  • Seçtiğin model. Anthropic, Sonnet'in çoğu kodlama görevini iyi çözdüğünü ve Opus'tan daha ucuz olduğunu söylüyor. /model ile değiştir.

Claude Code ve Studio sorunlarını giderme

Roblox'un kontrol listesi kısa: Studio'yu ve istemciyi yeniden başlat, komut yolunun var olduğunu kontrol et ve JSON'u gözden geçir. Bunlar Claude Code'a özgü durumlar.

Claude Code, Quick connect listesinde yok

Liste sadece bilgisayarında kurulu desteklenen istemcileri gösterir. Claude Code'u kur, sonra Studio'yu yeniden başlat. Studio açıkken kurduysan Studio'yu, Claude Code'u ya da ikisini yeniden başlat. 2. adımdaki .mcp.json dosyası Quick connect olmadan çalışır.

/mcp, Roblox Studio sunucusunu göstermiyor

Sunucuyu ekledikten sonra Claude Code'u yeniden başlat. Sonra nereye eklendiğini kontrol et: --scope olmadan eklenen bir sunucu sadece eklediğin klasörde yüklenir, o yüzden claude'u o klasörden başlat ya da --scope user ile tekrar ekle. VS Code'da yeni bir konuşma başlat, çünkü değişiklikler sonra başlayan konuşmalara uygulanır.

Sunucu Pending approval diyor

Bir .mcp.json dosyasından geliyor ve Claude Code bunları kullanmadan önce sorar. O klasörde claude çalıştır, çalışma alanı güven diyaloğunu kabul et ve sunucuyu onayla. claude mcp reset-project-choices önceki kararları siler.

Sunucu Failed to connect gösteriyor

claude mcp get Roblox_Studio çalıştır ve Issue: satırını oku. Dosyanın var olduğunu kontrol et: Windows'ta %LOCALAPPDATA%\Roblox\mcp.bat, macOS'ta /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP (Studio başka bir yere kuruluysa yolu değiştir). Enable Studio as MCP server'ın hâlâ açık olduğundan emin ol, sonra Studio'yu ve Claude Code'u yeniden başlat.

Terminal claude'u tanımadığını söylüyor

Kurduktan sonra yeni bir terminal penceresi aç. Hâlâ bulunamıyorsa kurulum klasörü PATH'inde değil; Anthropic'in kurulum sorunları sayfasında çözümü var. VS Code eklentisi PATH'ine claude eklemez, bu yüzden bu rehberdeki komutlar için terminal sürümünü ayrıca kur.

Claude yanlış oyunu değiştirdi

Birkaç Studio penceresi açıkken her araç çağrısı hedefini bir studio_id ile belirtir. Claude'dan list_roblox_studios'u çağırmasını iste ve istediğin oyunun adını söyle, kullanmadığın pencereleri kapat ve değişen oyunu Version History'den geri yükle.

Claude Code planım yerine API anahtarımdan ücret alıyor

Onu onayladığın anda bir ANTHROPIC_API_KEY ortam değişkeni aboneliğinin yerini alır. Değişkeni kaldır (ya da /config'te Use custom API key'i kapat), Claude Code'u tekrar başlat ve hangi girişin aktif olduğunu kontrol etmek için /status çalıştır. Hâlâ bir Console hesabıysa /login çalıştır ve Claude hesabını seç.

Bir bulut oturumu Studio'yu görmüyor

Bulut oturumları bilgisayarında değil Anthropic'in altyapısında çalışır, yani Studio'nun yerel sunucusuna ulaşamazlar. Terminali, editör eklentisini ya da Local seçili masaüstü uygulamasını kullan.

Ya da plugin tabanlı bir ajan kullan: RoCode

MCP ile Claude Code, terminalde ya da bir kod editöründe rahat olanlar için iyi. RoCode (RoCode.app) başka bir yol: Roblox Studio için bağımsız bir yapay zeka ajanı; rocode.app'te bir web sohbeti ve açık olan oyununda adımları uygulayan Creator Store'dan ücretsiz bir plugin. Bir MCP ürünü değil ve Studio'nun MCP sunucusunu kullanmıyor, yani ayarlanacak bir komut satırı, yapılandırma dosyası ya da MCP sunucusu yok. Studio, RoCode'da kullandığın aynı Roblox hesabıyla giriş yapmışsa plugin kendiliğinden bağlanır; değilse sohbeti ve plugin'i, plugin panelinin gösterdiği 8 karakterlik kodla bir kez eşleştirirsin.

Geçmeden önce bilmeye değer şeyler. RoCode bir Claude ya da Claude Code aboneliği bağlayamaz. OpenRouter üzerinden üçüncü taraf modeller çalıştırır; bunlar arasında Pro ve üstünde Claude Sonnet 5.5 ve Studio ve üstünde Claude Opus 5.5 var, ücretsiz Starter planı da GPT-6 Luna'da günde 1 kredi verir. Düzenleme modundan çalışır. Plugin 3.9 ya da üstüyle, Build modunda, kısa bir test yapıp hataları okuyabilir, plugin 3.9.11 ya da üstüyle de oyunun çalıştığını kontrol etmek için bir test karakterini yönetebilir. Plugin 3.9.14 ya da üstüyle ayrıca düzenleme modunda kurduğu şeyin ekran görüntülerini alır ve kötü görünen şeyi düzeltebilir. Doğrudan kod çalıştırmaz ve mesh üretmez; bu ikisini Studio'nun MCP araçları yapabilir. Senin kelimelerinle Creator Store'da ücretsiz modeller arayabilir (içlerindeki scriptleri kaldırır) ya da bir modeli, decal'ı veya mesh'i asset ID'siyle ekleyebilir, ve her oyun için yeni dekor, bina ve prop'lar tasarlar. Ask modu sadece okuma araçlarıyla oyunun hakkındaki soruları cevaplar ve hiçbir şeyi değiştirmez. Hesaplar 13 yaş üstü içindir; 18 yaşından küçüksen annenin, babanın ya da vasinin izniyle.

Sen yazarsın

Oyuncuların ServerStorage.Tools'tan bir araç isteyebilmesi için bir RemoteEvent ekle. Her şeyi sunucuda kontrol et.

RoCode yapar
  • Tools klasörünü ve zaten araç veren scriptleri bulmak için önce oyunu Search Game ve List Children ile inceleyebilir
  • Sunucu scriptini Create Script ile yazar ve RemoteEvent'i Create Instance ile ekleyebilir
  • Bitirmeden önce scriptin derlendiğini Studio içinde Check Script ile kontrol eder. Bu bir derleme kontrolüdür, tip kontrolü ya da oyun testi değil
  • Değişikliklerini gruplar halinde gönderir ve her grup Studio geçmişinde bir geri alma noktasıdır

Plugin 3.9 ya da üstüyle RoCode kısa bir test yapıp hataları okuyabilir, plugin 3.9.15 ya da üstüyle de test karakteri yürüyebilir, tuşlara basabilir ve ekrandaki butonlara tıklayabilir, ama sadece test etmeye karar verdiği şeyi kontrol eder; bu yüzden sonucu bir oyuncu olarak test etmek için Play'e kendin bas. Prompt bizim yazdığımız bir örnek; adımlar araçların gerçek adlarını kullanıyor. Plugin ve eşleştirme nasıl çalışır. RoCode bağımsız bir üründür; Roblox Corporation ile bağlantılı değildir, onun tarafından desteklenmez ya da sponsor olunmaz.

Sık sorulan sorular

Claude Code yerine Claude Desktop kullanabilir miyim?

Evet. Claude Desktop, Studio'nun Manage MCP Servers panelindeki Quick connect listesinde, yani Windows'ta ya da Mac'te tek bir anahtarla bağlanır. Aynı Studio araçlarını kullanır; Claude Code ise bir terminal ajanının iyi yaptığı şeyleri ekler, script dosyalarıyla ve Git ile çalışmak gibi. İkisinin adımları da Studio MCP kurulum rehberinde.

Claude Code, Roblox Studio'ya bağlanabilir mi?

Evet. Roblox, Claude Code'u Studio'nun yerleşik MCP sunucusu için bir Quick connect istemcisi olarak listeliyor. Assistant > … > Manage MCP Servers'ta Enable Studio as MCP server'ı aç, Quick connect'te Claude Code'u aç ve Claude Code'u yeniden başlat. Script Sync ya da Rojo ile scriptlerinle dosya olarak da çalışabilir.

Claude Code, Roblox Studio ile kullanmak için ücretsiz mi?

Studio'nun MCP sunucusunun belgelenmiş bir fiyatı yok, ama Claude Code Anthropic'in Free planının parçası değil (claude.com/pricing, 9 Ekim 2026'da kontrol edildi). Ya planının kullanım limitlerini paylaştığı ücretli bir Claude planına ya da API kullanımı için ücretlendirilen bir Claude Console hesabına ihtiyacın var.

Claude Code'u kullanmak için bir Roblox plugin'ine ya da HTTP isteklerine ihtiyacım var mı?

Studio'nun yerleşik MCP sunucusu için hayır. Roblox'un kurulum adımları sunucuyu Assistant'ta açmak ve istemciyi bağlamak; kurulacak bir plugin ya da değiştirilecek bir HTTP ayarı içermiyor. Bazı eski rehberler farklı çalışan topluluk MCP sunucularını anlatıyor. Dosyalar için Rojo'yu seçersen o kendi Studio plugin'ini kullanır.

Claude Code Roblox oyunumu test edebilir mi?

Studio'nun MCP araçları üzerinden evet. start_stop_play bir oyun testini başlatıp durdurur, get_console_output Output'u okur, screen_capture viewport'u yakalar ve girdi araçları karakteri hareket ettirip tuşlar ve tıklamalar gönderir. Bildirdiklerini gözden geçir ve yayınlamadan önce oyunu kendin oyna.

Roblox Studio ile Claude Code mu yoksa Codex mi kullanmalıyım?

İkisi de Roblox'un Quick connect listesinde ve aynı Studio MCP araçlarına ulaşıyor, yani fark model, hesap ve etrafındaki istemcide. Roblox bir karşılaştırma yayınlamıyor ve biz de onları birbirine karşı ölçmedik. Her birini aynı yazılı kurallarla oyununun bir kopyasında dene ve daha az düzeltme gerektiren değişiklikler yapanla devam et.

Claude Code bir Mac'te Roblox Studio ile çalışır mı?

Evet. Claude Code macOS 13.0 ve üstünü destekliyor ve Roblox elle yapılandırdığın istemciler için bir macOS sunucu yolu belgeliyor: /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP.

Kaynaklar ve ek okumalar

Kod nasıl kontrol edildi: bu sayfadaki her script, Roblox API tanımlarıyla Luau'nun katı tür denetleyicisinden geçiyor (luau-lsp, 20 Kasım 2026). Tür denetimi yanlış yazılmış API'leri ve hatalı türleri yakalar, oyun mantığını değil. Bu yüzden yayınlamadan önce Studio'da test et.

RoCode'u kendi oyununda dene.

Her gün ücretsiz kredi, kart gerekmez. Plugin'i kur, özelliği anlat ve Studio'da ne oluştuğunu kontrol et.