# 에이전트와 모델 — AI Game Dev 앱 & CLI · AI Game Developer Wiki

AI Game Dev 앱과 CLI에서 AI 모델, 추론 강도, 에이전트를 선택하고, 도구 승인을 제어하며, 내 GPU에서 로컬 AI 모델을 사용하세요.

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

AI Game Dev 앱에서는 어떤 AI 모델이 답할지, 얼마나 깊이 생각할지, 어떤 에이전트 페르소나가 작업을 맡을지, 그리고 어떤 도구를 사용할 수 있는지 선택할 수 있습니다. 이 페이지에서는 모델 선택기, 공급자와 가용성, 에이전트와 스킬, 승인, 플랜 모드, 음성 입력, 그리고 내 컴퓨터에서 실행되는 로컬 모델을 설명합니다.

## 모델과 공급자

이 앱은 여러 공급자의 호스팅 채팅 모델을 제공합니다: Anthropic의 Claude 제품군, OpenAI의 GPT 제품군, DeepSeek, Google의 Gemini. 정확한 목록은 앱에 내장되어 있지 않고 ai-game.dev에서 계정에 맞춰 전달되므로 항상 플랜과 지역에 부합합니다. 새 계정은 서버가 지정한 기본 모델로 시작합니다.

모델 사용 가능 여부를 결정하는 요소:

- **플랜.** 일부 모델은 Studio 이상처럼 특정 플랜이 필요합니다. [가격 페이지](https://ai-game.dev/pricing)를 참고하세요.
- **지역.** 가용성은 청구지 주소의 국가에 따라 달라집니다. [모델 가용성 페이지](https://ai-game.dev/model-availability)를 참고하세요.
- **나이.** 일부 모델은 계정에서 만 18세 이상임을 확인해야 합니다.

사용할 수 없는 모델도 목록에 표시되며, 이름 아래에 그 이유가 나옵니다.

## 데스크톱 앱에서 모델 선택하기

1. 채팅을 엽니다. 작성창의 컨트롤 행에 있는 모델 배지가 현재 모델을 보여줍니다.
2. 배지를 클릭하면 모델 목록이 열립니다.
3. 모델을 선택합니다. 사용할 수 없는 모델은 업그레이드 안내나 "해당 지역에서 사용할 수 없음" 같은 이유를 표시합니다. 목록 하단에는 가용성 판단 기준 지역이 표시됩니다.

이를 지원하는 모델에는 **추론 강도** 설정도 있습니다. 어려운 설계와 디버깅 작업에는 높은 강도가 좋고, 일상적인 편집에는 낮은 강도가 더 빠릅니다.

각 창은 자체 모델, 추론 강도, 에이전트를 유지합니다. 실용적인 구성은 한 창에서는 큰 모델이 기능을 계획하고 구현하고, 두 번째 창에서는 더 빠른 모델로 빠른 질문에 답하는 것입니다. [워크스페이스](https://ai-game.dev/ko/docs/wiki/app/workspace#panes)를 참고하세요.

## CLI에서 모델 선택하기

`/model`을 입력하면 모델 선택기가 열립니다. 화살표 키와 Enter로 선택하고, Tab으로 추론 강도를 변경합니다. 시작할 때 모델을 지정할 수도 있습니다:

```bash
gamedev --model <model-id>
```

지정한 모델을 계정에서 사용할 수 없으면 CLI가 이를 알리고 `--model`이나 `/model`로 다른 모델을 선택하라고 안내합니다.

**팁**

더 저렴하고 빠른 모델은 같은 작업에 월간 허용량의 더 적은 비율을 사용합니다. 가장 큰 모델은 그것이 필요한 작업에 남겨 두세요.

## 에이전트와 스킬

모델 외에도 세션에는 **에이전트**가 있습니다. 한 종류의 작업을 위한 전문가처럼 자체 지침을 가진 역할입니다. 목록에는 Claude agent SDK의 내장 에이전트와 프로젝트의 Claude 구성에 정의된 에이전트, 또는 Claude 플러그인이 추가한 에이전트가 포함됩니다.

CLI에서:

```text
/agent                    list the agents and show the active one
/agent use <agent-id>     switch this session to an agent
/agent refresh            ask for the agent list again
/skills                   list the skills available in this project
```

데스크톱 앱에서는 각 창이 자체 모델처럼 자체 에이전트를 유지합니다.

스킬, 명령어, 에이전트는 Claude 플러그인(**Settings**, **Claude Plugins**, 또는 CLI의 `/plugin`)과 패키지로 추가할 수 있습니다. [패키지](https://ai-game.dev/ko/docs/wiki/app/packages)를 참고하세요.

## 세션 도구

각 세션은 어떤 도구를 사용할지 선택합니다. 작성창 위의 **도구 행**은 설치된 패키지(Blender, Music, Knowledge Base, Image Gen, Video, Tripo, Cloud generation)의 도구를 나열하고, 이번 세션에만 각 도구를 켜거나 끕니다. CLI에서는 `/config`를 열고 **Tools** 섹션을 사용하세요.

모든 도구는 에이전트의 컨텍스트 일부를 차지하므로, 작업에 필요한 도구만 있는 세션이 더 빠르고 잘못된 도구를 선택할 가능성도 낮습니다. 변경은 채팅을 다시 시작하지 않고 다음 메시지부터 적용됩니다.

## 승인과 권한

승인 정책에 따라 에이전트가 도구를 실행하기 전에 묻습니다. 세 가지 모드가 있습니다:

| 모드 | 에이전트가 묻는 시점 |
| --- | --- |
| 매번 묻기 | AI가 실행하는 모든 도구 전에, 프로젝트 내부에서도 묻습니다. 가장 안전하지만 중단이 가장 많습니다 |
| 프로젝트 외부에서만 묻기 (기본값) | 프로젝트 폴더 밖에 접근하거나 프로젝트 자체의 권한 설정을 변경하려 할 때 묻습니다. 프로젝트 내부에서는 묻지 않고 읽고 쓰고 명령을 실행합니다 |
| 절대 묻지 않음 | 절대 묻지 않습니다. AI가 내 컴퓨터 어디에서나 읽고 쓰고 명령을 실행할 수 있습니다 |

**경고**

기본 모드에서는 프로젝트 내부에서 셸 명령이 묻지 않고 실행되므로 AI가 내 컴퓨터에서 코드를 실행할 수 있습니다. "절대 묻지 않음"은 이를 컴퓨터 전체로 확장합니다. 작업을 신뢰할 때만 사용하세요.

프로젝트 외부의 추가 폴더를 신뢰할 수도 있습니다. 그러한 경로에 대한 승인 프롬프트는 해당 폴더를 항상 허용하는 옵션을 제공합니다. 모드는 **Settings**, **Permissions**, 또는 CLI에서 변경하세요:

```text
/permissions                     show the mode and trusted folders
/permissions always              ask every time
/permissions outside-project     ask only outside the project
/permissions never               never ask
/permissions trust <folder>      trust a folder and everything in it
/permissions untrust <folder>    stop trusting a folder
/permissions timeout on          auto-deny a request left unanswered for 5 minutes
```

변경은 다음 턴부터 적용됩니다.

## 플랜 모드와 질문

플랜 모드는 작성창의 세션별 스위치입니다. 켜면 에이전트는 파일을 읽고 프로젝트를 검색하지만, 계획을 제시하고 승인을 받을 때까지 모든 변경이 거부됩니다. 에이전트가 명확화 질문을 할 수도 있고, 작업 중에 후속 메시지를 대기열에 넣을 수 있습니다. [플랜 모드](https://ai-game.dev/ko/blog/plan-mode-ai-agent-game-development) 게시물에서 전체 기능을 살펴볼 수 있습니다.

## 음성 입력

푸시 투 토크는 두 프런트엔드 모두에서 작동합니다. 채팅 입력창에서 Space를 누르고 있거나(데스크톱 앱에서는 마이크 버튼 사용) 말하고 나서 놓으면 됩니다. 음성은 로컬 Whisper 모델로 내 컴퓨터에서 전사되며, 따로 설치할 것은 없습니다. 언어는 **Settings**, **Voice**, 또는 CLI의 `/voice-language`에서 설정하세요.

## 내 GPU에서 실행하는 로컬 모델

채팅 모델은 호스팅되지만, 미디어 모델은 허용량을 쓰지 않고 무료로 내 컴퓨터에서 실행할 수 있습니다:

- **로컬 이미지 생성**: FLUX, SDXL 기반 모델, Qwen-Image, Qwen-Image-Edit, Z-Image Turbo 등이며 stable-diffusion.cpp로 실행됩니다. 세션의 도구 행에서 **Image Gen**을 켜세요.
- **로컬 비디오 생성**: LTX-2.5와 Wan 2.2 TI2V 5B. **Video**를 켜세요.

모델은 승인한 후에만 다운로드되는 패키지입니다. 앱이 GPU, 비디오 메모리, 드라이버를 확인하고 내 컴퓨터에서 실행할 수 있는 모델을 추천합니다. Packages 창의 **Models** 탭에서 관리하거나 CLI에서 `/images`와 `/models`를 사용하세요. 하드웨어 요구 사항이 포함된 전체 목록은 [패키지 카탈로그](https://ai-game.dev/ko/docs/wiki/app/packages-catalog#local-image-models)에 있습니다.

클라우드 미디어 모델(비디오, 음성, 음향 효과, 음악)은 대신 AI Game Dev 서버에서 실행되며 허용량을 사용합니다. [클라우드 생성](https://ai-game.dev/ko/docs/wiki/app/packages-catalog#cloud-generation)을 참고하세요.

## 더 알아보기

- 엔진별 요청 작성법에 대한 [모범 사례](https://ai-game.dev/docs/best-practices).
- [게임용 로컬 AI 이미지 생성](https://ai-game.dev/ko/blog/local-ai-image-generation-for-games)과 [로컬 AI 비디오 생성](https://ai-game.dev/ko/blog/local-ai-video-generation-on-your-gpu).
- 에이전트에 도구를 추가하는 [패키지](https://ai-game.dev/ko/docs/wiki/app/packages).

---

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

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