요약
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 이상, RAM 4GB 이상, 인터넷 연결, 그리고 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 사본이 따로 들어 있지만 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에서는 Claude Code가 자체 Bash 도구를 쓸 수 있도록 Git for Windows 설치를 Anthropic이 권장합니다. Git이 없으면 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에 따르면 클라이언트가 새 구성을 불러오려면 재시작이 필요합니다.
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의 구성을 그대로 쓸 수 있습니다. 내 시스템에 맞는 버전을 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에서는 대신 명령 하나로 Studio를 추가할 수 있습니다. --scope user를 붙이면 내 컴퓨터의 모든 프로젝트에서 쓸 수 있고, 붙이지 않으면 현재 폴더에서만 서버가 로드됩니다. --는 Claude Code 자체 옵션과 서버를 실행하는 명령을 구분합니다.
claude mcp add --transport stdio --scope user Roblox_Studio -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Windows에서는 PowerShell과 CMD가 명령줄의 %LOCALAPPDATA%를 서로 다르게 처리하므로 JSON 파일을 쓰는 방법이 더 간단합니다.
연결 확인하기
- 터미널에서
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은 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"
에이전트와 함께 쓰면 Script Sync의 두 가지 규칙이 더 중요해집니다. 속성이나 태그가 있는 스크립트는 동기화하지 마세요. 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.
일부 줄은 도구가 작동하는 방식 때문에 들어갔습니다. 파일 이름 규칙은 Script Sync에서 .client.luau가 LocalScript가 아니기 때문에 있습니다. list_roblox_studios에 관한 줄은 서버가 열려 있는 모든 창에 닿기 때문에 있습니다. 에셋에 관한 줄은 insert_asset이 외부 콘텐츠를 플레이스에 들여오고 upload_image가 이미지를 Roblox 에셋 서버로 보내기 때문에 있습니다. wait에 관한 줄은 wait, spawn, delay를 사용 중단으로 표시하고 task 라이브러리를 권하는 Roblox API 레퍼런스를 따른 것입니다.
프로젝트에 다른 코딩 에이전트용 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은 셸 명령으로 한 변경을 포함해 추적하지 않는 것들을 나열합니다. MCP 도구로 Studio에서 한 변경은 파일 수정이 아니므로 /rewind가 되돌려 줄 것이라고 기대하지 마세요. Roblox의 MCP 페이지는 그 변경이 Studio의 실행 취소 기록에 들어가는지 알려 주지 않습니다. Script Sync를 쓰면 /rewind가 복원한 파일은 다른 디스크 변경처럼 Studio로 다시 동기화됩니다. 그 밖의 모든 것은 저장한 버전으로 되돌아가야 합니다.
비밀 정보와 라이브 데이터는 닿지 않는 곳에
- API 키, Open Cloud 키, 웹훅 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은 두 가지 결제 방법을 제공합니다(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을 선택한 데스크톱 앱을 사용하세요.
또는 대신 플러그인 에이전트 RoCode를 쓰세요
MCP와 함께 쓰는 Claude Code는 터미널이나 코드 에디터가 편한 사람에게 맞습니다. RoCode(RoCode.app)는 다른 길입니다. rocode.app의 웹 채팅과 Creator Store의 무료 플러그인으로 이루어진 독립적인 Roblox Studio용 AI 에이전트이며, 플러그인이 열려 있는 플레이스에서 단계를 실행합니다. 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세 미만은 부모나 보호자의 허락이 필요합니다.
ServerStorage.Tools에서 플레이어가 도구를 요청할 수 있도록 RemoteEvent를 추가해 줘. 모든 것을 서버에서 확인하게.
- 먼저 Search Game과 List Children으로 플레이스를 살펴보고 Tools 폴더와 이미 도구를 지급하는 스크립트를 찾을 수 있습니다
- Create Script로 서버 스크립트를 작성하고 Create Instance로 RemoteEvent를 추가할 수 있습니다
- 끝내기 전에 Check Script로 Studio에서 스크립트가 컴파일되는지 검사합니다. 컴파일 검사일 뿐 타입 검사나 플레이 테스트가 아닙니다
- 변경 사항을 묶음으로 보내며, 묶음마다 Studio 자체 기록의 실행 취소 지점이 됩니다
플러그인 3.9 이상에서는 RoCode가 짧은 플레이 테스트를 실행하고 오류를 읽을 수 있으며, 플러그인 3.9.15 이상에서는 테스트 캐릭터가 걷고, 키를 누르고, 화면의 버튼을 클릭할 수 있습니다. 하지만 스스로 확인하기로 한 것만 확인하므로, 플레이어 입장에서 결과를 확인하려면 직접 Play를 누르세요. 프롬프트는 저희가 작성한 예시이며, 단계에는 실제 도구 이름이 쓰였습니다. 플러그인과 페어링이 작동하는 방식. RoCode는 Roblox Corporation과 관련이 없고, Roblox Corporation의 승인이나 후원을 받지 않는 독립 제품입니다.
자주 묻는 질문
Claude Code 대신 Claude Desktop을 써도 되나요?
네. Claude Desktop은 Studio의 Manage MCP Servers 패널에 있는 Quick connect 목록에 있으므로, Windows나 Mac에서 스위치 하나로 연결됩니다. 같은 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의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.