为什么这件事重要
很多代理方案把 Codex 当成普通的 OpenAI 兼容客户端来处理。这样做普通对话够用,但 Codex Desktop 里那些依赖官方 OpenAI Provider 形态、登录态、账号能力的部分可能会失效。
MuxLayer 走的是另一条路:保留客户端看起来像官方的入口,把实际的模型入口搬到本地。
Codex Desktop
-> Codex 配置里的 OpenAI Provider 入口
-> 本地 MuxLayer base URL
-> DeepSeek / 小米 MiMo / OpenAI / Kimi / GLM / DashScope / 其他 Provider
Codex Desktop 看到的还是一个 OpenAI 风格的 Provider 入口,但模型请求被 MuxLayer 在本地接住,再路由到你选的上游。
什么能继续用
| 方面 | MuxLayer 保留了什么 |
|---|---|
| Codex Desktop 登录 | 保留官方 auth.json 里的账号 token,不用本地 API Key 覆盖它。 |
| 插件和账号功能 | 保留 Codex Desktop 走 OpenAI 鉴权的 Provider 路径,插件和账号功能依赖的就是这条路径。 |
| 本地模型入口 | 模型请求先经过 MuxLayer,再转换或直连到 DeepSeek、MiMo、OpenAI、Kimi、GLM、DashScope 或其他配置的 Provider。 |
| 一键还原 | 保存原 Codex 配置的快照,可以从 MuxLayer 界面一键切回官方。 |
插件能不能用还取决于 Codex Desktop、你登录的账号、以及上游功能本身。MuxLayer 的作用是不去破坏那条官方路径,同时让模型请求本地可控、可追踪。
快速配置
- 从 Releases 下载 MuxLayer 并打开应用。
- 添加至少一个 Provider,比如 DeepSeek 或小米 MiMo。
- 在 概览 或 网关 启动网关。默认端点是
http://127.0.0.1:9090。 - 打开 客户端,在 Codex 卡片上点 应用配置。
- Codex Desktop 的账号保持登录状态。
- 在 Codex Desktop 里发一条消息,看 MuxLayer 的请求日志确认选用的 Provider。
工作原理
MuxLayer 的做法是:
- Codex 配置里仍然使用 OpenAI Provider 入口。
base_url指向本地 MuxLayer 网关。auth.json里的 ChatGPT / OpenAI 登录态保留,不被本地 token 覆盖。- 本地访问 token 放在 Codex 配置里,由 MuxLayer 网关校验。
- 真正的模型请求由 MuxLayer 路由到 DeepSeek、小米 MiMo 或其他 Provider。
结果是:Codex Desktop 可以继续保持它熟悉的官方 Provider 语义,同时你可以在 MuxLayer 里切换第三方 API。
跟普通代理的区别
| 普通代理 | MuxLayer |
|---|---|
| 通常把 Codex 当成普通 OpenAI 兼容客户端。 | 保留 Codex Desktop 的 OpenAI Provider 路径,只改本地 base URL。 |
| 可能要把 auth 替换成代理的 API Key。 | 保留官方账号 token,本地网关 token 放在配置里。 |
| 通常只针对一个 Provider。 | 支持 Route Profile、故障转移、模型映射和多 Provider。 |
| 切回官方常常要手动改。 | 一键切回官方 Codex 配置。 |