AI 어시스턴트 전환

개요

AIRGAP Studio 에는 두 종류의 AI 코딩 어시스턴트가 함께 설치되며, 항상 하나만 활성 상태 입니다. 작업 성격에 따라 둘 사이를 전환할 수 있습니다.

두 어시스턴트 비교

항목	AIRGAP Assistant	AIRGAP Lite Assistant
기반	Cline 3.56.2 fork	Continue 1.3.39 fork
동작 방식	자율 에이전트 (Plan/Act)	인라인 자동완성 + 채팅
강점	멀티파일 리팩토링, Checkpoint, Browser, 터미널 자동 실행	빠른 자동완성, Quick Edit, RAG 검색
기본 활성	—	✓ (기본값)
권장 사용처	자율 작업·복잡한 변경	일상적인 코딩 보조

두 어시스턴트는 동시에 동작하지 않습니다. 한쪽이 활성화되면 다른 쪽은 자동으로 비활성화됩니다.

전환 절차

방법 1: 명령 팔레트

Ctrl+Shift+P 로 명령 팔레트 열기
AIRGAP: Switch Assistant 실행
QuickPick 에서 활성화할 어시스턴트 선택
VSCodium 이 자동으로 재기동되며 새 어시스턴트가 활성화됨

방법 2: Launcher UI

AIRGAP Studio Launcher 창 열기
"Switch Assistant (restart required)" 섹션의 라디오 버튼으로 선택
Launcher 가 VSCodium 을 재기동

VSCodium 재기동 필수

중요 — 어시스턴트 전환은 VSCodium 재기동이 반드시 필요합니다.

확장 비활성화는 --disable-extension <publisher.name> CLI 플래그로 전달되는데, 이 플래그는 VSCodium spawn 시점에만 적용 됩니다. Developer: Reload Window 같은 윈도우 재로딩으로는 적용되지 않습니다.

내부 흐름:

어시스턴트 전환 명령이 IPC signal 파일을 atomic write
C# Launcher 가 변경 감지 → 현재 VSCodium child 프로세스를 Job Object 로 종료
새 --disable-extension 플래그로 VSCodium 을 다시 spawn
새 어시스턴트만 활성화된 상태로 윈도우가 열림

전환 확인

전환이 정상 적용됐는지 다음으로 확인할 수 있습니다.

Activity Bar 아이콘 — 활성 어시스턴트에 해당하는 아이콘만 표시됨
launcher.log — 새 spawn 라인에 --disable-extension <비활성 대상> 인자가 명시
새 user-data/logs/ 디렉토리 — VSCodium 이 새 timestamp prefix 로 디렉토리 생성

활성 어시스턴트 파일 위치

활성 어시스턴트는 다음 파일에 저장됩니다.

프로덕션: %ProgramData%\AirgapStudio\active-assistant.json
개발 환경: build\vscodium\data\active-assistant.json

파일 스키마:

{
  "assistantId": "airgap-lite-assistant"
}

assistantId 값:

"airgap-lite-assistant" — AIRGAP Lite Assistant 활성 (기본값)
"airgap-assistant" — AIRGAP Assistant 활성

이 파일을 수동으로 편집하지 마세요. 일관성이 깨지면 다음 기동 시 어시스턴트가 정상 활성화되지 않을 수 있습니다. 반드시 AIRGAP: Switch Assistant 명령 또는 Launcher UI 를 사용하세요.

개요