Magpie

Magpie是一款本地网关工具，核心作用是为设备上每一个AI智能体单独指定使用的模型。添加各类模型服务商之后，你可以单独给每个智能体分配模型，Magpie会直接写入对应智能体自身配置文件。

它在本机启动轻量网关，地址127.0.0.1:3425，可以翻译OpenAI、Anthropic、Gemini等多家API协议，流式输出、工具调用都能正常转发。

简单来说：你可以在Claude Code上跑GPT系列模型、DeepSeek上跑Codex、用ChatGPT订阅额度驱动OpenCode，打破智能体原生绑定模型的限制。

提供商接入方式

模型来源分为四类，统一命名格式provider/model：

1. 订阅账号（免API密钥，网页登录）

支持Claude（Pro/Max/Team）、ChatGPT Plus/Pro/Business、Cursor、SuperGrok、Copilot、Devin。在Magpie内直接跳转服务商登录页，可添加多账户，一键切换。本机已登录的智能体账号，也会自动识别为提供商。

Claude订阅的请求依赖本地安装的Claude Code运行，需要保持软件存在。

2. API密钥接入

Anthropic、OpenAI、Gemini、DeepSeek、Kimi、智谱GLM、MiniMax、Qwen、Mistral、Groq、xAI等，粘贴密钥即可。Magpie自动拉取该服务商可用模型列表，支持测试连通性，也可手动开启/关闭模型。

3. 本地模型

Ollama、LM Studio，无需密钥。

4. 自定义端点

任意兼容OpenAI /v1接口或Anthropic协议的自定义地址，分别填入对应BaseURL与密钥。Magpie会根据智能体原生协议自动做转换。

导入功能：支持直接读取Claude Code settings.json、Codex config.toml，导入已有服务商配置，不会修改原有文件。

密钥保存在~/.config/magpie/providers.json，仅本机用户可读；不会读取环境变量内的密钥，仅使用你手动添加的凭证。

智能体管理

Magpie可识别本机大量代码智能体：Claude Code、Codex、Gemini CLI、OpenCode、MiMo Code、Pi、Goose、Cursor、Copilot CLI、Crush、DeepSeek Harness、Command Code、omp、Devin、Hermes Agent、Grok Build、ZCode、OpenHanako、Alma。

• 在Agents面板，点击模型即可打开选择器，支持过滤搜索，也可手动输入未列出的模型ID；
• 支持调节推理参数，例如Codex的effort、Pi的thinking等；
• Claude Code可单独为Opus、Sonnet、Haiku三层分别配置模型，默认跟随主模型；
• 选定模型后，Magpie原子化写入智能体配置文件，只修改网关相关字段，原有注释、缩进、其他配置全部保留。

重要：已经启动的会话会沿用启动时加载的模型，修改后新建会话生效；Codex需要重启应用。Paseo等前端调用CLI工具时，会读取同一套配置，一次设置全局生效。

路由组（高级能力）

适合多账户、多密钥场景，实现负载均衡、配额耗尽自动故障转移，在智能体模型选择器内显示为group/<id>。

四种路由策略

• Smart（默认）：优先选用配额余量最早刷新的账户；
• In order：顺序执行，一个账户耗尽/报错才切下一个；
• In turn：轮询分发，每轮对话切换账户，分散负载；
• Least used：优先选用剩余额度最多的账户。

会话绑定策略（Stays）

控制同一个对话持续绑定账户的时长：Auto、Session、Within a turn、Off（每次请求重新路由）。

规则引擎

可按条件自动分配模型：

• 按token长度、图片输入、推理开启状态、智能体类型、用户意图；
• 意图识别由轻量分类模型判定，仅读取用户消息，超时/识别失败则退回基础路由；
• 支持嵌套组（组内包含其他路由组），最多8层，禁止循环引用；内层组全部失败时，自动回退外层下一个备选。

终端路由组示例

magpie groups
magpie group add "Opus anywhere" models=claude/claude-opus-5-5,copilot/claude-opus-5.5 routing=order stays=session
magpie group set opus-anywhere models+=openrouter/anthropic/claude-opus-5.5
magpie group rule add opus-anywhere use=openrouter/anthropic/claude-opus-5.5 tokens=150k
magpie group rule add opus-anywhere use=copilot/claude-opus-5.5 intent="a quick question" classifier=groq/llama-3.1-8b-instant
magpie group set coder models+=group/opus-anywhere
magpie claude group/opus-anywhere

使用、统计与终端命令

• Usage面板：统计每个智能体、模型的Token、缓存命中、成本与订阅额度重置时间；不经过Magpie网关的原生调用不会统计。
• TUI终端界面：magpie tui；后台托盘运行magpie tray；仅启动网关magpie serve。

常用命令清单

magpie ls                      # 查看所有智能体当前模型配置
magpie presets                 # 查看支持的服务商列表
magpie provider add deepseek sk-…
magpie accounts add codex      # 新增Claude/ChatGPT订阅账号
magpie claude codex/gpt-5.5    # 为claude智能体设置模型
magpie codex effort high       # 设置推理参数
magpie codex default           # 恢复智能体原生配置，移除magpie接管
magpie save work · use work    # 保存/加载配置快照
magpie usage 7d                # 查看7天用量统计

FAQ重点

1. 无需手动导出OPENAI_BASE_URL、ANTHROPIC_BASE_URL，Magpie自动写入智能体配置；
2. 使用Magpie分配的模型时，网关进程必须运行，可以最小化到托盘；
3. 恢复原生模式：选择智能体自身模型，或执行magpie <agent> default，自动还原旧配置；
4. 手动修改智能体配置文件不会造成损坏，Magpie只会修改它写入的字段。