지원
자주 묻는 질문과 기술 지원 안내
자주 묻는 질문 (FAQ)
Airgap Studio에 대해 자주 묻는 질문들을 모았습니다.
네트워크 격리(에어갭) 환경을 위해 설계되었습니다. 인터넷 연결 없이 완전히 오프라인으로 동작하며, 금융기관, 공공기관, 연구소 등 보안이 중요한 환경에서 사용할 수 있습니다. Windows 10/11 (64-bit)을 지원합니다.
Airgap Studio는 VSCodium 기반의 동일한 인터페이스에 사용자 페이싱 7개 확장(Assistant, Lite Assistant, Designer, Bridge, UI Library, Autocomplete, Monitor)과 인프라 확장이 사전 설치되어 있고, 로컬 AI 엔진(llama-server)이 내장되어 있습니다. 모든 AI 기능이 오프라인으로 동작하는 점이 가장 큰 차이입니다.
네, 핵심 기능 전체가 오프라인으로 동작합니다. AI 코딩 어시스턴트(Assistant), UI 디자이너(Designer), 코드 자동완성(Autocomplete)은 로컬 AI 엔진을 사용하고, UI Library는 AI 없이 정적으로 동작합니다. Bridge의 Figma MCP 연동은 Figma Desktop이 로컬에 설치되어 있어야 합니다. 라이선스 검증도 완전 오프라인(ED25519 서명 기반)입니다.
Windows 10/11 (64-bit), RAM 16GB 이상(32GB 권장), 디스크 공간 10GB 이상이 필요합니다. GPU는 선택 사항이며, Vulkan을 지원하는 GPU(최소 4GB VRAM, 권장 6GB+)가 있으면 AI 응답 속도가 2~5배 빨라집니다. VRAM이 부족하거나 GPU가 없는 경우 CPU 모드로 자동 폴백됩니다. 자세한 내용은 다운로드 페이지의 시스템 요구사항을 참고하세요.
아니요. 관리자 권한 없이 사용자 디렉토리에 설치할 수 있습니다. 파견 현장의 보안 정책 안에서 유연하게 도입할 수 있습니다.
앱 설치와 모델 설치를 합쳐 약 2분 정도 소요됩니다.
기본 제공 모델은 Qwen3 8B (Q4_K_M)이며, 로컬 AI 엔진(llama-server)을 통해 실행됩니다. 총 6종의 모델을 지원합니다. Vulkan 지원 GPU(NVIDIA/AMD) VRAM 최소 4GB(권장 6GB+)면 원활하게 사용할 수 있으며, VRAM이 부족하거나 GPU가 없어도 CPU 모드로 자동 폴백됩니다. Assistant(Cline fork)는 OpenAI 호환 4종 프로바이더를 지원하고, Lite Assistant(Continue fork)는 로컬 llama-server 단독 사용을 기본으로 하되 foundation provider(OpenAI, Anthropic, Gemini)는 옵트인으로 켤 수 있습니다.
네, 다른 모델로 변경할 수 있습니다. 기본 제공되는 Qwen3 8B는 8B 급 모델 중 도구 호출 성능이 가장 높아 Airgap Studio와 최적으로 연동되도록 튜닝되어 있습니다. 총 6종의 모델 중에서 선택할 수 있으며, 모델 변경 시 VRAM 요구사항과 성능이 달라질 수 있습니다.
네, AI 엔진을 별도 서버에 배포하고, 각 클라이언트 PC에서 서버 URL을 설정하여 사용할 수 있습니다. 고객이 원하는 오픈소스 모델을 자유롭게 탑재할 수 있으며, GPU가 없는 클라이언트에서도 AI 기능을 활용할 수 있습니다. 서버 하드웨어 납품이 필요한 경우 턴키 솔루션을 통해 도입할 수 있습니다.
AIRGAP License 확장이 오프라인 라이선스 검증을 담당합니다. ED25519 디지털 서명 기반으로, 인터넷 연결 없이 유효성을 검증합니다. 하드웨어 핑거프린트(MachineGuid, BIOS, Disk 시리얼)를 사용하여 머신에 바인딩되며, 시간 조작 방지(Clock Guard) 기능도 포함되어 있습니다. 라이선스 키는 관리자 도구(Admin)에서 발급합니다.
라이선스 키는 하드웨어에 바인딩되므로 직접 이전은 불가능합니다. 관리자에게 재발급을 요청하면 새 장비용 키를 발급받을 수 있습니다. 이전 키는 만료일까지 유효하다가 자연 만료됩니다.
구매 또는 체험판 발급 시 입력하신 이메일로 라이선스 키가 발송됩니다. 이메일을 확인해 주세요. 이메일을 찾을 수 없는 경우, 구매 시 사용한 이메일 주소를 axc@frameout.co.kr로 보내주시면 확인 후 재발급해 드립니다.
아니요. 각 라이선스 키는 1대의 디바이스에서만 사용 가능합니다. 추가 디바이스가 필요하시면 추가 라이선스를 구매해 주세요.
디바이스 변경 시 재발급이 필요합니다. axc@frameout.co.kr로 문의해 주시면 새 키를 발급해 드립니다.
Bridge의 Prototype 탭에서 Figma MCP(localhost:3845)를 통해 실시간으로 Figma Desktop의 디자인 데이터를 참조합니다. Production 탭에서는 코드 변환 엔진을 통해 ~95% 충실도로 변환합니다. Figma Desktop이 로컬에 설치되어 있어야 합니다.
Bridge의 Style Guide 탭에 한국 정부 표준 디자인 시스템(KRDS) 프리셋이 내장되어 있습니다. 표준형과 확장형 두 가지 프리셋을 제공하며, 정부 웹사이트 개편 시 KRDS 디자인 토큰을 자동으로 적용할 수 있습니다.
네, VSCodium은 VS Code API와 호환되므로 동일한 확장 API를 사용하는 확장을 쓸 수 있습니다. 오프라인 환경이므로 마켓플레이스에서 직접 설치는 불가능하며, VSIX 파일을 통해 수동으로 설치할 수 있습니다.
오프라인 환경 특성상 자동 업데이트는 지원되지 않습니다. 유료 라이선스 기간 내에 분기별로 업데이트 인스톨러를 제공하며, USB 등을 통해 폐쇄망 내부로 전달합니다. 인스톨러가 기존 환경을 자동으로 정리하여 깔끔한 업그레이드를 보장합니다.
두 어시스턴트는 상호 배타적으로 동작합니다. AIRGAP Lite Assistant(Continue 기반)는 인라인 자동완성과 RAG 채팅 중심으로, 신규 설치 시 기본 활성화됩니다. AIRGAP Assistant(Cline 기반)는 자율 에이전트 기반의 멀티 파일 리팩토링, Checkpoint, Browser 사용에 특화되어 있습니다. Command Palette에서 `AIRGAP: Switch Assistant` 명령으로 전환할 수 있으며, 전환 시 VSCodium 재기동이 필요합니다.
Command Palette(Ctrl+Shift+P)에서 `AIRGAP: Select LLM Model` 명령을 실행하세요. AIRGAP Monitor가 6종 모델 목록을 QuickPick으로 표시하며, 선택 시 llama-server가 자동으로 새 모델로 재시작됩니다. 어시스턴트 내부에서 직접 모델을 변경할 수는 없으며, 모델 선택은 Monitor 확장이 단독으로 책임집니다.
AIRGAP Studio Launcher의 GpuFallback 메커니즘이 VRAM 4096MB 미만을 자동 감지하여 CPU 모드로 폴백합니다. AI 응답 속도는 느려질 수 있으나 정상적으로 동작합니다. 더 빠른 응답을 원하신다면 Qwen3 1.7B 또는 Granite 4.0 Micro 같은 경량 모델을 권장합니다.
기본값인 Qwen3 8B를 권장합니다(8B급 모델 중 도구 호출 성능 우수). VRAM이 부족한 경우 Qwen3 4B → Qwen3 1.7B → Granite 4.0 Micro 순으로 가벼운 모델을 선택하세요. 영어 위주 작업이라면 Mistral 7B Instruct 또는 Meta Llama 3.1 8B도 좋은 선택입니다.
현재 활성화된 모델, llama-server 상태(running/error), 메모리 및 응답 속도 지표, 모델 변경 이력을 표시합니다. Activity Bar의 Monitor 아이콘을 클릭하여 접근할 수 있습니다.
AIRGAP Bridge의 Figma MCP 연동(localhost:3845)에는 Figma Desktop이 필요합니다. 다만 Bridge의 결정론적 코드 변환, KRDS 프리셋, Style Guide 생성 기능은 Figma Desktop 없이도 사용할 수 있습니다.
네. Mistral 7B Instruct v0.3와 Meta Llama 3.1 8B Instruct가 모두 지원 모델(compatible 등급)에 포함됩니다. `AIRGAP: Select LLM Model` 명령으로 전환할 수 있습니다.
모델·클라이언트별 chat format 차이를 정규화하는 게이트웨이입니다(port 11433). 어시스턴트가 모델에 메시지를 보낼 때 자동으로 경유하며, 사용자가 직접 설정할 필요가 없습니다 — Launcher가 자동으로 엔드포인트를 패치합니다.
VSCodium은 VS Code의 오픈소스 빌드로, Microsoft 텔레메트리와 로고가 제거되어 있습니다. AIRGAP Studio는 VSCodium 기반의 커스텀 빌드입니다. 기능적으로 VS Code와 거의 동일하나, 마켓플레이스가 일부 다릅니다.
네. VSIX 파일은 Command Palette의 `Extensions: Install from VSIX...` 명령으로 수동 설치가 가능합니다. 다만 에어갭 환경의 보안 정책상 외부 마켓플레이스에서의 자동 다운로드는 차단됩니다.
버그 리포트 가이드
문제가 발생했을 때 효율적인 지원을 위해 아래 절차를 따라 주세요.
1
문제 재현 확인
버그가 일관되게 재현되는지 확인하세요. 재현 가능한 경우 정확한 단계를 기록해 주세요.
2
환경 정보 수집
Airgap Studio 버전, Windows 버전, GPU 모델, VRAM 용량, llama-server 버전(인스톨러에 포함)을 확인하세요.
3
로그 수집
Airgap Studio에서 Ctrl+Shift+I로 개발자 도구를 열고, Console 탭에서 오류 메시지를 복사하세요.
4
문의 제출
위 정보와 함께 문의 페이지에서 '기술 지원' 유형으로 문의를 보내주세요.
버그 리포트에 포함해야 할 정보
- 문제가 발생한 확장 이름 (예: Airgap Designer)
- 정확한 재현 단계
- 예상 동작 vs 실제 동작
- Console 로그 또는 스크린샷
- Airgap Studio 버전, OS, GPU 정보