muxlayer
muxlayer guides/use-codex-desktop-with-third-party-api-and-plugins

Codex Desktop

让 Codex Desktop 使用第三方 API 并保留插件能力

MuxLayer 把 Codex Desktop 原本基于 OpenAI 鉴权的官方模型入口,变成一个本地 MuxLayer 入口。Codex Desktop 保留它的插件和账号功能依赖的 Provider 路径,模型请求由本地接管,再路由到 DeepSeek、小米 MiMo、OpenAI、Kimi、GLM、DashScope 等上游 Provider。

为什么这件事重要

很多代理方案把 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 的作用是不去破坏那条官方路径,同时让模型请求本地可控、可追踪。

快速配置

  1. Releases 下载 MuxLayer 并打开应用。
  2. 添加至少一个 Provider,比如 DeepSeek 或小米 MiMo。
  3. 概览网关 启动网关。默认端点是 http://127.0.0.1:9090
  4. 打开 客户端,在 Codex 卡片上点 应用配置
  5. Codex Desktop 的账号保持登录状态。
  6. 在 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 配置。

相关教程