프로바이더 설정
AI 프로바이더 설정 및 모델 구성 가이드
AIRGAP Assistant (Cline fork) Provider 설정
AIRGAP Assistant 는 OpenAI 호환 API 표준을 따르는 4종 Provider 를 지원합니다.
기본 설정 — llama-server (자동)
설치 직후 AIRGAP Assistant 는 다음 endpoint 를 자동으로 사용합니다:
| 항목 | 값 |
|---|---|
| Provider | openai-compatible |
| Base URL | http://127.0.0.1:11433/v1 (Compatibility Proxy 경유) |
| 모델 | 현재 활성 모델 (AIRGAP Monitor 가 결정) |
| API Key | 불필요 (로컬) |
dev-launcher 또는 인스톨러가 자동으로 Base URL 을
11433(Proxy) 으로 패치합니다. 직접11434(llama-server) 를 가리키지 마세요 — 자동 패치와 충돌합니다.
지원 Provider 종류
| Provider 이름 | 용도 | API Key |
|---|---|---|
openai | 일반 OpenAI 호환 endpoint (LM Studio, vLLM, 사내 OpenAI gateway 등) | 필요 (endpoint에 따라) |
openai-native | OpenAI 직접 (api.openai.com) | 필요 |
openai-codex | Codex CLI 호환 | 필요 |
lmstudio | LM Studio 호환 | 불필요 |
Anthropic Claude / Google Gemini 는 AIRGAP Assistant 의 직접 Provider 가 아닙니다. 외부 SaaS Provider 가 필요한 경우 AIRGAP Lite Assistant 의 foundation provider opt-in 을 사용하세요.
Provider 변경 절차
- AIRGAP Assistant 사이드 패널 → 설정 (톱니바퀴 아이콘)
- Provider 드롭다운에서 위 4종 중 선택
- Base URL / API Key 입력 (필요 시)
- 저장 → 다음 메시지부터 적용
모델 변경은 별도
AI 모델 변경은 Provider 설정이 아닌 AIRGAP Monitor 의 AIRGAP: Select LLM Model 명령으로 수행합니다. Provider 는 그대로 두고 모델만 바꾸는 방식.
자세한 내용: Monitor 문서
외부 네트워크 사용 안내
에어갭 환경에서는 외부 SaaS Provider 사용을 권장하지 않습니다. 외부 Provider 연결 시 인터넷 연결이 필요하며, 환경 정책에 따라 차단될 수 있습니다.