설치

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

데스크톱 앱 설치#

다운로드 페이지를 여세요. 페이지가 시스템을 감지해 맞는 빌드를 제안하고, 기본 버튼 아래에 모든 빌드를 나열합니다.

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

Windows#

1. 다운로드 페이지에서 설치 프로그램을 다운로드합니다.
2. .exe를 실행하고 설치 프로그램의 안내를 따릅니다.
3. 시작 메뉴에서 AI Game Dev를 실행합니다.

macOS#

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

Linux#

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

# 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

gamedev CLI 설치#

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

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

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

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

cd /path/to/your/game
gamedev

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

npx @baizor/gamedev

CLI는 처음 실행할 때 로그인을 요청합니다. 전체 명령 목록은 CLI 레퍼런스에 있습니다.

업데이트#

데스크톱 앱 업데이트#

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

각 버전의 변경 사항은 릴리스 노트 페이지에 있습니다.

CLI 업데이트#

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

gamedev update

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

패키지 업데이트#

Blender나 Knowledge Base 같은 패키지는 앱과 별도로 업데이트됩니다. 시작할 때 그리고 4시간마다 확인하며, 패키지별로 자동 업데이트를 끌 수 있습니다. 패키지를 참고하세요.

백그라운드 서비스#

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

gamedev daemon status
gamedev daemon install

다른 daemon 하위 명령은 CLI 레퍼런스를 참고하세요.

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

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

다음 단계#

• 계정으로 로그인하세요.
• 첫 프로젝트를 여세요.
• 엔진 플러그인을 직접 설정하고 싶다면 Unity, Unreal, Godot 플러그인 설치 가이드를 참고하세요.