서론
"Roblox의 코드 관리나 개발을 더 효율화하고 싶다"
"AI (Claude Code)에게 코드를 작성하게 하고, 그것을 실시간으로 Roblox Studio에 반영하고 싶다"
이런 분들을 위해 VS Code・Rojo・Claude Code를 조합한 AI 구동 Roblox 개발 환경 구축 방법을 정리했습니다.
개발 환경 개요
| 툴 | 역할 |
|---|
| VS Code | 코드를 작성하고 AI에게 지시를 내리는 메인 에디터 |
| Rojo | 로컬 스크립트(.luau)를 Roblox Studio에 자동 동기화하는 툴 |
| Claude Code | 터미널에서 한국어로 코드 생성 및 수정을 해주는 AI 에이전트 |
흐름은 다음과 같습니다.
Claude Code ──(파일을 수정)──▶ src/*.luau
│
rojo serve가 변경을 감지
...
이 구성을 사용하면 Studio에 코드를 복사/붙여넣기 할 필요가 없습니다. AI와 대화하며 빠르게 게임을 개발할 수 있습니다.
단계 1: Rojo 설치
바이너리 다운로드 (Mac의 경우)
Rojo의 GitHub Releases에서 사용하는 환경에 맞는 .zip 파일을 다운로드합니다.
압축을 풀고 나온 rojo 파일을 경로가 설정된 위치(예: /usr/local/bin/)에 배치합니다.
sudo mv ~/Downloads/rojo /usr/local/bin/
sudo chmod +x /usr/local/bin/rojo
보안 해제 및 버전 확인
브라우저를 통해 다운로드한 바이너리는 macOS의 Gatekeeper에 의해 차단되어 "개발자를 확인할 수 없습니다"와 같은 메시지가 표시될 수 있습니다. 이 경우 격리 속성을 제거합니다.
xattr -d com.apple.quarantine /usr/local/bin/rojo
명령어가 실행되는지 확인해 봅시다.
Rojo 7.7.1처럼 버전이 표시되면 성공입니다.
단계 2: 프로젝트 초기화 및 Roblox Studio 연동
프로젝트 폴더 생성
임의의 위치에 빈 폴더(예: MyRobloxGame)를 만들고 VS Code로 엽니다.
Rojo 초기화
VS Code 터미널에서 다음 명령어를 실행합니다.
폴더 내부에 default.project.json이나 src 폴더 등이 자동 생성됩니다.
MyRobloxGame/
├── default.project.json
└── src/
...
로컬 폴더와 Studio 상의 어떤 서비스가 대응하는지는 default.project.json에 작성되어 있습니다. Claude Code에게 지시를 내릴 때도 이 대응 관계를 염두에 두고 진행하면 순조롭습니다.
또한, Rojo는 파일명으로 스크립트 종류를 판별합니다.
| 파일명 | Studio 상의 종류 |
|---|
xxx.server.luau | Script |
xxx.client.luau | LocalScript |
xxx.luau | ModuleScript |
Roblox Studio에 플러그인 도입
GitHub Releases에서 Rojo.rbxm 파일을 다운로드합니다. Roblox Studio로 드래그 앤 드롭하고, 마우스 오른쪽 버튼 메뉴의 **"로컬 플러그인으로 저장(Save as Local Plugin...)"**을 선택합니다.
연결 시작
VS Code 측: 터미널에서 다음 명령어를 실행하여 서버를 구동합니다.
Roblox Studio 측: 플러그인 탭의 Rojo 아이콘을 클릭하고, "Connect" 버튼을 누릅니다.
Studio에 Connected to session ... at localhost:34872. 라고 표시되면 연결이 완료된 것입니다.
3단계: Claude Code로 개발을 시작하기
환경이 준비되었다면, rojo serve와는 별도의 터미널을 열고 프로젝트 폴더에서 Claude Code를 실행합니다.
이제 만들고 싶은 기능을 일본어로 지시하기만 하면 됩니다.
src/server 안에 플레이어가 참가했을 때 인사 메시지를 출력하는 서버용 스크립트를 만들라고 지시하면,
Claude Code가 예를 들어 다음과 같은 src/server/Greeting.server.luau를 생성합니다.
local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
print(`ようこそ、{player.DisplayName}さん!`)
...
Claude Code가 로컬의 src 내부 파일을 수정하면, Rojo가 이를 즉시 감지합니다. 수동으로 복사/붙여넣기 할 필요 없이 Roblox Studio 측 게임에 자동으로 동기화됩니다.
팁: CLAUDE.md에 프로젝트 규칙을 작성해 두기
프로젝트 직하위에 CLAUDE.md를 놓아두면, Claude Code가 매번 그 규칙을 읽고 작업합니다. Rojo의 폴더 대응이나 파일 명명 규칙을 작성해 두면 스크립트 배치 위치나 종류의 실수를 방지할 수 있습니다.
# 프로젝트의 규칙
- Roblox (Luau) 게임 프로젝트. Rojo로 Roblox Studio에 동기화함
- src/server → ServerScriptService, src/client → StarterPlayerScripts, src/shared → ReplicatedStorage.Shared
...
맺음말
이 구성을 사용하면 코드 관리나 Studio로의 수동 반영에서 해방되어 AI의 힘을 활용한 쾌적한 개발이 가능합니다.
Roblox에서의 개인 개발이나 게임 제작을 부스트하고 싶은 분들은 꼭 시도해 보세요!
토론 (Discussion)