首页
教程
立即安装
GitHub
English
模型与供应商

切换供应商与模型调度

支持 CLI 极速切换、系统菜单栏一键选择与 TUI 键盘导航，无损 AST 语法树改配即刻热生效。

在配置好多个模型供应商与账号之后，日常开发中最频繁的操作就是根据具体任务在不同模型之间快速切换：

  • 写复杂架构设计或高难算法时，切换到 Claude 3.5 Sonnet 或 DeepSeek R1；
  • 执行日常脚本编写、批量单元测试或常规文档生成时，切换到低成本的 DeepSeek V3 或 Kimi K2.5；
  • 遇到特定厂商接口网络波动或频控时，秒级切换至备用线路。

Magpie AI 让这种切换变得轻而易举——无需反复手动修改每个 Agent 繁琐的 .json 或 .toml 配置文件，更不需要重新启动或注销工具。

本篇指南将讲解如何通过 CLI 命令行、系统菜单栏与终端 TUI 完成高效切换，并深入剖析底层的生效机制与排错技巧。

方式一：CLI 快捷指令秒级切换（效率最高）

对于熟悉终端操作的工程师，Magpie AI 提供了极致简短的语法糖。你只需要输入 magpie <agent> <provider/model> 即可完成改配：

bash
# 将 Claude Code 切换为 DeepSeek V4 Pro
magpie claude deepseek/deepseek-v4-pro

# 将 Codex 切换为 Kimi K2.5 模型
magpie codex kimi/kimi-k2.5

# 将 OpenCode 切换为 OpenAI GPT-4o
magpie opencode openai/gpt-4o

# 将 Claude Code 绑定到高可用虚拟路由组
magpie claude group/opus-anywhere

执行后，Magpie 会在毫秒级内完成底层配置的 AST 修改，并在终端输出即时确认信息：

text
✓ Switched Claude Code to deepseek/deepseek-v4-pro (via 127.0.0.1:3425)

此时打开新的终端窗口运行 claude，你的请求就会自动流经 Magpie 本地网关，并由 DeepSeek 强力驱动。

方式二：macOS 菜单栏与系统托盘一键切换

如果你正在使用 VS Code、Cursor 或重度依赖鼠标交互，系统菜单栏是最顺手的入口：

  1. 点击 macOS 顶部菜单栏中的 Magpie 图标（或 Windows/Linux 右下角系统托盘）；
  2. 弹出的面板中会罗列出本机检测到的所有 Agent（如 Claude Code、Codex、Gemini CLI 等）；
  3. 找到目标 Agent，展开其模型下拉菜单；
  4. 点击你想启用的供应商或模型名称。

菜单栏会自动更新当前激活标记（✓），整个切换过程无需切换窗口，丝毫不打断当前的编码心流。

方式三：终端 TUI 键盘极速切换

在全屏开发或远程终端环境下，通过 magpie tui 即可享受纯键盘交互：

  1. 在终端输入 magpie tui 启动界面；
  2. 使用 Tab 键在左侧「Agents」列表中移动，用方向键或 j / k 选中目标 Agent；
  3. 按 Enter 键展开该 Agent 可用的模型与供应商清单；
  4. 移动光标至期望的模型，按下 Space（空格键）或 Enter 完成绑定；
  5. 按 q 键随时退出 TUI，配置即刻生效。

检查当前绑定状态

无论使用哪种方式切换，你都可以随时使用 magpie ls 命令快速审计所有 Agent 的实时绑定状态：

bash
magpie ls

典型输出如下：

text
AGENT          STATUS     PROVIDER / MODEL              ROUTE
Claude Code    ACTIVE     deepseek/deepseek-v4-pro      http://127.0.0.1:3425
Codex          ACTIVE     kimi/kimi-k2.5                http://127.0.0.1:3425
Gemini CLI     ACTIVE     zhipu/glm-4-plus              http://127.0.0.1:3425
OpenCode       STOCK      anthropic/claude-3-5-sonnet   direct (official)

通过这一览表，你可以清晰掌控哪款工具走本地网关、哪款工具直连官方，状态黑白分明。

底层生效机制：无损 AST 注入

许多开发者会好奇：为什么 Magpie AI 切换模型如此迅速且稳定？

  • 精准 AST 节点改写：当执行切换时，Magpie 底层的 Go 解析器会读取 Agent 的配置文件（例如 Claude Code 的 ~/.claude.json 或 Codex 的 ~/.codex/config.toml），仅对 ANTHROPIC_BASE_URL、model 或相关字段进行外科手术式替换。
  • 保留自定义配置与注释：你在配置文件中手写的环境变量、自定义忽略路径、快捷指令以及各种注释都会被 100% 完整保留，绝对不会出现其他工具覆写后导致格式错乱的问题。
  • 即时热生效：大多数现代 AI CLI 在每次执行会话循环时都会读取最新的环境变量或端点配置，因此通常无需重启编辑器即可直接发起新对话。

一键恢复：出厂设置重置（Reset）

如果某天你希望暂时离开第三方模型，完全恢复该 Agent 最原始的官方原生连接，只需执行：

bash
# 将 Claude Code 还原为官方出厂配置
magpie reset claude

# 将所有受管 Agent 一键全部还原
magpie reset --all

Magpie 会自动移除本地网关端点，将 Base URL 和模型重置为官方原厂默认值，干净利落，不留任何残留配置。

常见问题与排错指引

Q：执行切换后，终端里的 Claude Code 似乎还在调用旧模型？

A：如果你是在某个现有的终端会话内修改了配置，且该工具对环境变量进行了内存缓存，只需简单退出当前会话（输入 /exit 或关闭终端 Tab）重新打开即可；新会话会自动加载 Magpie 注入的最新网关配置。

Q：可以为同一个 Agent 的不同项目绑定不同的模型吗？

A：可以！Magpie 支持基于配置预设（Profiles）的快速切换（例如 magpie use work 与 magpie use personal），具体用法可参考 配置预设与运行模式指南。

Q：切换模型时，当前进行中的多轮对话历史会丢失吗？

A：不会丢失。Claude Code 或 Codex 的历史对话记忆存储于其本地会话文件（如会话 JSONL）中，Magpie 只负责调度后续出站请求的目标端点。模型切换后发起的新一轮交流，会完整保留此前的项目代码上下文。