文档 · 指南

让 Grok App 用任意模型

Grok App（RongleCat/grok-app）是 grok CLI 的桌面前端，通过 ACP 启动 CLI。它自己的模型列表只有 Grok Build 的官方目录，你自己选的模型要作为「供应商通道」加在它的设置里。magpie 把自己加成一个名为 magpie 的自定义供应商，Grok App 的模型选择器里就能选 DeepSeek、GLM、Kimi、Qwen、Claude 或 ChatGPT 订阅等 magpie 里的任意模型。

接入 Grok App

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Agent 页给 Grok App 选模型选一个 via magpie 的模型，magpie 写入它的自定义供应商。
  3. 在 Grok App 里按 Use在 Grok App 的设置 › Account 里对 magpie 按 Use，Grok App 才切到 magpie。
终端
magpie grok-app deepseek/deepseek-v4-pro

magpie 这个自定义供应商

magpie 按 Grok App 自己写通道的方式，在数据文件夹的 agent-home/config.toml 里写 [model.magpie]：base_url 是网关的 /v1，api_key 是 magpie 给 Grok App 的专用 Key，接口是 chat completions。app_models 是 magpie 模型的 JSON 列表，每个都带上下文长度、是否支持图片和思考强度，所以设置里的自定义供应商会列出 magpie，模型选择器也能列出这些模型和它们的思考强度。

终端
# /agent-home/config.toml
[model.magpie]
model = "deepseek/deepseek-v4-pro"
base_url = "http://127.0.0.1:3425/v1"
name = "magpie"
api_key = ""
api_backend = "chat_completions"
app_provider_mode = "generic"
app_models = "[…]"
app_efforts = "[…]"
supports_reasoning_effort = …
context_window = …

通道里的上下文长度、图片和思考强度跟着当前选的模型。magpie 不再有的模型被选着时，通道换到列表里的第一个。

路由由你在 Grok App 里切换

[models] default 是 Grok App 启动时走的路由。magpie 不写它：把它设成 magpie 会接管 Grok App，它就会丢掉自己的登录，会话也跑不起来。所以路由保持 Grok App 原来的值，要切到 magpie，就在 Grok App 的设置里按 Use，这是 Grok App 自己的选择。旧版 magpie 曾把路由设成 magpie，新版会在下次同步或接入时把原来的路由放回去一次；之后你自己按的 Use 会一直保留。你后来在 Grok App 的模型选择器里选的模型也是你的，同步时不会被改掉。

切到 magpie 后，Grok App 用 agent-home 作为 GROK_HOME 启动 CLI，也就是它的独立模式；默认的共享模式和 Grok Build 共用 ~/.grok。

模型和思考强度

Grok Build 的通道没有 none 这一档，所以思考强度是模型的其他档位。模型选择器一开始用的档位，是你在 Grok App 的供应商页给这个模型标的默认档（模型还有这一档时），否则是 medium；没有 medium 时取中间那一档。

数据文件夹

magpie 找 Grok App 的数据文件夹：设了 $GROK_APP_HOME 就用它，否则按系统找，第一个存在的为准。

终端
macOS    ~/Library/Application Support/com.grokapp.grok-app
Windows  %APPDATA%\grokapp\grok-app\data
Linux    $XDG_DATA_HOME/grok-app (~/.local/share/grok-app)
         或 ~/.grok-app；设了 $GROK_APP_HOME 就用它

断开

断开时 magpie 删掉 [model.magpie]。只有路由还指向 magpie 时才动它，因为这样的路由跑不起来：放回 magpie 记下的原路由，没有就清掉。其他路由都是 Grok App 的，原样保留。在 magpie 里选 Grok App 自己的路由，比如官方的 Grok，也会删掉 magpie 的通道并把路由设成你选的那个。

常见问题

Grok App 能用 DeepSeek、GLM 或 ChatGPT 订阅吗？

能。magpie 把自己加成 Grok App 的自定义供应商，模型选择器里就能选 magpie 的模型；在设置里对 magpie 按 Use 即可切过去。

为什么接入后 Grok App 还没切到 magpie？

magpie 不改 Grok App 的路由，因为接管路由会让它丢掉自己的登录。在 Grok App 的设置 › Account 里对 magpie 按 Use 就行。

Grok App 里能选思考强度吗？

能。每个 magpie 模型带着自己的思考强度档位，默认是你标的那一档，否则是 medium。

断开后 Grok App 会恢复原来的路由吗？

会。路由还指向 magpie 时，magpie 放回原来的路由；其他路由不动。

更多 Agent 用同样的模型：让 fx 用任意模型、让 Aside 用任意模型、让 Ante 用任意模型、让 Mister Morph 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。