Unity에서 AI로 게임 만들기 — Claude Code + MCP 플러그인 (전체 워크스루)

빈 폴더에서 시작해 물리, 머티리얼, 애니메이션, 파티클, 조작까지 갖춘 완전히 플레이 가능한 Unity 게임을 단 한 줄의 코드도 직접 작성하지 않고 만들 수 있다면 어떨까요? 이 전체 워크스루에서는 Claude Code와 AI Game Developer 플러그인(Unity-MCP)을 사용해 바로 그걸 해냅니다. 여러 AI 에이전트가 병렬로 작업해 개발 속도를 높이고, 전체 과정은 음성 명령과 자연어 프롬프트로 진행됩니다.

설정: 빈 폴더에서 AI 연결까지

설정 전체는 단 세 개의 터미널 명령으로 끝납니다. 먼저 CLI로 새 Unity 프로젝트를 만듭니다. 그다음 AI Game Developer 플러그인을 설치합니다. 마지막으로 Unity에서 프로젝트를 엽니다. Unity가 로드되는 동안 프로젝트 폴더에서 Claude Code를 미리 실행해 작업을 시작할 수 있습니다.

# Create a new Unity project
unity-mcp-cli create-project ./MyUnityProject --unity 6000.3.1f1

# Install the AI Game Developer plugin
unity-mcp-cli install-plugin ./MyUnityProject

# Open the project in Unity
unity-mcp-cli open ./MyUnityProject --keep-connected

프로젝트가 열리면 AI Game Developer 창에서 "Generate Skills" 체크박스를 활성화하세요. 그러면 Claude Code가 인식할 수 있는 스킬 파일이 생성됩니다. 기본으로 57개의 명령을 사용할 수 있습니다. 스킬을 활성화한 뒤에는 Claude Code를 재시작해야 스킬을 불러옵니다. Claude Code에서 / 를 입력해 사용 가능한 명령 목록을 살펴보면 확인할 수 있습니다.

스킬 vs MCP 도구 — 스킬이 이기는 이유

AI Game Developer는 MCP 도구와 Claude Code 스킬을 모두 지원합니다. 스킬은 컨텍스트 효율이 훨씬 뛰어납니다. 스킬 하나는 컨텍스트를 약 8 토큰만 차지하는 반면, MCP 도구는 훨씬 더 많이 소비합니다. AI에서 병목은 속도가 아니라 컨텍스트가 차오를수록 떨어지는 지능이기 때문에, 컨텍스트를 가볍게 유지하는 것이 결정적입니다. 스킬은 거의 공짜로 수천 개까지 로드할 수 있습니다.

• 스킬: 스킬당 약 8 토큰, 필요할 때 로드되며 컨텍스트 오버헤드 없음
• MCP 도구: 컨텍스트 점유량이 크고 항상 프롬프트에 포함됨
• 팁: 필요 없는 MCP 도구(Gmail, Calendar 등)는 비활성화해 컨텍스트를 깨끗하게 유지하세요
• 작업 사이사이 /clear로 새로 시작하세요 — 묵은 대화 기록을 끌고 다니지 마세요

음성 명령으로 씬 구성하기

Claude Code에서 음성 모드를 켜면(/voice 입력 또는 Space 키를 누르고 있기) 명령을 자연스럽게 말할 수 있습니다. 첫 번째 작업은 구 세 개를 일렬로 만드는 것입니다. Claude Code가 알맞은 스킬을 로드하고 AI Game Developer를 통해 Unity API를 호출하면, 몇 초 만에 씬에 구가 나타납니다.

병렬 AI 에이전트

여기서부터가 진짜 강력합니다. 같은 프로젝트 폴더에서 Claude Code 터미널을 여러 개 열 수 있고, 각 터미널은 독립적인 AI 에이전트로 동작합니다. 한 에이전트가 금, 은, 투명 유리 머티리얼을 만드는 동안 다른 에이전트가 경계 벽이 있는 바닥을 만듭니다. 둘은 서로 방해하지 않고 동시에 작업합니다.

워크스루에서는 두세 개의 에이전트를 꾸준히 병렬로 돌립니다. 하나는 WASD 회전 컨트롤러를 만들고, 다른 하나는 구의 위치를 고치고, 세 번째는 카메라 각도를 조정합니다. 각 에이전트가 자기 컨텍스트를 독립적으로 관리하기 때문에 시스템이 이를 매끄럽게 처리합니다.

AI의 자가 수정

실수는 일어납니다. 그리고 그래도 괜찮습니다. AI Game Developer 플러그인은 Unity의 상세한 오류 피드백을 Claude Code로 전달하므로, AI는 무엇이 잘못됐고 어떻게 고쳐야 하는지 정확히 알 수 있습니다. 도구 호출이 실패하거나 C# 스크립트에 컴파일 오류가 나면 에이전트가 자동으로 수정해 다시 시도합니다. 직접 개입할 일은 거의 없습니다.

컨텍스트 관리 팁

AI의 병목은 속도가 아니라 품질, 즉 컨텍스트입니다. 컨텍스트 윈도의 약 50%를 넘기면 AI는 덜 효과적이 됩니다. 영상에서 보여준 핵심 실천 방법은 다음과 같습니다.

1. MCP 도구 대신 스킬을 사용하세요 — 스킬은 컨텍스트를 거의 소비하지 않습니다
2. 작업 사이사이 /clear를 실행해 대화를 초기화하세요
3. 이전 작업의 대화 기록을 끌고 가지 마세요
4. 사용하지 않는 MCP 도구와 연동은 비활성화하세요
5. 일괄 작업에는 서브에이전트를 사용하세요 — 순차 호출보다 훨씬 빠릅니다
6. 각 에이전트는 한 번에 하나의 작업에만 집중하게 하세요

권한 우회

Claude Code는 도구를 실행하려 할 때마다 권한을 요청합니다. 더 빠르게 반복하려면 Claude Code에 프로젝트의 권한 우회를 활성화하도록 요청할 수 있습니다. Claude Code를 재시작한 뒤(Ctrl+C 두 번, 그다음 claude 입력) 권한 프롬프트 없이 실행됩니다. 주의할 점이 있습니다. 이렇게 하면 Claude Code가 확인 없이 어떤 명령이든 실행하게 되며, 프롬프트 인젝션을 통해 잠재적으로 위험한 명령도 포함됩니다. 신뢰할 수 있는 환경에서만 사용하세요.

즉석에서 확장 설치하기

AI Game Developer에는 특화 기능을 위한 확장 시스템이 있습니다. 영상에서는 세션 도중에 AI Particle System 패키지와 AI Animation 패키지 두 확장을 Claude Code에 요청하는 것만으로 설치합니다. 설치가 끝나면 새 스킬이 자동으로 나타나고(57개에서 59개 이상으로), 아무것도 재시작하지 않고 바로 사용할 수 있습니다.

• AI Particle System 확장: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md
• AI Animation 확장: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md

애니메이션과 파티클 만들기

확장을 설치한 뒤, 씬의 모든 장식 오브젝트에 대한 부유 애니메이션을 만들어 달라고 Claude Code에 요청합니다. 크기를 조절하고 수직으로 움직이는 동작을 무한 반복하는 애니메이션입니다. AI는 애니메이션 클립과 애니메이터 컨트롤러를 만들고 모든 것을 연결합니다. 애니메이션 위치 지정 때문에 오브젝트가 원점으로 튀는 경우에는, 각 오브젝트를 부모 GameObject로 감싸 달라고 AI에 요청해 해결합니다.

파티클의 경우 먼지 파티클 시스템을 요청합니다. AI가 이를 만들고, 머티리얼이 분홍색으로 보이면(셰이더 누락) 짧은 후속 프롬프트로 고칩니다. 그다음 더 밝고 잘 보이는 파티클을 요청하고 파티클 수를 세 배로 늘립니다. 모두 자연어 명령으로 처리됩니다.

최종 결과

완성된 게임에는 WASD 키로 조작되는 회전 바닥, 사실적인 물리로 굴러다니는 세 개의 금속 구(금, 은, 유리), 반복 애니메이션으로 떠다니는 다채로운 장식, 씬에 분위기를 더하는 먼지 파티클 시스템이 있습니다. 모두 빈 폴더에서 AI 프롬프트만으로 만들었으며, 컨텍스트 사용량은 작업당 컨텍스트 윈도의 3~5%로 최소 수준입니다.

어떤 AI 클라이언트와도 호환

이 워크스루는 Claude Code를 사용하지만, AI Game Developer는 MCP 호환 클라이언트라면 무엇이든 함께 쓸 수 있습니다. Cursor, Gemini, GitHub Copilot, VS Code 등이 대표적입니다. 이 플러그인은 완전히 무료이며 오픈 소스입니다. 선호하는 AI 도구를 연결하고 바로 만들기 시작하세요.

시작하기

AI Game Developer를 설치하고 Claude Code를 연결한 뒤 프롬프트를 입력하세요. 단계별 설정 안내는 ai-game.dev/docs/quickstart 의 퀵스타트 가이드를 확인하거나, ai-game.dev/download 에서 바로 다운로드하세요.

• AI Game Developer (Unity-MCP): github.com/IvanMurzak/Unity-MCP
• AI Animation 확장: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/Animation/README.md
• AI Particle System 확장: github.com/IvanMurzak/Unity-MCP/blob/main/extensions/ParticleSystem/README.md
• 다운로드: ai-game.dev/download
• 퀵스타트 가이드: ai-game.dev/docs/quickstart
• 이전 글: Claude Code를 Unity에 연결하기 — ai-game.dev/blog/claude-code-unity-tutorial
• 이전 글: AI로 애니메이션 생성하기 — ai-game.dev/blog/generating-unity-animations-with-ai