Magpie 教程(2026):把 Codex 订阅接进 Claude Code
这篇文章做什么: 用开源工具 magpie 把 Codex 订阅里的模型接进 Claude Code,不用自己折腾反代,很方便。全程 Windows 实操,四步走完,最后说明怎么换回去。
magpie 是一个开源项目(GitHub yetone/magpie,MIT 协议,官网 usemagpie.ai,文档 usemagpie.ai/docs),由一个面板和一个本地网关组成。面板列出本机装了哪些 AI agent,每个 agent 一行,显示当前模型和接入状态;点开模型下拉框就能换。所有请求统一先到本机 127.0.0.1:3425 的网关,由 magpie 翻译成目标供应商的协议再发出去。
这篇用到它两件事:读本机 Codex 的 ChatGPT 登录,把这个订阅的模型指给 Claude Code。

📚 本文目录(点击跳转)
- 开始之前:三个前提
- 第一步:下载并安装 magpie
- 第二步:确认 magpie 读到了 Codex 登录
- 第三步:在 Agent 页把 Claude Code 切到 Codex 模型
- 第四步:验证是否切换成功
- 进阶:用命令行切换模型
- 进阶:多个账号与路由组
- 想换回去怎么办
- 排错
- 常见问题 FAQ
- 相关教程
- 总结
开始之前:三个前提
- 一个 ChatGPT(Codex)订阅,并且本机登录过 Codex。 magpie 读的是 Codex 自己的登录文件,Windows 上是
C:/Users/<用户名>/.codex/auth.json,macOS / Linux 上是~/.codex/auth.json。没登录过的话,先在 Codex 里登录一次。还没开通订阅的,可以参考 Codex 使用教程。 - 本机装好 Claude Code。 没有的话执行
npm install -g @anthropic-ai/claude-code,需要先有 Node.js 环境。 - Windows 10 / 11。 macOS 和 Linux 也支持,本文以 Windows 为例。写作时的最新版是 v0.1.3225(2026-11-07),装好之后会自动更新,不用手动升级。
第一步:下载并安装 magpie
打开 usemagpie.ai,点页面上的「下载 Windows 版」,或者到 yetone/magpie-releases 的 Releases 页面手动下:
magpie-windows-amd64.exe:带界面的版本,托盘图标 + 窗口magpie-cli-windows-arm64.exe/magpie-cli-windows-amd64.exe:只有命令行的版本,后面进阶那节会用到

Windows 版目前没有代码签名,第一次运行可能会被 SmartScreen 拦一下,点「更多信息」→「仍要运行」即可。
运行起来以后,托盘里会有一个 magpie 图标,点开就是一个面板。本地网关跟着 magpie 进程走:magpie 退出,网关就没了,接在上面的 agent 也就断了。所以日常用的时候让它留在托盘里即可。
第二步:确认 magpie 读到了 Codex 登录
打开左侧的 模型 → 供应商 页。如果本机 Codex 已经登录过,列表里会多出一行 Codex,标着「已登录 <账号>」,右边是订阅档位(截图里是 ChatGPT Go)。magpie 直接读 Codex 的登录文件,需要续期时也由它去刷新 token,你不用再复制任何东西。

没看到这一行,按顺序查两件事:
- 本机 Codex 是不是真的登录过。在终端里跑一次
codex login再回来看。 - 登录文件在不在默认位置。用了自定义配置目录的话,用供应商页底部的「导入本地配置」手动导入
auth.json。
到这一步,Codex 订阅就是一个可用的供应商了。
第三步:在 Agent 页把 Claude Code 切到 Codex 模型
回到 使用 → Agent 页。每个 agent 一行,Claude Code 那一行的「详情」里写着它管的配置文件:Windows 上是 C:\Users\<用户名>\.claude\settings.json。
打开 Claude Code 那一行的开关,表示接入。下面会出现一个模型下拉框,点开它,输入 codex/ 过滤,选一个即可,截图里选的是 gpt-6-luna。你的订阅能开哪些模型,列表里就有什么,以实际显示的为准。

选完以后,magpie 只改 settings.json 里的 provider 和 model 两个键,文件里的注释、顺序和格式都不动。
除了主模型,Claude Code 还有一组档位:Opus、Sonnet、Haiku、Fable、子代理、自动模式。每一档可以单独选模型,也能单独设推理强度(截图里设的是「最高」)。这些档位在 Claude Code 里用 /model 切换,不单独设就跟着主模型走。

第四步:验证是否切换成功
改完直接生效,不用重开会话。确认看三处,任选一处:

- magpie 的 Agent 页里,Claude Code 那行显示的模型变了
- magpie 的 观测 → 用量 里出现刚才这一轮的请求,能看到走的是哪个供应商和模型
- 直接在 Claude Code 里问一句它当前是什么模型(截图里它回答「我是 Codex,基于 GPT-6 Luna」)
能正常回话就说明接上了。没通的话,看下面的排错表。
进阶:用命令行切换模型
不想点界面的话,magpie 的命令行能做同样的事。Windows 上需要下 magpie-cli-windows-amd64.exe 那个版本:
magpie ls # 列出本机每个 agent 和它当前的设置
magpie claude codex/gpt-6-luna # 把 Claude Code 切到 Codex 的某个模型
magpie sync # 刷新一遍模型列表装好以后想让 Claude Code 和 Codex 用同一份订阅也没问题,两个 agent 各指各的模型,互不影响。
进阶:多个账号与路由组
magpie 的第二个用处是管额度。同一个订阅可以加多个账号,一个额度用完,请求自动落到下一个账号上,agent 那边看不到报错。
如果连模型都不同,可以用路由组把几个模型当成一个来用:
magpie group add "daily" models=codex/gpt-6-luna,claude/claude-sonnet-5 routing=smart然后把 Claude Code 指到这个组上(group/daily),组里的成员按 smart 策略轮流承担请求。
模型 → 路由 页能看到实时走向:哪个 agent 的请求、经过哪个账号、额度多少天后重置,底下还有请求 / 改道 / 错误三个计数。
只有一个账号、也没有加第二个供应商的时候,没有可切换的对象,额度用完的报错会原样抛给 Claude Code。

想换回去怎么办
三条路,按需要选:
- 换成别的模型:在 Agent 页把 Claude Code 的模型点回
claude/开头的那个,或者换成任何你加过的 provider 的模型。 - 撤销这个 agent 的配置:把 Claude Code 那一行的接入开关关掉(Disconnect),magpie 会把
settings.json按原样写回去。 - 卸载之前:先关掉接入开关,再卸载程序,避免
settings.json里留着指向本机网关的配置。
之前用 CC Switch + CLIProxyAPI 那套接过 Claude Code 的,建议先在 CC Switch 里切回官方配置,再让 magpie 接管,两个工具同时改一个文件容易互相覆盖。
排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 托盘里没有 magpie,Claude Code 连不上 | magpie 没在运行,网关跟着进程走 | 重新打开 magpie,让它留在托盘里 |
| 供应商页里没有 Codex | 本机 Codex 没登录,或登录文件不在默认位置 | 先跑一次 codex login;或用「导入本地配置」导入 auth.json |
列表里没有 codex/ 开头的模型 | 订阅登录过期,或模型列表没刷新 | 重新登录 Codex,再点 magpie sync 刷新列表 |
| 请求报额度不足 / 被拒绝 | 订阅额度用完,单个账号没有可切换的对象 | 等额度重置,或在同一个订阅里再加一个账号 |
| 安装时被系统拦住 | Windows 构建还没有代码签名 | 点「更多信息」→「仍要运行」 |
常见问题 FAQ
用 magpie 把 Codex 接进 Claude Code,需要 API Key 吗?
需要装 CC Switch 吗?
切换以后怎么确认 Claude Code 真的在用 Codex 模型?
模型名要填什么?
我用的是 Claude 订阅,切到 Codex 以后还能切回去吗?
订阅额度用完了会怎样?
相关教程
- CC Switch 接入 Claude Code 教程 — 另一套改 Claude Code 配置的方案,可以和 magpie 对比着看
- CLIProxyAPI:把 Codex 会员转成 API Key — 想把订阅变成一把通用 API Key 的走这篇
- Codex 使用教程 — 先把订阅用起来,再来接 Claude Code
- ChatGPT Plus 和 Pro 的区别 — 确认你的订阅里能开哪些模型
总结
Codex 订阅 → magpie 网关 → Claude Code,这条链就三步。最容易忘的是 magpie 得一直开着,关掉网关就没了。
