教程 · Roblox Studio 中的 AI

如何把 Claude Code 连接到 Roblox Studio

Claude Code 是 Anthropic 推出的智能编程工具。Roblox 把它列为 Studio 内置 MCP 服务器的 quick connect 客户端,所以它能读取你的场景、修改脚本,并在你打开的 Studio 窗口里运行试玩测试。它还能通过 Script Sync 或 Rojo 把你的脚本当作文件来处理。本教程讲的是 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. 插件式 AI 代理
  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,用来保存脚本历史。如果想在编辑器面板而不是终端里使用 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 模式下由后台分类器替你审核操作。这样一来,修改脚本或在 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 列表涵盖只读的工具:游戏树、属性、脚本、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 指明目标窗口。

凡是超过一个脚本的工作,都先让它出一个计划。在 plan 模式下(按 Shift+Tab,或在提示词开头写 /plan),Claude 会调研并提出方案,但不编辑你的文件。Anthropic 是从文件编辑和 shell 命令的角度描述 plan 模式的,所以 Studio 工具的 ask 规则也请保留。

第 5 步:通过 Script Sync 或 Rojo 把脚本当作文件处理

Claude Code 是围绕文件夹里的文件构建的。它用自己的工具编辑文件,Git 保存文件的历史,/rewind 可以恢复文件。把脚本放到磁盘上,就能用上这一切,而 MCP 工具则留给场景中不是脚本的部分,例如 StarterGui 里的 GUI、RemoteEvent 和零件。Roblox 记录了两种做法。

Script Sync 与 Rojo,依据 Roblox 关于 Script Sync 和第三方工具的页面
Script SyncRojo
是什么Studio 的一项功能,把场景中的脚本与磁盘上的文件双向同步。第三方工具:你电脑上的一个服务器,加上一个 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可以配合使用。避免两个人同时编辑同一个同步的脚本。Roblox 指出,第三方工具常常无法与它内置的协作工具配合使用。
Roblox 的建议适合想用自己的编辑器和版本控制来管代码、其余都用 Studio 的情况。如果你想把整个项目而不只是代码放进版本控制,它是最佳选择。

同一个文件名可能含义不同

两个工具都按文件名决定脚本类型,而它们的后缀并不一致。.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 文件的文件夹带子对象的脚本,类型由 init 文件的名字决定文件夹变成由 init.server.lua、init.client.lua 或 init.lua 描述的脚本

为 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"

有 AI 代理参与时,Script Sync 的两条规则变得更重要。不要同步带有 Attribute 或标签的脚本: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.

有些行是因为工具的工作方式而存在的。文件名规则之所以存在,是因为 .client.luau 在 Script Sync 中不是 LocalScript。关于 list_roblox_studios 的那一行之所以存在,是因为服务器能连到每个打开的窗口。关于资源的那一行之所以存在,是因为 insert_asset 会把外部内容引入场景,而 upload_image 会把图片发送到 Roblox 的资源服务器。关于 wait 的那一行遵循 Roblox 的 API 参考,其中把 wait、spawn 和 delay 标记为已弃用,推荐使用 task 库。

如果你的项目里已经有给其他编程代理用的 AGENTS.md,Claude Code 可以把它当作项目指令读取,所以可以两者共用一个文件。Anthropic 关于记忆的页面解释了两个文件都存在时以哪个为准。

这些规则在代码中是什么样子

下面是一个遵循上述 Luau 规则的服务端脚本。它是为本教程手写的,不是 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 只同步脚本和文件夹,所以由服务器自己创建它的 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,并在 Studio 中通过 File > Save to Roblox with Notes 保存场景的一个版本。Studio MCP 教程展示了如何从 Version History 恢复它。
  2. 凡是超过一个脚本的工作,都先要一个计划,批准前先读一遍。
  3. 检查 diff。对于文件,接受前先读 git diff 或扩展里的内置 diff。对于在 Studio 中做的修改,读一读 Claude 动过的脚本,并在 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 URL 和密码粘贴到提示词或 CLAUDE.md 中。两者都是 Claude 会读取的文本,而 CLAUDE.md 通常会被提交到仓库。
  • 也不要把它们硬编码进脚本。Roblox 为每个游戏提供了密钥存储:在 Creator Dashboard 中创建密钥,并在服务端脚本里通过 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 共用同一份用量限额。限额按滚动的 5 小时窗口重置,付费套餐在此之上还有每周限额。达到其中之一时,你可以等待、升级到更高的套餐,或者开启用量额度。
  • Claude Console 账户。你按处理的文本量为 API 用量付费。Anthropic 关于费用的页面说,花费在很大程度上取决于模型选择、代码库大小以及你的使用方式。

当前价格见 claude.com/pricing。本教程不重复这些价格,因为它们会变。在 Claude Code 中,/usage 命令会向订阅用户显示套餐的用量条,向 API 用户显示会话的大致费用。

哪些因素让 Roblox 会话消耗更多

  • 上下文大小。消耗随 Claude 上下文中的内容增加而增加。在不相关的任务之间使用 /clear。
  • 庞大的工具结果。在大型场景中遍历整个游戏树,或者完整读取很长的脚本,都会返回大量文本。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 的桌面应用。

或者改用插件式 AI 代理: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 套餐每天在 GPT-6 Luna 上提供 1 个额度。它在编辑模式下工作。在插件 3.9 及以上的 Build 模式下,它可以运行简短的试玩测试并读取错误;在插件 3.9.11 及以上,它可以操控测试角色来确认游戏能正常运行。在插件 3.9.14 及以上,它还会在编辑模式下给自己搭建的内容截图,并修正看起来不对的地方。它不直接执行代码,也不生成网格,而 Studio MCP 的工具两者都能做。它可以按你的描述在 Creator Store 中搜索免费模型(会删除其中的脚本),或者按资源 ID 插入模型、贴花或网格,而装饰、建筑和道具则为每个游戏重新设计。它的 Ask 模式用只读工具回答关于你场景的问题,不做任何修改。账户面向 13 岁及以上的用户,未满 18 岁需要父母或监护人的许可。

你输入

添加一个 RemoteEvent,让玩家可以请求 ServerStorage.Tools 里的工具。所有检查都在服务器上做。

RoCode 的操作
  • 可以先用 Search Game 和 List Children 查看场景,找到 Tools 文件夹和已经在发放工具的脚本
  • 用 Create Script 编写服务端脚本,并可以用 Create Instance 添加 RemoteEvent
  • 结束前用 Check Script 在 Studio 中检查脚本能否编译。这是编译检查,不是类型检查,也不是试玩测试
  • 分批提交修改,每一批都是 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 额外带来终端代理擅长的东西,例如处理脚本文件和 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 把你的脚本当作文件来处理。

用 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。

参考资料

代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。

在你自己的游戏里试试 RoCode。

每天有免费额度,无需绑定银行卡。安装插件,描述你想要的功能,然后看看它在 Studio 里做了什么。