Unity와 AI로만 게임 만들기! 바이브 코딩의 핵심 가이드 (2)

◀ [이전회차] Unity와 AI로만 게임 만들기! 바이브 코딩의 핵심 가이드 (1) 바로가기

Unity MCP 연결하기

MCP를 설정하면 Claude Code가 Unity를 직접 조작할 수 있습니다. 이 장에서는 가장 널리 사용되는 mcp-unity를 설치합니다.


🔧 MCP 설치 방법

Step 1: Unity 프로젝트 생성

  1. Unity Hub 실행

  2. "새 프로젝트(New Project)" 클릭

  3. 템플릿 선택:

    • 2D 게임: 2D (Built-In Render Pipeline)

    • 3D 게임: 3D (Built-In Render Pipeline) 또는 3D (URP)

  4. 프로젝트 이름과 저장 위치 설정

  5. "프로젝트 생성" 클릭

Step 2: Unity Package 설치

Unity 에디터가 열리면:

  1. 상단 메뉴에서 Window → Package Manager 클릭

  2. 좌측 상단 "+" 버튼 클릭

  3. "Add package by name..." 선택

  4. 입력창에 아래 내용 입력:

com.unity.nuget.newtonsoft-json

  1. "Add" 클릭

Step 3: MCP Unity 패키지 설치

  1. 다시 "+" 버튼 클릭

  2. "Add package from git URL..." 선택

  3. 아래 URL 입력:

<https://github.com/CoderGamester/mcp-unity.git>

  1. "Add" 클릭하고 설치 완료까지 대기

Step 4: MCP 서버 설정

설치가 완료되면 Unity 상단 메뉴에 "Tools"가 추가됩니다.

  1. Tools → MCP Unity → Server Window 클릭

  2. 나타나는 창에서 "Start Server" 버튼 클릭

  3. 상태가 "Running"으로 바뀌면 성공


⚙️ Claude Code에 MCP 연결하기

Step 1: 설정 파일 위치 찾기

Windows:

C:\\\\Users\\\\[사용자이름]\\\\AppData\\\\Roaming\\\\Claude\\\\claude_desktop_config.json

Mac:

~/Library/Application Support/Claude/claude_desktop_config.json

💡 파일이 없다면? Claude Code를 한 번 실행했다가 종료하면 자동으로 생성됩니다.

Step 2: 설정 파일 수정

해당 파일을 메모장이나 VS Code로 열고, 아래 내용으로 수정합니다:

{
  "mcpServers": {
    "mcp-unity": {
      "command": "node",
      "args": [
        "C:/Users/[사용자이름]/[Unity프로젝트경로]/Library/PackageCache/com.gamedevmcp.mcp-unity@[버전]/Server~/build/index.js"
      ]
    }
  }
}

⚠️ 주의: [사용자이름], [Unity프로젝트경로], [버전]을 실제 값으로 바꿔야 합니다.

Step 3: 연결 확인

  1. Unity에서 MCP 서버가 "Running" 상태인지 확인

  2. 터미널에서 프로젝트 폴더로 이동 후 Claude Code 실행:

cd "Unity프로젝트 경로"
claude

  1. Claude Code에서 아래와 같이 입력해봅니다:

Unity에 빨간색 큐브를 하나 만들어줘

Unity 씬에 빨간 큐브가 나타나면 연결 성공! 🎉


🚫 MCP 없이 사용하기

MCP 설정이 어렵다면, MCP 없이도 사용할 수 있습니다:

  1. Claude Code에게 코드 생성을 요청

  2. Claude가 만든 코드를 복사

  3. Unity에서 새 스크립트 생성 후 붙여넣기

이 방식도 충분히 효과적입니다. 다만 "복사-붙여넣기" 과정이 추가될 뿐입니다.

프롬프트 작성의 기초

  • 프롬프트(Prompt) 란 AI에게 전달하는 요청/지시문입니다. 프롬프트를 어떻게 작성하느냐에 따라 결과물의 품질이 크게 달라집니다.


📝 좋은 프롬프트의 5가지 원칙

1️⃣ 구체적으로 작성하기

❌ 나쁜 예시:
"플레이어 만들어줘"

✅ 좋은 예시:
"WASD 키로 이동하고, 스페이스바로 점프하는 3D 플레이어 캐릭터를 만들어줘.
이동 속도는 5, 점프 높이는 2로 설정해줘."

2️⃣ 맥락 제공하기

AI는 여러분의 프로젝트에 대해 모릅니다. 필요한 배경 정보를 알려주세요.

✅ 좋은 예시:
"나는 2D 플랫포머 게임을 만들고 있어.
플레이어가 적과 충돌하면 HP가 1 감소하는 시스템을 만들어줘.
현재 PlayerController 스크립트에 이미 이동 로직이 있어."

3️⃣ 단계별로 나누기

복잡한 기능은 한 번에 요청하지 말고 나눠서 요청하세요.

❌ 나쁜 예시:
"인벤토리 시스템 만들어줘"

✅ 좋은 예시:
1단계: "아이템 데이터를 저장할 ScriptableObject 구조를 만들어줘"
2단계: "인벤토리 UI 레이아웃을 만들어줘"
3단계: "아이템을 추가/제거하는 로직을 만들어줘"
4단계: "아이템을 클릭하면 사용하는 기능을 추가해줘"

4️⃣ 예시나 참고 자료 활용하기

원하는 결과물의 예시가 있다면 공유하세요.

✅ 좋은 예시:
"젤다 야생의 숨결처럼 패러글라이더로 활강하는 시스템을 만들어줘.
- 점프 중 특정 키를 누르면 패러글라이더 발동
- 천천히 하강하면서 앞으로 이동
- 스태미나가 소모되고, 0이 되면 자동으로 접힘"

5️⃣ 제약 조건 명시하기

지켜야 할 규칙이 있다면 미리 알려주세요.

✅ 좋은 예시:
"적 AI를 만들어줘.
제약 조건:
- NavMesh는 사용하지 말고 간단한 방식으로
- Update에서 직접 움직이는 방식으로
- 모바일에서도 돌아갈 수 있게 성능 고려해줘"


🎯 프롬프트 템플릿

복사해서 바로 사용할 수 있는 템플릿입니다:

기능 요청 템플릿

## 목표
[만들고 싶은 기능을 한 문장으로]

## 상세 설명
[구체적인 동작 방식 설명]

## 조작 방법
- [키/버튼]: [동작]
- [키/버튼]: [동작]

## 참고 사항
- [지켜야 할 규칙이나 제약 조건]
- [참고할 만한 게임이나 예시]

버그 수정 템플릿

## 문제 상황
[어떤 문제가 발생하는지]

## 재현 방법
1. [첫 번째 단계]
2. [두 번째 단계]
3. [문제 발생]

## 예상 동작
[원래 어떻게 동작해야 하는지]

## 에러 메시지 (있다면)
[Unity 콘솔에 나온 에러 메시지 복사]


💬 대화 이어가기

Claude Code와의 대화는 일회성이 아닙니다. 결과가 마음에 들지 않으면 계속 수정을 요청하세요.

👤 You: 플레이어 이동 스크립트 만들어줘

🤖 Claude: [스크립트 생성]

👤 You: 이동 속도가 너무 빨라. 절반으로 줄여줘

🤖 Claude: [속도 수정]

👤 You: 대각선 이동할 때 속도가 더 빨라지는 문제가 있어. 수정해줘

🤖 Claude: [대각선 이동 정규화 적용]

👤 You: 좋아! 이제 달리기 기능도 추가해줘. Shift 누르면 1.5배 빨라지게

🤖 Claude: [달리기 기능 추가]

📂 부록: 함께 읽으면 좋은 레시피 & 용어

▶ [다음회차] Unity와 AI로만 게임 만들기! 바이브 코딩의 핵심 가이드 (3) 바로가기

▶ [게임 기획] 서브 퀘스트 30개를 2주 안에? AI로 시나리오 뼈대 10분 만에 잡기

▶ [게임 QA] "기획서 5건, TC 마감 일주일... 엑셀 앞에서 멘붕 온 QA 테스터의 비장의 무기"


2025.11.29.
7
1개의 답글