ドキュメント · ガイド

miniQ を任意のモデルで

miniQ はデスクトップの AI アシスタントで、miniq ターミナルクライアントもあります。どちらも同じ miniq-daemon につながります。モデルは OpenAI または Anthropic 互換のエンドポイント 1 つから来ます。それが settings.json の provider です。magpie がこの provider をローカルのゲートウェイにすると、miniQ が DeepSeek、GLM、Kimi、Qwen、GPT、ChatGPT サブスクリプションなど magpie の任意のモデルで動きます。

miniQ の設定

  1. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. エージェント ページで miniQ のモデルを選ぶminiQ の行には今の miniQ のモデルと via magpie のモデルがあります。後者を選びます。
  3. そのまま使う動作中の daemon には新しい provider が伝えられ、開いているチャットも新しいモデルに移ります。再起動は不要です。
ターミナル
magpie miniq deepseek/deepseek-v4-pro

Windows では WSL ディストリビューション内の miniQ も見つかり、同じように設定されます。

settings.json の場所

settings.json は daemon のデータフォルダーにあり、magpie は miniQ と同じ順で探します。まず MINIQ_DATA_DIR です。次に、既定フォルダーの隣の miniq-data-dir.json が指すフォルダーです。このファイルは miniQ の設定でデータフォルダーを移したときにできます。どちらもなければ既定フォルダーです。macOS も ~/.local/share/miniq です。

ターミナル
macOS / Linux: ~/.local/share/miniq/settings.json
Windows:       %LOCALAPPDATA%\miniq\settings.json
MINIQ_DATA_DIR set: $MINIQ_DATA_DIR/settings.json

書き込まれる内容

ターミナル
{
  "provider": {
    "baseUrl": "http://127.0.0.1:3425/v1",
    "apiKey": "",
    "model": "deepseek/deepseek-v4-pro",
    "apiProtocol": "chat_completions"
  }
}

baseUrl はゲートウェイの /v1 です。apiKey は magpie が miniQ 用に発行するキーです。miniQ は独自の User-Agent を送らないので、magpie はこのキーで miniQ のリクエストを見分けます。model はモデルのカタログ id です。apiProtocol は chat_completions で固定します。auto だとモデル名から Responses や Anthropic Messages を推測してしまうからです。

magpie が変えるのは provider だけで、元の provider は丸ごと控えておきます。settings.json の他の内容はそのままです。MCP サーバー、承認、hooks、リモートアクセスも変わりません。ファイルがないときは、miniQ と同じく 0600 の権限で作ります。

動作中の daemon

daemon は起動時に一度だけ settings.json を読み、設定が変わるたびに自分の内容を書き戻します。そのため magpie はファイルを書いたあと、daemon.json が示すローカルの WebSocket で settings.update を呼びます。miniQ 自身の設定画面と同じ方法です。届かない daemon は再起動するまで古い provider を使い続けます。その場合、magpie が miniQ の再起動を促します。

元に戻す

既定に戻すと、元の provider を丸ごと戻し、daemon に伝えます。元の provider がなかった場合は magpie のものを消し、miniQ は自分の既定に戻ります。settings.json を magpie が作っていて空になれば、ファイルごと消します。magpie で自分の miniQ のモデルを選んでも戻せます。そのモデルは元の provider に入ります。

ターミナル
magpie miniq default

よくある質問

miniQ で DeepSeek、GLM、ChatGPT サブスクリプションを使うには？

magpie のエージェントページで miniQ に via magpie のモデルを選びます。magpie が settings.json の provider をローカルゲートウェイの /v1 にし、動作中の miniq-daemon に伝えます。

miniQ の再起動は必要ですか？

通常は不要です。magpie が settings.update で動作中の daemon に伝え、開いているチャットも新しいモデルに移ります。届かない daemon のときだけ再起動が必要で、magpie がそう伝えます。

なぜ auto ではなく chat_completions なのですか？

auto はモデル名からプロトコルを推測し、Responses や Anthropic Messages を選ぶことがあります。ゲートウェイの /v1 は Chat Completions なので固定します。

MCP サーバーなど他の設定は変わりますか？

変わりません。magpie が変えるのは settings.json の provider だけで、元に戻すと元の provider に戻ります。

同じモデルを他のエージェントでも：Empryo を任意のモデルで、Lody を任意のモデルで、Cindy を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。