# 워크스페이스 — AI Game Dev 앱 & CLI · AI Game Developer Wiki

AI Game Dev 데스크톱 워크스페이스: 프로젝트 창, 팬에 배치된 세션, 텍스처·3D 모델·오디오 파일 미리보기, Explorer, Search, Git.

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

데스크톱 앱은 AI 에이전트와 하루 종일 반복하는 루프, 즉 요청을 보내고 결과를 확인하고 변경 사항을 검토하는 과정을 중심으로 만들어진 게임 개발 워크스페이스입니다. 이 페이지에서는 프로젝트 창, 세션과 팬, 파일 미리보기, Explorer, Search, Source Control이 있는 오른쪽 패널, 그리고 워크스페이스를 자신에게 맞게 설정하는 방법을 설명합니다.

## 프로젝트당 하나의 창

VS Code에서처럼 각 프로젝트는 자체 창에서 열립니다. 앱을 다시 실행하면 열려 있던 모든 프로젝트 창이 각자의 크기, 위치, 사이드 패널, 팬 레이아웃과 함께 복원됩니다.

빈 창은 최근 프로젝트, **Open folder…**, **Create new project**가 있는 런처입니다. Ctrl-클릭(Windows, Linux) 또는 Cmd-클릭(macOS)하면 현재 창을 대체하는 대신 새 창에서 프로젝트가 열립니다. 프로젝트 열기와 생성에 관해서는 [Projects and engines](https://ai-game.dev/ko/docs/wiki/app/projects-and-engines)를 참고하세요.

## 팬에 배치된 세션

창의 중앙은 팬 레이아웃입니다. 다음을 할 수 있습니다:

- 여러 세션을 탭으로 열어 두거나, 세로 또는 가로로 나란히 분할할 수 있습니다.
- 하나의 팬을 최대화하거나 레이아웃 위에 띄울 수 있습니다.
- 세션 목록에서 세션을 레이아웃으로 바로 끌어다 놓을 수 있습니다.

백그라운드의 세션은 계속 스트리밍되며, 레이아웃은 프로젝트별로 저장됩니다. 각 팬은 자체 모델, 추론 강도, 에이전트를 유지하므로 한 팬에서는 큰 모델로 기능을 계획하고 다른 팬에서는 빠른 모델로 간단한 질문에 답할 수 있습니다. [Agents and models](https://ai-game.dev/ko/docs/wiki/app/agents-and-models)를 참고하세요.

### 세션 그룹

사이드바는 세션을 그룹으로 정리하며, 그룹은 생성, 이름 변경, 색상 지정, 순서 변경이 가능합니다. 그룹 구성은 프로젝트와 함께 커밋되므로 저장소를 클론한 팀원도 동일한 레이아웃을 보게 됩니다. 각 행에는 AI가 무엇을 하는지와 얼마나 오래 작업했는지가 표시되며, 검색 필드로 이름이나 그룹 기준으로 세션을 필터링할 수 있습니다. 완료로 표시한 세션은 복원하거나 영구적으로 삭제할 수 있습니다.

긴 대화에서는 프롬프트 내비게이터로 이전 메시지로 바로 이동할 수 있으며, 마우스를 올리면 미리보기가 표시됩니다.

## 채팅 옆에서 파일 미리보기

에이전트가 파일을 생성하거나 변경하면 세션 옆의 미리보기 팬에서 열어 보세요. 채팅 메시지의 파일 경로는 클릭할 수 있으며, 클릭하면 파일이 열리고 메시지에 줄 번호가 있으면 해당 줄로 이동합니다.

| 파일 형식 | 미리보기에서 보여주는 내용 |
| --- | --- |
| 코드 및 Markdown | 구문 강조, 렌더링된 Markdown |
| 이미지 및 텍스처 | PNG, JPEG 등은 물론 TGA, TIFF, PSD, HDR, EXR, DDS, KTX, SVG |
| 3D 모델 | 텍스처가 적용된 모델, 전환 가능한 조명과 그림자, 방향 기즈모 |
| 오디오 | 파형, 실제 샘플 레이트, 코덱, 비트 심도, 채널, 루프 토글 |
| 비디오, 폰트, CSV | 재생, 글리프, 표 |
| 그 외 모든 파일 | 헥스 뷰 |

한 번 클릭하면 임시 미리보기가 열리고, 두 번 클릭하면 미리보기가 고정됩니다. 파일이 디스크에서 변경되면 미리보기가 다시 로드되므로, 더 어두운 텍스처를 요청하면 에이전트가 파일을 쓰는 즉시 열려 있는 미리보기가 갱신됩니다. 패키지는 다른 파일 형식을 위한 자체 미리보기와 편집기를 추가할 수 있습니다.

## 오른쪽 패널: Explorer, Search, Source Control

오른쪽 패널에는 세 개의 탭이 있습니다:

- **Explorer**: Git 상태가 표시되는 실시간 트리로 프로젝트 파일을 보여주며, 인라인 이름 변경과 생성, 파일을 채팅 작성창으로 끌어다 놓기를 지원합니다.
- **Search**: 포함 및 제외 glob을 사용하는 콘텐츠 검색과 모든 일치 항목 바꾸기.
- **Source Control**: 브랜치, 앞서감/뒤처짐 수, diffstat을 보여주며 여기서 커밋과 풀을 할 수 있습니다.

Source Control에서 변경된 파일을 클릭하면 diff로 열립니다. 이미지의 경우 diff가 나란히 비교 보기로 표시되므로, 커밋하기 전에 텍스처가 어떻게 바뀌었는지 정확히 확인할 수 있습니다.

패키지는 사이드 패널에 자체 탭을 추가할 수 있습니다. 예를 들어 Knowledge Base 패키지는 Knowledge Base 뷰를 추가합니다.

CLI에도 동일한 작업이 명령으로 있습니다. `/git`은 status, stage, commit, discard, pull, push에, `/search`와 `/replace`는 프로젝트 검색에, `/file`은 파일 변경에, `/files`는 채팅에서 언급된 파일에 사용합니다. [CLI reference](https://ai-game.dev/ko/docs/wiki/app/cli#slash-commands)를 참고하세요.

## 루프: 요청, 미리보기, 검토

1. 요청을 보냅니다. 예: "Meadow Isle을 밤 잔디 텍스처로 바꾸고 활공 낙하를 조금 느리게 해줘."
2. 채팅 옆에서 결과를 확인합니다. 텍스처는 이미지 미리보기에서, 캐릭터는 3D 미리보기에서, 음악은 오디오 미리보기에서 볼 수 있습니다.
3. Source Control을 열어 이전 텍스처와 새 텍스처를 비교하고 코드 diff를 읽어 봅니다.
4. 만족스러우면 커밋하고, 아니면 다른 변경을 요청합니다.

**팁**

자주 커밋하세요. 작은 커밋은 실험이 잘 되지 않았을 때 되돌리기 쉽게 해주며, 히스토리에서 어느 세션이 어떤 변경을 했는지 확인할 수 있습니다.

## 도구, 상태 표시줄, 명령 팔레트

- 작성창 위의 **Tools row**는 세션의 도구를 켜고 끕니다. Blender, Music, Knowledge Base, Image Gen, Video, Tripo, Cloud generation 및 설치한 다른 패키지의 도구가 포함됩니다.
- 하단의 **status bar**는 Knowledge Base 노트 개수 같은 패키지 항목과 Packages 창을 여는 패키지 아이콘을 표시합니다.
- **command palette**는 앱과 패키지의 명령을 나열합니다.
- 패키지는 작성창 툴바에 버튼을, 마우스 오른쪽 버튼 메뉴에 항목을 추가할 수 있습니다.

## 나에게 맞게 설정하기

워크스페이스에는 중성적인 검정 Dark부터 차콜색 Carbon, 밝은 테마까지 여섯 가지 테마가 있습니다. **Settings**, **Appearance**에서 선택하세요. 창이 좁아지면 작성창이 정해진 순서대로 컨트롤을 숨기므로 작게 분할해도 계속 사용할 수 있습니다. 짧은 인앱 팁은 기능이 처음 유용해질 때 소개해 줍니다. **Settings**, **General**에서 초기화할 수 있습니다.

## 더 알아보기

- [one workspace for panes, previews and Git](https://ai-game.dev/ko/blog/ai-game-dev-workspace-panes-previews-git) 글에서 데모 게임으로 전체 루프를 보여줍니다.
- [Packages](https://ai-game.dev/ko/docs/wiki/app/packages)에서 패널, 미리보기, 도구를 추가하는 방법을 설명합니다.

---

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

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