要点
Claude Code をインストールし、有料の Claude プランか Claude Console のアカウントでログインします。Studio で Assistant を開き、… > Manage MCP Servers をクリックして Enable Studio as MCP server をオンにし、Quick connect の一覧で Claude Code をオンにします。Claude Code を再起動し、/mcp と入力して Studio のサーバーが接続されていることを確認したら、読み取りだけを行うリクエストから始めましょう。
- Claude Code は Anthropic の Free プランには含まれません。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 の料金ページには、Claude Code は Free プランに含まれないと書かれています。 |
| 年齢 | 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 を内蔵していますが、PATH に claude を追加しないので、そのコマンドが必要ならターミナル版もインストールしてください。 |
| デスクトップアプリの Code タブで Local を選んだもの | はい | あなたのパソコンで動きます。Anthropic によると、有料のサブスクリプションが必要です。 |
| クラウドのセッション(claude.ai/code、またはデスクトップアプリの Cloud) | いいえ | あなたのパソコンではなくクラウドのインフラで動くので、ローカルの Studio のサーバーを起動できません。 |
ステップ1:Claude Code をインストールしてログインする
Anthropic は、ターミナルで1つのコマンドを実行するインストール方法を勧めています。以下は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 では、Claude Code が Bash ツールを使えるように Git for Windows をインストールすることを Anthropic は勧めています。Git for Windows がないと、Claude Code は PowerShell でコマンドを実行します。この設定では、Claude Code を WSL の中ではなく Windows 自体にインストールしてください。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 によると、新しい設定を読み込むにはクライアントの再起動が必要です。
quick connect が Claude Code のどのファイルに書き込むのか、サーバーにどんな名前を付けるのかを、Roblox は説明していません。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 の設定がそのまま使えます。自分のシステム用のものを、claude を実行するフォルダーに .mcp.json として保存してください。
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
次にこのフォルダーで claude を実行すると、サーバーを承認するよう求められます。Anthropic は、.mcp.json ファイルから来るサーバーごとにこの確認を表示します。Anthropic はこのファイルを、コミットしてチーム全体で共有するものとして設計していますが、Windows と macOS ではパスが違います。チームに両方のシステムがある場合は、ファイルをリポジトリの外に置き、それぞれが自分で Studio を追加するようにしてください。
macOS では、代わりに1つのコマンドで 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 の呼び出しが、確認なしで通ることがあります。
すべての変更を自分で管理する方法は2つあります。
- 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 を頼むのは良い習慣です。1つのクライアントが開いているすべての Studio のウィンドウに届き、ツールの呼び出しはそれぞれ studio_id で対象のウィンドウを指定するからです。
スクリプト1つより大きな作業では、まず計画を頼みましょう。plan モード(Shift+Tab を押すか、プロンプトを /plan で始めます)では、Claude はファイルを編集せずに調べて提案します。Anthropic は plan モードをファイルの編集とシェルのコマンドについて説明しているので、Studio のツールの ask のルールも残しておいてください。
ステップ5:Script Sync か Rojo でスクリプトをファイルとして扱う
Claude Code は、フォルダーの中のファイルを中心に作られています。自分のツールでファイルを編集し、Git がその履歴を残し、/rewind でファイルを元に戻せます。スクリプトをディスクに置けば、これらをすべて使えます。そして MCP のツールは、StarterGui の GUI、RemoteEvent、パーツのような、スクリプト以外の部分のために残しておけます。Roblox は、そのための方法を2つ説明しています。
| 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 | 一緒に使えます。2人が同時に同じ同期中のスクリプトを編集するのは避けてください。 | 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 の設定
- プロジェクトのフォルダーを作り、その中に、ディスクで管理したいサービスごとに1つずつフォルダーを作ります。たとえば
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"
エージェントと使うときに、さらに大事になる Script Sync のルールが2つあります。属性やタグがあるスクリプトは同期しないでください。Script Sync はそれらを無視し、Roblox はそれがデータの損失につながることがあると注意しています。また、Studio を閉じている間にファイルが変わると、プレイスを開き直したときに Studio がどう解決するかを尋ね、Keep Studio と Keep Disk でそれぞれ何が追加、変更、削除されるかを一覧にします。選ぶ前にこの一覧を読んでください。
Script Sync をオンにしていると、ファイルの編集は保存した直後に Studio に入ります。Claude Code で編集を承認することは、プレイスでそれを承認することと同じなので、承認する前に確認してください。編集を自動で承認するモードでは特に注意が必要です。
エディターでの補完や型エラーの表示には、Studio 用のコンパニオンプラグインと組み合わせた Luau Language Server の拡張機能を Roblox は勧めています。VS Code では、Claude Code の拡張機能が内蔵のツールで Problems パネルを読めるので、Claude もあなたと同じ警告を見られます。
ステップ6:CLAUDE.md で Roblox のルールを Claude に伝える
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.
いくつかの行は、ツールの動き方が理由で入っています。ファイル名のルールがあるのは、Script Sync では .client.luau が LocalScript にならないからです。list_roblox_studios の行があるのは、サーバーが開いているすべてのウィンドウに届くからです。アセットの行があるのは、insert_asset が外部のコンテンツをプレイスに持ち込み、upload_image が画像を Roblox のアセットサーバーに送るからです。wait の行は、wait、spawn、delay を非推奨とし、task ライブラリを使うよう示している Roblox の API リファレンスに従っています。
ほかのコーディングエージェント用の AGENTS.md がすでにプロジェクトにある場合、Claude Code はそれをプロジェクトの指示として読めるので、両方に1つのファイルを使えます。両方がある場合にどちらが優先されるかは、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. 1人のプレイヤーが頼める頻度を制限します。
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 のハンドラーでは、どれでも同じ点を確認してください。クライアントが送ってきたものの型とサイズを確認しているか、1人のプレイヤーが呼び出せる頻度を制限しているか、判断をサーバーが下しているか、プレイヤーが退出したらその記録を削除しているか、です。それぞれがなぜ大事かは RemoteEvent のガイドで説明しています。
安全な作業の進め方:チェックポイント、確認、プレイテスト
- 両方の側でチェックポイントを作る。ファイルを Git にコミットし、Studio で File > Save to Roblox with Notes からプレイスのバージョンを保存します。Version History から復元する方法は Studio MCP のガイドで紹介しています。
- 計画を頼む。スクリプト1つより大きな作業では計画を頼み、承認する前に読みます。
- diff を確認する。ファイルについては、承認する前に
git diffか拡張機能の組み込みの diff を読みます。Studio で行われた変更については、Claude が触ったスクリプトを読み、Explorer で増えたり消えたりしたオブジェクトがないかを確認します。 - 自分でテストする。Claude はプレイテストを実行して Output を読めますが、確認するのは Claude 自身が確認すると決めたことだけです。コミットや公開の前に、プレイヤーと同じように機能を遊んでみてください。
- コミットする。すべて動いたら、何が変わったかを書いたメッセージでコミットします。
/rewind で取り消せるものと取り消せないもの
Claude Code はプロンプトのたびにチェックポイントを保存し、/rewind(または Esc を2回)で、Claude がファイル編集のツールで変更したファイルを元に戻せます。Anthropic は、追跡しないものとして、シェルのコマンドによる変更などを挙げています。MCP のツールで Studio に加えた変更はファイルの編集ではないので、/rewind で取り消せるとは考えないでください。また、それが Studio の取り消し履歴に入るかどうかを、Roblox の MCP のページは説明していません。Script Sync を使っている場合、/rewind が元に戻したファイルは、ほかのディスク上の変更と同じように Studio へ同期されます。それ以外のすべてについては、保存したバージョンが戻る手段です。
秘密情報とライブのデータを手の届かないところに置く
- API キー、Open Cloud のキー、Webhook の URL、パスワードを、プロンプトや
CLAUDE.mdに貼り付けないでください。どちらも Claude が読むテキストで、CLAUDE.mdは普通リポジトリにコミットされます。 - スクリプトに直接書き込むのもやめましょう。Roblox にはゲームごとの秘密情報のストアがあります。Creator Dashboard で秘密情報を作り、サーバースクリプトで
HttpService:GetSecret()を使って読みます。ローカルのプレイテストには、File > Experience Settings > Security でローカルの秘密情報を追加します。 - 個人的な設定は、Git の外に置くことを想定した
.claude/settings.local.jsonとCLAUDE.local.mdに入れます。CLAUDE.local.mdは自分で.gitignoreに追加してください。 - Enable Studio Access to API Services は、ゲームの別のテスト用コピーだけでオンにしてください。Roblox は、Studio がライブのゲームと同じデータストアを使うと注意しています。そのため、そこで Claude が実行したプレイテストが本物のプレイヤーデータを上書きするおそれがあります。
- サードパーティの skill は、インストールする前に読んでください。skill のカタログには Claude Code 用の Roblox の skill がありますが、Anthropic は、skill が
allowed-toolsフィールドで自分に広いツールのアクセスを与えられると指摘しています。
Roblox の作業に使う Claude Code の費用
Studio 側には公表された料金がありません。MCP サーバーは Studio の一部で、Roblox の MCP のページは料金に触れていません。費用は Claude Code の費用で、Anthropic には支払い方法が2つあります(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 までに制限します。代わりに、1つのフォルダー、深さの制限、行の範囲を指定して頼みましょう。
search_game_treeとscript_readはどちらもそれに対応しています。 - モデルの選択。Anthropic によると、Sonnet はほとんどのコーディング作業をうまくこなし、Opus より安く済みます。
/modelで切り替えます。
Claude Code と Studio のトラブルシューティング
Roblox 自身のチェックリストは短く、Studio とクライアントを再起動する、コマンドのパスが存在するか確認する、JSON を確認する、の3つです。ここでは 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 の拡張機能は PATH に claude を追加しないので、このガイドのコマンドを使うにはターミナル版を別にインストールしてください。
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 サーバーはありません。RoCode で使っているのと同じ Roblox アカウントで Studio にログインしていれば、プラグインは自動で接続します。そうでない場合は、プラグインのパネルに表示される8文字のコードで、チャットとプラグインを一度だけつなぎます。
乗り換える前に知っておきたいこと。RoCode は Claude のサブスクリプションや Claude Code をつなげません。OpenRouter を通じてサードパーティのモデルを動かしていて、Pro 以上では Claude Sonnet 5.5、Studio 以上では Claude Opus 5.5 が使え、無料の Starter プランでは GPT-6 Luna で1日1クレジットが使えます。編集モードから動きます。プラグイン 3.9 以降では、Build モードで短いプレイテストを実行してエラーを読み取れ、プラグイン 3.9.11 以降ではテスト用のキャラクターを操作してゲームが動くかを確認できます。プラグイン 3.9.14 以降では、作ったものを編集モードでスクリーンショットに撮り、おかしく見えるところを直すこともできます。コードを直接実行したりメッシュを生成したりはしませんが、Studio MCP のツールはどちらもできます。あなたの言葉で Creator Store の無料モデルを検索したり(中のスクリプトは削除されます)、アセット ID でモデル、デカール、メッシュを挿入したりでき、装飾、建物、小道具はゲームごとに新しく考え出します。Ask モードでは、読み取り専用のツールでプレイスについての質問に答え、何も変更しません。アカウントは13歳以上が対象で、18歳未満は親か保護者の許可が必要です。
プレイヤーが ServerStorage.Tools のツールをリクエストできるように RemoteEvent を追加して。確認はすべてサーバーでやって。
- まず Search Game と List Children でプレイスを調べ、Tools フォルダーと、すでにツールを渡しているスクリプトを見つけられます
- Create Script でサーバースクリプトを書き、Create Instance で RemoteEvent を追加できます
- 終える前に、Studio で Check Script を使ってスクリプトのコンパイルを確認します。これはコンパイルのチェックで、型チェックでもプレイテストでもありません
- 変更をまとまりごとに送り、まとまりごとに Studio 自体の履歴の取り消しポイントになります
プラグイン 3.9 以降では、RoCode は短いプレイテストを実行してエラーを読み取れます。プラグイン 3.9.15 以降では、テスト用のキャラクターが歩き、キーを押し、画面のボタンをクリックできます。ただし確認するのは RoCode 自身が確認すると決めたことだけなので、自分でも Play を押して、プレイヤーとして結果を確かめてください。プロンプトは私たちが書いた例で、手順に出てくるのは実際のツール名です。プラグインとペアリングの仕組み。RoCode は独立した製品であり、Roblox Corporation とは提携しておらず、同社の承認やスポンサーを受けていません。
よくある質問
Claude Code の代わりに Claude Desktop を使えますか?
はい。Claude Desktop は Studio の Manage MCP Servers パネルの Quick connect の一覧にあるので、Windows でも Mac でもスイッチ1つで接続できます。使うのは同じ Studio のツールです。Claude Code は、スクリプトのファイルや Git の扱いのような、ターミナルのエージェントが得意なことを加えます。両方の手順は Studio MCP の設定ガイドにあります。
Claude Code は Roblox Studio に接続できますか?
はい。Roblox は、Studio に内蔵された MCP サーバーの quick connect クライアントとして Claude Code を挙げています。Assistant > … > Manage MCP Servers で Enable Studio as MCP server をオンにし、Quick connect の一覧で Claude Code をオンにして、Claude Code を再起動します。Script Sync や Rojo を使えば、スクリプトをファイルとして扱うこともできます。
Roblox Studio で Claude Code を無料で使えますか?
Studio の MCP サーバーには公表された料金がありませんが、Claude Code は Anthropic の Free プランに含まれません(claude.com/pricing、2026年10月9日に確認)。プランの利用上限を共有する有料の Claude プランか、API の利用量に応じて支払う Claude Console のアカウントが必要です。
Claude Code を使うのに Roblox のプラグインや HTTP リクエストは必要ですか?
Studio に内蔵の MCP サーバーなら不要です。Roblox の設定手順は、Assistant でサーバーを有効にしてクライアントを接続するだけで、インストールするプラグインも、変更が必要な HTTP の設定もありません。古いガイドの中には、仕組みの違うコミュニティ製の MCP サーバーを説明しているものもあります。ファイルの管理に Rojo を選んだ場合、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(英語). MCP のツールを含む allow、ask、deny のルール
- 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 でテストしてください。