Universal Modder + Claude Code: 완전 설정 가이드

왜 Claude Code가 기준 에이전트인가

제작자는 실제 Claude Code 세션을 바탕으로 툴킷을 만들었고, 저장소에는 Claude 전용 설정이 들어 있습니다. 플러그인 마켓플레이스(.claude-plugin/), .claude/skills로 복사된 스킬, .mcp.json의 fal MCP 서버, 그리고 세션이 시작되거나 재개될 때마다 um CLI를 PATH에 넣는 SessionStart 훅입니다. 다른 에이전트도 작동하지만(멀티 에이전트 설치 가이드 참고), 가장 많이 테스트된 경로는 Claude Code입니다.

1. Claude Code 설치

claude --version이 이미 작동하면 건너뛰세요.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

그다음 모드 작업용 폴더(예: ~/mods 또는 C:\mods)를 만들고, 그 안에서 claude를 실행해 로그인합니다. Claude Pro, Max, Team, Enterprise 요금제나 API 결제가 연결된 Console 계정이 필요합니다. 문제가 있으면 claude doctor를 실행하세요.

툴킷에 필요한 Git, Python 3.10+, ffmpeg, uv도 설치하세요(한 줄 설치).

2. Universal Modder 플러그인 추가

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

• 모든 프로젝트 폴더에서 쓸 수 있도록 user 범위를 고르세요.
• Claude Code가 요청하면 /reload-plugins를 실행하거나 세션을 재시작하세요.
• 셸이 편하다면 claude plugin marketplace add …와 claude plugin install …로도 됩니다.
• SSH 오류가 나면 문제 해결을 보세요.

플러그인이 설치하는 것

3. 아트·3D·오디오용 fal 연결

fal MCP 서버는 Claude Code를 실행한 환경의 FAL_KEY를 읽습니다. fal.ai/dashboard/keys에서 키를 만들어 설정하고 claude를 재시작하세요.

export FAL_KEY="your-key"     # macOS / Linux / WSL
setx FAL_KEY "your-key"       # Windows, 이후 새 터미널 열기

Claude Code 안에서 /mcp로 확인하세요. fal 서버가 연결됨으로 나오면 됩니다. 에셋별 가격은 비용 페이지에 있습니다.

스킬 호출하기

스킬 이름을 직접 말할 일은 거의 없습니다. "스타듀 밸리 모드를…" 같은 요청이면 mod-any-game이 로드되고 필요에 따라 다른 스킬을 불러옵니다. 특정 스킬을 강제로 쓰려면 슬래시 명령을 입력하세요:

각 스킬에 무엇이 들어 있나 →

잘 먹히는 프롬프트

좋은 프롬프트에는 게임, 구체적인 결과 하나, 그리고 무엇이 "완성"인지가 들어 있습니다. 프로젝트 README의 예시:

테라리아 모드 만들어 줘: 유도 미사일 발사기와 지형에 큰 구멍을 내는 전술 핵을 추가하고, 스프라이트는 fal로 만들어 줘.

에이지 오브 엠파이어 II에 3D로 렌더링한 고유 유닛이 있는 새 문명을 만들어 줘.

진짜 마인크래프트를 GTA V 스토리 모드 안에 넣어 줘. 마인크래프트 카메라는 GTA 카메라를 따라가고, TNT로 GTA 차를 폭파할 수 있게.

C:\Games\Foo는 어떤 엔진이고, 누가 모딩해 본 적 있어?

토큰과 돈을 아끼는 팁:

• 정찰 먼저, 작업은 나중에. 변경 전에 계획을 요청하면 MODDING_PLAN.md를 씁니다.
• 한 번에 조각 하나. 작동하는 무기 하나가 반쯤 만든 무기 열 개보다 낫습니다.
• fal 전에 임시 에셋. 메커니즘이 게임에서 작동한 뒤에 최종 아트를 생성하세요.
• 가격부터 물어보기. "3D 모델 만들기 전에 um fal price로 확인해 줘."
• 테스트 중엔 손 떼기. 게임을 조작하거나 녹화하는 동안 PC를 쓰지 마세요.

긴 프로젝트와 컨텍스트 한도

스킬은 MODLOG.md에 작업 일지(경로, ID, 포맷, 실패한 것, 다음 단계)를 남기므로 Claude Code가 대화를 압축해도 중요한 정보가 사라지지 않습니다. 새 세션은 이렇게 시작하세요:

MODLOG.md와 MODDING_PLAN.md를 읽고 다음 단계부터 이어서 해 줘.

모드가 작동하면 share-field-notes 스킬로 필드 노트를 쓰게 하세요. 공유 지식 베이스에 PR을 여는 것은 사용자가 동의한 뒤뿐입니다.

Claude Code가 이걸로 만든 것

• Age of Empires II: Definitive Edition: San Franciscans: a new civilization for Age of Empires II DE with units rendered from 3D
• Baldur's Gate 3: Act 2 never loads (hang at 50% or crash): one modded NPC on a bad level layer, found by bisecting a pak
• Baldur's Gate 3: A generated wardrobe mod: 260 clothing mods sorted by race and body type into containers summoned by reusable scrolls
• Baldur's Gate 3: Custom outfits from cloned mod and vanilla meshes: visuals, materials, body masks, cloth, LODs, icons and the Blender GR2 round trip
• Baldur's Gate 3: Gameplay and compatibility patches in stats and Osiris: level-gated armour tiers, Extra Attack on a modded cantrip, crit immunity, stacking damage reduction, feats from items, removing equipment glow, a class vs starting-equipment fix
• Baldur's Gate 3: Running a 500+ mod load order by hand: modsettings.lsx rules, recovering a wiped order from a save, mod.io re-subscribes, game-folder files and conflict diagnosis
• Baldur's Gate 3: Weapons: porting a Skyrim dagger and scabbard, fixing a modded sword's sheath height with a Dummy_Sheath bone, and visible stowed shields for modded shields
• Borderlands 2: BL3 weapons and movement in Borderlands 2 (Willow2 SDK mods)
• Darkest Dungeon: A seeded randomizer (trinkets, heroes, monsters, curios, quirks, quests) as a Darkest Dungeon data mod
• Dragon's Dogma 2: Blink Strike teleports behind the target (REFramework Lua skill rework)
• Dragon's Dogma 2: Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)
• Elden Ring: CS2 conversion of Elden Ring offline: native Rust DLL via me3 (fall death, spirit springs, 3D inspect, params)

모든 게임 보기 →