ドキュメント · ガイド

MothX を任意のモデルで

MothX（OSCHINA の oschina/mothx、mothx コマンド、旧名 vibecoding）は Go で書かれたターミナルのコーディングエージェントです。プロバイダーと起動時のモデルは一つの settings.json にあります。magpie が magpie という名前のプロバイダーを加えて既定にすると、MothX が DeepSeek、GLM、Kimi、Qwen、Claude、ChatGPT サブスクリプションなど magpie の任意のモデルで動きます。

MothX の設定

  1. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. エージェント ページで MothX のモデルを選ぶvia magpie のモデルを選び、必要なら思考レベルも選びます。
  3. MothX を再起動MothX は起動時に設定を読むので、開いているセッションは再起動するまで元のモデルのままです。
ターミナル
magpie mothx deepseek/deepseek-v4-pro

settings.json

設定フォルダーは $MOTHX_DIR、なければ Windows では %APPDATA%\mothx、ほかでは ~/.mothx です。magpie が書く内容：

ターミナル
{
  "defaultProvider": "magpie",
  "defaultModel": "deepseek/deepseek-v4-pro",
  "defaultThinkingLevel": "high",
  "providers": {
    "magpie": {
      "baseUrl": "http://127.0.0.1:3425/v1",
      "api": "openai-chat",
      "apiKey": "",
      "thinkingFormat": "openai",
      "models": [
        { "id": "deepseek/deepseek-v4-pro", "name": "…", "reasoning": true,
          "input": ["text"], "contextWindow": …, "maxTokens": …,
          "cost": { "input": …, "output": …, "cacheRead": …, "cacheWrite": … } }
      ]
    }
  }
}

MothX は既定のプロバイダーの api で既定のモデルを呼びます。openai-chat は baseUrl に /chat/completions を付けた先で、Bearer apiKey を付けます。magpie の各モデルは一つのエントリで、画像を読めるか、コンテキストウィンドウ、一回の応答の上限、100 万トークンあたりの価格が付きます。これがないと MothX は自身の既定のウィンドウと上限を使い、ターンの費用も数えられません。magpie のプロバイダーに自分で加えた headers や httpProxy は残り、自分のプロバイダーには触れません。WSL のディストリビューションの MothX も、そちらの ~/.mothx で同じように設定します。

思考レベル

defaultThinkingLevel はセッション開始時の思考レベルで、off、minimal、low、medium、high、xhigh、max から選びます。magpie が対応レベルを知っているモデルではそれだけに絞ります。MothX はエントリの reasoning が true のモデルにだけ思考レベルを送ります。magpie は thinkingFormat: "openai" を書き、MothX がどのモデルにも reasoning_effort で頼むようにし、ゲートウェイがそれを各ベンダーの形式に直します。これがないと MothX はモデル名とアドレスからベンダーを推測し、qwen で始まるモデルには Qwen の enable_thinking、deepseek のものには thinking:{type:enabled} だけを送っていました。すでに自分で thinkingFormat を書いていれば、そのままです。

MothX の再起動

MothX は起動時に settings.json を読むので、起動中の MothX は再起動が要ります。mothx や vibecoding のプロセスが動いていれば magpie が知らせます。MothX 自身の /model や /auth はファイル全体を書き戻しますが、magpie の設定は消えません。リクエストの User-Agent は Vibecoding Client/<version> で、使用量では MothX として数えます。

元に戻す

元に戻すと、defaultProvider、defaultModel、providers.magpie を外し、空になった providers も外します。そのときファイルが magpie の最初の書き込み前と同じ内容なら、元のファイルをそのまま戻します。

ターミナル
magpie mothx default

よくある質問

MothX で DeepSeek、GLM、ChatGPT サブスクリプションを使えますか？

使えます。magpie のエージェントページで MothX に via magpie のモデルを選び、MothX を再起動します。

vibecoding でも使えますか？

使えます。vibecoding は MothX の旧名で、magpie は同じ settings.json で MothX として扱います。

思考レベルはどうモデルに届きますか？

magpie が thinkingFormat を openai にするので、MothX は reasoning_effort で送り、ゲートウェイが各ベンダーの形式に直します。

元に戻すと設定も戻りますか？

戻ります。magpie は加えた既定とプロバイダーを外し、ファイルが書き込み前と同じなら元のファイルをそのまま戻します。

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