QUICKSTART

3 分クイックスタート

デスクトップ版と modelbuff CLI は同一のローカル設定を共有。どちらからでもすぐ始められます。

CHAPTER 01 · DESKTOP APP

デスクトップ版クイックスタート

既存設定の取り込みから、アカウントプール、専用ブラウザ、エージェント接続まで 4 ステップ。

  1. 01導入・移行
  2. 02アカウント管理
  3. 03認証・ブラウザ
  4. 04エージェント連携

01

アプリを導入して既存設定を取り込む

インストールして起動するだけ。初回起動時に既存ツールの設定を読み取り専用でスキャンします。

既存設定を読み取り専用で一括インポート
ステップ 01:既存設定のワンクリック取り込み
表示で再生

CC Switch・OpenCode や ccswitch:// リンクを検出し、元ファイルを壊さず取り込みます。

  • 非破壊インポート — CC Switch・Magpie・OpenCode・各種 CLI 設定や ccswitch:// リンクを安全に取り込みます。

02

アカウントプールとディレクトリ紐付けを設定

5 時間 / 7 日間クォータを同画面で確認し、プロジェクトフォルダごとに隔離アカウントを固定します。

2 軸クォータ制御 & フォルダ自動固定
ステップ 02:アカウントプールとフォルダ固定
表示で再生

複数アカウントの残量・5 軸環境チェック・429 自動リレーとディレクトリ紐付けを一覧管理。

  • スマートリレー — リセット間近の週間枠を優先消化し、未使用 5 時間枠を温存。429 制限時は無停止で切り替えます。
  • フォルダ固定 — 業務と個人のリポジトリで自動的に別アカウントへ切り替わり、混用を防ぎます。

03

隔離ログイン・速度計測・専用ブラウザ

自前の出口ノードを紐付けてタイムゾーンと言語を整合させ、クリーンなサンドボックスで公式サインインを行います。

出口連動の隔離ログイン & 専用ブラウザ
ステップ 03:隔離ログインと専用ブラウザ
表示で再生

固定出口に合わせて時差・言語を自動整合し、隔離サンドボックスで安全に公式ログイン。

  • クリーン境界 — ホスト側の認証情報は一切持ち込まず、ログイン・SMS・二段階認証はすべてご自身で安全に完了できます。
  • 専用ブラウザ即起動 — 「ネットワーク」で全ノード一括計測が可能。アカウントごとに色分けされた純正 Chrome / Edge をワンクリックで起動できます。

04

主力エージェントとローカルゲートウェイを接続

普段使っているエージェントをワンクリック連携。モデルを変えても開発体験はそのままです。

エージェント接続 & ローカル保護ゲートウェイ
ステップ 04:エージェント接続とローカルゲートウェイ
表示で再生

愛用エージェントのままモデルを自在に切替。外部ツールは 127.0.0.1:28330 へ接続。

  • ツールそのままモデル切替 — Claude Code・Codex・Cursor・Antigravity・Gemini CLI・OpenCode を一括接続。
  • 双方向マスク対応 — 既定アドレス 127.0.0.1:28330。秘密鍵マスクとパス仮想化をキャッシュを壊さず実行します。

CHAPTER 02 · CLI

modelbuff CLI クイックスタート

GUI 依存ゼロで SSH / WSL2 にも最適。デスクトップ版と ~/.modelbuff/config.toml を共有します。

  1. 01CLI 導入
  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 を 1 行で導入し、ディレクトリ自動切替シムを有効化します。

  • 依存ゼロ・超高速 — ネイティブ 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 1 つでフォルダ固定・タイムゾーン整合・公式 CLI 認証を定義します。

  • 多段固定出口 — egress を 1 行足して [proxies.<name>] を指定すると、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 で同じ出口と独立 0700 プロファイルを持つ純正 Chrome / Edge を開けます。

04

残量確認とローカルゲートウェイ起動

普段通り claude や codex を実行すれば自動で隔離切替。残量確認やゲートウェイ起動も 1 コマンドです。

ステータス確認とローカル保護ゲートウェイ起動
terminal — zsh · ~/work/acme-core
modelbuff status
modelbuff gateway serve
表示で再生

現在のフォルダに紐付くアカウントと残量を確認し、主要形式対応のローカル保護ゲートウェイを起動します。

  • ローカル専用 — 127.0.0.1:28330 で OpenAI / Anthropic / Gemini を統合受付。ポートは [gateway] で変更可能です。
ModelBuff をダウンロードmacOS · Windows · Linux