에이전트와 모델

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

모델과 공급자#

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

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

• 플랜. 일부 모델은 Studio 이상처럼 특정 플랜이 필요합니다. 가격 페이지를 참고하세요.
• 지역. 가용성은 청구지 주소의 국가에 따라 달라집니다. 모델 가용성 페이지를 참고하세요.
• 나이. 일부 모델은 계정에서 만 18세 이상임을 확인해야 합니다.

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

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

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

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

각 창은 자체 모델, 추론 강도, 에이전트를 유지합니다. 실용적인 구성은 한 창에서는 큰 모델이 기능을 계획하고 구현하고, 두 번째 창에서는 더 빠른 모델로 빠른 질문에 답하는 것입니다. 워크스페이스를 참고하세요.

CLI에서 모델 선택하기#

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

gamedev --model <model-id>

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

에이전트와 스킬#

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

CLI에서:

/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)과 패키지로 추가할 수 있습니다. 패키지를 참고하세요.

세션 도구#

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

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

승인과 권한#

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

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

/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

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

플랜 모드와 질문#

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

음성 입력#

푸시 투 토크는 두 프런트엔드 모두에서 작동합니다. 채팅 입력창에서 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를 사용하세요. 하드웨어 요구 사항이 포함된 전체 목록은 패키지 카탈로그에 있습니다.

클라우드 미디어 모델(비디오, 음성, 음향 효과, 음악)은 대신 AI Game Dev 서버에서 실행되며 허용량을 사용합니다. 클라우드 생성을 참고하세요.

더 알아보기#

• 엔진별 요청 작성법에 대한 모범 사례.
• 게임용 로컬 AI 이미지 생성과 로컬 AI 비디오 생성.
• 에이전트에 도구를 추가하는 패키지.