要点
安装 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 中做的修改,所以请先保存一个版本。
本页内容
开始前需要准备什么
| 需要的 | 详情 |
|---|---|
| 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 服务器是你电脑上的一个本地进程,所以会话也必须在你的电脑上。
| 形式 | 能连到 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 的安装页面。
curl -fsSL https://claude.ai/install.sh | bash
irm https://claude.ai/install.ps1 | iex
- 打开一个新的终端窗口,运行
claude --version。显示版本号就说明安装成功。如果找不到命令,说明安装文件夹还不在 PATH 中,解决方法见 Anthropic 关于安装问题的页面。 - 进入项目文件夹,运行
claude。第一次运行时它会打开浏览器窗口让你登录。如果浏览器没有打开,按c复制登录链接。 - 登录你的 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
- 在同一个面板(Assistant Settings > MCP Servers)中展开 Quick connect 列表。里面是你电脑上已安装的受支持客户端。
- 打开 Claude Code。如果列表里没有它,请安装 Claude Code 并重启 Studio。
- 重启 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 的文件夹里:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
下次你在这个文件夹里运行 claude 时,它会请你批准这个服务器:对每个来自 .mcp.json 文件的服务器,Anthropic 都会显示这个确认。Anthropic 设计这个文件是为了提交到仓库、让整个团队共用,但 Windows 和 macOS 的路径不同。如果你的团队两种系统都有,请把这个文件放在仓库之外,让每个人自己添加 Studio。
在 macOS 上,也可以改用一条命令添加 Studio。--scope user 让它在你电脑上的每个项目中都可用;不加的话,服务器只在当前文件夹加载。-- 用来把 Claude Code 自己的参数和启动服务器的命令分开。
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 模式也不例外。
{
"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 | |
|---|---|---|
| 是什么 | 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 创建 | Rojo 创建 |
|---|---|---|
.server | 运行上下文为 Server 的 Script | Script |
.client | 运行上下文为 Client 的 Script | LocalScript |
.local | LocalScript | 没有特殊含义(其他任何 .lua 文件都是 ModuleScript) |
| 无后缀 | ModuleScript | ModuleScript |
带 init 文件的文件夹 | 带子对象的脚本,类型由 init 文件的名字决定 | 文件夹变成由 init.server.lua、init.client.lua 或 init.lua 描述的脚本 |
为 Claude Code 设置 Script Sync
- 创建一个项目文件夹,为每个想放到磁盘上的服务建一个子文件夹,例如
ServerScriptService、ReplicatedStorage和StarterPlayerScripts,并在其中运行git init。 - 如果右键点击服务时没有出现 Script Sync,请在 File > Beta Features 中启用它,点击 Save 并重启 Studio。
- 在 Explorer 中右键点击 ServerScriptService,选择 Script Sync > Sync to,指定顶层的项目文件夹,而不是其中的子文件夹。对其他服务重复这一步。
- 在这个文件夹里运行
claude。现在 Claude 编辑的是.luau文件,Studio 会接收每一次修改。 - 每次会话前都提交一次,这样总有一个干净的点可以回退。
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 的项目。请按你的游戏修改名称,并删掉你用不到的内容。
# 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") 请求工具,服务器检查一切。
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 教程解释了每一点为什么重要。
安全的工作方式:检查点、审查、试玩测试
- 两边都建立检查点。把文件提交到 Git,并在 Studio 中通过 File > Save to Roblox with Notes 保存场景的一个版本。Studio MCP 教程展示了如何从 Version History 恢复它。
- 凡是超过一个脚本的工作,都先要一个计划,批准前先读一遍。
- 检查 diff。对于文件,接受前先读
git diff或扩展里的内置 diff。对于在 Studio 中做的修改,读一读 Claude 动过的脚本,并在 Explorer 里检查有没有新出现或消失的对象。 - 自己测试。Claude 可以运行试玩测试并读取 Output,但它只检查自己决定要检查的内容。在提交或发布之前,像玩家那样亲自玩一遍这个功能。
- 一切正常后提交,并在提交信息里写明改了什么。
/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 里的工具。所有检查都在服务器上做。
- 可以先用 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 Creator Docs: Connect to the Roblox Studio MCP server(英文). 启用服务器、quick connect、通过 JSON 和 CLI 配置、工具、多个 Studio 窗口和问题排查
- Roblox Creator Docs: Build with a coding harness(英文). VS Code 中的 Claude Code,Script Sync、MCP 和 Git 的配合
- Roblox Creator Docs: Script Sync(英文). 同步什么、文件名规则、冲突和 language server
- Roblox Creator Docs: Third-party tools(英文). 使用 Rokit 的 Rojo 和版本控制
- Roblox Creator Docs: Secrets stores(英文). 如何把 API 密钥放在脚本之外
- Roblox Creator Docs: Data stores(英文). 为什么 Studio 对 API services 的访问只应在测试副本中开启
- Rojo documentation (v7)(英文). 安装,以及文件名如何变成对象
- Claude Code Docs: Overview(英文). 所有形式使用同一个引擎,桌面应用需要付费订阅
- Claude Code Docs: Advanced setup(英文). 系统要求和安装命令
- Claude Code Docs: Authentication(英文). 登录和适用的账户类型
- Claude Code Docs: Connect Claude Code to tools via MCP(英文). stdio 服务器、.mcp.json、作用范围和服务器状态
- Claude Code Docs: Configure permissions(英文). allow、ask 和 deny 规则,包括 MCP 工具
- Claude Code Docs: Choose a permission mode(英文). 作为默认启动模式的 auto 模式、Manual 模式和 plan 模式
- Claude Code Docs: How Claude remembers your project(英文). CLAUDE.md、/init 和 AGENTS.md
- Claude Code Docs: Checkpointing(英文). /rewind 能恢复什么,以及它不跟踪什么
- Claude Code Docs: Manage costs effectively(英文). /usage、上下文大小和模型选择
- Claude Code Docs: Use Claude Code in the cloud(英文). 为什么云端会话不在你的电脑上运行
- Claude Code Docs: Use Claude Code in VS Code(英文). 要求、关于 PATH 的说明、共用的 MCP 配置和 Problems 面板
- Claude Code Docs: Extend Claude with skills(英文). skill 的 allowed-tools 字段能授予什么
- Claude pricing(英文). 哪些套餐包含 Claude Code,以及用量限额
- Claude Help Center: Use Claude Code with your Pro or Max plan(英文). 共用的限额,以及关于 ANTHROPIC_API_KEY 的警告
- Anthropic: Consumer Terms of Service(英文). 最低年龄
代码如何验证:本页的所有脚本都已用 Roblox API 类型定义(luau-lsp,2026年11月20日)通过 Luau strict 类型检查。类型检查能发现 API 名称写错和类型不匹配,但发现不了游戏逻辑上的错误。发布前请务必在 Studio 中测试。