팁 & 트릭 | Airgap Studio

AI 어시스턴트 활용

명확한 지시를 내리세요

AI 어시스턴트에게 요청할 때는 구체적으로 작성하면 더 정확한 결과를 얻을 수 있습니다.

# 비효율적인 요청
"이 코드 고쳐줘"

# 효과적인 요청
"handleSubmit 함수에서 null 체크를 추가하고, 에러 발생 시 사용자에게 토스트 알림을 보여줘"

컨텍스트를 제공하세요

파일을 열어두거나 코드를 선택한 상태에서 요청하면 AI가 더 정확한 맥락을 파악합니다. 관련 파일이 여러 개라면 @파일명으로 참조할 수 있습니다.

자동 컴팩트(Auto Compact) 활용

대화가 길어지면 컨텍스트 창이 부족해질 수 있습니다. AIRGAP Assistant는 Auto Compact가 기본으로 활성화되어 있어 자동으로 대화를 요약합니다.

디자인 워크플로우

Bridge에서 Designer로 연동

AIRGAP Bridge에서 디자인 토큰을 생성합니다.
토큰이 자동으로 AIRGAP Designer의 시스템 프롬프트에 주입됩니다.
Designer에서 UI를 생성할 때 디자인 토큰이 적용된 일관된 결과물을 얻을 수 있습니다.

UI Library 컴포넌트 활용

UI Library에서 원하는 컴포넌트를 검색하고, 코드 복사 또는 편집기에 삽입 기능을 활용하세요.

성능 최적화

GPU 가속

NVIDIA·AMD·Intel GPU가 있다면 로컬 AI 엔진(llama-server, Vulkan 백엔드)이 자동으로 GPU를 사용합니다. GPU 사용 여부는 Launcher UI의 상태 패널 또는 http://127.0.0.1:11434/health 헬스체크 엔드포인트, 명령 팔레트의 AIRGAP: Refresh Status 명령으로 확인할 수 있습니다.

컨텍스트 크기 조정

복잡한 작업에서 AI 응답이 불완전하다면 컨텍스트 크기를 확인하세요. 컨텍스트 크기는 모델별로 다르게 설정됩니다. 예를 들어 Qwen3 8B의 경우 GPU 모드에서 약 40,960 토큰, CPU 모드에서 약 16,384 토큰이 권장값으로 적용되며, 설정에서 조정할 수 있습니다.

불필요한 익스텐션 비활성화

사용하지 않는 익스텐션은 비활성화하면 IDE 시작 속도가 빨라집니다. 명령 팔레트(Ctrl+Shift+P)에서 Extensions: Show Installed Extensions를 선택하세요.

레이아웃 설정

듀얼 모니터 추천 레이아웃

모니터	배치
메인 모니터	코드 편집기 + 터미널
보조 모니터	AIRGAP Assistant (사이드바) + 브라우저 미리보기

싱글 모니터 추천 레이아웃

편집기를 좌측에, AIRGAP Assistant를 우측 사이드바에 배치합니다.
Ctrl+B로 파일 탐색기를 토글하여 화면 공간을 확보하세요.
Ctrl+J로 하단 패널(터미널)을 필요할 때만 표시합니다.

모델 변경

기본 Qwen3 8B 외에 다른 모델을 사용하려면 프로바이더 설정을 참고하세요. AIRGAP Assistant(Cline fork)는 openai/openai-native/openai-codex/lmstudio 4종 provider 를 지원하며, AIRGAP Lite Assistant(Continue fork)는 기본적으로 llama-server 단독으로 동작합니다. 외부 foundation provider(Anthropic, OpenAI, Google Gemini)는 네트워크가 허용되는 환경에서 별도 opt-in 설정으로 활성화할 수 있습니다.