教學 · Roblox Studio 中的 AI

如何把 Claude Code 連接到 Roblox Studio

Claude Code 是 Anthropic 推出的代理式程式撰寫工具。Roblox 把它列為 Studio 內建 MCP 伺服器的 quick connect 用戶端,所以它可以讀取你的場景、修改 Script,並在你開啟的 Studio 視窗中執行試玩測試。它也可以透過 Script Sync 或 Rojo,把你的 Script 當成檔案來處理。這篇教學說明 Claude Code 這一端:需要什麼、如何連接、權限、寫有 Roblox 規則的 CLAUDE.md、安全的工作方式,以及要花多少錢。OpenAI 的代理請看如何在 Roblox Studio 使用 OpenAI Codex(英文);Cursor、Claude Desktop 與其他用戶端請看 Studio MCP 設定教學。

更新日期 2026年11月20日閱讀約 7 分鐘作者

重點摘要

安裝 Claude Code,並用付費 Claude 方案或 Claude Console 帳號登入。在 Studio 中打開 Assistant,按 … > Manage MCP Servers,開啟 Enable Studio as MCP server,再在 Quick connect 清單中開啟 Claude Code。重新啟動 Claude Code,輸入 /mcp 確認 Studio 伺服器已連接,然後從只讀取的請求開始。

  • Anthropic 的 Free 方案不包含 Claude Code。它包含在 Pro、Max、Team 與 Enterprise 中,或透過 Claude Console 帳號依 API 使用量付費(2026 年 10 月 9 日確認)。
  • 請使用本機工作階段:終端機、VS Code 或 Cursor 的擴充功能,或選擇 Local 的桌面應用程式。雲端工作階段不是在你的電腦上執行,碰不到 Studio。
  • 從 v2.1.283 開始,終端機與 VS Code 的工作階段在可用的地方預設以 auto 模式啟動,所以請替會改變場景的 Studio 工具加上 ask 規則。Claude Code 的 /rewind 指令無法復原在 Studio 中做的變更,所以請先儲存一個版本。
本頁內容
  1. 需要什麼
  2. 1. 安裝與登入
  3. 2. 連接 Studio
  4. 3. 權限
  5. 4. 第一個請求
  6. 5. Script Sync 或 Rojo
  7. 6. CLAUDE.md
  8. 安全的工作方式
  9. 費用
  10. 疑難排解
  11. 外掛程式代理
  12. 常見問題
  13. 來源與延伸閱讀

開始之前需要什麼

依照 Roblox 與 Anthropic 文件的需求,2026 年 10 月 9 日
需要什麼詳細說明
Roblox Studio最新版本,Windows 或 macOS。MCP 伺服器內建在 Studio 中,所以 Roblox 這一端不需要再安裝任何東西。
支援 Claude Code 的電腦macOS 13.0 或更新版本,或 Windows 10 1809 或更新版本,4 GB 以上的記憶體、網路連線,並且位於 Anthropic 支援的國家。
包含 Claude Code 的 Claude 帳號付費 Claude 方案(Pro、Max、Team 或 Enterprise)或 Claude Console 帳號。Anthropic 的價格頁面寫明 Free 方案不包含 Claude Code。
年齡Anthropic 的 Consumer Terms(自 2025 年 10 月 8 日起生效)規定,你必須年滿 18 歲,如果你所在國家的最低同意年齡更高,則以該年齡為準。
選用Git,用來保存 Script 的歷史紀錄。如果你想在編輯器面板而不是終端機中使用 Claude Code,需要 Visual Studio Code 1.94.0 或更新版本,或 Cursor。

要使用哪一種 Claude Code

Claude Code 可以在好幾個地方執行。Anthropic 表示它們都使用同一個引擎,所以你的 CLAUDE.md、設定與 MCP 伺服器在每個地方都能用。對 Studio 來說,重要的是工作階段在哪裡執行:Roblox 的 MCP 伺服器是你電腦上的本機程序,所以工作階段也必須在你的電腦上。

Claude Code 的各種形式與 Roblox Studio
形式碰得到 Studio 嗎?備註
終端機(claude 指令)可以在專案資料夾中執行它。下方的 claude mcp 指令也需要它。
VS Code 或 Cursor 的擴充功能可以這是 Roblox coding harness 教學中的方式。擴充功能內含自己的一份 Claude Code,但不會把 claude 加進 PATH,所以如果你需要這些指令,也請安裝終端機版本。
桌面應用程式的 Code 分頁,並選擇 Local可以在你的電腦上執行。Anthropic 表示需要付費訂閱。
雲端工作階段(claude.ai/code 或桌面應用程式中的 Cloud)不行它們在雲端基礎設施上執行,而不是在你的電腦上,所以無法啟動本機的 Studio 伺服器。

步驟 1:安裝 Claude Code 並登入

Anthropic 建議在終端機中用一行指令安裝。以下是 2026 年 10 月 9 日它的安裝頁面上的指令;最新的指令請看 Anthropic 的安裝頁面。

終端機 · macOS
curl -fsSL https://claude.ai/install.sh | bash
PowerShell · Windows
irm https://claude.ai/install.ps1 | iex
  1. 打開新的終端機視窗並執行 claude --version。出現版本號碼就代表成功了。如果找不到指令,代表安裝資料夾還不在 PATH 中,解決方法在 Anthropic 關於安裝問題的頁面上。
  2. 切換到專案資料夾並執行 claude。第一次啟動時,它會打開瀏覽器視窗讓你登入。如果瀏覽器沒有打開,按 c 複製登入連結。
  3. 登入你的 Claude 帳號。用 Pro 或 Max 登入時,會使用你的方案內含的使用限制。

在 Windows 上,Anthropic 建議安裝 Git for Windows,讓 Claude Code 可以使用它的 Bash 工具;沒有它的話,Claude Code 會在 PowerShell 中執行指令。這個設定請把 Claude Code 安裝在 Windows 本身,而不是 WSL 裡面:Roblox 的 Windows 設定會用 %LOCALAPPDATA% 路徑啟動 cmd.exe,而 Roblox 沒有替 WSL 提供文件。

比較喜歡編輯器中的面板?在 VS Code 或 Cursor 中打開 Extensions(Ctrl+Shift+X,Mac 上是 Cmd+Shift+X),搜尋 Claude Code,安裝後從 Claude 面板登入。Roblox 的 coding harness 教學用的就是這種設定。

步驟 2:把 Claude Code 連接到 Studio

先開啟伺服器。在 Studio 中打開 Assistant,按 … > Manage MCP Servers,開啟 Enable Studio as MCP server。Studio MCP 教學會更詳細地說明這個步驟。找不到 Assistant 按鈕?請看如何打開 Assistant 面板。

Quick connect

  1. 在同一個面板(Assistant Settings > MCP Servers)中展開 Quick connect 清單。裡面是你電腦上已安裝、受支援的用戶端。
  2. 開啟 Claude Code。如果沒有看到它,請安裝 Claude Code 並重新啟動 Studio。
  3. 重新啟動 Claude Code:結束工作階段後再次執行 claude,或在擴充功能中開始新的對話。Roblox 表示用戶端需要重新啟動才會載入新的設定。

Roblox 沒有說明 quick connect 會寫入 Claude Code 的哪個檔案,也沒說伺服器叫什麼名字。在 Claude Code 中輸入 /mcp 就能看到名稱。步驟 3 的權限規則會用到它。

你在 VS Code 或 Cursor 中使用 Claude Code 擴充功能嗎?這裡同樣要開啟 Claude Code。Roblox 的 coding harness 教學開啟的是 Cursor 或 Visual Studio Code,但 Anthropic 的文件說明,擴充功能和終端機版 Claude Code 共用 MCP 設定,並沒有說它會讀取編輯器自己的 MCP 設定。

透過 .mcp.json 檔案手動設定

如果 quick connect 對你無效,請自己加入 Studio。Claude Code 會從專案資料夾中名為 .mcp.json 的檔案讀取專案的 MCP 伺服器,格式和 Roblox 文件中的 mcpServers 相同,而且會把沒有 type 的項目當成本機 stdio 伺服器。所以 Roblox 的設定可以直接使用。把適合你系統的版本存成 .mcp.json,放在你執行 claude 的資料夾中:

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

下次你在這個資料夾執行 claude 時,它會要求你核准這個伺服器:對於來自 .mcp.json 檔案的每個伺服器,Anthropic 都會顯示這個詢問。Anthropic 設計這個檔案是為了讓它被提交並由整個團隊共用,但 Windows 與 macOS 的路徑不同。如果你的團隊兩種系統都有,請把檔案放在儲存庫之外,讓每個人自己加入 Studio。

在 macOS 上,也可以改用一行指令加入 Studio。--scope user 會讓它在你電腦上的每個專案中都能使用;沒有它的話,伺服器只會在目前的資料夾載入。-- 用來分隔 Claude Code 自己的參數與啟動伺服器的指令。

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

在 Windows 上用 JSON 檔案的方式比較簡單,因為 PowerShell 與 CMD 在命令列中處理 %LOCALAPPDATA% 的方式不同。

檢查連線

  • 在終端機中,claude mcp list 會顯示每個伺服器及其狀態。claude mcp get Roblox_Studio 會顯示更多資訊,包括伺服器無法連接時的 Issue: 那一行。
  • 在 Claude Code 中輸入 /mcp。已連接的伺服器名稱旁會顯示工具數量。
  • 在 Studio 中,Assistant > … > Manage MCP Servers 會顯示綠色指示燈,以及已連接的用戶端數量。

步驟 3:決定 Claude 可以不經詢問做哪些事

請在 Claude 碰你的場景之前設定好這件事。根據 Anthropic 關於權限模式的頁面,從 Claude Code v2.1.283 開始,終端機與 VS Code 中的互動式工作階段在所有可用的地方預設以 auto 模式啟動,而在 auto 模式中,由背景分類器替你檢查動作。這樣一來,修改 Script 或在 Studio 中執行 Luau 的 MCP 呼叫,可能不經詢問就通過。

有兩種方式能讓每個變更都由你掌控:

  • 以 Manual 模式啟動。執行 claude --permission-mode default。在 Manual 模式中,只有讀取會不經詢問就執行。在工作階段中按 Shift+Tab 可以切換模式。
  • 替會改變東西的 Studio 工具加上 ask 規則。Anthropic 表示,沒有任何模式會自動核准符合明確 ask 規則的工具,連 bypass 模式也不會。
.claude/settings.json · 範例
{
  "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 規則的格式是 mcp__<server>__<tool>,伺服器名稱要和 Claude Code 認得的名稱一樣。把 Roblox_Studio 換成 /mcp 顯示的名稱。專案檔案 .claude/settings.json 中的 allow 規則,要等你接受這個資料夾的工作資料夾信任對話框之後才會生效。只有你自己需要的規則,請使用 .claude/settings.local.json。

allow 清單涵蓋只讀取的工具:遊戲樹、屬性、Script、Output,以及開啟中的 Studio 視窗清單。ask 清單涵蓋會改變場景、執行程式碼、啟動試玩測試、加入外部素材或把圖片傳送到 Roblox 的工具。不在任何清單中的工具,例如 screen_capture 與輸入工具,會依照你的權限模式處理。完整的工具清單與每個工具的說明,請看 Studio MCP 教學。

步驟 4:從只讀取的請求開始

打開你想處理的場景,關掉不想處理的場景。然後給 Claude 第一個不可能改變任何東西的請求:

提示詞
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.

在全新的 Baseplate 上,Roblox 的 coding harness 教學預期回答會列出預設的 Camera、Terrain、Baseplate 與 SpawnLocation。先要求 list_roblox_studios 是好習慣:一個用戶端能碰到你開啟的每個 Studio 視窗,而每次工具呼叫都透過 studio_id 指定目標視窗。

任何超過一個 Script 的工作,都請先要求計畫。在 plan 模式中(按 Shift+Tab,或在提示詞開頭加上 /plan),Claude 會研究並提出建議,而不修改你的檔案。Anthropic 是以檔案修改與 shell 指令來描述 plan 模式的,所以 Studio 工具的 ask 規則也請保留。

步驟 5:透過 Script Sync 或 Rojo 把 Script 當成檔案處理

Claude Code 是圍繞著資料夾中的檔案打造的。它用自己的工具修改檔案,Git 保存它們的歷史,/rewind 可以還原它們。把 Script 放到磁碟上,就能使用這一切,而 MCP 工具則留給場景中不是 Script 的部分,例如 StarterGui 中的 GUI、RemoteEvent 與 part。Roblox 的文件提供了兩種做法。

Script Sync 與 Rojo,依照 Roblox 關於 Script Sync 與第三方工具的頁面
Script SyncRojo
是什麼Studio 的功能,讓場景中的 Script 與磁碟上的檔案雙向同步。第三方工具:你電腦上的伺服器,加上 Studio 外掛程式。
同步什麼只有 Script、LocalScript、ModuleScript 與 Folder 物件。同步資料夾中的其他物件會被忽略。可以把整個專案當成檔案管理,以你的檔案系統作為唯一的事實來源。
設定在 Explorer 中對服務或資料夾按右鍵,選擇 Sync to… 並指定資料夾。Roblox 的 coding harness 教學會先在 File > Beta Features 中開啟它。透過 Rokit 安裝(rokit add rojo-rbx/rojo,再執行 rokit install),用 rojo plugin install 指令加入外掛程式,執行 rojo serve,再從外掛程式連接。
Team Create可以一起使用。避免兩個人同時修改同一個同步中的 Script。Roblox 指出,第三方工具常常無法和它內建的協作工具一起運作。
Roblox 的建議如果你希望程式碼使用自己的編輯器與版本控制,其他一切使用 Studio,這很適合。如果你想把整個專案,而不只是程式碼,放進版本控制,這是最好的選擇。

同一個檔名可能代表不同的東西

兩種工具都依照檔名決定 Script 的類型,而它們的後綴並不相同。.client 檔案在 Rojo 中是 LocalScript,但在 Script Sync 中是執行情境為 Client 的 Script。請告訴 Claude 你的專案使用哪一種工具;下方的 CLAUDE.md 範例就這麼做了。

Script Sync 的規則來自 Roblox 的 Script Sync 頁面(.luau 檔案)。Rojo 的規則來自 Rojo v7 的 Sync Details 頁面,其中列出的是 .lua 檔案
檔名結尾是Script Sync 建立Rojo 建立
.server執行情境為 Server 的 ScriptScript
.client執行情境為 Client 的 ScriptLocalScript
.localLocalScript沒有特別意義(其他任何 .lua 檔案都是 ModuleScript)
沒有後綴ModuleScriptModuleScript
含有 init 檔案的資料夾帶有子物件的 Script,類型由 init 檔案的名稱決定資料夾會變成由 init.server.lua、init.client.lua 或 init.lua 描述的 Script

替 Claude Code 設定 Script Sync

  1. 建立一個專案資料夾,並替每個你想放在磁碟上的服務各建一個資料夾,例如 ServerScriptService、ReplicatedStorage 與 StarterPlayerScripts,然後在裡面執行 git init。
  2. 如果你對服務按右鍵時沒有出現 Script Sync,請在 File > Beta Features 中開啟它,按 Save 並重新啟動 Studio。
  3. 在 Explorer 中對 ServerScriptService 按右鍵,選擇 Script Sync > Sync to,並指定最上層的專案資料夾,而不是裡面的資料夾。其他服務也重複這個步驟。
  4. 在這個資料夾執行 claude。現在 Claude 修改的是 .luau 檔案,而 Studio 會接收每個變更。
  5. 每次工作階段前都提交一次,這樣隨時都有一個乾淨的點可以回去。
終端機,在專案資料夾中
git add .
git commit -m "Before Claude session"

搭配代理時,Script Sync 有兩條規則變得更重要。不要同步帶有屬性或標籤的 Script:Script Sync 會忽略它們,Roblox 也警告這可能導致資料遺失。另外,如果檔案在 Studio 關閉時被修改,重新打開場景時 Studio 會詢問要如何處理,並列出 Keep Studio 與 Keep Disk 各會新增、修改或刪除什麼。選擇之前請先讀這份清單。

開啟 Script Sync 時,檔案的修改在儲存後會立刻進入 Studio。在 Claude Code 中接受修改,就等於在你的場景中接受它,所以接受之前請先檢查,特別是在會自動接受修改的模式中。

若要在編輯器中取得自動完成與型別錯誤,Roblox 建議使用 Luau Language Server 擴充功能及其搭配的 Studio 外掛程式。在 VS Code 中,Claude Code 擴充功能可以透過內建工具讀取 Problems 面板,所以 Claude 會看到和你一樣的警告。

步驟 6:在 CLAUDE.md 中給 Claude 你的 Roblox 規則

每個 Claude Code 工作階段都從全新的情境開始。專案資料夾中的 CLAUDE.md 檔案會在每個工作階段開始時讀取,所以你的慣例應該寫在裡面。執行 /init 讓 Claude 起個草稿,或自己寫。Anthropic 建議讓它保持在 200 行以內,把規則寫得夠具體、能夠檢查,並執行 /context 確認它已載入。

這個範例是為這篇教學寫的,適用於使用 Script Sync 的專案。依照你的遊戲修改名稱,並刪掉你不需要的部分。

CLAUDE.md · 使用 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.

有些規則是因為工具的運作方式才出現的。檔名規則存在,是因為 Script Sync 中的 .client.luau 不是 LocalScript。關於 list_roblox_studios 的那一行存在,是因為伺服器碰得到每個開啟中的視窗。關於素材的那一行存在,是因為 insert_asset 會把外部內容加進場景,而 upload_image 會把圖片傳送到 Roblox 的素材伺服器。關於 wait 的那一行依照 Roblox 的 API 參考,其中把 wait、spawn 與 delay 標示為已過時,建議改用 task 函式庫。

如果你的專案已經有給其他程式撰寫代理用的 AGENTS.md,Claude Code 可以把它當成專案指示來讀取,所以兩者可以共用一個檔案。Anthropic 關於記憶的頁面說明了兩個檔案都存在時,哪一個優先。

這些規則在程式碼中是什麼樣子

以下是遵守上方 Luau 規則的伺服器 Script。它是為這篇教學手寫的,不是 Claude 產生的。檢查 Claude 交出的東西時,可以把它當成標準。LocalScript 透過 RequestTool:FireServer("Sword") 請求工具,而伺服器檢查一切。

Script 位於 ServerScriptService 名稱為 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 只同步 Script 與資料夾,所以伺服器自己建立它的 remote。
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)
	-- 忽略玩家離開之後才抵達的請求。
	if player.Parent ~= Players then
		return
	end

	-- 1. 檢查參數:用戶端可能送來任何東西。
	if typeof(toolName) ~= "string" or #toolName == 0 or #toolName > MAX_NAME_LENGTH then
		return
	end

	-- 2. 限制一位玩家可以請求的頻率。
	local now = os.clock()
	local last = lastRequest[player]
	if last ~= nil and now - last < COOLDOWN_SECONDS then
		return
	end
	lastRequest[player] = now

	-- 3. 由伺服器決定。在這裡加上你自己的擁有權檢查(遊戲通行證、購買紀錄)。
	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. 清除玩家資料。
Players.PlayerRemoving:Connect(function(player: Player)
	lastRequest[player] = nil
end)

在使用 Script Sync 的磁碟上:ServerScriptService/ToolRequests.server.luau。把 Tool 物件放進 ServerStorage 中名為 Tools 的 Folder。在你加上擁有權檢查之前,每位玩家都能拿到這個資料夾中的任何工具。

在 Claude 寫的任何 remote 處理函式中都找找看同樣的東西:它會檢查用戶端送來的東西的型別與大小、限制一位玩家可以呼叫它的頻率、由伺服器做決定,並在玩家離開時刪除他的紀錄。RemoteEvent 教學說明了每一點為什麼重要。

安全的工作方式:檢查點、檢查、試玩測試

  1. 在兩邊都建立檢查點。把檔案提交到 Git,並透過 File > Save to Roblox with Notes 在 Studio 中儲存場景的版本。Studio MCP 教學示範了如何從 Version History 還原它。
  2. 任何超過一個 Script 的工作都先要求計畫,並在核准之前讀過它。
  3. 檢查 diff。檔案的部分,在接受之前讀 git diff 或擴充功能中內建的 diff。在 Studio 中做的變更,請讀 Claude 碰過的 Script,並檢查 Explorer 中有沒有出現或消失的物件。
  4. 自己測試。Claude 可以執行試玩測試並讀取 Output,但它只會檢查自己決定要檢查的東西。在提交或發布之前,像玩家一樣實際玩一次這個功能。
  5. 一切正常時提交,並在訊息中寫下改了什麼。

/rewind 能復原什麼、不能復原什麼

Claude Code 會在每個提示詞之前儲存檢查點,而 /rewind(或按兩次 Esc)會還原 Claude 用它的檔案編輯工具修改過的檔案。Anthropic 列出了它不追蹤的東西,包括透過 shell 指令做的變更。透過 MCP 工具在 Studio 中做的變更不是檔案修改,所以別指望 /rewind 能復原它們,而 Roblox 的 MCP 頁面也沒說它們會不會進入 Studio 的復原紀錄。使用 Script Sync 時,被 /rewind 還原的檔案會像磁碟上的其他變更一樣同步回 Studio。其他一切,回頭的路就是已儲存的版本。

讓機密與正式資料保持在碰不到的地方

  • 不要把 API 金鑰、Open Cloud 金鑰、webhook 網址與密碼貼進提示詞或 CLAUDE.md。兩者都是 Claude 會讀的文字,而 CLAUDE.md 通常會被提交到儲存庫。
  • 也不要把它們寫死在 Script 中。Roblox 替每個遊戲提供機密儲存區:在 Creator Dashboard 中建立機密,並在伺服器 Script 中透過 HttpService:GetSecret() 讀取。本機試玩測試則請在 File > Experience Settings > Security 中加入本機機密。
  • 個人設定請放在 .claude/settings.local.json 與 CLAUDE.local.md,它們的設計就是留在 Git 之外。請自己把 CLAUDE.local.md 加進 .gitignore。
  • 只在獨立的遊戲測試複本中開啟 Enable Studio Access to API Services。Roblox 警告,Studio 使用的資料儲存區和正式遊戲相同,所以 Claude 在那裡執行的試玩測試可能會覆寫真實的玩家資料。
  • 安裝第三方 skill 之前先讀過它。skill 目錄中有給 Claude Code 用的 Roblox skill,而 Anthropic 指出,skill 可以透過 allowed-tools 欄位替自己取得廣泛的工具存取權。

用 Claude Code 開發 Roblox 要花多少錢

Studio 這一端沒有公開的價格:MCP 伺服器是 Studio 的一部分,Roblox 的 MCP 頁面也沒有提到任何費用。費用就是 Claude Code 的費用,而 Anthropic 提供兩種付費方式(截至 2026 年 10 月 9 日):

  • Claude 訂閱。Claude Code 包含在 Pro、Max、Team 與 Enterprise 中,但不包含在 Free 中。它使用的是和網頁、桌面與行動裝置上的 Claude 相同的使用限制。限制以滾動的五小時區間重設,付費方案在此之外還有每週限制。達到其中一個限制時,你可以等待、升級到更高的方案,或開啟使用點數。
  • Claude Console 帳號。你依處理的文字量支付 API 使用費。Anthropic 關於費用的頁面表示,支出很大程度取決於模型選擇、程式碼庫大小,以及你的使用方式。

目前的價格請看 claude.com/pricing。這篇教學不重複列出,因為它們會變動。在 Claude Code 中,/usage 指令會向訂閱者顯示方案的使用量,並向 API 使用者顯示工作階段的大約費用。

什麼會讓 Roblox 工作階段用得更多

  • 情境大小。用量會隨著 Claude 情境中的內容增加。在不相關的工作之間使用 /clear。
  • 大量的工具結果。在大型場景中走訪整個遊戲樹,或完整讀取很長的 Script,都會回傳大量文字。Claude Code 以模型衡量文字的單位來計算:當 MCP 工具的結果超過 10 000 個這種單位時會發出警告,並預設限制在 25 000 個。請改為要求單一資料夾、限制深度或指定行數範圍:search_game_tree 與 script_read 都支援。
  • 模型選擇。Anthropic 表示,Sonnet 能妥善處理大部分程式工作,價格也比 Opus 低。透過 /model 切換。

Claude Code 與 Studio 的疑難排解

Roblox 自己的檢查清單很短:重新啟動 Studio 與用戶端、確認指令路徑存在,以及檢查 JSON。以下是 Claude Code 特有的情況。

Quick connect 清單中沒有 Claude Code

清單只會顯示你電腦上已安裝、受支援的用戶端。請安裝 Claude Code,再重新啟動 Studio。如果你是在 Studio 開著的時候安裝的,請重新啟動 Studio、Claude Code,或兩者都重新啟動。步驟 2 的 .mcp.json 檔案不需要 quick connect 也能運作。

/mcp 沒有顯示 Roblox Studio 伺服器

加入伺服器後請重新啟動 Claude Code。接著檢查它被加到哪裡:沒有加 --scope 就加入的伺服器,只會在你加入它的資料夾中載入,所以請從那個資料夾執行 claude,或用 --scope user 重新加入。在 VS Code 中請開始新的對話,因為變更只會套用到之後開始的對話。

伺服器顯示 Pending approval

它來自 .mcp.json 檔案,而 Claude Code 在使用這類伺服器之前會先詢問。在這個資料夾執行 claude,接受工作資料夾信任對話框並核准伺服器。claude mcp reset-project-choices 會重設之前的選擇。

伺服器顯示 Failed to connect

執行 claude mcp get Roblox_Studio 並閱讀 Issue: 那一行。確認檔案存在:Windows 上是 %LOCALAPPDATA%\Roblox\mcp.bat,macOS 上是 /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP(如果 Studio 安裝在其他地方,請修改路徑)。確認 Enable Studio as MCP server 仍然開著,再重新啟動 Studio 與 Claude Code。

終端機說無法辨識 claude

安裝後請打開新的終端機視窗。如果還是找不到指令,代表安裝資料夾不在 PATH 中;解決方法在 Anthropic 關於安裝問題的頁面上。VS Code 擴充功能不會把 claude 加進 PATH,所以這篇教學中的指令請另外安裝終端機版本。

Claude 改錯了場景

開著多個 Studio 視窗時,每次工具呼叫都會透過 studio_id 指定目標。請要求 Claude 呼叫 list_roblox_studios 並指定你要的場景,關掉不用的視窗,並從 Version History 還原被修改的場景。

Claude Code 從我的 API 金鑰扣款,而不是從方案

一旦你核准了它,ANTHROPIC_API_KEY 環境變數就會優先於訂閱。刪除這個變數(或在 /config 中關閉 Use custom API key),重新啟動 Claude Code,並執行 /status 確認目前使用哪種登入。如果仍然是 Console 帳號,請執行 /login 並選擇你的 Claude 帳號。

雲端工作階段看不到 Studio

雲端工作階段在 Anthropic 的基礎設施上執行,而不是在你的電腦上,所以碰不到本機的 Studio 伺服器。請使用終端機、編輯器擴充功能,或選擇 Local 的桌面應用程式。

或者改用外掛程式代理:RoCode

搭配 MCP 的 Claude Code 適合習慣終端機或程式碼編輯器的人。RoCode(RoCode.app)是另一條路:獨立的 Roblox Studio AI 代理,在 rocode.app 有網頁聊天,並有一個來自 Creator Store 的免費外掛程式,在你開啟的場景中執行每個步驟。它不是 MCP 產品,也不使用 Studio 的 MCP 伺服器,所以沒有命令列、設定檔或 MCP 伺服器需要設定。如果 Studio 登入的是你在 RoCode 使用的同一個 Roblox 帳號,外掛程式會自動連接;否則你只要用外掛程式面板中顯示的 8 位字元代碼,把聊天與外掛程式配對一次。

轉換前值得知道的事。RoCode 無法連接 Claude 訂閱或 Claude Code。它透過 OpenRouter 執行第三方模型,包括 Pro 以上方案的 Claude Sonnet 5.5,以及 Studio 以上方案的 Claude Opus 5.5,而免費的 Starter 方案每天提供 1 點數,可用於 GPT-6 Luna。它在編輯模式中運作。使用 3.9 或更新版本的外掛程式時,它可以在 Build 模式中執行簡短的試玩測試並讀取錯誤;使用 3.9.11 或更新版本時,它可以操控測試角色,檢查遊戲是否正常運作。使用 3.9.14 或更新版本時,它還會在編輯模式中拍下自己建造的東西的截圖,並修正看起來不對的地方。它不會直接執行程式碼,也不會產生網格(mesh),而 Studio MCP 工具兩者都做得到。它可以依照你的描述在 Creator Store 搜尋免費模型(裡面的 Script 會被移除),或依素材 ID 插入模型、貼圖(decal)或網格,而裝飾、建築與道具則會替每個遊戲重新設計。它的 Ask 模式會用只讀取的工具回答關於你場景的問題,不會改變任何東西。帳號限 13 歲以上,未滿 18 歲需經家長或監護人同意。

你輸入

加入一個 RemoteEvent,讓玩家可以從 ServerStorage.Tools 請求工具。所有東西都在伺服器上檢查。

RoCode 會做
  • 可以先透過 Search Game 與 List Children 查看場景,找出 Tools 資料夾以及已經在發放工具的 Script
  • 透過 Create Script 撰寫伺服器 Script,並可以透過 Create Instance 加入 RemoteEvent
  • 完成前在 Studio 中透過 Check Script 檢查 Script 能否編譯。這是編譯檢查,不是型別檢查,也不是試玩測試
  • 分批送出變更,每一批都是 Studio 本身歷史紀錄中的一個復原點

使用 3.9 或更新版本的外掛程式時,RoCode 可以執行簡短的試玩測試並讀取錯誤;使用 3.9.15 或更新版本時,它的測試角色會走路、按鍵並點擊畫面上的按鈕,但它只會檢查自己決定要檢查的東西,所以請自己按 Play,像玩家一樣檢查結果。這個提示詞是我們寫的範例;步驟中是真實的工具名稱。外掛程式與配對如何運作。RoCode 是獨立產品,與 Roblox Corporation 沒有任何關聯,也未獲其認可或贊助。

常見問題

可以用 Claude Desktop 取代 Claude Code 嗎?

可以。Claude Desktop 在 Studio 的 Manage MCP Servers 面板的 Quick connect 清單中,所以在 Windows 或 Mac 上只要切換一個開關就能連接。它使用相同的 Studio 工具;Claude Code 另外加上了終端機代理擅長的事,例如處理 Script 檔案與 Git。兩者的步驟都在 Studio MCP 設定教學中。

Claude Code 可以連接 Roblox Studio 嗎?

可以。Roblox 把 Claude Code 列為 Studio 內建 MCP 伺服器的 quick connect 用戶端。在 Assistant > … > Manage MCP Servers 中開啟 Enable Studio as MCP server,在 Quick connect 清單中開啟 Claude Code,然後重新啟動 Claude Code。它也可以透過 Script Sync 或 Rojo,把你的 Script 當成檔案處理。

用 Claude Code 開發 Roblox Studio 是免費的嗎?

Studio 的 MCP 伺服器沒有公開的價格,但 Anthropic 的 Free 方案不包含 Claude Code(claude.com/pricing,2026 年 10 月 9 日確認)。你需要付費 Claude 方案,它會和你方案的使用限制共用;或是依 API 使用量付費的 Claude Console 帳號。

使用 Claude Code 需要 Roblox 外掛程式或 HTTP 請求嗎?

使用 Studio 內建的 MCP 伺服器時不需要。Roblox 的設定步驟就是在 Assistant 中開啟伺服器並連接用戶端;其中沒有要安裝的外掛程式,也沒有要修改的 HTTP 設定。有些舊的教學介紹的是社群製作的 MCP 伺服器,運作方式不同。如果你選擇用 Rojo 處理檔案,它會使用自己的 Studio 外掛程式。

Claude Code 可以測試我的 Roblox 遊戲嗎?

透過 Studio MCP 工具可以。start_stop_play 會啟動與停止試玩測試,get_console_output 會讀取 Output,screen_capture 會擷取視埠畫面,而輸入工具會移動角色並送出按鍵與點擊。請確認它回報的內容,並在發布前自己玩一次。

Roblox Studio 該選 Claude Code 還是 Codex?

兩者都在 Roblox 的 quick connect 清單中,也都能使用相同的 Studio MCP 工具,所以差別在於模型、帳號以及包在外面的用戶端。Roblox 沒有發布比較,我們也沒有做過比較測試。請在場景的複本上,用相同的書面規則各試一次,留下修改需要較少修正的那一個。

Claude Code 在 Mac 上能搭配 Roblox Studio 使用嗎?

可以。Claude Code 支援 macOS 13.0 或更新版本,而 Roblox 也替手動設定的用戶端提供了 macOS 的伺服器路徑 /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP。

來源與延伸閱讀

程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。

在你自己的遊戲裡試試 RoCode。

每天都有免費點數,不需要信用卡。安裝外掛程式,描述你要的功能,再看看 Studio 裡出現了什麼。