# 설치 — AI Game Dev 앱 & CLI · AI Game Developer Wiki

Windows, macOS, Linux에 AI Game Dev 데스크톱 앱을 설치하거나 npm으로 gamedev CLI를 설치하고, 둘 다 최신 상태로 유지하세요.

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

이 페이지에서는 AI Game Dev 데스크톱 앱과 `gamedev` CLI를 설치하는 방법, 운영체제별로 어떤 빌드가 제공되는지, 업데이트가 어떻게 동작하는지 설명합니다. 둘 다 무료로 다운로드할 수 있으며, 에이전트가 할 수 있는 일은 요금제에 따라 다릅니다([로그인 및 계정](https://ai-game.dev/ko/docs/wiki/app/sign-in-and-account) 참고).

## 데스크톱 앱 설치

[다운로드 페이지](https://ai-game.dev/ko/download)를 여세요. 페이지가 시스템을 감지해 맞는 빌드를 제안하고, 기본 버튼 아래에 모든 빌드를 나열합니다.

| 운영체제 | 빌드 | 비고 |
| --- | --- | --- |
| Windows | 서명된 `.exe` 설치 프로그램, x64 | Windows on ARM에서 에뮬레이션으로 실행됩니다 |
| macOS, Apple silicon | arm64용 네이티브 `.dmg` | 모든 M 시리즈 Mac에 권장 |
| macOS, Intel | x64용 `.dmg` | Intel Mac용 |
| Linux | AppImage 및 `.deb`, x86\_64 | 아직 arm64 Linux 빌드는 없습니다 |

macOS용 범용 바이너리는 없습니다. Apple silicon 또는 Intel 빌드 중에서 선택하세요. 브라우저가 Mac의 아키텍처를 알려주지 않는 경우(Safari와 Firefox는 알려주지 않음) 페이지에 두 빌드가 모두 표시되며 직접 선택할 수 있습니다.

### Windows

1. [다운로드 페이지](https://ai-game.dev/ko/download)에서 설치 프로그램을 다운로드합니다.
2. `.exe`를 실행하고 설치 프로그램의 안내를 따릅니다.
3. 시작 메뉴에서 **AI Game Dev**를 실행합니다.

### macOS

1. Mac에 맞는 `.dmg`(Apple silicon 또는 Intel)를 다운로드합니다.
2. 파일을 열고 앱을 Applications 폴더로 드래그합니다.
3. Applications 또는 Launchpad에서 앱을 실행합니다.

### Linux

Debian 및 Ubuntu 계열 시스템에서는 `.deb`를, 그 외 환경에서는 AppImage를 사용하세요:

```bash
# Debian / Ubuntu: use the name of the file you downloaded
sudo apt install ./<downloaded-file>.deb

# Any distribution: make the AppImage executable, then run it
chmod +x ./<downloaded-file>.AppImage
./<downloaded-file>.AppImage
```

**참고**

데스크톱 앱에는 Node.js, npm 또는 엔진 CLI가 필요하지 않습니다. Unity, Unreal, Godot 플러그인 설치 프로그램이 앱 안에 포함되어 있습니다.

## gamedev CLI 설치

`gamedev` CLI는 터미널에서 사용하는 동일한 에이전트입니다. npm에 `@baizor/gamedev`로 게시되어 있으며, 사용 중인 플랫폼용으로 미리 빌드된 자체 포함 바이너리를 설치합니다: Windows x64, macOS arm64 및 x64, Linux x64 및 arm64.

요구 사항: npm이 포함된 Node.js 22 이상.

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

그런 다음 게임 프로젝트로 이동해 실행하세요:

```bash
cd /path/to/your/game
gamedev
```

전역 설치 없이 한 번만 실행할 수도 있습니다:

```bash
npx @baizor/gamedev
```

CLI는 처음 실행할 때 로그인을 요청합니다. 전체 명령 목록은 [CLI 레퍼런스](https://ai-game.dev/ko/docs/wiki/app/cli)에 있습니다.

## 업데이트

### 데스크톱 앱 업데이트

데스크톱 앱은 자체적으로 업데이트를 확인합니다. 새 버전이 있으면 백그라운드에서 다운로드하고 **Restart to update**를 표시하며, 재시작할 때 업데이트가 설치됩니다. **Settings**, **About**에서 직접 확인할 수도 있으며, 여기에서 앱 버전과 업데이트 상태를 볼 수 있습니다.

각 버전의 변경 사항은 [릴리스 노트 페이지](https://ai-game.dev/ko/releases)에 있습니다.

### CLI 업데이트

명령 하나로 CLI를 업데이트하세요:

```bash
gamedev update
```

이 명령은 대신 `npm install -g @baizor/gamedev@latest`를 실행합니다. 대화형 CLI 안에서 `/update`는 업그레이드 방법을 설명하고 백그라운드 서비스 상태를 보여주며, `/update now`는 업데이트를 기다리는 백그라운드 서비스를 교체합니다.

### 패키지 업데이트

Blender나 Knowledge Base 같은 패키지는 앱과 별도로 업데이트됩니다. 시작할 때 그리고 4시간마다 확인하며, 패키지별로 자동 업데이트를 끌 수 있습니다. [패키지](https://ai-game.dev/ko/docs/wiki/app/packages#updates)를 참고하세요.

## 백그라운드 서비스

데스크톱 앱, CLI, `gamedev acp`는 모두 컴퓨터에서 실행되는 하나의 AI Game Dev 백그라운드 서비스에 연결됩니다. 이 서비스가 로그인, 채팅, 패키지, 프로젝트 파일을 관리하므로, 채팅을 시작한 터미널을 닫아도 채팅은 계속 실행됩니다. 보통은 이 서비스를 직접 다룰 일이 없습니다. 다른 기기에서 항상 접근할 수 있어야 하는 컴퓨터라면, CLI로 로그인 시 시작되는 사용자별 OS 서비스로 설치할 수 있습니다:

```bash
gamedev daemon status
gamedev daemon install
```

다른 `daemon` 하위 명령은 [CLI 레퍼런스](https://ai-game.dev/ko/docs/wiki/app/cli#daemon)를 참고하세요.

## 무엇이 어디에 설치되나요

- 앱은 구성, 로그인 정보, 패키지 캐시를 홈 디렉터리의 `.ai-game-dev` 폴더(`~/.ai-game-dev/`)에 보관합니다.
- 프로젝트에는 프로젝트 수준에서 저장되는 항목이 있을 때만 `.ai-game-dev/` 폴더가 생깁니다. 예를 들어 팀 전체를 위해 추가한 패키지나 Knowledge Base 노트가 그렇습니다.
- 로컬 AI 모델은 **Settings**, **Model storage**에서(또는 CLI에서 `/images storage`로) 다른 드라이브로 옮길 수 있는 모델 저장 폴더에 보관됩니다.

## 다음 단계

- 계정으로 [로그인](https://ai-game.dev/ko/docs/wiki/app/sign-in-and-account)하세요.
- [첫 프로젝트를 여세요](https://ai-game.dev/ko/docs/wiki/app/projects-and-engines).
- 엔진 플러그인을 직접 설정하고 싶다면 [Unity](https://ai-game.dev/ko/docs/wiki/unity/installation), [Unreal](https://ai-game.dev/ko/docs/wiki/unreal/installation), [Godot](https://ai-game.dev/ko/docs/wiki/godot/installation) 플러그인 설치 가이드를 참고하세요.

---

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

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