QUICKSTART

三分鐘上手

桌面工作台與 modelbuff 命令列共用同一份本機設定,任選一種都能立刻開始。

CHAPTER 01 · DESKTOP APP

桌面工作台上手

四個步驟完成無損匯入、雙視窗帳號池、帳號瀏覽器與 Agent 一鍵接入。

  1. 01安裝與匯入
  2. 02帳號與綁定
  3. 03登入與瀏覽器
  4. 04接入 Agent

01

下載桌面版並無損匯入既有設定

安裝開啟即可使用,首次啟動支援唯讀掃描並一鍵匯入既有設定:

一鍵無損匯入既有設定
桌面版步驟 01:ModelBuff 一鍵無損匯入既有設定
捲入播放

唯讀掃描本機 CC Switch、OpenCode 與 ccswitch:// 連結,一鍵無損遷移。

  • 唯讀遷移 — 無損匯入 CC Switch、Magpie、OpenCode 與本機 CLI 設定,相容 ccswitch:// 連結。

02

管理雙視窗帳號池與目錄綁定

同屏掌握每組帳號的 5h / 7d 雙視窗餘量,並依專案資料夾鎖定專屬隔離身分:

雙視窗排程與目錄自動綁定
桌面版步驟 02:ModelBuff 帳號池與目錄綁定
捲入播放

檢視雙視窗帳號池的限流接力與五維環境檢測,依目錄鎖定工作與個人帳號。

  • 智慧接力 — 臨期週額優先排空,未啟動的 5h 視窗待命保護,遇 429 原地無縫切換。
  • 目錄鎖定 — 工作與個人資料夾自動切入各自帳號,徹底杜絕跨專案串用。

03

沙盒登入、出口測速與帳號瀏覽器

綁定自有出口並自動匹配地區時區與語系,在原生純淨的沙盒完成官方登入,隨時一鍵直開帳號瀏覽器:

出口時區對齊與隔離沙盒登入
桌面版步驟 03:ModelBuff 隔離沙盒登入與專屬瀏覽器
捲入播放

自動對齊出口時區與語系,在獨立沙盒完成登入並一鍵直開帳號瀏覽器。

  • 原生純淨 — 本機憑證無法進入沙盒;登入、簡訊與雙重驗證皆由你本人完成,零代填、零截獲。
  • 出口測速與帳號瀏覽器 — 「網路」頁可一鍵併發測速;帳號卡片一鍵直開色標原版 Chrome / Edge,共用同一出口並阻斷本機 DNS 與非代理 WebRTC。

04

一鍵接入主力 Agent 與本機遮罩閘道

在工作台一鍵接入常用 Agent,最新模型隨時切、主力工具不用換:

一鍵切模型與本機遮罩閘道
桌面版步驟 04:ModelBuff 一鍵接入 Agent 與本機遮罩閘道
捲入播放

保留主力 Agent 一鍵切換模型,第三方工具直連 127.0.0.1:28330 遮罩閘道。

  • 換模型不換 Agent — 一鍵接入 Claude Code、Codex、Cursor、Antigravity、Gemini CLI 與 OpenCode。
  • 雙向遮罩閘道 — 預設監聽 127.0.0.1:28330,金鑰遮蔽、路徑可逆還原且不影響提示詞快取。

CHAPTER 02 · CLI

modelbuff 命令列上手

零 GUI 相依,適合純終端機與 SSH / WSL2,與桌面版共用 ~/.modelbuff/config.toml。

  1. 01安裝 CLI
  2. 02宣告設定
  3. 03登入與瀏覽器
  4. 04巡檢與閘道

01

一行指令安裝 CLI 並啟用 PATH 替身

安裝獨立 CLI 與輕量 PATH 替身,之後照常執行原版指令即可:

CLI 安裝與 PATH 替身初始化
terminal — zsh · ~
curl -fsSL https://go.modelbuff.com/install.sh | sh
export PATH="$HOME/.modelbuff/shims:$HOME/.modelbuff/bin:$PATH"
modelbuff shims install
捲入播放

一行指令安裝零 GUI 相依的 modelbuff CLI,並啟用依目錄自動切換替身。

  • 零相依秒啟 — 原生 Rust 執行檔、免管理員權限,支援 macOS / Linux / WSL2(啟動開銷 < 15ms)。

02

在 config.toml 中宣告帳號與目錄綁定

寫明目錄規則、時區與語系立即生效,與桌面版即時共用同一檔案:

宣告隔離身分與目錄綁定設定
~/.modelbuff/config.toml
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.<名稱>],CLI 與帳號瀏覽器共用同一條乾淨鏈路。

03

沙盒登入、直開帳號瀏覽器與環境檢測

在沙盒中原樣執行官方 CLI 登入,隨時從終端機一鍵開啟帳號瀏覽器並執行檢測:

沙盒登入、帳號瀏覽器與診斷
terminal — zsh · ~/work/acme-core
modelbuff login --identity claude-us claude
modelbuff browser open --identity claude-us
modelbuff identity list
modelbuff doctor
捲入播放

在隔離沙盒內完成官方 CLI 登入,隨時一鍵直開帳號瀏覽器並透過 doctor 診斷。

  • 出口與環境檢測 — 執行 modelbuff egress check --identity claude-us 查驗出口連通、實際出口 IP、遠端 DNS 與延遲;modelbuff doctor 檢查沙盒與邊界狀態,任一環節失效立即中止絕不直連。
  • 終端直開帳號瀏覽器 — modelbuff browser open 一鍵開啟專屬原版 Chrome / Edge,共用出口與獨立 0700 Profile,查看帳單或用網頁版絕不混用。

04

狀態巡檢與啟動本機遮罩閘道

日常照常輸入 claude、codex 自動切身分;按需查餘量或開啟遮罩閘道:

狀態巡檢與本機遮罩閘道啟動
terminal — zsh · ~/work/acme-core
modelbuff status
modelbuff gateway serve
捲入播放

檢視目前目錄對應身分與雙視窗餘量,並啟動相容主流協定的本機雙向遮罩閘道。

  • 本機迴環 — 僅監聽 127.0.0.1:28330,相容 OpenAI / Anthropic / Gemini;可於 [gateway] 區段調整連接埠。
下載 ModelBuffmacOS · Windows · Linux