시작하기

AIRGAP Studio는 인터넷 연결 없이도 AI 코딩 기능을 제공하는 오프라인 AI IDE입니다. 본 가이드는 처음 설치하는 사용자를 위한 단계별 안내입니다.

1단계: 인스톨러 다운로드

다운로드 페이지 에서 다음 중 하나를 선택합니다:

Standard 통합팩 (권장, ~4.9 GB) — IDE + AI 엔진(llama-server) + 확장 + Qwen3 8B 모델 포함. 즉시 사용 가능.
IDE Only — IDE + 확장만 포함. 모델은 별도 Modelpack 인스톨러로 추가.
Modelpack — 추가 AI 모델 (.gguf 파일) 단독 패키지.

AI 모델 파일이 5 GB 가까이 되므로 Standard 통합팩 을 권장합니다.

다운받은 AIRGAPStudio-Standard-*.exe 를 더블 클릭하여 실행. 관리자 권한 불필요. 설치 위치 기본값은 %LOCALAPPDATA%\AIRGAP\Studio\ 입니다.

모델 파일은 자동으로 build/vscodium/models/ (설치 디렉토리 안) 에 배치되며, 첫 실행 시 AIRGAP Studio가 자동 탐지합니다.

바탕 화면의 AIRGAP Studio 아이콘을 더블 클릭하거나 시작 메뉴에서 실행합니다.

기동 순서 (자동):

첫 기동 시 모델 로딩에 1-2분 소요될 수 있습니다.

VSCodium 의 Activity Bar (좌측 세로 아이콘 줄)에서 AIRGAP 아이콘을 클릭. 사이드 패널에 채팅창이 열립니다.

단축키 (Continue fork 기반): Ctrl+L (Quick Edit), Ctrl+I (Inline Edit), Ctrl+Alt+Space (Autocomplete)
채팅창에 한국어/영어 질문 입력 → 로컬 Qwen3 8B 가 응답

Command Palette (Ctrl+Shift+P) → AIRGAP: Select LLM Model 실행. 지원 모델 6종 중 선택:

선택 후 llama-server 가 자동 재시작되며 모든 확장의 모델 표시가 갱신됩니다. (Monitor 단독 책임 — 자세한 내용은 Monitor 문서)

자율 에이전트와 멀티 파일 리팩토링이 필요하면:

Command Palette → AIRGAP: Switch Assistant → VSCodium 재기동 → AIRGAP Assistant (Cline 3.56.2 fork) 활성.

두 어시스턴트는 동시에 활성되지 않습니다 (상호 배타). 자세한 내용은 어시스턴트 전환 문서

OS: Windows 10 64-bit (1903+) 또는 Windows 11
RAM: 최소 16 GB (32 GB 권장)
그래픽카드: Vulkan 지원 GPU 권장 (NVIDIA / AMD / Intel Arc), 권장 6 GB+ VRAM. 4 GB 미만은 자동 CPU 폴백 (응답 속도 느림).
디스크: 10 GB 이상 (20 GB SSD 권장)

자세한 사양은 시스템 요구사항 문서를 참고하세요.