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 隔离沙盒登录与专属浏览器
滚入播放

自动对齐出口时区与语言,在独立沙盒完成登录并一键直开账号浏览器。

  • 生来纯净 — 宿主机凭据无法进入沙盒;登录、手机与两步验证均由你本人完成,零代填、零截获。
  • 出口测速与账号浏览器 — 「网络代理」页「全部测速」查延迟与出口 IP;账号卡一键直开色标原版 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