# AI Game Dev 앱과 gamedev CLI — AI Game Developer Wiki

AI Game Dev 데스크톱 앱과 gamedev CLI가 무엇이고, Unity, Unreal, Godot 플러그인과 어떻게 연동되며, 어디서 시작해야 하는지 설명합니다.

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

AI Game Dev는 AI Game Developer의 AI 게임 개발 앱입니다. 게임 프로젝트를 이해하고, 파일을 편집하며, 자연어로 엔진 에디터를 조작하는 AI 에이전트입니다. 하나의 계정, 하나의 백그라운드 서비스, 하나의 채팅 기록을 공유하는 두 가지 형태로 제공됩니다: **데스크톱 앱**과 터미널용 **`gamedev` CLI**입니다. 위키의 이 섹션에서는 이 둘을 설치하고 로그인하며, 프로젝트를 열고, 모델을 선택하고, 패키지로 앱을 확장하고, 흔한 문제를 해결하는 방법을 설명합니다.

## 데스크톱 앱 또는 CLI

두 프런트엔드 모두 Claude Agent SDK로 구동되는 동일한 에이전트를 실행하며, 둘 다 AI Game Developer 계정으로 인증합니다.

|  | 데스크톱 앱 | `gamedev` CLI |
| --- | --- | --- |
| 실행 환경 | Windows, macOS, Linux | Windows, macOS, Linux 터미널 |
| 설치 | [다운로드 페이지](https://ai-game.dev/ko/download)에서 받는 서명된 설치 프로그램 | `npm install -g @baizor/gamedev` |
| 적합한 용도 | 일상 작업: 창 분할, 미리보기, Source Control, Packages window | 터미널 워크플로, 스크립팅(`--print`), T3 Code나 Zed 같은 ACP 클라이언트 |
| 패키지 | Packages window와 `/packages` | `gamedev pkg`와 `/packages` |
| 업데이트 | 업데이트를 다운로드하고 **Restart to update**를 제안합니다 | `gamedev update` |

같은 컴퓨터에서 둘 다 사용할 수 있습니다. 한쪽에서 시작한 채팅은 공유 기록에 보관되고, 사용자 수준에서 설치한 패키지는 양쪽 모두에 적용됩니다.

## 엔진 플러그인 및 MCP와의 관계

이 앱은 엔진 플러그인을 대체하지 않고 활용합니다. 각 엔진에는 에디터 도구(오브젝트 생성, 씬 편집, 테스트 실행, 스크린샷 촬영 등)를 노출하는 자체 MCP 플러그인이 있습니다:

- Unity용 [Unity MCP](https://ai-game.dev/ko/docs/wiki/unity)로, `unity-mcp-cli`가 관리합니다.
- Unreal Engine용 [Unreal MCP](https://ai-game.dev/ko/docs/wiki/unreal)로, `unreal-mcp-cli`가 관리합니다.
- Godot용 [Godot MCP](https://ai-game.dev/ko/docs/wiki/godot)로, `godot-cli`가 관리합니다.

Unity, Unreal 또는 Godot 프로젝트를 열면 앱이 엔진을 감지하고, 해당 플러그인을 설치하거나 업데이트하도록 제안하며, 에이전트가 필요로 할 때 에디터를 열고, 로그인한 세션을 통해 ai-game.dev를 거쳐 에디터의 도구를 채팅에 연결합니다. 설치 프로그램이 앱 안에 포함되어 있으므로 데스크톱 앱에는 Node.js나 npm이 필요하지 않습니다.

플러그인은 앱 없이도 작동합니다. 모든 MCP 클라이언트(Claude Code, Cursor, VS Code, Codex 등)가 [MCP 엔드포인트](https://ai-game.dev/ko/mcp-endpoint-info)에 연결할 수 있습니다. [생태계 개요](https://ai-game.dev/ko/docs/ecosystem)에서는 앱, 플러그인, MCP 서버가 어떻게 맞물리는지 보여 주고, [도구 카탈로그](https://ai-game.dev/docs/tools)에서는 플러그인이 에이전트에게 제공하는 것들을 나열합니다.

## 앱이 플러그인 위에 더하는 것

- 프로젝트 파일을 읽고 편집하며, 명령을 실행하고 엔진 도구를 호출하는 채팅 에이전트. 승인은 사용자가 제어합니다.
- 여러 제공자의 AI 모델 중에서 선택하며, 요금제와 지역에 따라 배정됩니다. [에이전트와 모델](https://ai-game.dev/ko/docs/wiki/app/agents-and-models)을 참고하세요.
- 프로젝트마다 창 하나, 창 분할된 세션, 파일 미리보기(텍스처, 3D 모델, 오디오, 비디오), Git을 제공하는 데스크톱 워크스페이스입니다. [워크스페이스](https://ai-game.dev/ko/docs/wiki/app/workspace)를 참고하세요.
- 통째로 기능을 추가하는 **Packages**: Blender, SuperCollider를 이용한 음악, 프로젝트 Knowledge Base, Tripo 3D, GPU에서의 로컬 이미지·비디오 생성, 클라우드 비디오·오디오 모델. [패키지](https://ai-game.dev/ko/docs/wiki/app/packages)를 참고하세요.
- 세션 도구: 각 채팅이 어떤 도구를 지닐지 선택하므로 에이전트의 컨텍스트가 작게 유지됩니다.

## 페이지 맵

처음이라면 여기서 시작하세요:

1. [설치](https://ai-game.dev/ko/docs/wiki/app/installation): Windows, macOS, Linux에 데스크톱 앱을 설치하거나 `gamedev` CLI를 설치하고, 최신 상태로 유지합니다.
2. [로그인과 계정](https://ai-game.dev/ko/docs/wiki/app/sign-in-and-account): 로그인, 요금제, 퍼센트로 표시되는 사용량, 계정 전환.
3. [프로젝트와 엔진](https://ai-game.dev/ko/docs/wiki/app/projects-and-engines): 프로젝트를 열거나 만들고, 앱이 Unity, Unreal 또는 Godot 플러그인을 설정하도록 합니다.
4. [에이전트와 모델](https://ai-game.dev/ko/docs/wiki/app/agents-and-models): 모델, 추론 강도, 에이전트 선택, 승인, 로컬 모델.

그다음 더 깊이 들어가 보세요:

- [워크스페이스](https://ai-game.dev/ko/docs/wiki/app/workspace): 데스크톱 앱의 창 분할, 미리보기, Explorer, Search, Source Control.
- [패키지](https://ai-game.dev/ko/docs/wiki/app/packages): 패키지란 무엇인지, Packages window, `gamedev pkg`, 레벨, 업데이트.
- [패키지 카탈로그](https://ai-game.dev/ko/docs/wiki/app/packages-catalog): 현재 사용 가능한 모든 패키지와 각 패키지의 기능.
- [패키지 만들기](https://ai-game.dev/ko/docs/wiki/app/creating-packages): 나만의 패키지를 작성하고, 테스트하고, 공유합니다.
- [CLI 레퍼런스](https://ai-game.dev/ko/docs/wiki/app/cli): 모든 `gamedev` 명령과 터미널의 슬래시 명령.
- [문제 해결](https://ai-game.dev/ko/docs/wiki/app/troubleshooting): 로그인, 엔진 연결, 패키지 및 모델.
- [FAQ](https://ai-game.dev/ko/docs/wiki/app/faq): 자주 묻는 질문에 대한 짧은 답변.

## 빠른 시작

1. [다운로드 페이지](https://ai-game.dev/ko/download)에서 앱을 다운로드하거나 `npm install -g @baizor/gamedev`를 실행하세요.
2. AI Game Developer 계정으로 로그인하세요.
3. 게임 프로젝트 폴더를 여세요.
4. 원하는 작업을 설명하세요. 예: "List everything in the active scene."

4단계 [빠른 시작](https://ai-game.dev/ko/docs/quickstart)은 스크린샷과 함께 동일한 흐름을 안내하며, [앱 가이드](https://ai-game.dev/docs/app)는 한 페이지 개요를 제공합니다. 프롬프트 작성 팁은 [모범 사례](https://ai-game.dev/docs/best-practices)를 읽어 보세요.

- [**설치** Windows, macOS, Linux에 AI Game Dev 데스크톱 앱을 설치하거나 npm으로 gamedev CLI를 설치하고, 둘 다 최신 상태로 유지하세요.](https://ai-game.dev/ko/docs/wiki/app/installation)
- [**로그인 및 계정** AI Game Dev 앱과 gamedev CLI에 로그인하고, 계정을 전환하고, 플랜과 사용량 비율을 이해하고, 다른 기기를 관리하는 방법을 설명합니다.](https://ai-game.dev/ko/docs/wiki/app/sign-in-and-account)
- [**프로젝트와 엔진** AI Game Dev 앱에서 Unity, Unreal, Godot 프로젝트를 열거나 만들고, 엔진 플러그인을 설치하고, 필요할 때 에이전트가 에디터를 열도록 합니다.](https://ai-game.dev/ko/docs/wiki/app/projects-and-engines)
- [**에이전트와 모델** AI Game Dev 앱과 CLI에서 AI 모델, 추론 강도, 에이전트를 선택하고, 도구 승인을 제어하며, 내 GPU에서 로컬 AI 모델을 사용하세요.](https://ai-game.dev/ko/docs/wiki/app/agents-and-models)
- [**워크스페이스** AI Game Dev 데스크톱 워크스페이스: 프로젝트 창, 팬에 배치된 세션, 텍스처·3D 모델·오디오 파일 미리보기, Explorer, Search, Git.](https://ai-game.dev/ko/docs/wiki/app/workspace)
- [**패키지** AI Game Dev 앱에 어떤 패키지가 들어 있는지, Packages 창이나 gamedev pkg로 설치·업데이트·제외·제거하는 방법, 레벨이 동작하는 방식을 설명합니다.](https://ai-game.dev/ko/docs/wiki/app/packages)
- [**패키지 카탈로그** 오늘날 제공되는 모든 퍼스트파티 AI Game Dev 패키지: Blender, SuperCollider 음악, Knowledge Base, Tripo 3D, 로컬 이미지·비디오 모델, 클라우드 모델.](https://ai-game.dev/ko/docs/wiki/app/packages-catalog)
- [**패키지 만들기** 나만의 AI Game Dev 패키지를 작성하세요: aigd-package.json 매니페스트, 명령, 슬래시 명령, MCP 도구, gamedev pkg dev를 이용한 로컬 개발, 공유하기.](https://ai-game.dev/ko/docs/wiki/app/creating-packages)
- [**gamedev CLI 레퍼런스** 모든 gamedev CLI 명령과 옵션: 대화형 및 헤드리스 모드, pkg, remote, daemon, acp, image-runtime, update, 그리고 터미널의 슬래시 명령을 다룹니다.](https://ai-game.dev/ko/docs/wiki/app/cli)
- [**문제 해결** AI Game Dev 앱과 gamedev CLI에서 흔한 문제 해결: 로그인, 모델, 엔진 플러그인과 에디터 연결, 패키지, 로컬 및 클라우드 생성.](https://ai-game.dev/ko/docs/wiki/app/troubleshooting)
- [**FAQ** AI Game Dev 앱과 gamedev CLI에 대한 짧은 답변: 엔진, 플랫폼, 요금제, 사용량, 패키지, 로컬 모델, 개인정보 보호, 자체 AI 클라이언트 사용.](https://ai-game.dev/ko/docs/wiki/app/faq)

---

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

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