文档 · 指南

让 Crush 用任意模型

Crush 是 Charm 出品的终端编程 Agent，使用配置里的供应商。magpie 把自己作为供应商加进 Crush，于是 Crush 能用你在 magpie 里的任何模型：DeepSeek、Kimi、GLM、Qwen、OpenAI Key，或 ChatGPT、Copilot 订阅，不用往 Crush 里贴 Key。

Crush 的配置是 ~/.config/crush/crush.json（设置了 $XDG_CONFIG_HOME 时在其下；Windows 上在 %LOCALAPPDATA%\crush）。magpie 在里面添加 providers.magpie，写入网关地址、一个 Crush 专用的 Key 和 magpie 的模型，并设置 Crush 使用的模型。网关把每个请求翻译给该模型的供应商，工具调用和推理都保留。WSL 里的 Crush 也一样设置，用发行版能访问到的网关地址。

接入 Crush

  1. 在 magpie 里添加供应商在 供应商 页添加 API Key，或登录一个订阅。
  2. 在 Crush 那一行选模型在 Agent 页，给 Crush 选大模型，需要的话再选小模型。
  3. 启动 crushmagpie 的模型也在 Crush 自己的模型选择器里，位于 magpie 下。
终端
magpie crush deepseek/deepseek-v4-pro     # Crush 的大模型用 DeepSeek
magpie crush small deepseek/deepseek-v4-flash
magpie crush                              # 查看 Crush 当前的模型

大模型、小模型和强度

Crush 有两个模型位：large 干主要的活，small 做轻量任务。每个位都可以是任何模型，magpie 的或你自己供应商的。这一行还能设置大模型的 reasoning_effort：low、medium 或 high。

终端
magpie crush effort high
magpie crush effort default    # 恢复 Crush 的默认

两个文件

Crush 把它自己选择器选的模型存在数据文件 ~/.local/share/crush/crush.json（设置了 $XDG_DATA_HOME 时在其下），它优先于配置文件。所以 magpie 也把选择写在那里，和 Crush 写的地方一致，供应商则留在配置文件里。magpie 选模型时，会去掉 Crush 选择器为上一个模型存的设置，比如 max_tokens，免得给一个模型的上限用到另一个模型上。你自己加到 magpie 供应商里的字段，magpie 重写模型时会保留。

切回

两个模型位都选你自己供应商的模型、把这一行从 magpie 移除，或运行 magpie crush default。两个位都不再用 magpie 的模型后，magpie 会从 crush.json 里删除它的供应商。

常见问题

Crush 能用我的 ChatGPT 订阅吗？

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

magpie 里选的和 Crush 里选的，哪个生效？

最后选的那个。两边都存进 Crush 的数据文件，所以最后一次选的模型，不论在 Crush 那一行还是 Crush 自己的选择器里，就是 Crush 用的。

Crush 的小模型是干什么的？

做主要工作之外的轻量任务。在 Crush 那一行的 small 设置，任何模型都行。

WSL 里的 Crush 能用吗？

能。magpie 也会设置 WSL 发行版里的 Crush，用发行版能访问到的网关地址。

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