文档 · 指南

让 MothX 用任意模型

MothX（开源中国的 oschina/mothx，mothx 命令，原名 vibecoding）是用 Go 写的终端编程 Agent。它的供应商和启动时用的模型都在一个 settings.json 里。magpie 在里面加一个名为 magpie 的供应商并把它设为默认，MothX 就能用 DeepSeek、GLM、Kimi、Qwen、Claude 或 ChatGPT 订阅等 magpie 里的任意模型。

接入 MothX

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Agent 页给 MothX 选模型选一个 via magpie 的模型，需要的话再选思考强度。
  3. 重启 MothXMothX 只在启动时读设置，正在运行的会话要重新启动才换模型。
终端
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 用默认供应商的接口去请求默认模型：openai-chat 就是 baseUrl 加 /chat/completions，带上 Bearer apiKey。magpie 的每个模型都写成一条，带上能不能读图片、上下文窗口、单次回复上限和每百万 token 的价格；没有这些值时，MothX 会用它自己的默认窗口和回复上限，也算不出每轮的花费。你在 magpie 供应商里自己加的 headers、httpProxy 会保留，你自己的供应商不动。WSL 发行版里的 MothX 也一样设置，目录是那边的 ~/.mothx。

思考强度

defaultThinkingLevel 是会话开始时的思考强度，可选 off、minimal、low、medium、high、xhigh、max；对 magpie 知道支持哪些强度的模型，只列出那些。只有条目里 reasoning 为 true 的模型，MothX 才会发送思考强度。magpie 写 thinkingFormat: "openai"，让 MothX 对每个模型都用 reasoning_effort，再由网关转成各厂商自己的格式。不写的话，MothX 会按模型名和地址猜厂商：名字以 qwen 开头的模型会收到 Qwen 的 enable_thinking，deepseek 的只收到 thinking:{type:enabled}，不管实际是谁在服务。你自己已经写了 thinkingFormat 的，magpie 不改。

重启 MothX

MothX 在启动时读 settings.json，所以正在运行的 MothX 要重启；magpie 发现 mothx 或 vibecoding 进程在运行时会提醒你。MothX 自己的 /model 和 /auth 对话框会把整个文件写回去，magpie 的设置不会因此丢失。MothX 的请求带着 Vibecoding Client/<版本> 的 User-Agent，用量页会把它认作 MothX。

切回

切回时，magpie 删掉 defaultProvider、defaultModel 和 providers.magpie，只剩空的 providers 也一起删掉。如果文件这时和 magpie 第一次写入之前说的一样，就把原来的文件一字不差地放回去。

终端
magpie mothx default

常见问题

MothX 能用 DeepSeek、GLM 或 ChatGPT 订阅吗？

能。在 magpie 的 Agent 页给 MothX 选一个 via magpie 的模型，然后重启 MothX。

vibecoding 也能这样接吗？

能。vibecoding 是 MothX 以前的名字，magpie 把它当作 MothX，用同一个 settings.json。

思考强度是怎么传给模型的？

magpie 设 thinkingFormat 为 openai，MothX 用 reasoning_effort 发送，网关再转成各厂商自己的格式。

切回后原来的设置会恢复吗？

会。magpie 删掉它加的默认和供应商；文件和 magpie 写入前一样时，原文件原样放回。

更多 Agent 用同样的模型：让 PenguinHarness 用任意模型、让 Paimon 用任意模型、让 Pi 用任意模型、让 Avibe 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。