가이드
설계 철학
ModelBuff가 끝까지 지키는 것과 단호히 거부하는 것 — 모두 아래 5가지 엔지니어링 원칙에 뿌리를 둡니다.
01
공식 원본을 네이티브 그대로 구동
리버스 프록시와 위장을 거부하고 격리 환경 안에서 공식 CLI를 그대로 실행합니다.
지키는 원칙
- 공식 직구동 — 정식 CLI로 로그인·통신해 신기능을 지체 없이 활용
- 표준 프로토콜 — ACP로 에이전트를 구동하고 MCP로 미디어 도구 제공
- 개방형 API 호환 — 로컬 게이트웨이가 OpenAI / Anthropic / Gemini 형식 지원
하지 않는 것
- 토큰 추출 금지 — 구독 인증 토큰을 빼내 프록시가 대리 전송하지 않음
- 프롬프트 위장 금지 — 시스템 프롬프트를 변조하거나 지우지 않음
02
독립 샌드박스 + 전용 브라우저, 이상 시 즉시 차단
계정마다 격리 경계·고정 출구·전용 브라우저를 묶고, 경계가 깨지면 직접 연결 없이 즉시 중단합니다.
지키는 원칙
- 전용 브라우저 원클릭 — 정품 Chrome / Edge를 독립 프로필과 색상 배지로 재사용
- 무오염 샌드박스 — 호스트 자격 증명 차단, 출구 기준 시간대·언어 정렬, DNS/WebRTC 누출 봉쇄
- 폴더 × 그룹 격리 — 업무·개인 환경과 다중 계정의 경계를 물리적으로 분리
하지 않는 것
- 비격리 실행 금지 — 샌드박스나 출구 오류 시 즉시 에러로 중단
- 묵시적 폴백 금지 — 호스트 $HOME이나 직접 연결로 슬쩍 되돌리지 않음
03
100% 로컬 실행, 오직 개인을 위한 도구
내 컴퓨터 안에서만 완결되는 개인 생산성 워크스테이션. 자격 증명도 대화도 기기 밖으로 나가지 않습니다.
지키는 원칙
- 모든 데이터 로컬 보관 — 로그인 세션, API 키, 이중 소스 사용량 장부를 로컬 디스크에만 저장
- 제공사 직접 연결 — 모든 모델 요청을 기기에서 대상 제공사로 직접 전송
- 양방향 민감 정보 보호 —
127.0.0.1:28330전용으로 키 마스킹과 경로 치환 수행
하지 않는 것
- 클라우드 계정 없음 — 로그인 강제나 대화·사용량 업로드 없음
- 다인 공유·재판매 불가 — 멀티 테넌트 계정 풀이나 구독 상업 재판매 미제공
04
밀리초 초경량 코어, 컴퓨터 한 대로 충분
VM·Docker보다 훨씬 가볍게 격리해 작업 리듬을 전혀 늦추지 않는 아키텍처.
지키는 원칙
- 상주 메모리 5 MB 미만 — 자체 경량 엔진으로 세션당 실측 약 3 MB
- 약 45 ms 즉시 시작 — 샌드박스+고정 출구 전체 활성 시 ~45 ms, 전환만 ~3 ms
- 독립 CLI 바이너리 — GUI 의존성 제로, macOS / Linux / WSL2 고속 동작
하지 않는 것
- 무거운 VM 지양 — 계정마다 가상 머신이나 대형 이미지를 띄우지 않음
- 다중 클라우드 불필요 — 컴퓨터 한 대로 여러 격리 환경을 가볍게 병렬 운용
05
MIT 오픈소스로 기존 생태계 확장
자격 증명·설정·프로토콜을 다루는 모든 핵심 구성요소는 MIT 오픈소스로 투명하게 감사 가능합니다.
지키는 원칙
- 핵심 클라이언트·프로토콜 전면 공개 — 데스크톱 앱, CLI, 보호 게이트웨이, 멀티모달 MCP, 프로토콜 계약 공개
- 투명한 로컬 파일 — 설정과 키 모두 명확한 로컬 파일로 벤더 종속 없음
- 무손실 마이그레이션 — CC Switch / Magpie / OpenCode 및
ccswitch://읽기 전용 가져오기
하지 않는 것
- 원본 설정 덮어쓰기 금지 — 기존 도구의 설정 파일을 손상시키지 않음
- 폐쇄적 생태계 지양 — 오픈 플러그인과 표준 프로토콜로 기존 도구를 증폭
아키텍처 경계 — 샌드박스 격리, 멀티홉 체인, 듀얼 윈도우 스케줄링은 동봉된 mb-engine이 수행하며 공개 계약을 통해 오픈소스 클라이언트와 통신합니다.