文档 · 指南

让 Ante 用任意模型

Ante 是 antigma.ai 的终端编程 Agent，命令是 ante。它自带一批供应商，你可以在 catalog.json 里再加自己的，叠在自带的上面。magpie 在里面加一个名为 magpie 的供应商，再在 settings.json 里让 Ante 从它启动，Ante 就能用 DeepSeek、GLM、Kimi、Qwen、Claude 或 ChatGPT 订阅等 magpie 里的任意模型。

接入 Ante

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Agent 页给 Ante 选模型选一个 via magpie 的模型。
  3. 重启 AnteAnte 每个进程只读一次 catalog.json，正在运行的要重启才生效。
终端
magpie ante deepseek/deepseek-v4-pro

catalog.json

文件在 ~/.ante/catalog.json；设了 ANTE_HOME 时是 $ANTE_HOME/catalog.json。providers 的键就是 --provider 接受的名字。magpie 加的条目指向网关的 /v1，wire_style 是 OpenAiCompatible，也就是 Ante 说 Chat Completions 的方式，网关的每个模型都接受它。magpie 的模型都列在 preferred_models 里，那就是 Ante 的模型选择器。

终端
// ~/.ante/catalog.json
{
  "providers": {
    "magpie": {
      "display_name": "magpie",
      "base_url": "http://127.0.0.1:3425/v1",
      "wire_style": "OpenAiCompatible",
      "preferred_models": [
        { "id": "deepseek/deepseek-v4-pro", "display_name": "…",
          "context_limit": …, "max_tokens": …, "supported_efforts": […] }
      ]
    }
  }
}

条目里没有 auth：网关只在本机监听，本机的请求不用 Key，而 Ante 把没有 auth 块的供应商当作已认证。写 bearer env_key 的话，就得往 Ante 的环境变量里放 Key，那应该由你自己决定。你在 magpie 条目里自己加的 auth、http_headers、extra_body 等都会保留，局域网共享网关或从 WSL 访问时就靠它们带 Key。你自己的供应商和 models 部分，magpie 不动。magpie 也不写 support_vision：Ante 默认认为模型能看图，写 false 会让 Ante 在请求到网关之前就把图片丢掉；而网关能先把图片描述给看不了图的模型。路由组不写思考强度，因为每轮由哪个成员回答、它支持什么，是组自己决定的。

settings.json

只在 catalog 里还不够。会话从哪个供应商开始，看 ~/.ante/settings.json 里的 provider 和 model；两者都没设时，Ante 用 catalog 顺序里第一个已认证的供应商，而自带的排在前面。所以 magpie 把这两项也写上，并记下原来的值。

终端
// ~/.ante/settings.json
{ "provider": "magpie", "model": "deepseek/deepseek-v4-pro" }

重启 Ante

Ante 每个进程只读一次 catalog，所以改动要重启 Ante 才生效。它解析得很宽松：某个条目读不出来就跳过并提示，其余照常加载，所以就算 magpie 写坏了条目，丢的也只是 magpie 的供应商，不是你的。

切回

切回时，magpie 把 Ante 原来的 provider 和 model 放回去（原来没有就留空，让 Ante 自己检测），并删掉 catalog 里 magpie 的条目；providers 删空了就一起删掉，magpie 新建的文件也删掉。接入期间你在 Ante 自己的 /providers 里选了别的，那是你的选择，会保留，不会被覆盖。

终端
magpie ante default

常见问题

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

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

为什么 magpie 的供应商在 catalog 里，Ante 却没用它？

Ante 从 settings.json 的 provider 和 model 启动，都没设时用 catalog 里第一个已认证的自带供应商。magpie 会把这两项也写上。

magpie 的条目为什么没有 API Key？

网关在本机不要 Key，Ante 也把没有 auth 的供应商当作已认证。你自己加的 auth 会保留。

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

会。原来的 provider 和 model 放回去，magpie 的条目删掉；你在 Ante 里自己改过的选择保留。

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