# 빠른 시작 — AI Game Developer

몇 분 만에 시작하세요. AI Game Developer 앱을 다운로드하고 구독으로 로그인한 뒤 Unity, Unreal, Godot 중 하나를 선택하면 앱이 필요한 모든 것을 설치하고 연결해 줍니다.

이 페이지는 영어에서 기계 번역되었습니다. [영어 원문 읽기](https://ai-game.dev/docs/quickstart).

문서 · 빠른 시작

몇 분 만에 시작하세요. **Game Dev App**을 다운로드하고 구독으로 로그인한 뒤 엔진을 선택하면, 앱이 알맞은 Unity, Unreal, Godot 플러그인을 설치하고 연결해 줍니다. 수동 토큰도, 구성 파일도 필요 없습니다.

## Game Dev App 받기

AI Game Developer 앱은 모든 엔진에서 사용하는 AI 페어 프로그래머입니다. 데스크톱 앱을 받거나 `gamedev` CLI 설치로 시작하세요. 같은 계정, 같은 구독입니다.

▸ 데스크톱 앱

Windows, macOS, Linux용 서명된 설치 프로그램과 자동 업데이트를 제공합니다.

[앱 다운로드 →](https://ai-game.dev/ko/download)

**터미널이 더 편하신가요? `gamedev` CLI 설치를 권합니다.**

셸에서도 동일한 핵심을 사용할 수 있습니다 (Node.js 20.19+ 또는 22.12+):

```bash
npm install -g @baizor/gamedev
```

```bash
gamedev
```

앱과 CLI 전체 안내를 보고 싶으신가요? [앱 가이드 열기 →](https://ai-game.dev/docs/app)

## 구독으로 로그인

앱을 실행하고 **로그인**을 클릭하세요. 브라우저 창에서 안전한 기기 인증 흐름이 열립니다. 승인하면 바로 시작됩니다. 사용량, 기록, 한도는 데스크톱 앱과 CLI 모두에서 동기화됩니다.

1. 앱을 열고 **로그인**을 선택하세요.
2. 열린 브라우저 창에서 로그인을 승인하세요.
3. 앱이 계정과 플랜을 확인합니다.

로그인 방식이 궁금하거나, 원하는 AI 클라이언트를 연결하시나요? [인증 가이드 읽기 →](https://ai-game.dev/docs/auth)

## 엔진 선택

앱에서 엔진을 선택하세요. 알맞은 플러그인이 설치되고 클라우드 연결이 구성되며 에디터가 열립니다. 직접 설치할 것은 없습니다. Brutal 출시 예정입니다.

**Unity**

Unity 2022.3 LTS Unity 2023 Unity 6 (6000.x) 모든 2022.3+ 버전

**Unity** 선택 시 앱이 플러그인을 설치하고 **ai-game.dev**를 통해 연결한 뒤 에디터를 엽니다. 상태 표시가 ● 준비됨 로 바뀌면 프롬프트를 시작할 수 있으며, **72개 기능 (21개 MCP 도구 + RQL)**가 제공됩니다.

▸ 이것부터 시도해 보세요

_“디렉셔널 라이트와 회전하는 큐브가 있는 새 씬을 만든 뒤 플레이 모드로 들어가세요.”_

직접 설정하거나 원하는 MCP 클라이언트를 연결하시나요? 고급 CLI + 수동 설정은 [Unity 설치 가이드 →](https://ai-game.dev/ko/engines/unity)에서 확인하세요.

**Unreal Engine**

Unreal Engine 5.5+ 5.7에서 테스트 완료 C++ 프로젝트

**Unreal Engine** 선택 시 앱이 플러그인을 설치하고 **ai-game.dev**를 통해 연결한 뒤 에디터를 엽니다. 상태 표시가 ● 준비됨 로 바뀌면 프롬프트를 시작할 수 있으며, **90개 MCP 도구**가 제공됩니다.

▸ 이것부터 시도해 보세요

_“정적 메시 큐브를 사용하는 새 Actor 블루프린트를 만들고 레벨에 세 개 배치해 주세요.”_

직접 설정하거나 원하는 MCP 클라이언트를 연결하시나요? 고급 CLI + 수동 설정은 [Unreal Engine 설치 가이드 →](https://ai-game.dev/ko/engines/unreal)에서 확인하세요.

**Godot**

Godot 4.3–4.5 C# / .NET 8 (mono)

**Godot** 선택 시 앱이 플러그인을 설치하고 **ai-game.dev**를 통해 연결한 뒤 에디터를 엽니다. 상태 표시가 ● 준비됨 로 바뀌면 프롬프트를 시작할 수 있으며, **99개 MCP 도구**가 제공됩니다.

▸ 이것부터 시도해 보세요

_“Camera3D와 MeshInstance3D 큐브가 있는 Node3D 씬을 추가하고 Main.tscn으로 저장합니다.”_

직접 설정하거나 원하는 MCP 클라이언트를 연결하시나요? 고급 CLI + 수동 설정은 [Godot 설치 가이드 →](https://ai-game.dev/ko/engines/godot)에서 확인하세요.

## 제작 시작하기

이제 끝입니다. 원하는 것을 자연어로 설명하면 에이전트가 에디터를 실시간으로 조작합니다. 도구 ID를 외울 필요 없이 그냥 요청하세요.

▸ 시도해 볼 프롬프트

- _“활성 씬의 모든 항목을 나열해 주세요.”_
- _“원점에 큐브를 만들고 물리 바디를 추가해 주세요.”_
- _“현재 뷰의 스크린샷을 찍어 주세요.”_

에이전트가 무엇을 더 할 수 있는지 궁금하신가요?

[261개 기능 모두 둘러보기 →](https://ai-game.dev/docs/tools)

## 자주 발생하는 문제

가장 많이 보고된 주의사항을 정리했습니다. 인증 관련 질문은 [인증 가이드](https://ai-game.dev/docs/auth)에서 자세히 다룹니다.

**로그인 브라우저 창이 열리지 않았습니다**

**예상 원인** 기본 브라우저가 설정되지 않았거나 방화벽이 로컬 콜백을 차단했습니다

**해결 방법**

기본 브라우저를 설정한 뒤 **로그인**을 다시 시도하세요. 앱은 브라우저에서 표준 OAuth 디바이스 플로우를 엽니다. 플로우 작동 방식은 [인증 가이드](https://ai-game.dev/docs/auth)를 참고하세요. 회사 프록시 환경에서는 `ai-game.dev`(으)로의 아웃바운드 HTTPS가 허용되어야 할 수 있습니다.

**엔진을 선택한 뒤에도 엔진 플러그인이 설치되지 않았습니다**

**예상 원인** 이 컴퓨터에서 엔진이나 프로젝트를 찾을 수 없습니다

**해결 방법**

엔진(Unity Hub, Unreal Engine, Godot)이 설치되어 있는지 확인하고 앱에서 실제 프로젝트 폴더를 지정하세요. 직접 설치하는 편이 좋다면 [엔진별 설치 가이드](https://ai-game.dev/ko/engines/unity)에서 플러그인을 바로 설치할 수도 있습니다.

**로그인 후 에디터 패널에 “연결 끊김”이 표시됩니다**

**예상 원인** 에디터가 인증을 마치지 못했거나 Cloud 연결이 끊겼습니다

**해결 방법**

에디터에서 **AI Game Developer** 창을 열고 **Cloud**를 선택한 다음 **Authorize**를 클릭합니다. 상태 표시가 ● Ready 로 표시될 때까지 기다립니다. 권한이 취소된 경우 다시 승인합니다. 활성 세션은 [연결된 기기](https://ai-game.dev/app/connected-devices) 페이지에서 확인할 수 있습니다.

**앱 대신 자체 AI 클라이언트(Claude Code, Cursor, Copilot…)를 사용하는 경우**

**예상 원인** 클라이언트에 MCP 엔드포인트와 자체 인증이 필요합니다

**해결 방법**

클라이언트를 MCP 엔드포인트로 지정하고 OAuth로 인증하도록 하세요. [인증 가이드](https://ai-game.dev/docs/auth)에서 `/mcp`와 고정된 `/mcp/p/<pin>` URL의 차이를 다루며, [MCP 엔드포인트 페이지](https://ai-game.dev/mcp-endpoint-info)에는 클라이언트별 설정 스니펫이 있습니다.

### 다음은 어디로 갈까요?

[**앱 →** 데스크톱 앱과 gamedev CLI 사용법을 자세히 살펴봅니다.](https://ai-game.dev/docs/app) [**인증 →** OAuth 디바이스 플로우, CI용 PAT, 엔드포인트 고정.](https://ai-game.dev/docs/auth) [**도구 카탈로그 →** AI가 할 수 있는 261가지 기능: MCP 도구와 RQL.](https://ai-game.dev/docs/tools) [**자주 묻는 질문 →** 설치, 인증, 개인정보 보호에 관한 일반적인 질문입니다.](https://ai-game.dev/docs/faq)

---

Source (HTML): https://ai-game.dev/ko/docs/quickstart

Machine-translated (ko) from the English page: https://ai-game.dev/docs/quickstart