AIRGAP StudioAIRGAP Studio

지원

자주 묻는 질문과 기술 지원 안내

자주 묻는 질문 (FAQ)

Airgap Studio에 대해 자주 묻는 질문들을 모았습니다.

네트워크 격리(에어갭) 환경을 위해 설계되었습니다. 인터넷 연결 없이 완전히 오프라인으로 동작하며, 금융기관, 공공기관, 연구소 등 보안이 중요한 환경에서 사용할 수 있습니다. Windows 10/11 (64-bit)을 지원합니다.

Airgap Studio는 VSCodium 기반으로, VS Code와 동일한 인터페이스를 제공합니다. 여기에 6개의 전용 확장(Designer, Bridge, Library, Assistant, Autocomplete, License)이 사전 설치되어 있고, Ollama 기반 로컬 AI가 통합되어 있습니다. 모든 AI 기능이 오프라인으로 동작하는 점이 가장 큰 차이입니다.

네, 핵심 기능 전체가 오프라인으로 동작합니다. AI 코딩 어시스턴트(Assistant), UI 디자이너(Designer), 코드 자동완성(Autocomplete)은 로컬 Ollama LLM을 사용하고, UI Library는 LLM 없이 정적으로 동작합니다. Bridge의 Figma MCP 연동은 Figma Desktop이 로컬에 설치되어 있어야 합니다. 라이선스 검증도 완전 오프라인(ED25519 서명 기반)입니다.

Windows 10/11 (64-bit), NVIDIA GPU 12GB VRAM 이상 (RTX 3060~), RAM 32GB, 디스크 공간 15GB 이상이 필요합니다. CUDA 12+ 드라이버가 설치되어 있어야 합니다. 자세한 내용은 다운로드 페이지의 시스템 요구사항을 참고하세요.

아니요. Inno Setup 기반 인스톨러는 관리자 권한 없이 사용자 디렉토리에 설치할 수 있습니다. 파견 현장의 보안 정책 안에서 유연하게 도입할 수 있습니다.

앱 설치와 모델 설치를 합쳐 약 2분 정도 소요됩니다.

기본 제공 모델은 Qwen3:8b이며, Ollama를 통해 로컬에서 실행됩니다. NVIDIA GPU VRAM 8GB 이상이면 원활하게 사용할 수 있습니다. 설정에서 Anthropic, OpenAI, Google Gemini 등 외부 프로바이더로 전환할 수 있어, 네트워크가 허용되는 환경에서는 다른 모델도 사용 가능합니다.

Ollama가 지원하는 다른 모델로 변경할 수 있습니다. 단, Qwen3:8b은 8B 급 모델 중 Tool Calling 성능(F1 0.933)이 가장 높아 Airgap Studio와 최적으로 연동되도록 튜닝되어 있습니다. 모델 변경 시 VRAM 요구사항과 성능이 달라질 수 있습니다.

네, Ollama를 별도 서버에 배포하고, 각 클라이언트 PC의 Airgap Studio에서 서버 URL을 설정하여 사용할 수 있습니다. 이 방식으로 GPU가 없는 클라이언트에서도 AI 기능을 활용할 수 있습니다.

AIRGAP License 확장이 오프라인 라이선스 검증을 담당합니다. ED25519 디지털 서명 기반으로, 인터넷 연결 없이 유효성을 검증합니다. 하드웨어 핑거프린트(MachineGuid, BIOS, Disk 시리얼)를 사용하여 머신에 바인딩되며, 시간 조작 방지(Clock Guard) 기능도 포함되어 있습니다. 라이선스 키는 관리자 도구(Admin)에서 발급합니다.

라이선스 키는 하드웨어에 바인딩되므로 직접 이전은 불가능합니다. 관리자에게 재발급을 요청하면 새 장비용 키를 발급받을 수 있습니다. 이전 키는 만료일까지 유효하다가 자연 만료됩니다.

Bridge의 Prototype 탭에서 Figma MCP(localhost:3845)를 통해 실시간으로 Figma Desktop의 디자인 데이터를 참조합니다. Production 탭에서는 VibeFigma CLI를 통해 ~95% 충실도로 코드를 변환합니다. Figma Desktop이 로컬에 설치되어 있어야 합니다.

Bridge의 Style Guide 탭에 한국 정부 표준 디자인 시스템(KRDS) 프리셋이 내장되어 있습니다. 표준형과 확장형 두 가지 프리셋을 제공하며, 정부 웹사이트 개편 시 KRDS 디자인 토큰을 자동으로 적용할 수 있습니다.

VSCodium 1.95.3 기반으로, VS Code API와 호환되는 확장을 사용할 수 있습니다. 오프라인 환경이므로 마켓플레이스에서 직접 설치는 불가능하며, VSIX 파일을 통해 수동으로 설치해야 합니다.

오프라인 환경 특성상 자동 업데이트는 지원되지 않습니다. 프로페셔널 이상 플랜에서는 분기별로 업데이트 인스톨러를 제공하며, USB 등을 통해 폐쇄망 내부로 전달합니다. Inno Setup 인스톨러가 기존 확장 디렉토리를 자동으로 정리하여 깔끔한 업그레이드를 보장합니다.

버그 리포트 가이드

문제가 발생했을 때 효율적인 지원을 위해 아래 절차를 따라 주세요.

1

문제 재현 확인

버그가 일관되게 재현되는지 확인하세요. 재현 가능한 경우 정확한 단계를 기록해 주세요.

2

환경 정보 수집

Airgap Studio 버전, Windows 버전, GPU 모델, VRAM 용량, Ollama 버전을 확인하세요.

3

로그 수집

Airgap Studio에서 Ctrl+Shift+I로 개발자 도구를 열고, Console 탭에서 오류 메시지를 복사하세요.

4

문의 제출

위 정보와 함께 문의 페이지에서 '기술 지원' 유형으로 문의를 보내주세요.

버그 리포트에 포함해야 할 정보

  • 문제가 발생한 확장 이름 (예: Airgap Designer)
  • 정확한 재현 단계
  • 예상 동작 vs 실제 동작
  • Console 로그 또는 스크린샷
  • Airgap Studio 버전, OS, GPU 정보

추가 지원이 필요하신가요?

FAQ에서 답변을 찾지 못하셨다면 직접 문의해 주세요.

문의하기