Panduan · AI dalam Roblox Studio

Cara sambungkan Claude Code ke Roblox Studio

Claude Code ialah alat pengekodan agentik daripada Anthropic. Roblox menyenaraikannya sebagai client quick connect untuk pelayan MCP yang terbina dalam Studio, jadi ia boleh membaca place anda, menyunting skrip dan menjalankan playtest dalam tetingkap Studio yang anda buka. Ia juga boleh bekerja dengan skrip anda sebagai fail melalui Script Sync atau Rojo. Panduan ini tentang bahagian Claude Code: apa yang diperlukan, cara menyambungkannya, kebenaran, CLAUDE.md dengan peraturan untuk Roblox, cara kerja yang selamat dan berapa kosnya. Untuk ejen OpenAI, lihat panduan cara menggunakan OpenAI Codex dengan Roblox Studio (dalam bahasa Inggeris); untuk Cursor, Claude Desktop dan client lain, lihat panduan tetapan Studio MCP.

Dikemas kini 20 November 202621 minit bacaanDitulis oleh

Ringkasnya

Pasang Claude Code dan log masuk dengan pelan Claude berbayar atau akaun Claude Console. Dalam Studio, buka Assistant, klik … > Manage MCP Servers, hidupkan Enable Studio as MCP server, kemudian hidupkan Claude Code dalam senarai Quick connect. Mulakan semula Claude Code, taip /mcp untuk memastikan pelayan Studio bersambung, dan mulakan dengan permintaan yang hanya membaca.

  • Claude Code tiada dalam pelan Free daripada Anthropic. Ia termasuk dalam Pro, Max, Team dan Enterprise, atau dibayar mengikut jumlah penggunaan API melalui akaun Claude Console (disemak pada 9 Oktober 2026).
  • Gunakan sesi tempatan: terminal, sambungan untuk VS Code atau Cursor, atau aplikasi desktop dengan Local dipilih. Sesi awan tidak berjalan pada komputer anda dan tidak dapat mencapai Studio.
  • Bermula dengan v2.1.283, sesi dalam terminal dan VS Code secara lalai bermula dalam mod auto di tempat ia tersedia, jadi tambah peraturan ask untuk alat Studio yang mengubah place. Arahan /rewind dalam Claude Code tidak membatalkan perubahan yang dibuat dalam Studio, jadi simpan versi dahulu.
Di halaman ini
  1. Apa yang diperlukan
  2. 1. Pasang dan log masuk
  3. 2. Sambung ke Studio
  4. 3. Kebenaran
  5. 4. Permintaan pertama
  6. 5. Script Sync atau Rojo
  7. 6. CLAUDE.md
  8. Kerja selamat
  9. Kos
  10. Selesaikan masalah
  11. Ejen plugin
  12. Soalan lazim
  13. Sumber dan bacaan lanjut

Apa yang diperlukan sebelum bermula

Keperluan, menurut dokumentasi Roblox dan Anthropic, 9 Oktober 2026
Apa yang diperlukanButiran
Roblox StudioVersi terkini, pada Windows atau macOS. Pelayan MCP terbina dalam Studio, jadi tiada apa lagi yang perlu dipasang di pihak Roblox.
Komputer yang menyokong Claude CodemacOS 13.0 atau lebih baharu, atau Windows 10 1809 atau lebih baharu, RAM sekurang-kurangnya 4 GB, sambungan internet dan lokasi di negara yang disokong oleh Anthropic.
Akaun Claude yang merangkumi Claude CodePelan Claude berbayar (Pro, Max, Team atau Enterprise) atau akaun Claude Console. Halaman harga Anthropic menyatakan bahawa Claude Code tidak termasuk dalam pelan Free.
UmurConsumer Terms daripada Anthropic (berkuat kuasa sejak 8 Oktober 2025) menyatakan bahawa anda mesti berumur sekurang-kurangnya 18 tahun, atau umur minimum persetujuan di negara anda jika ia lebih tinggi.
PilihanGit, untuk menyimpan sejarah skrip. Visual Studio Code 1.94.0 atau lebih baharu, atau Cursor, jika anda mahu Claude Code dalam panel editor dan bukan dalam terminal.

Claude Code mana yang perlu digunakan

Claude Code berjalan di beberapa tempat. Anthropic menyatakan bahawa semuanya menggunakan enjin yang sama, jadi CLAUDE.md, tetapan dan pelayan MCP anda berfungsi di mana-mana. Bagi Studio, yang penting ialah di mana sesi berjalan: pelayan MCP Roblox ialah proses tempatan pada komputer anda, jadi sesi juga mesti berada pada komputer anda.

Pilihan Claude Code dan Roblox Studio
PilihanBoleh capai Studio?Nota
Terminal (arahan claude)YaJalankannya dalam folder projek. Ia juga diperlukan untuk arahan claude mcp di bawah.
Sambungan untuk VS Code atau CursorYaLaluan daripada panduan Roblox tentang coding harness. Sambungan ini mengandungi salinan Claude Code sendiri, tetapi tidak menambah claude ke PATH, jadi jika anda memerlukan arahan itu, pasang juga versi terminal.
Aplikasi desktop, tab Code, dengan Local dipilihYaBerjalan pada komputer anda. Anthropic menyatakan bahawa langganan berbayar diperlukan.
Sesi awan (claude.ai/code atau Cloud dalam aplikasi desktop)TidakIa berjalan dalam infrastruktur awan, bukan pada komputer anda, jadi tidak boleh menjalankan pelayan Studio tempatan.

Langkah 1: pasang Claude Code dan log masuk

Anthropic mengesyorkan pemasangan dengan satu arahan dalam terminal. Inilah arahan yang ada pada halaman pemasangannya pada 9 Oktober 2026; untuk yang terkini, lihat halaman pemasangan Anthropic.

Terminal · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. Buka tetingkap terminal baharu dan jalankan claude --version. Nombor versi bermakna semuanya berjaya. Jika arahan tidak ditemui, folder pemasangan belum ada dalam PATH, dan penyelesaiannya ada pada halaman Anthropic tentang masalah pemasangan.
  2. Pergi ke folder projek dan jalankan claude. Pada kali pertama ia membuka tetingkap pelayar untuk log masuk. Jika pelayar tidak terbuka, tekan c untuk menyalin pautan log masuk.
  3. Log masuk ke akaun Claude anda. Log masuk dengan Pro atau Max menggunakan had yang termasuk dalam pelan anda.

Pada Windows, Anthropic mengesyorkan pemasangan Git for Windows supaya Claude Code boleh menggunakan alat Bash miliknya; tanpanya, Claude Code menjalankan arahan dalam PowerShell. Untuk tetapan ini, pasang Claude Code dalam Windows itu sendiri, bukan di dalam WSL: konfigurasi Roblox untuk Windows menjalankan cmd.exe dengan laluan %LOCALAPPDATA%, dan Roblox tidak mendokumentasikan WSL.

Lebih suka panel dalam editor? Dalam VS Code atau Cursor, buka Extensions (Ctrl+Shift+X, atau Cmd+Shift+X pada Mac), cari Claude Code, pasangnya dan log masuk dari panel Claude. Inilah tetapan yang digunakan oleh panduan Roblox tentang coding harness.

Langkah 2: sambungkan Claude Code ke Studio

Hidupkan pelayan dahulu. Dalam Studio, buka Assistant, klik … > Manage MCP Servers dan hidupkan Enable Studio as MCP server. Panduan Studio MCP menghuraikan langkah ini dengan lebih terperinci. Tiada butang Assistant? Lihat cara membuka panel Assistant.

Quick connect

  1. Dalam panel yang sama (Assistant Settings > MCP Servers), kembangkan senarai Quick connect. Ia mengandungi client yang disokong dan dipasang pada komputer anda.
  2. Hidupkan Claude Code. Jika ia tiada, pasang Claude Code dan mulakan semula Studio.
  3. Mulakan semula Claude Code: tamatkan sesi dan jalankan claude sekali lagi, atau mulakan perbualan baharu dalam sambungan. Roblox menyatakan bahawa client perlu dimulakan semula untuk membaca konfigurasi baharu.

Roblox tidak menyatakan fail mana yang ditulis oleh quick connect untuk Claude Code dan apa nama yang diberikan kepada pelayan. Taip /mcp dalam Claude Code untuk melihat nama itu. Ia diperlukan untuk peraturan kebenaran dalam langkah 3.

Menggunakan sambungan Claude Code dalam VS Code atau Cursor? Hidupkan Claude Code di sini juga. Panduan Roblox tentang coding harness menghidupkan Cursor atau Visual Studio Code, tetapi Anthropic mendokumentasikan bahawa sambungan itu berkongsi konfigurasi MCP dengan versi terminal Claude Code, dan tidak menyatakan bahawa ia membaca tetapan MCP editor itu sendiri.

Tetapan manual melalui fail .mcp.json

Jika quick connect tidak berfungsi untuk anda, tambah Studio sendiri. Claude Code membaca pelayan MCP projek daripada fail bernama .mcp.json dalam folder projek, dalam format mcpServers yang sama seperti yang didokumentasikan oleh Roblox, dan menganggap entri tanpa type sebagai pelayan stdio tempatan. Oleh itu konfigurasi Roblox berfungsi seadanya. Simpan versi untuk sistem anda sebagai .mcp.json dalam folder tempat anda menjalankan claude:

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

Kali seterusnya anda menjalankan claude dalam folder ini, ia akan meminta anda meluluskan pelayan: Anthropic memaparkan permintaan ini untuk setiap pelayan yang datang daripada fail .mcp.json. Anthropic mereka fail ini supaya ia di-commit dan dikongsi oleh seluruh pasukan, tetapi laluan untuk Windows dan macOS berbeza. Jika pasukan anda menggunakan kedua-dua sistem, simpan fail itu di luar repositori, dan biar setiap orang menambah Studio sendiri.

Pada macOS, anda juga boleh menambah Studio dengan satu arahan. --scope user menjadikannya tersedia dalam setiap projek pada komputer anda; tanpanya, pelayan hanya dimuatkan dalam folder semasa. -- memisahkan parameter Claude Code sendiri daripada arahan yang menjalankan pelayan.

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

Pada Windows, laluan dengan fail JSON lebih mudah, kerana PowerShell dan CMD mengendalikan %LOCALAPPDATA% dalam baris arahan secara berbeza.

Semak sambungan

  • Dalam terminal, claude mcp list memaparkan setiap pelayan dan statusnya. claude mcp get Roblox_Studio memaparkan lebih banyak, termasuk baris Issue: jika pelayan gagal bersambung.
  • Di dalam Claude Code, taip /mcp. Pelayan yang bersambung memaparkan bilangan alat di sebelah namanya.
  • Dalam Studio, Assistant > … > Manage MCP Servers memaparkan penunjuk hijau dengan bilangan client yang bersambung.

Langkah 3: tentukan apa yang Claude boleh buat tanpa bertanya

Tetapkan ini sebelum Claude menyentuh place anda. Menurut halaman Anthropic tentang mod kebenaran, bermula dengan Claude Code v2.1.283, sesi interaktif dalam terminal dan VS Code secara lalai bermula dalam mod auto di mana-mana ia tersedia, dan dalam mod auto, tindakan disemak bagi pihak anda oleh pengelas latar belakang. Dalam keadaan itu, panggilan MCP yang menyunting skrip atau menjalankan Luau dalam Studio mungkin lulus tanpa bertanya.

Ada dua cara untuk mengekalkan setiap perubahan dalam kawalan anda:

  • Jalankan dalam mod Manual. Jalankan claude --permission-mode default. Dalam mod Manual, hanya bacaan dijalankan tanpa bertanya. Tekan Shift+Tab semasa sesi untuk menukar mod.
  • Tambah peraturan ask untuk alat Studio yang mengubah sesuatu. Anthropic menyatakan bahawa tiada mod yang meluluskan secara automatik alat yang terkena peraturan ask yang jelas, malah mod bypass pun tidak.
.claude/settings.json · contoh
{
  "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"
    ]
  }
}

Peraturan MCP berbentuk mcp__<server>__<tool>, dengan nama pelayan seperti yang dikenali oleh Claude Code. Gantikan Roblox_Studio dengan nama yang dipaparkan oleh /mcp. Peraturan allow dalam fail projek .claude/settings.json hanya berkuat kuasa selepas anda menerima dialog kepercayaan folder kerja untuk folder itu. Untuk peraturan yang hanya anda perlukan, gunakan .claude/settings.local.json.

Senarai allow merangkumi alat yang hanya membaca: pokok game, sifat, skrip, Output dan senarai tetingkap Studio yang terbuka. Senarai ask merangkumi alat yang mengubah place, menjalankan kod, memulakan playtest, membawa masuk aset luar atau menghantar imej ke Roblox. Alat yang tiada dalam mana-mana senarai, contohnya screen_capture dan alat input, mengikut mod kebenaran anda. Senarai penuh alat dengan penerangan setiap satu ada dalam panduan Studio MCP.

Langkah 4: mulakan dengan permintaan yang hanya membaca

Buka place yang anda mahu kerjakan, dan tutup yang tidak. Kemudian beri Claude permintaan pertama yang tidak boleh mengubah apa-apa:

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.

Pada Baseplate baharu, panduan Roblox tentang coding harness menjangkakan jawapan akan menyenaraikan Camera, Terrain, Baseplate dan SpawnLocation yang standard. Meminta list_roblox_studios dahulu ialah tabiat yang baik: satu client boleh mencapai setiap tetingkap Studio yang anda buka, dan setiap panggilan alat menamakan tetingkap sasaran melalui studio_id.

Untuk apa-apa yang lebih besar daripada satu skrip, minta pelan dahulu. Dalam mod plan (tekan Shift+Tab atau mulakan prompt dengan /plan), Claude meneroka dan mencadangkan tanpa menyunting fail anda. Anthropic menerangkan mod plan dari segi suntingan fail dan arahan shell, jadi kekalkan juga peraturan ask untuk alat Studio.

Langkah 5: kerjakan skrip sebagai fail melalui Script Sync atau Rojo

Claude Code dibina di sekeliling fail dalam folder. Ia menyunting fail dengan alatnya sendiri, Git menyimpan sejarahnya, dan /rewind boleh memulihkannya. Jika skrip diletakkan pada cakera, semua ini boleh digunakan, manakala alat MCP kekal untuk bahagian place yang bukan skrip, contohnya GUI dalam StarterGui, RemoteEvent dan part. Roblox mendokumentasikan dua cara untuk melakukannya.

Script Sync dan Rojo, menurut halaman Roblox tentang Script Sync dan alat pihak ketiga
Script SyncRojo
Apa ituCiri Studio yang menyegerakkan skrip dalam place dengan fail pada cakera, dalam kedua-dua arah.Alat pihak ketiga: pelayan pada komputer anda ditambah plugin untuk Studio.
Apa yang disegerakkanHanya objek Script, LocalScript, ModuleScript dan Folder. Objek lain dalam folder yang disegerakkan diabaikan.Boleh mengurus seluruh projek sebagai fail, dengan sistem fail anda sebagai sumber kebenaran.
TetapanKlik kanan pada servis atau folder dalam Explorer, pilih Sync to… dan tetapkan folder. Panduan Roblox tentang coding harness menghidupkannya dahulu dalam File > Beta Features.Pasangnya melalui Rokit (rokit add rojo-rbx/rojo, kemudian rokit install), tambah plugin dengan arahan rojo plugin install, jalankan rojo serve dan sambung dari plugin.
Team CreateBerfungsi dengannya. Elakkan keadaan dua orang menyunting skrip disegerakkan yang sama pada masa yang sama.Roblox menyatakan bahawa alat pihak ketiga selalunya tidak berfungsi dengan alat kerjasama terbina dalamnya.
Nasihat RobloxSesuai jika anda mahu editor sendiri dan kawalan versi untuk kod, dan Studio untuk semua yang lain.Pilihan terbaik jika anda mahu menyimpan seluruh projek dalam kawalan versi, bukan hanya kod.

Nama fail yang sama boleh membawa maksud berbeza

Kedua-dua alat memilih jenis skrip berdasarkan nama fail, dan akhirannya tidak sama. Fail .client ialah LocalScript dalam Rojo, tetapi Script dengan konteks larian Client dalam Script Sync. Beritahu Claude alat mana yang digunakan oleh projek anda; contoh CLAUDE.md di bawah melakukannya.

Peraturan Script Sync daripada halaman Roblox tentang Script Sync (fail .luau). Peraturan Rojo daripada halaman Sync Details untuk Rojo v7, yang menyenaraikan fail .lua
Nama fail berakhir denganScript Sync menciptaRojo mencipta
.serverScript dengan konteks larian ServerScript
.clientScript dengan konteks larian ClientLocalScript
.localLocalScriptTiada makna khas (mana-mana fail .lua lain ialah ModuleScript)
Tanpa akhiranModuleScriptModuleScript
Folder dengan fail initSkrip dengan objek anak, yang jenisnya ditetapkan oleh nama fail initFolder menjadi skrip yang diterangkan oleh init.server.lua, init.client.lua atau init.lua

Tetapan Script Sync untuk Claude Code

  1. Cipta folder projek dengan satu folder bagi setiap servis yang anda mahu simpan pada cakera, contohnya ServerScriptService, ReplicatedStorage dan StarterPlayerScripts, dan jalankan git init di dalamnya.
  2. Jika Script Sync tidak muncul apabila anda klik kanan pada servis, hidupkannya dalam File > Beta Features, klik Save dan mulakan semula Studio.
  3. Dalam Explorer, klik kanan pada ServerScriptService, pilih Script Sync > Sync to dan tetapkan folder projek peringkat atas, bukan folder di dalamnya. Ulang untuk servis lain.
  4. Jalankan claude dalam folder ini. Kini Claude menyunting fail .luau, dan Studio menerima setiap perubahan.
  5. Buat commit sebelum setiap sesi, supaya sentiasa ada titik bersih untuk kembali.
Terminal, dalam folder projek
git add .
git commit -m "Before Claude session"

Dua peraturan Script Sync menjadi lebih penting apabila menggunakan ejen. Jangan segerakkan skrip yang mempunyai atribut atau tag: Script Sync mengabaikannya, dan Roblox memberi amaran bahawa ini boleh menyebabkan kehilangan data. Dan jika fail berubah semasa Studio ditutup, apabila place dibuka semula Studio bertanya cara menyelesaikannya dan menyenaraikan apa yang akan ditambah, diubah atau dipadam oleh Keep Studio dan Keep Disk. Baca senarai itu sebelum memilih.

Dengan Script Sync dihidupkan, suntingan fail sampai ke Studio sebaik sahaja disimpan. Menerima suntingan dalam Claude Code bermakna menerimanya ke dalam place anda, jadi semak sebelum menerima, terutamanya dalam mod yang menerima suntingan secara automatik.

Untuk autolengkap dan ralat jenis dalam editor, Roblox mengesyorkan sambungan Luau Language Server dengan plugin pendampingnya untuk Studio. Dalam VS Code, sambungan Claude Code boleh membaca panel Problems melalui alat terbina dalam, jadi Claude melihat amaran yang sama seperti anda.

Langkah 6: beri Claude peraturan Roblox anda dalam CLAUDE.md

Setiap sesi Claude Code bermula dengan konteks baharu. Fail CLAUDE.md dalam folder projek dibaca pada permulaan setiap sesi, jadi konvensyen anda patut berada di situ. Jalankan /init supaya Claude membuat draf, atau tulis sendiri. Anthropic menasihatkan supaya ia kurang daripada 200 baris, peraturan ditulis cukup spesifik untuk boleh disemak, dan menjalankan /context untuk memastikan ia dimuatkan.

Contoh ini ditulis untuk panduan ini, untuk projek yang menggunakan Script Sync. Tukar nama mengikut game anda dan buang apa yang tidak diperlukan.

CLAUDE.md · contoh untuk projek dengan Script Sync
# Roblox project rules (example: edit to fit your game)

## Project
- Roblox game "Wave Survival". The place open in Studio is named WaveSurvival.
- Scripts sync to Studio with Script Sync:
  - ServerScriptService/ holds server game logic
  - ReplicatedStorage/ holds ModuleScripts shared by server and client
  - StarterPlayerScripts/ holds client code
- File names set the script type (Script Sync rules):
  - name.server.luau = Script with Server run context
  - name.local.luau = LocalScript
  - name.luau = ModuleScript
  - Do not use name.client.luau unless I ask. In Script Sync it makes a Script with Client run context, not a LocalScript.
- Never add attributes or tags to synced scripts. Script Sync ignores them.

## Roblox Studio MCP
- Call list_roblox_studios first. Work only in the place named WaveSurvival.
- Edit synced scripts as files, not with multi_edit.
- Use the MCP tools only for what is not a synced script: GUIs in StarterGui, RemoteEvents, parts, attributes.
- Never use insert_asset, upload_image or the generate tools unless I ask in this session.
- Ask before deleting any instance you did not create in this session.

## Luau
- Use task.wait, task.spawn and task.delay. Never wait, spawn or delay.
- Get services with game:GetService.
- The server decides coins, health, inventory and rewards. A LocalScript only asks.
- Every OnServerEvent handler checks the type and size of each argument and limits how often each player can call it.
- Wrap DataStore and HttpService calls in pcall and handle the failure.
- Remove per-player table entries in Players.PlayerRemoving.
- Never put API keys, webhook URLs or passwords in scripts or in this repository.

## Before you say a task is done
- List every script and instance you changed.
- Read the Output with get_console_output and report any errors.
- Tell me what to playtest by hand.

Sesetengah baris ada kerana cara alat-alat itu berfungsi. Peraturan nama fail ada kerana .client.luau dalam Script Sync bukan LocalScript. Baris tentang list_roblox_studios ada kerana pelayan boleh mencapai setiap tetingkap yang terbuka. Baris tentang aset ada kerana insert_asset membawa kandungan luar ke dalam place, dan upload_image menghantar imej ke pelayan aset Roblox. Baris tentang wait mengikut rujukan API Roblox, yang menandakan wait, spawn dan delay sebagai lapuk dan menggalakkan pustaka task.

Jika projek anda sudah mempunyai AGENTS.md untuk ejen pengekodan lain, Claude Code boleh membacanya sebagai arahan projek, jadi anda boleh menyimpan satu fail untuk kedua-duanya. Halaman Anthropic tentang memori menerangkan fail mana yang diutamakan apabila kedua-duanya ada.

Rupa peraturan ini dalam kod

Berikut ialah skrip pelayan yang mengikut peraturan Luau di atas. Ia ditulis dengan tangan untuk panduan ini, bukan dijana oleh Claude. Gunakannya sebagai ukuran apabila menyemak apa yang diberikan oleh Claude. LocalScript meminta alat melalui RequestTool:FireServer("Sword"), dan pelayan menyemak semuanya.

Script dalam ServerScriptService bernama 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 hanya menyegerakkan skrip dan folder, jadi pelayan mencipta remote sendiri.
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)
	-- Abaikan permintaan yang tiba selepas pemain keluar.
	if player.Parent ~= Players then
		return
	end

	-- 1. Semak argumen: client boleh menghantar apa sahaja.
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. Hadkan berapa kerap seorang pemain boleh meminta.
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. Pelayan yang memutuskan. Tambah semakan pemilikan anda di sini (game pass, rekod pembelian).
	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. Bersihkan data pemain.
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

Pada cakera dengan Script Sync: ServerScriptService/ToolRequests.server.luau. Letakkan objek Tool dalam Folder bernama Tools dalam ServerStorage. Selagi anda belum menambah semakan pemilikan, setiap pemain boleh mendapatkan mana-mana alat daripada folder ini.

Cari perkara yang sama dalam mana-mana pengendali remote yang ditulis oleh Claude: ia menyemak jenis dan saiz apa yang dihantar oleh client, mengehadkan berapa kerap seorang pemain boleh memanggilnya, keputusan dibuat oleh pelayan, dan rekod pemain dipadam apabila dia keluar. Panduan RemoteEvent menerangkan kenapa setiap perkara itu penting.

Cara kerja yang selamat: titik semak, semakan, playtest

  1. Buat titik semak di kedua-dua pihak. Commit fail ke Git dan simpan versi place dalam Studio melalui File > Save to Roblox with Notes. Panduan Studio MCP menunjukkan cara memulihkannya dari Version History.
  2. Minta pelan untuk apa-apa yang lebih besar daripada satu skrip, dan bacanya sebelum meluluskan.
  3. Semak diff. Untuk fail, baca git diff atau diff terbina dalam sambungan sebelum menerima. Untuk perubahan yang dibuat dalam Studio, baca skrip yang disentuh oleh Claude dan semak Explorer untuk objek yang muncul atau hilang.
  4. Uji sendiri. Claude boleh menjalankan playtest dan membaca Output, tetapi ia hanya menyemak apa yang diputuskannya untuk disemak. Mainkan ciri itu seperti pemain sebelum commit atau menerbitkan.
  5. Buat commit apabila semuanya berfungsi, dengan mesej tentang apa yang berubah.

Apa yang boleh dan tidak boleh dibatalkan oleh /rewind

Claude Code menyimpan titik semak sebelum setiap prompt, dan /rewind (atau Esc dua kali) memulihkan fail yang diubah oleh Claude dengan alat suntingan failnya. Anthropic menyenaraikan apa yang tidak dijejakinya, termasuk perubahan yang dibuat oleh arahan shell. Perubahan yang dibuat dalam Studio melalui alat MCP bukan suntingan fail, jadi jangan harap /rewind membatalkannya, dan halaman MCP daripada Roblox tidak menyatakan sama ada ia masuk ke dalam sejarah undo Studio. Dengan Script Sync, fail yang dipulihkan oleh /rewind disegerakkan kembali ke Studio seperti mana-mana perubahan lain pada cakera. Untuk semua yang lain, jalan kembali ialah versi yang disimpan.

Jauhkan rahsia dan data sebenar daripada capaian

  • Jangan tampal kunci API, kunci Open Cloud, URL webhook dan kata laluan ke dalam prompt atau ke dalam CLAUDE.md. Kedua-duanya ialah teks yang dibaca oleh Claude, dan CLAUDE.md biasanya di-commit ke repositori.
  • Jangan tulis terus dalam skrip juga. Roblox mempunyai stor rahsia untuk setiap game: cipta rahsia dalam Creator Dashboard dan bacanya dalam skrip pelayan melalui HttpService:GetSecret(). Untuk playtest tempatan, tambah rahsia tempatan dalam File > Experience Settings > Security.
  • Simpan tetapan peribadi dalam .claude/settings.local.json dan CLAUDE.local.md, yang direka untuk kekal di luar Git. Tambah CLAUDE.local.md ke dalam .gitignore sendiri.
  • Hidupkan Enable Studio Access to API Services hanya dalam salinan ujian game yang berasingan. Roblox memberi amaran bahawa Studio menggunakan stor data yang sama seperti game sebenar, jadi playtest yang dijalankan oleh Claude di situ boleh menulis ganti data pemain sebenar.
  • Baca skill pihak ketiga sebelum memasangnya. Katalog skill mengandungi skill Roblox untuk Claude Code, dan Anthropic menyatakan bahawa skill boleh memberi dirinya akses luas kepada alat melalui medan allowed-tools.

Berapa kos Claude Code untuk kerja Roblox

Bahagian Studio tiada harga yang didokumentasikan: pelayan MCP ialah sebahagian daripada Studio, dan halaman MCP daripada Roblox tidak menyebut sebarang bayaran. Kosnya ialah kos Claude Code, dan Anthropic menawarkan dua cara untuk membayar (pada 9 Oktober 2026):

  • Langganan Claude. Claude Code termasuk dalam Pro, Max, Team dan Enterprise, tetapi tidak dalam Free. Ia menggunakan had penggunaan yang sama seperti Claude di web, desktop dan mudah alih. Had ditetapkan semula mengikut tetingkap lima jam yang bergerak, dan pelan berbayar juga mempunyai had mingguan di atasnya. Apabila anda mencapai salah satu had, anda boleh menunggu, bertukar ke pelan yang lebih tinggi atau menghidupkan kredit penggunaan.
  • Akaun Claude Console. Anda membayar penggunaan API mengikut jumlah teks yang diproses. Halaman Anthropic tentang perbelanjaan menyatakan bahawa perbelanjaan sangat bergantung pada pilihan model, saiz pangkalan kod dan cara anda menggunakannya.

Harga semasa ada di claude.com/pricing. Panduan ini tidak mengulanginya kerana harga berubah. Di dalam Claude Code, arahan /usage memaparkan bar penggunaan pelan kepada pelanggan langganan, dan anggaran kos sesi kepada pengguna API.

Apa yang membuat sesi Roblox menggunakan lebih banyak

  • Saiz konteks. Penggunaan bertambah bersama apa yang ada dalam konteks Claude. Gunakan /clear antara tugas yang tidak berkaitan.
  • Hasil alat yang besar. Menjelajah seluruh pokok game dalam place yang besar atau membaca skrip panjang sepenuhnya memulangkan banyak teks. Claude Code mengira teks dalam unit yang digunakan oleh model untuk mengukurnya: ia memberi amaran apabila hasil alat MCP melebihi 10,000 unit sedemikian, dan secara lalai mengehadkannya kepada 25,000. Minta satu folder, had kedalaman atau julat baris sebagai ganti: search_game_tree dan script_read kedua-duanya menyokong perkara ini.
  • Pilihan model. Anthropic menyatakan bahawa Sonnet mengendalikan kebanyakan tugas pengekodan dengan baik dan lebih murah daripada Opus. Tukar melalui /model.

Menyelesaikan masalah Claude Code dan Studio

Senarai semakan Roblox sendiri pendek: mulakan semula Studio dan client, pastikan laluan arahan wujud, dan semak JSON. Berikut ialah kes yang khusus untuk Claude Code.

Claude Code tiada dalam senarai Quick connect

Senarai itu hanya memaparkan client yang disokong dan dipasang pada komputer anda. Pasang Claude Code, kemudian mulakan semula Studio. Jika anda memasangnya semasa Studio terbuka, mulakan semula Studio, Claude Code atau kedua-duanya. Fail .mcp.json dari langkah 2 berfungsi tanpa quick connect.

/mcp tidak memaparkan pelayan Roblox Studio

Mulakan semula Claude Code selepas menambah pelayan. Kemudian semak di mana ia ditambah: pelayan yang ditambah tanpa --scope hanya dimuatkan dalam folder tempat anda menambahnya, jadi jalankan claude dari folder itu atau tambahnya semula dengan --scope user. Dalam VS Code, mulakan perbualan baharu, kerana perubahan terpakai pada perbualan yang dimulakan selepasnya.

Pelayan memaparkan Pending approval

Ia datang daripada fail .mcp.json, dan Claude Code bertanya sebelum menggunakan pelayan sebegini. Jalankan claude dalam folder itu, terima dialog kepercayaan folder kerja dan luluskan pelayan. claude mcp reset-project-choices menetapkan semula keputusan sebelum ini.

Pelayan memaparkan Failed to connect

Jalankan claude mcp get Roblox_Studio dan baca baris Issue:. Pastikan fail wujud: %LOCALAPPDATA%\Roblox\mcp.bat pada Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP pada macOS (tukar laluan jika Studio dipasang di tempat lain). Pastikan Enable Studio as MCP server masih dihidupkan, kemudian mulakan semula Studio dan Claude Code.

Terminal menyatakan claude tidak dikenali

Selepas pemasangan, buka tetingkap terminal baharu. Jika arahan masih tidak ditemui, folder pemasangan tiada dalam PATH; penyelesaiannya ada pada halaman Anthropic tentang masalah pemasangan. Sambungan VS Code tidak menambah claude ke PATH, jadi untuk arahan dalam panduan ini, pasang versi terminal secara berasingan.

Claude mengubah place yang salah

Apabila beberapa tetingkap Studio terbuka, setiap panggilan alat menamakan sasaran melalui studio_id. Minta Claude memanggil list_roblox_studios dan namakan place yang dikehendaki, tutup tetingkap yang tidak digunakan, dan pulihkan place yang diubah dari Version History.

Claude Code mengenakan caj pada kunci API saya, bukan pelan saya

Sebaik sahaja anda meluluskannya, pemboleh ubah persekitaran ANTHROPIC_API_KEY diutamakan berbanding langganan. Padam pemboleh ubah itu (atau matikan Use custom API key dalam /config), jalankan Claude Code semula dan jalankan /status untuk menyemak log masuk mana yang aktif. Jika ia masih akaun Console, jalankan /login dan pilih akaun Claude anda.

Sesi awan tidak nampak Studio

Sesi awan berjalan dalam infrastruktur Anthropic, bukan pada komputer anda, jadi ia tidak dapat mencapai pelayan Studio tempatan. Gunakan terminal, sambungan editor atau aplikasi desktop dengan Local dipilih.

Atau gunakan ejen plugin sebagai ganti: RoCode

Claude Code dengan MCP sesuai untuk mereka yang selesa dengan terminal atau editor kod. RoCode (RoCode.app) ialah laluan lain: ejen AI bebas untuk Roblox Studio dengan chat web di rocode.app dan plugin percuma dari Creator Store yang menjalankan langkah-langkah dalam place yang anda buka. Ia bukan produk MCP dan tidak menggunakan pelayan MCP Studio, jadi tiada baris arahan, fail konfigurasi atau pelayan MCP untuk disediakan. Plugin bersambung sendiri jika Studio log masuk ke akaun Roblox yang sama yang anda gunakan dalam RoCode; jika tidak, anda memautkan chat dan plugin sekali sahaja dengan kod 8 aksara yang dipaparkan dalam panel plugin.

Perkara yang perlu diketahui sebelum beralih. RoCode tidak boleh menyambungkan langganan Claude atau Claude Code. Ia menjalankan model pihak ketiga melalui OpenRouter, termasuk Claude Sonnet 5.5 pada Pro dan ke atas dan Claude Opus 5.5 pada Studio dan ke atas, dan pelan percuma Starter memberi 1 kredit sehari pada GPT-6 Luna. Ia bekerja dari mod edit. Dengan plugin 3.9 atau lebih baharu, dalam mod Build, ia boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.11 atau lebih baharu ia boleh mengawal watak ujian untuk menyemak bahawa game berfungsi. Dengan plugin 3.9.14 atau lebih baharu, ia juga mengambil gambar apa yang dibinanya dalam mod edit dan boleh membaiki apa yang kelihatan salah. Ia tidak menjalankan kod secara terus dan tidak menjana mesh, manakala alat Studio MCP boleh melakukan kedua-duanya. Ia boleh mencari model percuma dalam Creator Store mengikut kata-kata anda (skrip di dalamnya dibuang) atau memasukkan model, decal atau mesh mengikut ID aset, dan ia mereka hiasan, bangunan dan prop secara baharu untuk setiap game. Mod Ask miliknya menjawab soalan tentang place anda dengan alat baca sahaja dan tidak mengubah apa-apa. Akaun untuk mereka yang berumur 13 tahun dan ke atas, dan bawah 18 tahun dengan kebenaran ibu bapa atau penjaga.

Anda tulis

Tambah RemoteEvent supaya pemain boleh meminta alat daripada ServerStorage.Tools. Semak semuanya pada pelayan.

RoCode buat
  • Boleh meninjau place dahulu melalui Search Game dan List Children untuk mencari folder Tools dan skrip yang sudah memberikan alat
  • Menulis skrip pelayan melalui Create Script dan boleh menambah RemoteEvent melalui Create Instance
  • Menyemak kompilasi skrip dalam Studio melalui Check Script sebelum selesai. Ini semakan kompilasi, bukan semakan jenis dan bukan playtest
  • Menghantar perubahan secara berkumpulan, dan setiap kumpulan ialah titik undo dalam sejarah Studio itu sendiri

Dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan plugin 3.9.15 atau lebih baharu watak ujiannya boleh berjalan, menekan kekunci dan mengklik butang pada skrin, tetapi ia hanya menyemak apa yang diputuskannya untuk disemak, jadi tekan Play sendiri untuk menyemak hasilnya sebagai pemain. Prompt ini ialah contoh yang kami tulis; langkah-langkahnya menggunakan nama alat yang sebenar. Cara plugin dan pemautan berfungsi. RoCode ialah produk bebas, tidak bergabung dengan Roblox Corporation, dan tidak disokong atau ditaja olehnya.

Soalan lazim

Bolehkah saya menggunakan Claude Desktop dan bukan Claude Code?

Boleh. Claude Desktop ada dalam senarai Quick connect dalam panel Manage MCP Servers dalam Studio, jadi ia bersambung dengan satu suis, pada Windows atau Mac. Ia menggunakan alat Studio yang sama; Claude Code menambah apa yang dikuasai dengan baik oleh ejen terminal, contohnya kerja dengan fail skrip dan Git. Langkah untuk kedua-duanya ada dalam panduan tetapan Studio MCP.

Bolehkah Claude Code bersambung ke Roblox Studio?

Boleh. Roblox menyenaraikan Claude Code sebagai client quick connect untuk pelayan MCP yang terbina dalam Studio. Hidupkan Enable Studio as MCP server dalam Assistant > … > Manage MCP Servers, hidupkan Claude Code dalam senarai Quick connect dan mulakan semula Claude Code. Ia juga boleh bekerja dengan skrip anda sebagai fail melalui Script Sync atau Rojo.

Adakah Claude Code percuma untuk kerja dengan Roblox Studio?

Pelayan MCP Studio tiada harga yang didokumentasikan, tetapi Claude Code tidak termasuk dalam pelan Free daripada Anthropic (claude.com/pricing, disemak pada 9 Oktober 2026). Anda memerlukan pelan Claude berbayar, tempat ia berkongsi had penggunaan pelan anda, atau akaun Claude Console dengan bayaran mengikut penggunaan API.

Adakah saya perlukan plugin Roblox atau permintaan HTTP untuk menggunakan Claude Code?

Untuk pelayan MCP terbina dalam Studio, tidak. Langkah tetapan Roblox ialah menghidupkan pelayan dalam Assistant dan menyambungkan client; tiada plugin untuk dipasang atau tetapan HTTP untuk diubah. Sesetengah panduan lama menerangkan pelayan MCP komuniti yang berfungsi secara berbeza. Rojo, jika anda memilihnya untuk fail, menggunakan plugin Studio sendiri.

Bolehkah Claude Code menguji game Roblox saya?

Melalui alat Studio MCP, boleh. start_stop_play memulakan dan menghentikan playtest, get_console_output membaca Output, screen_capture mengambil gambar viewport, dan alat input menggerakkan watak dan menghantar kekunci dan klik. Semak apa yang dilaporkannya, dan mainkan game itu sendiri sebelum menerbitkan.

Mana yang patut dipilih untuk Roblox Studio: Claude Code atau Codex?

Kedua-duanya ada dalam senarai quick connect Roblox dan mencapai alat Studio MCP yang sama, jadi perbezaannya ialah model, akaun dan client di sekelilingnya. Roblox tidak menerbitkan perbandingan, dan kami tidak menjalankan ujian perbandingan antara kedua-duanya. Cuba setiap satu pada salinan place anda dengan peraturan bertulis yang sama, dan kekalkan yang perubahannya memerlukan paling sedikit pembaikan.

Adakah Claude Code berfungsi dengan Roblox Studio pada Mac?

Ya. Claude Code menyokong macOS 13.0 atau lebih baharu, dan Roblox mendokumentasikan laluan pelayan untuk macOS, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, untuk client yang anda sediakan secara manual.

Sumber dan bacaan lanjut

Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.