官方原文 · 截至 2026-11-10

CC Switch 迁移到 magpie:导入范围与 Codex 旧会话(2026 年 11 月)

截至 2026-11-10,magpie 的 README 写明:Import 能从 CC Switch、Claude Code、Codex 和 Alma 导入服务商。迁移步骤是:安装 magpie,在 Providers 里点 Add provider 再点 Import…,勾选要带过来的服务商,然后在 Agents 页给 Claude Code、Codex 选模型。Codex 旧会话看不到时,用 magpie「会话 → Codex」里的「迁移到 magpie…」。magpie 作者 2026-11-09 在 X 上说,CC Switch 的配置可以一键导入,两个并用也行。已在 CC Switch 里配过 QCode 的,导入后核对 anthropic、chat、responses 三个地址即可。

更新于 2026-11-10

把这个工具接到 QCode 端点:一把 key 调 Claude、GPT 与国产模型。

#CC Switch 迁移到 magpie#导入范围#Codex 旧会话#两个能否并用

官方来源里的四条事实

Import

导入来源包括 CC Switch

magpie 的 README:Import 能导入 CC Switch、Claude Code、Codex 和 Alma 里的服务商。打开 Providers 页时,magpie 也会检查这几个应用里能导入的本地配置,你确认选择之前不会添加任何东西。

issue #887

Codex 旧会话可以手动迁移

从 CC Switch 换过来后 Codex 旧会话看不到,是 issue #887 反馈的问题。magpie 作者 2026-10-05 答复:v0.1.999 起,「会话 → Codex」里可以把这些会话手动迁移到 magpie,只改会话的服务商标记,消息、会话 ID、标题和归档状态都不动。该 issue 于 2026-10-14 以 completed 关闭。

v4.0.28

CC Switch 的 Codex 会话分组变化

CC Switch v4.0.28(2026-11-08)说明:Codex 桌面版 26.1103、CLI 0.167 起,官方订阅和第三方服务商的会话彻底分开;可改用路由或聚合模式,或打开「统一 Codex 会话历史」。

并用

作者:两个并用也行

magpie 作者 yetone 2026-11-09 在 X 上回复:CC Switch 的配置可以一键导入,两个并用也行,试试再决定。他说两者的区别在请求走哪:CC Switch 主要改各 agent 的配置,magpie 是本机一个网关,所有 agent 都连它。

CC Switch 迁移到 magpie 要做什么?

截至 2026-11-10,迁移主要做四件事:安装 magpie,用 Import… 把 CC Switch 里的服务商导入,给每个客户端选模型,再处理 Codex 旧会话。导入的是服务商配置,而且是副本:magpie 文档说,之后在原应用里改设置不会再同步过来。选好模型后,magpie 把模型写进各客户端自己的配置文件:Claude Code 连的是本机网关 127.0.0.1:3425,Codex 的 config.toml 里多一张 [model_providers.magpie] 表。新开的会话才用新设置,magpie 的网关也要保持运行。Codex 旧会话的处理见下文。

2026-11-08:CC Switch v4.0.28 适配 Codex 新的会话分组

CC Switch v4.0.28 于 2026-11-08 发布,release notes 说明主要应对 Codex 11 月 8 日的不兼容更新。其中写道:Codex 按服务商标识记录会话,官方订阅记在内置的 openai 下,CC Switch 写入的第三方服务商记在 custom 下;新版 Codex 只能继续与当前服务商同一组的会话,另一组只读,继续时提示「模型提供商不匹配」。magpie 这边,「会话」页也会提示有几个 Codex 会话是用其他服务商(例如 custom)创建的、在 Codex 的历史列表里看不到,并给出迁移按钮(见下文)。

时间线

2026-10-05

magpie issue #887:通过 CC Switch 用过的 Codex 旧会话,接入 magpie 后在 Codex 历史里看不到,提出者建议在「会话 → Codex」加手动迁移。作者当天答复已做进新版本。

2026-11-08

CC Switch v4.0.28 发布,适配新版 Codex 的会话分组。

2026-11-09

magpie 作者在 X 上说明两者的区别,并说 CC Switch 的配置可以一键导入,两个并用也行。

官方写明了什么,还有什么没说清

官方文档写明的

① README:Import 从 CC Switch、Claude Code、Codex 和 Alma 带入服务商。② 参考文档:打开 Providers 页时,magpie 会检查 Alma、CC Switch、Claude Code 和 Codex 里能导入的本地配置,确认选择之前不会添加任何东西;在原应用里被关掉的服务商,以及 ID 冲突无法并入的条目,不进自动提示,仍可手动导入。③ 导入进来的服务商是副本,之后在原应用里改设置不会再同步。④ 选好模型后,magpie 把模型写进各客户端自己的配置文件,只改它需要的键:Claude Code 是 ~/.claude/settings.json 里的 ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN 和 env 块里的模型变量,Codex 是 ~/.codex/config.toml 里的 [model_providers.magpie] 表。⑤ 运行中的会话沿用启动时的模型,下一个会话才用新设置,Codex 还要重启应用。⑥ 想退回去,运行 magpie claude default 和 magpie codex default,magpie 会移除它写入的内容,并还原被替换的值,例如你原来的 ANTHROPIC_BASE_URL。⑦ 卸载用官方命令 curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall,magpie 会先断开每个客户端并还原;设置和服务商记录留在 ~/.config/magpie,加 --purge 才删除。

官方文档没说清的

截至 2026-11-10:① magpie 的 README 和文档只写 Import 带入服务商,没有逐项说明 CC Switch 来源包含哪些字段,也没说 CC Switch 里的故障转移队列、路由或聚合模式设置、MCP、Skills、Prompts 会不会带过来;迁移前先在 CC Switch 里确认这些你还要不要,导入后在 magpie 里逐项查看。② 两个工具并用时,官方没有给出完整的配置步骤,作者只说并用也行、试试再决定。③ 作者 2026-10-05 在 issue #887 的答复里写明,这个版本当时还没在真实的 CC Switch 历史上跑过,测试用的是构造出来的 Codex 目录;该 issue 2026-10-14 关闭时写明发版后没有新的反馈,作者也请更新后仍有问题的人直接在该 issue 里回复。magpie 的 README、文档和参考文档里没有提到 Codex 26.1103 的会话分组变化。

迁移前后的分工

CC Switch(迁移前)

README:切换时只替换端点、Key 和模型这些连接信息,你自己加的插件、hooks、MCP 和注释保持原样;Direct 模式让工具直连服务商,Routing 经本机转发请求,另有 Aggregation 模式。

magpie(迁移后)

README:本机网关 127.0.0.1:3425 支持 OpenAI Chat、OpenAI Responses、Anthropic Messages 和 Gemini 四种格式,并在它们之间转换;客户端连网关,Key 存在 magpie 的 ~/.config/magpie/providers.json 里。

CC Switch 迁移到 magpie 的步骤

① 安装:运行 curl -fsSL https://usemagpie.ai/install.sh | sh,或到 usemagpie.ai 下载应用。② 打开 Providers,点 Add provider,再点顶部的 Import…,勾选要带过来的服务商并确认;Providers 页也可能出现「Import local configurations」链接,同样确认后才会添加。③ 导入后打开 QCode 那一项核对三个地址:anthropic 填 https://api.qcode.cc/api,chat 填 https://api.qcode.cc/openai/v1,responses 填 https://api.qcode.cc/openai,缺哪项补哪项;没有 Key 时运行 magpie provider key qcode cr_xxx(qcode 是这一项在 magpie 里的 id,以 magpie providers 列出的为准)。④ 给客户端选模型,例如 magpie claude qcode/claude-sonnet-5-5 和 magpie codex qcode/gpt-6.1-sol,然后新开会话,Codex 要重启应用。⑤ Codex 旧会话看不到时,到「会话 → Codex」(英文界面 Sessions → Codex),点列表顶部提示里的「迁移到 magpie…」(英文界面 Move to magpie…),在预览里确认;迁移后的提示条上有「撤销」。⑥ 保持 magpie 网关运行;想退回原来的配置,就运行 magpie claude default 和 magpie codex default。

迁移后用 QCode 的 Key

截至 2026-11-10,一把 QCode Key 同时提供 Anthropic 与 OpenAI 两种兼容接口,按 token 计费,各模型单价见 /models。在 magpie 里的三项是:anthropic 填 https://api.qcode.cc/api(Claude 型号走这里,国产型号也能走),chat 填 https://api.qcode.cc/openai/v1(GPT 与国产型号),responses 填 https://api.qcode.cc/openai(GPT)。三步开始:① 注册并充值(支付宝、微信支付、信用卡、加密货币等);② 复制以 cr_ 开头的 API Key;③ 在 CC Switch 里配过 QCode 的,导入后核对上面三项,也可以在 QCode 控制台点「导入到 magpie」,magpie 里已有 QCode 时再导入不会替换原来的 Key。完整步骤见 QCode 文档 https://docs.qcode.cc/docs/ide/magpie。不想包月?按量包 ¥26 起买一笔额度,7 天内用完为止;已有个人套餐的用户额度不够时买加油包。详见 /pay-as-you-go。

常见问题

magpie 能一键导入 CC Switch 的配置吗?

能导入服务商配置。magpie 的 README 写明,Import 能从 CC Switch、Claude Code、Codex 和 Alma 带入服务商;在 Providers 的 Add provider → Import… 里勾选并确认后才会添加。导入进来的是副本,之后在原应用里改设置不会再同步。作者 2026-11-09 在 X 上也说,CC Switch 的配置可以一键导入。

换到 magpie 后 Codex 历史会话不见了怎么办?

到 magpie 的「会话 → Codex」,点列表顶部提示里的「迁移到 magpie…」,在预览里确认即可(v0.1.999 起提供)。issue #887 的提出者描述:以前通过 CC Switch 用 Codex,旧会话记的 model_provider 是 custom;接入 magpie 后 Codex 当前的服务商是 magpie,默认历史列表会过滤旧服务商的会话,所以看起来历史没了,但会话文件仍在。作者 2026-10-05 答复:确认后只改会话文件和 state_*.sqlite 里 threads 表的服务商标记,迁移前先备份到 magpie 的回收站目录,提示条上有撤销,最近一分钟内还在写入的会话会跳过,也不会自动迁移。

magpie 和 CC Switch 可以同时装吗?

可以。magpie 作者 2026-11-09 在 X 上的原话是「两个并用也行,试试再决定」。两个工具的官方说法分别是:CC Switch 的 README 写的是,切换时只替换各工具配置里的端点、Key 和模型这些连接信息;magpie 的 README 和文档写的是,客户端连本机网关 127.0.0.1:3425,你选好的模型由 magpie 写进客户端自己的配置文件。

迁移后想换回 CC Switch 怎么办?

先运行 magpie claude default 和 magpie codex default:magpie 会移除它写入的内容,并还原被替换的值,例如你原来的 ANTHROPIC_BASE_URL。然后在 CC Switch 里重新选一次服务商并切换。要卸载 magpie,运行 curl -fsSL https://usemagpie.ai/install.sh | sh -s -- --uninstall,它会先断开每个客户端并还原;设置留在 ~/.config/magpie,加 --purge 才删除。magpie 的参考文档说,[model_providers.magpie] 表会留在 Codex 的 config.toml 里,让在 magpie 下开过的会话仍能打开。

迁移后 QCode 的 key 要重新填吗?

先看导入后的 QCode 那一项有没有 Key。magpie 把 Key 存在 ~/.config/magpie/providers.json,只有你自己能读;文档没有逐字段说明 CC Switch 来源会带过来哪些内容。没有 Key 时,运行 magpie provider key qcode 加上你的 cr_ 开头的 Key,或在 QCode 控制台点「导入到 magpie」。magpie 里已有 QCode 时,控制台再导入不会替换原来的 Key,换 Key 请用上面的命令。别忘了核对三个地址:anthropic https://api.qcode.cc/api,chat https://api.qcode.cc/openai/v1,responses https://api.qcode.cc/openai。

只是切换服务商,有必要换吗?

不一定。magpie 自己的对比页写道:主要靠手动给每个工具切换服务商、希望配置尽量保持原样时,CC Switch 更合适;同时用好几个客户端、想让每个客户端用不同模型时,magpie 更合适。作者也说两个并用也行,试试再决定。两款工具的取舍见站内「magpie 和 CC Switch 怎么选」一页。

资料来源

magpie:GitHub 仓库 yetone/magpie 的 README、docs/reference.md 和会话页界面文字(internal/gui/assets/plugins/sessions/i18n.js),usemagpie.ai 的 Get started、Add to magpie 和对比页,issue #887 及其评论(GitHub API),均于 2026-11-10 读取。CC Switch:GitHub 仓库 farion1231/cc-switch 的 README,v4.0.28 的 release notes(中文、英文与日文)。magpie 作者 yetone 2026-11-09 在 X 上的回复,经 fxtwitter 存档。QCode:qcode.cc/models、qcode.cc/pricing,以及 docs.qcode.cc 的 magpie 与接入端点页,2026-11-10 抓取。

在 magpie 里用一把 QCode Key 跑 Claude Code 和 Codex

填好 anthropic、chat、responses 三个地址,Claude、GPT 与国产型号都走同一把 Key;按 token 计费,各模型单价见 /models。

不确定从哪开始?

先试一周

小包 ¥26($30 额度,7 天)

每天都用

体验版 ¥63/月,每天 $5 额度;每 $1 额度只要 ¥0.42,中包约 ¥0.79