01
앱 설치 및 기존 설정 무손실 가져오기
설치 후 바로 실행하세요. 첫 실행 시 기존 도구 설정을 읽기 전용으로 탐색해 원클릭으로 가져옵니다.

로컬 CC Switch, OpenCode 및 ccswitch:// 링크를 스캔해 원본 손상 없이 가져옵니다.
- 비파괴 마이그레이션 — CC Switch, Magpie, OpenCode 및 기존 CLI 설정과
ccswitch://링크를 안전하게 가져옵니다.
QUICKSTART
데스크톱 워크벤치와 modelbuff CLI는 동일한 로컬 설정을 공유합니다. 편한 방식으로 바로 시작하세요.
ModelBuff는 여러 플랫폼의 구독, API, 멀티모달 한도를 로컬에서 통합 관리하고 격리 샌드박스·전용 브라우저·표준 프로토콜로 주력 에이전트에 전달합니다.
듀얼 윈도우 계정 풀, 전용 브라우저, 멀티홉 프록시, 사용량 분석, 에이전트 원클릭 연결을 GUI로 관리.
데스크톱 섹션으로GUI 의존성 제로. 폴더별 자동 격리 전환, 전용 브라우저 실행, 로컬 보호 게이트웨이를 터미널에서 즉시 구동.
CLI 섹션으로기존 설정 가져오기, 듀얼 윈도우 계정 풀, 전용 브라우저, 에이전트 연결까지 4단계로 완료.
01
설치 후 바로 실행하세요. 첫 실행 시 기존 도구 설정을 읽기 전용으로 탐색해 원클릭으로 가져옵니다.

로컬 CC Switch, OpenCode 및 ccswitch:// 링크를 스캔해 원본 손상 없이 가져옵니다.
ccswitch:// 링크를 안전하게 가져옵니다.02
모든 계정의 5시간 / 7일 잔여 한도를 한눈에 보고, 프로젝트 폴더별로 격리 계정을 고정하세요.

다중 계정 잔여 한도, 5차원 환경 점검, 429 무중단 릴레이 및 프로젝트 폴더 고정을 관리합니다.
03
자체 출구 노드를 연결해 지역 시간대와 언어를 맞추고 클린 샌드박스에서 공식 로그인을 진행하세요.

고정 출구에 맞춰 시간대와 언어를 자동 정렬하고 클린 샌드박스에서 공식 로그인을 완료합니다.
04
워크벤치에서 자주 쓰는 에이전트를 클릭 한 번으로 연결하세요. 모델을 바꿔도 개발 흐름은 그대로입니다.

쓰던 에이전트 그대로 모델을 전환하고, 외부 도구는 127.0.0.1:28330 게이트웨이에 연결합니다.
127.0.0.1:28330. 키 마스킹과 경로 치환을 캐시 손실 없이 처리합니다.GUI 의존성 없이 SSH / WSL2에서도 완벽 동작하며 데스크톱 앱과 ~/.modelbuff/config.toml을 공유합니다.
01
경량 독립 CLI와 PATH 심을 설치하면 이후에는 평소처럼 원래 명령을 입력하면 됩니다.
curl -fsSL https://go.modelbuff.com/install.sh | shexport PATH="$HOME/.modelbuff/shims:$HOME/.modelbuff/bin:$PATH"modelbuff shims installGUI 의존성 없는 modelbuff CLI를 한 줄로 설치하고 폴더별 자동 전환 심을 활성화합니다.
02
폴더 규칙, 시간대, 로캘을 적어두면 즉시 적용되며 데스크톱 앱과 실시간으로 공유됩니다.
bat ~/.modelbuff/config.toml[identities.claude-us]bindings = ["~/work/**"]timezone = "America/Los_Angeles"locale = "en_US.UTF-8" [identities.claude-us.cli.claude]mode = "official_auth"로컬 ~/.modelbuff/config.toml 하나로 폴더 고정, 시간대·언어 정렬, 공식 CLI 인증 모드를 선언합니다.
egress 한 줄로 [proxies.<name>]를 지정하면 CLI와 전용 브라우저가 동일한 경로를 공유합니다.03
샌드박스 안에서 공식 CLI로 로그인하고 터미널에서 전용 브라우저 실행과 진단을 바로 수행합니다.
modelbuff login --identity claude-us claudemodelbuff browser open --identity claude-usmodelbuff identity listmodelbuff doctor격리 샌드박스에서 공식 CLI 로그인을 마치고 계정 브라우저 실행과 doctor 진단으로 상태를 검증합니다.
modelbuff egress check --identity claude-us로 출구 IP·원격 DNS·지연을 확인하고, modelbuff doctor로 격리 상태를 점검합니다. 이상 시 직접 연결로 새지 않고 즉시 중단합니다.modelbuff browser open으로 동일 출구와 독립 0700 프로필을 쓰는 정품 Chrome / Edge를 바로 엽니다.04
평소처럼 claude, codex를 실행하면 자동으로 격리 계정이 전환됩니다.
modelbuff statusmodelbuff gateway serve현재 폴더에 매칭된 계정과 윈도우 잔량을 확인하고 주요 프로토콜을 지원하는 로컬 마스킹 게이트웨이를 실행합니다.
127.0.0.1:28330에서 OpenAI / Anthropic / Gemini 요청을 통합 수신하며 [gateway]에서 포트를 변경할 수 있습니다.