文档 · 指南

让 Copilot CLI 用任意模型

GitHub Copilot CLI 可以使用你自己的模型供应商（自带 Key，BYOK），这不需要登录 GitHub。magpie 把自己作为一个供应商加进 Copilot CLI，于是 copilot 能用你在 magpie 里的任何模型：DeepSeek、Kimi、GLM、Qwen、OpenAI Key，或 ChatGPT 订阅，不用往 Copilot 里贴 Key。

Copilot CLI 的目录是 ~/.copilot（或 $COPILOT_HOME），它自己的供应商在其中的 providers.json（或 $COPILOT_PROVIDERS_CONFIG）。magpie 在这个文件里添加一个名为 magpie 的 OpenAI 兼容供应商，写入网关地址和一个 Copilot 专用的 Key，并在旁边加上 magpie 的模型，每个都带名称、上下文窗口和输出上限。然后把 settings.json 的 model 设为 magpie/<模型>。网关把每个请求翻译给该模型的供应商，工具调用和推理都保留。

接入 Copilot CLI

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Copilot CLI 那一行选模型在 Agent 页，选 magpie 下的一个模型。
  3. 启动 copilot它就用这个模型运行。Copilot 自己的 /model 里也列出 magpie 的模型。
终端
magpie copilot deepseek/deepseek-v4-pro    # settings.json 里是 magpie/deepseek/deepseek-v4-pro
magpie copilot                             # 查看 Copilot CLI 当前的模型

这一行也列出 Copilot 自己的模型和 auto（由 Copilot 自己选），想用回 GitHub 的模型时选它们。

推理强度

这一行可以设置 effortLevel，Copilot 把它存在模型旁边：可选的档位来自模型本身，Copilot 的列表没写时是 low、medium、high 和 xhigh。Copilot 自己的 /model 换模型时会清掉它。

终端
magpie copilot effort high
magpie copilot effort default

你的 providers.json

magpie 只管名为 magpie 的供应商和指向它的模型。你的其他供应商、它们的模型和文件里的其他字段都原样保留，你自己加到 magpie 供应商里的字段也保留。不是合法 JSON 的 providers.json 会被原样留下，绝不覆盖。magpie 的模型有变化时，magpie 会更新它那几项，只有内容真的变化才写文件。

切回

在这一行选 Copilot 自己的模型，或运行 magpie copilot default。这会删掉 settings.json 里的 model，并从 providers.json 中移除 magpie 的供应商和模型，其余内容不动。

常见问题

需要 GitHub Copilot 订阅吗？

不需要。Copilot CLI 自带的供应商功能不需要登录 GitHub，所以没有 Copilot 套餐也能用 magpie 的模型。

Copilot CLI 能用我的 ChatGPT 订阅吗？

能。在 magpie 里登录 ChatGPT，在 Copilot CLI 那一行选 magpie 下的一个 GPT 模型。Copilot 把请求发给 magpie，由 magpie 使用订阅。

为什么 settings.json 里写的是 magpie/deepseek/…？

Copilot 用「供应商/模型」来指一个供应商的模型，而 magpie 的供应商就叫 magpie。在命令行里可以省略 magpie/。

我自己的 BYOK 供应商还能保留吗？

能。magpie 只改 providers.json 里它自己的供应商和模型，你的原样保留。

更多 Agent 用同样的模型：OpenCode 接入其他模型、Claude Code 接入其他模型、让 Raycast 用任意模型。遇到报错？见 常见错误排查，或到 Discord 提问。