피드로 돌아가기
Dev.toAI/ML
원문 읽기
Ollama 기반 로컬 LLM 구축을 통한 Zero-Cloud 코딩 에이전트 환경 구현
Run Coding Agents on Local AI — Zero Cloud, Full Control
AI 요약
Context
기존 Cloud AI API 기반 코딩 에이전트의 데이터 외부 유출 위험과 비용 및 Rate Limit 제약을 해결해야 하는 상황. 특히 기업 내부 보안 정책(NDA) 및 컴플라이언스 준수를 위해 인프라 제어권 확보가 필수적인 아키텍처 요구사항 존재.
Technical Solution
- Apple Silicon Unified Memory 아키텍처를 활용한 GPU/CPU 공유 메모리 기반의 대규모 LLM Inference 환경 최적화
- Mixture-of-Experts(MoE) 구조의 qwen3-coder:30b 모델 채택으로 파라미터 효율성 확보 및 256K Context Window를 통한 코드베이스 전체 컨텍스트 처리
- OpenAI 호환 /v1 엔드포인트를 제공하는 Ollama 서버를 LAN 내부 0.0.0.0 바인딩으로 설정하여 분산 환경의 에이전트 접근성 확보
- Codex CLI의 TOML 설정 및 Custom Model Catalog 정의를 통한 모델 메타데이터 매핑으로 Cloud API 의존성 제거
- 작업 특성에 따른 모델 스위칭 전략(Vision: qwen3.6, Function Calling: gpt-oss, Reasoning: deepseek-r1)을 통한 태스크별 최적 추론 경로 설계
실천 포인트
- Apple Silicon 환경에서 LLM 구동 시 Unified Memory 용량에 따른 모델 파라미터 크기 매칭 확인 - 외부 도구 연결 시 OLLAMA_HOST 환경 변수를 통한 네트워크 인터페이스 바인딩 설정 - Codex CLI 등 외부 클라이언트 사용 시 Model Catalog JSON의 스키마 일치 여부 검증 - 보안을 위해 Ollama 포트(11434)의 외부 인터넷 노출 차단 및 LAN 내부망 제한 적용