大家好，我是阿伟。

今天遇到一个很崩溃的事情，我的codex 无法正常使用，codex一直重连，登录chatGpt官网才知道我们公司的账号被停用了。

可是阿伟最近已经被codex的能力折服了，这下又要让我去回到claude code 和 cursor 这两颗回头草吗？不，codex，没有你我可怎么办？

我不能这样放弃，我知道codex 本身无法配置国内大模型，但是我让ima copilot 帮我整理了一份codex 桌面版接入国产模型的解决方案，他很贴心的梳理了好几个解决方案，并做了对比，其中就有我们熟知的cc switch，还有全程图形化操作的EchoBird（号称一键安装所有主流AI Agent）。

接下来，我们来看下具体增加让codex 接入国产大模型。

我们这边针对的都是windows系统描述，注意也是针对codex 桌面端，不是cli，因为cli 我们可以通过降低版本来修改配置文件解决这个问题，如果不知道这些区别，我先给大家做一个科普。

先搞清楚：桌面端 ≠ CLI

很多人把两者混为一谈，但它们的配置方式差异很大：

⌨️ Codex CLI（命令行）

• 通过 npm install 安装

• 配置文件：~/.codex/config.toml

• 可随意降级版本

• 环境变量直接生效

• 纯终端交互

🖥️ Codex Agent 桌面端（你用的）

• 独立安装包，非 npm 管理

• 配置目录：~/.codex/（共享）

• 不能随意降级

• 需额外方式注入环境变量

• GUI 界面，默认要求登录

• 支持 model_catalog.json 扩展模型列表

关键差异：桌面端不能像 CLI 那样通过 npm install @openai/codex@0.80.0 降级来绕过协议问题。因此必须使用中转工具来做协议转换。

codex桌面版为什么必须要使用中转工具来解决这个问题？

双方语言不通，需要翻译

**协议不兼容：**Codex 桌面端（最新版）仅使用 OpenAI Responses API，而国产模型只支持 Chat Completions API。直接改 config.toml 指向国产模型 API 会报错，必须通过中转站做协议转换。

问题	说明
协议不兼容	Codex 发 Responses 格式请求，国产模型只接受 Chat 格式 → 需中转站转换
认证不兼容	Codex 不会向自定义 base_url 发送 Authorization 请求头 → 需中转站注入认证
强制登录	桌面端默认弹出 OpenAI 登录窗口 → 需中转工具或特殊注入绕过
不能降级	CLI 可降级到 0.80.0 用 wire_api=“chat”，桌面端不行
base_url 可能不生效	部分版本 Codex 无视 config.toml 中的 base_url，始终直连默认端口

**结论：**让桌面端接入国内模型的核心思路 = 本地中转站（协议转换 + 认证注入）+ 配置管理

桌面端方案大比拼

方案	平台	难度	GUI	免登录	核心原理	实战验证
ccx + cc-switch	Win/Mac/Linux	中等	✅ 双GUI	✅	ccx协议转换+认证 + cc-switch配置管理	✅ 已验证
EchoBird	Win/Mac/Linux	低	✅	✅ 自动跳过	一键配置 + 自动跳过登录	✅ 已验证
codex-CN-Bridge	Win有GUI / Mac命令行	中等	✅ Win	✅	本地代理(localhost:8765) + 协议转换	✅ 已验证
CLIProxyAPI	Win/Mac/Linux	较高	❌	✅	本地代理(localhost:8317) + 多账号轮询	社区方案
model_catalog.json + 中转	全平台	较高	❌	视中转站	桌面端专用模型目录 + 环境变量	社区方案
Codex++ + EchoBird	Win	低	✅	✅	中转注入 + 免登录启动器	社区方案

阿伟会分一个系列，把所有的解决方案都实测一遍，大家根据自己情况选择适合自己的。

这一篇，我们先来把echoBird搞清楚

echoBird是什么？

进入官网：https://echobird.ai/ 看到echoBird的主页，就知道这个是我们国内大神的杰作。而且，这个logo让我想起了年轻时候的那只蓝鸟（迅雷），那可以是我的青春呀！

主页介绍了作者开发这款**Agent管理工具（注意我用的是管理工具，不是中转工具来称呼他）**的初衷。而且，在github 进发布三周，已经有了1.1k star https://github.com/edison7009/EchoBird。滑动页面，我们可以更了解echoBird。

他的界面也是那种简约大方的布局，也支持技术深色主题和浅色主题。

echoBird 号称三个“一键”，搞定整个AI Agent 工作流

他可以支持你已经在用的大多数Agent 与 AI编程助手

echoBird支持在Model Nexus 链接所有主流的模型

我们已经了解了echoBird 是一个什么工具了，废话不多说，快来跟着阿伟来安装这款Agent 管理工具。

5分钟跑通你的第一个Agent

滑到页面底部，我们就能看到echoBird的下载链接，我们这边以windows 系统为例进行演示，别问为什么不用Mac，问就是，阿伟“不配”！

下载安装包

最新安装包是6小时前发布的v5.0.4, 这次主要更新可以看下面截图，另外提醒大家，使用echoBird 不要用其他魔改工具启动Codex。否则会有一些无法预想到的问题，这点作者也做了申明。

这里我们直接下载windows的安装包，只有10 Mb左右大小，很轻量的，如果你对他的代码感兴趣，可以下载Source code来研究。

下载完成后，双击安装包进行安装。 这时候，windows如果弹出以下提示框，不要慌，我们点击仍要运行。就进入echoBird的安装界面。

安装软件-无脑next

直接无脑点击next安装就行，如果你要改安装目录，可以在第二步进行更改。这种基操，阿伟就不赘述了。

安装完成

如你所见，安装完成就是AI 资讯界面，echoBird 很贴心的帮你推送了每日的试试AI资讯，你不用到处翻网页来找了。这个小功能 我很喜欢。

这不是咱们今天的重点，你有时间可以慢慢了解echoBird给你带来的惊喜，接下来我们按照步骤来让你你的codex 接入国产大模型。

接入国产模型

先进入模型中心界面，配置你要接入的国产大模型，echoBird 已经内置了国内主流大模型的供应商，你也可以通过添加模型来配置。

我这边配置的glm-5.1，国内目前最强的编程模型之一。

配置完成后，你可以测试下模型连通性，点击右上角的测试速度即可。如果延迟是毫秒级的，说明连通性正常，我们就可以配置codex了。

进入应用管理界面–>选择 Codex 桌面版–> 勾选刚配置的GLM 模型–> 点击启用应用。

如果你已经打开codex，请退出

一个小插曲：

我配置的glm-5.1 模型明明有余额，但是codex 显示余额不足，于是我在issue中找到相同的问题。

作者回复，目前glm 模型有兼容问题，所以大家不要codex 不要使用glm系列模型，可以改用miniMax 和deepseek v4.

我换成miniMax 测试。模型配置还是在 模型中心 配置，然后再到 应用管理进行模型绑定，启用应用后，记得不要关闭echoBird（不要关闭echoBird，不要关闭echoBird，重要的事说三遍），启用之后，我们先测试下对话，这次，他终于回复了。

不要看codex的模型还是openAI的ChatGPT，但是你看了echoBird的执行日志，你会发现，不管你选择什么模型，他都会转成，你配置的国内模型。

我们可以看到，codex 接入echoBird，仍然是完全态。插件和skills 都能正常安装。

这下我又可以开心的使用codex了。好了，我要继续搬砖了，你们如果在使用过程中遇到任何问题，可以https://github.com/edison7009/EchoBird/issues 把这个地址给codex，让他自己排查提供方案。

下期我们用cc switch 来实操如何让codex 桌面版使用国产大模型，点个关注，怕你走丢了。