Codex 桌面版 使用国内大模型系列一 | EchoBird
大家好，我是阿伟。
今天遇到一个很崩溃的事情，我的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 桌面端（最新版）仅使用 OpenAIResponses 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 桌面版使用国产大模型，点个关注，怕你走丢了。