AI Game Dev 앱과 gamedev CLI
AI Game Dev 데스크톱 앱과 gamedev CLI가 무엇이고, Unity, Unreal, Godot 플러그인과 어떻게 연동되며, 어디서 시작해야 하는지 설명합니다.
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 터미널 |
| 설치 | 다운로드 페이지에서 받는 서명된 설치 프로그램 | 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로,
unity-mcp-cli가 관리합니다. - Unreal Engine용 Unreal MCP로,
unreal-mcp-cli가 관리합니다. - Godot용 Godot MCP로,
godot-cli가 관리합니다.
Unity, Unreal 또는 Godot 프로젝트를 열면 앱이 엔진을 감지하고, 해당 플러그인을 설치하거나 업데이트하도록 제안하며, 에이전트가 필요로 할 때 에디터를 열고, 로그인한 세션을 통해 ai-game.dev를 거쳐 에디터의 도구를 채팅에 연결합니다. 설치 프로그램이 앱 안에 포함되어 있으므로 데스크톱 앱에는 Node.js나 npm이 필요하지 않습니다.
플러그인은 앱 없이도 작동합니다. 모든 MCP 클라이언트(Claude Code, Cursor, VS Code, Codex 등)가 MCP 엔드포인트에 연결할 수 있습니다. 생태계 개요에서는 앱, 플러그인, MCP 서버가 어떻게 맞물리는지 보여 주고, 도구 카탈로그에서는 플러그인이 에이전트에게 제공하는 것들을 나열합니다.
앱이 플러그인 위에 더하는 것
- 프로젝트 파일을 읽고 편집하며, 명령을 실행하고 엔진 도구를 호출하는 채팅 에이전트. 승인은 사용자가 제어합니다.
- 여러 제공자의 AI 모델 중에서 선택하며, 요금제와 지역에 따라 배정됩니다. 에이전트와 모델을 참고하세요.
- 프로젝트마다 창 하나, 창 분할된 세션, 파일 미리보기(텍스처, 3D 모델, 오디오, 비디오), Git을 제공하는 데스크톱 워크스페이스입니다. 워크스페이스를 참고하세요.
- 통째로 기능을 추가하는 Packages: Blender, SuperCollider를 이용한 음악, 프로젝트 Knowledge Base, Tripo 3D, GPU에서의 로컬 이미지·비디오 생성, 클라우드 비디오·오디오 모델. 패키지를 참고하세요.
- 세션 도구: 각 채팅이 어떤 도구를 지닐지 선택하므로 에이전트의 컨텍스트가 작게 유지됩니다.
페이지 맵
처음이라면 여기서 시작하세요:
- 설치: Windows, macOS, Linux에 데스크톱 앱을 설치하거나
gamedevCLI를 설치하고, 최신 상태로 유지합니다. - 로그인과 계정: 로그인, 요금제, 퍼센트로 표시되는 사용량, 계정 전환.
- 프로젝트와 엔진: 프로젝트를 열거나 만들고, 앱이 Unity, Unreal 또는 Godot 플러그인을 설정하도록 합니다.
- 에이전트와 모델: 모델, 추론 강도, 에이전트 선택, 승인, 로컬 모델.
그다음 더 깊이 들어가 보세요:
- 워크스페이스: 데스크톱 앱의 창 분할, 미리보기, Explorer, Search, Source Control.
- 패키지: 패키지란 무엇인지, Packages window,
gamedev pkg, 레벨, 업데이트. - 패키지 카탈로그: 현재 사용 가능한 모든 패키지와 각 패키지의 기능.
- 패키지 만들기: 나만의 패키지를 작성하고, 테스트하고, 공유합니다.
- CLI 레퍼런스: 모든
gamedev명령과 터미널의 슬래시 명령. - 문제 해결: 로그인, 엔진 연결, 패키지 및 모델.
- FAQ: 자주 묻는 질문에 대한 짧은 답변.
빠른 시작
- 다운로드 페이지에서 앱을 다운로드하거나
npm install -g @baizor/gamedev를 실행하세요. - AI Game Developer 계정으로 로그인하세요.
- 게임 프로젝트 폴더를 여세요.
- 원하는 작업을 설명하세요. 예: "List everything in the active scene."
4단계 빠른 시작은 스크린샷과 함께 동일한 흐름을 안내하며, 앱 가이드는 한 페이지 개요를 제공합니다. 프롬프트 작성 팁은 모범 사례를 읽어 보세요.
- 설치Windows, macOS, Linux에 AI Game Dev 데스크톱 앱을 설치하거나 npm으로 gamedev CLI를 설치하고, 둘 다 최신 상태로 유지하세요.
- 로그인 및 계정AI Game Dev 앱과 gamedev CLI에 로그인하고, 계정을 전환하고, 플랜과 사용량 비율을 이해하고, 다른 기기를 관리하는 방법을 설명합니다.
- 프로젝트와 엔진AI Game Dev 앱에서 Unity, Unreal, Godot 프로젝트를 열거나 만들고, 엔진 플러그인을 설치하고, 필요할 때 에이전트가 에디터를 열도록 합니다.
- 에이전트와 모델AI Game Dev 앱과 CLI에서 AI 모델, 추론 강도, 에이전트를 선택하고, 도구 승인을 제어하며, 내 GPU에서 로컬 AI 모델을 사용하세요.
- 워크스페이스AI Game Dev 데스크톱 워크스페이스: 프로젝트 창, 팬에 배치된 세션, 텍스처·3D 모델·오디오 파일 미리보기, Explorer, Search, Git.
- 패키지AI Game Dev 앱에 어떤 패키지가 들어 있는지, Packages 창이나 gamedev pkg로 설치·업데이트·제외·제거하는 방법, 레벨이 동작하는 방식을 설명합니다.
- 패키지 카탈로그오늘날 제공되는 모든 퍼스트파티 AI Game Dev 패키지: Blender, SuperCollider 음악, Knowledge Base, Tripo 3D, 로컬 이미지·비디오 모델, 클라우드 모델.
- 패키지 만들기나만의 AI Game Dev 패키지를 작성하세요: aigd-package.json 매니페스트, 명령, 슬래시 명령, MCP 도구, gamedev pkg dev를 이용한 로컬 개발, 공유하기.
- gamedev CLI 레퍼런스모든 gamedev CLI 명령과 옵션: 대화형 및 헤드리스 모드, pkg, remote, daemon, acp, image-runtime, update, 그리고 터미널의 슬래시 명령을 다룹니다.
- 문제 해결AI Game Dev 앱과 gamedev CLI에서 흔한 문제 해결: 로그인, 모델, 엔진 플러그인과 에디터 연결, 패키지, 로컬 및 클라우드 생성.
- FAQAI Game Dev 앱과 gamedev CLI에 대한 짧은 답변: 엔진, 플랫폼, 요금제, 사용량, 패키지, 로컬 모델, 개인정보 보호, 자체 AI 클라이언트 사용.