メインコンテンツへスキップ
Mac Studioのユニファイドメモリはノートパソコンでは保持できないモデルを格納でき、LM Studio、Ollama、MLX Studio、MLX-LM Serverをヘッドレス推論ボックスとして運用することになる。Tokiosのコネクターをランタイムの隣で実行すれば、https://api.tokios.comに認証付きエンドポイントが生成され、サーバーの0.0.0.0へのバインドも、VPNも、チームメンバーごとのネットワーク設定も不要だ。

LANはチームと同じではない

LM Studioの公式ドキュメントではserve on local networkの設定 — サーバーを127.0.0.1より広範囲にバインドして同一Wi-Fi上の他デバイスからアクセス可能にする方法 — に警告付きで説明されており、リクエストレベルの認証はデフォルトで無効になっている。これで自宅ネットワーク内の別マシンからMac Studioと通信できる。しかし以下は実現できない。
  • LAN外にいるチームメンバー。 別の建物、別の都市、自宅ネットワークから作業している人は、ローカルサブネットにバインドされたサーバーにアクセスできない。
  • 個人単位のアクセス制御。 LM StudioのネットワークサーバーにはAPIキー機能がなく、バインドされたポートとパスに到達できる者は誰でも呼び出せる。特定のチームメンバーにだけアクセス権を付与したり、サーバーを再起動せずに誰かのアクセスを遮断したりする手段はない。
  • マシン変更後も有効なアドレス。 LAN IPはネットワークに紐付いている。Mac Studioを移動させたり、ルーターを変更したり、Mac miniに役割を引き継がせたりすると、全クライアントの設定が壊れる。
TokiosはLM Studio、Ollama、MLX Studio、MLX-LM Serverの動作を変更しない。Mac Studioからhttps://api.tokios.comへ外向きに接続するコネクターを追加するだけで、ランタイムをループバック以外にバインドしたり、インバウンドポートを開放したりする必要はない。
ターミナルなしでGUIを使いたい? MLX StudioはvMLX推論エンジン、モデルマネージャー、OpenAI互換APIサーバーをバンドルしたネイティブmacOSアプリだ。pipもvenvもコマンドラインも不要。アプリをダウンロードし、Hugging Faceのmlx-communityからモデルを選んで、Serverタブからサーバーを起動する。デフォルトでポート8000で待ち受ける。

Mac Studioの構成と実行可能なモデル

現在のMac StudioはM4 Ultra、M5 Max、M5 Ultraチップを搭載している。各チップのローカル推論での仕様を以下に示す。 この量のユニファイドメモリがあれば、Mac Studioは他のプラットフォームではマルチGPUサーバーを必要とするモデルサイズも処理できる。
  • 70BモデルはQ4またはQ8量子化でM4 Ultra(192 GB)および全M5構成で快適に動作する。
  • 500B以上のMoEモデル(DeepSeek V4.1-Flash(552B)やKimi K3(2.8Tの低量子化)など)はマルチデバイス構成が必要。DeepSeek V4.1-Flashローカルハードウェアを参照のこと。
  • ネイティブ精度のDeepSeek V4-Flash(155 GB)はM5 Ultra 256 GB構成にKVキャッシュの余裕を持って収まる。
  • 複数の小規模モデルを同時実行 — Ollamaでコーディングモデルを、MLX Studioで汎用モデルを同時に実行し、それぞれを独自のTokiosデプロイの背後に配置できる。
MLX-LM ServerとMLX StudioはApple Silicon向けに最適化されている。M5 UltraのNeural Acceleratorsは前世代比で最大4xの高速なプロンプト処理を実現し、MLXベースのランタイムはM5ハードウェアで最大の恩恵を受ける。
現在のMac Studioの価格は$2,499からのM5 Max、$5,499からのM5 Ultra。

Mac Studioでセットアップを行う

1

Mac Studio上でランタイムを起動する

通常通りにループバック上でモデルサーバーを実行します。
コネクターを追加する前に、サーバーが独自のOpenAI互換/v1 APIに応答することを確認してください。
2

Get a claim code and pair the connector

TokiosのdashboardでSetupタブを開き、Start pairingを選択して、TKS-XXXX-XXXX形式のワンタイムペアリングコードを取得します(約15分間有効)。Mac Studio上で次を実行します:
TokiosはApple Silicon(arm64)向けのtokios-connectorネイティブビルドを提供しており、Mac Studio、Mac mini、Apple Silicon搭載のMacBook Proに対応している。Gatekeeperがバイナリを警告した場合はxattr -d com.apple.quarantine ./tokios-connectorで解除できる。上記のインストール用ワンライナーを使えばこの手順は不要。ダッシュボードでデバイスをapproveします。SetupまたはConnectorsタブから操作できます。コネクターのトークンはトンネル経由で配信され、画面に表示されたりファイルに貼り付けたりすることはありません。
3

コネクターをランタイムの /v1 エンドポイントに向ける

コネクターのアップストリームはMac Studio上のランタイム自身のOpenAI互換APIであり、ループバック上のままでネットワークに公開するポートではない。デフォルトポート: LM Studio 1234、Ollama 11434、MLX Studio 8000、MLX-LM Server 8080(いずれも末尾に/v1が付加される)。この単一マシン構成ではインバウンドのファイアウォールルール、LANバインディング、追加のコネクター設定は不要。
4

Register a deployment

次のModelsタブで、アップストリームモデルID(例: LM StudioまたはOllamaで読み込んだモデル)をstudio-modelのような公開デプロイ名にマップします。クライアントはこのデプロイ名をmodelフィールドで送信し、アップストリームIDは送信しません。
5

Create an API key

次のKeysタブでキーを作成します。キーはsk-tok-…形式のBearerトークンであり、作成時に一度だけ表示され、特定のデプロイ名パターンにスコープできるため、チームメイトのキーをこのデプロイのみに制限できます。

常時稼働を維持する

ターミナルウィンドウでもテストには十分だが、Mac Studioをこの用途で常時使用するなら、再起動やログアウト後もコネクターを起動し続けるべきだ。launchd バックグラウンドサービスとして、~/Library/LaunchAgents/com.tokios.connector.plistエージェントでProgramArgumentsをtokios-connector --configとtokios-connector.jsonに向けて実行する。RunAtLoadとKeepAliveを設定すれば自動再起動される。詳しくはコネクター設定: バックグラウンドサービスとして実行するを参照のこと。完全なplistとlaunchctl load / launchctl startコマンドが記載されている。 対話的にログインすることがないマシンの場合は、LaunchDaemonではなくLaunchAgentを検討してほしい。使用しているmacOSバージョンについてAppleの最新ガイドラインを確認し、どちらが適切か判断すること。

どこからでも使用する

コネクターのペアリングとデプロイ登録が完了したら、クライアントをMac StudioのIPアドレスやホスト名ではなくTokiosに向けます。
Claude Codeのモデルピッカーはclaude*形式のIDのみを表示するため、Tokiosデプロイはリストに現れません。--model studio-modelを明示的に渡してください。
Mac Studio上で複数のモデルを実行している場合 — たとえばLM Studioで一つ、Ollamaでもう一つ、MLX Studioで三つ目、MLX-LM Serverで四つ目 — は、単一モデルのペアリングフローではなくコネクター設定ファイルを使用して複数のルートとアップストリームを定義してください。同じエンドポイントの背後で複数のデプロイを登録・切り替える方法についてはモデルルーティングを参照ください。

なぜ一つのエンドポイントなのか

  • ネットワークを共有せずにMac Studioを共有できる。 チームメイトは自身にスコープされたキーでhttps://api.tokios.comを呼び出す。LANやTailscaleのtailnetに参加する必要はない。
  • クライアント設定を変更せずにモデルを切り替えられる。 studio-modelを別のアップストリームモデルやバックエンドに向ければ、それを既に使用している全エージェントとスクリプトがそのまま動作し続ける。
  • インバウンドポートなし、0.0.0.0なし。 LM Studio、Ollama、MLX Studio、MLX-LM Serverは127.0.0.1のまま。コネクターはTokiosへの外向き接続のみ行う。

次のステップ

Quickstart

ゼロから動作するコネクター、デプロイ、APIキーまで構築します。

Install the connector

全プラットフォーム向けのコネクターインストール・ペアリングリファレンス。

Use Claude Code

設定方法: ANTHROPIC_BASE_URLとANTHROPIC_API_KEYの詳細。

Connector config reference

一台のMacからtokios-connector.jsonで複数モデルを配信し、launchdサービスとして実行する。