codex 连接国内大模型（例如Deepseek 和 MiMo ）

codex-bridge 零基础配置指南本文通过 codex-bridge 让 Codex CLI 连接 DeepSeek、小米 MiMo 等国内大模型。一、这是什么为什么要用1.1 问题OpenAI Codex CLI 是一个终端里的 AI 编程助手它默认只能连接 OpenAI 的模型如 GPT 系列。但很多人想用国内的模型比如DeepSeek深度求索— 性价比极高推理能力强小米 MiMo— 小米自研大模型这些模型用的是Chat Completions协议而 Codex CLI 用的是 OpenAI 的Responses API协议两者不兼容。1.2 解决方案codex-bridge是一个本地代理程序就像一个翻译官它接收 Codex CLI 发出的请求自动翻译成 DeepSeek / MiMo 能理解的格式把模型的回复翻译回 Codex CLI 能理解的格式你的电脑内部 ┌──────────┐ ┌──────────────┐ ┌────────────┐ │ Codex │ 请求 │ codex-bridge │ 请求 │ DeepSeek │ │ CLI │ ──────▶ │ (翻译官) │ ──────▶ │ / MiMo │ │ │ ◀────── │ :4000 │ ◀────── │ 服务器 │ └──────────┘ 回复 └──────────────┘ 回复 └────────────┘所有东西都在你的电脑本地运行数据不经过任何第三方。二、工作原理简单理解角色做什么Codex CLI你用的 AI 编程工具发请求给 codex-bridgecodex-bridge本地代理翻译协议转发请求DeepSeek / MiMo实际回答你问题的大模型codex-bridge 默认在localhost:4000端口运行不对外网开放。三、准备工作3.1 安装 Node.jscodex-bridge 需要 Node.js 18 或更高版本。检查是否已安装打开终端Windows 用户打开 PowerShell输入node--version如果显示v18.x.x或更高版本如v20、v24跳过下面的安装步骤。如果没有安装打开 https://nodejs.org/下载LTS长期支持版安装包双击安装一路点下一步即可安装完成后重新打开终端再执行node --version确认3.2 安装 Git检查是否已安装git--version如果没有安装打开 https://git-scm.com/下载对应系统的安装包安装完成后重新打开终端确认3.3 安装 Codex CLI如果你还没装 Codex CLInpminstall-gopenai/codex安装完成后确认codex--version3.4 获取模型 API Key你需要至少一个模型的 API Key模型获取地址Key 格式DeepSeekhttps://platform.deepseek.comsk-开头小米 MiMohttps://platform.xiaomimimo.com/#/console/api-keyssk-开头注册账号后在对应平台的「API Keys」页面创建一个新 Key复制保存好。注意API Key 只显示一次创建后请立即复制保存。如果丢失需要重新创建。四、方案一连接 DeepSeek推荐新手这是最简单的配置方式只需 5 步。4.1 第 1 步下载 codex-bridge打开终端执行gitclone https://github.com/wujfeng712-ui/codex-bridge.gitcdcodex-bridge4.2 第 2 步创建配置文件cpenv.example .env4.3 第 3 步编辑配置文件用任意文本编辑器打开.env文件推荐 VS Codecode .env# 如果你装了 VS Code或者用记事本notepad .env找到以下两行填入你的信息# 第一行生成一个代理密钥随便写一串字符也行用于 Codex 连接代理PROXY_AUTH_KEYsk-proxy-local-这里换成任意48位字符# 第二行填入你的 DeepSeek API KeyDEEPSEEK_API_KEYsk-你的DeepSeek密钥生成代理密钥的简单方法在终端执行以下命令把输出结果粘贴到PROXY_AUTH_KEY后面node-econsole.log(sk-proxy-local- require(crypto).randomBytes(24).toString(hex))最终.env文件看起来像这样PROXY_AUTH_KEYsk-proxy-local-a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6DEEPSEEK_API_KEYsk-79cda1a50053488b812c9a6f816ae148PROXY_PORT4000LOG_LEVELinfoMODEL_CATALOG_PATH./proxy-models.json保存文件。4.4 第 4 步启动 codex-bridge在终端中确保当前目录是codex-bridge执行node--env-file.env proxy.mjs如果看到类似以下输出说明启动成功[codex-bridge] Listening on http://localhost:4000 [codex-bridge] Default provider: deepseek [codex-bridge] Deepseek: https://api.deepseek.com/v1 | modelsdeepseek-v4-pro, deepseek-v4-flash重要这个终端窗口不要关闭关闭后代理就停止了。4.5 第 5 步配置 Codex CLI方法 A手动编辑配置文件编辑~/.codex/config.tomlWindows 路径C:\Users\你的用户名\.codex\config.tomlmodel deepseek-v4-flash model_provider local_proxy [model_providers.local_proxy] name local_proxy base_url http://127.0.0.1:4000/v1 wire_api responses requires_openai_auth true编辑~/.codex/auth.jsonWindows 路径C:\Users\你的用户名\.codex\auth.json{OPENAI_API_KEY:sk-proxy-local-你生成的代理密钥}注意auth.json里的OPENAI_API_KEY填的是.env中的PROXY_AUTH_KEY不是 DeepSeek 的 Key方法 B使用 CC Switch推荐见下方配合 CC Switch 使用4.6 验证打开一个新的终端窗口运行codex你应该能看到 Codex CLI 界面模型显示为deepseek-v4-flash。试着问它一个问题比如你是什么模型如果能正常回答说明配置成功五、方案二连接小米 MiMo步骤和 DeepSeek 基本一样只需修改.env文件PROXY_AUTH_KEYsk-proxy-local-你的代理密钥MIMO_API_KEYsk-你的MiMo密钥PROXY_PORT4000LOG_LEVELinfoMODEL_CATALOG_PATH./proxy-models.json注意MiMo 的模型 ID 必须全部小写如mimo-v2.5-pro。在config.toml中把模型名改为model mimo-v2.5-pro可用的 MiMo 模型模型 ID说明mimo-v2.5-proMiMo v2.5 Pro推荐mimo-v2.5MiMo v2.5六、方案三同时连接多个模型如果你想同时使用 DeepSeek 和 MiMo可以都配置上。6.1.env文件配置PROXY_AUTH_KEYsk-proxy-local-你的代理密钥# DeepSeekDEEPSEEK_API_KEYsk-你的DeepSeek密钥# MiMoMIMO_API_KEYsk-你的MiMo密钥PROXY_PORT4000LOG_LEVELinfoMODEL_CATALOG_PATH./proxy-models.json6.2 切换模型在 Codex CLI 运行时输入/model可以切换模型。或者修改config.toml中的model字段# 切换到 DeepSeek model deepseek-v4-pro # 或切换到 MiMo model mimo-v2.5-pro6.3 可用模型列表模型 ID供应商说明deepseek-v4-proDeepSeekDeepSeek V4 Pro推理能力最强deepseek-v4-flashDeepSeekDeepSeek V4 Flash速度更快mimo-v2.5-pro小米MiMo v2.5 Promimo-v2.5小米MiMo v2.5七、配合 CC Switch 使用图形界面管理CC Switch 是一个桌面应用可以通过图形界面管理 AI 模型配置不用手动编辑配置文件。7.1 安装 CC Switch前往 https://github.com/farion1231/cc-switch 下载安装。7.2 配置步骤打开 CC Switch点击Codex选项卡点击添加供应商填写以下信息字段填什么名称codex-bridge或任意你喜欢的名字API Key.env文件中的PROXY_AUTH_KEY如sk-proxy-local-a1b2c3...Base URLhttp://127.0.0.1:4000/v1点击启用CC Switch 会自动帮你写入~/.codex/auth.json和config.toml不需要手动编辑。7.3 多供应商切换如果你想用不同密钥分别路由到 DeepSeek 和 MiMo可以在.env中使用PROXY_KEYSPROXY_KEYSsk-deepseek-key:deepseek,sk-mimo-key:mimo,sk-all-key:*格式说明密钥:供应商名多个用逗号分隔。*表示可以访问任意供应商。然后在 CC Switch 中为每个密钥创建独立配置切换配置就等于切换上游模型。八、常用操作8.1 启动 codex-bridgecdcodex-bridgenode--env-file.env proxy.mjs8.2 后台运行Linux / macOSnohupnode--env-file.env proxy.mjs/tmp/codex-bridge.log218.3 后台运行Windows PowerShellStart-Process-NoNewWindow-FilePathnode-ArgumentList--env-file.env,proxy.mjs-RedirectStandardOutputcodex-bridge.log8.4 运行冒烟测试验证代理是否正常工作./scripts/smoke.sh8.5 查看代理日志代理运行时会在终端输出请求日志。如果需要更详细的日志在.env中设置LOG_LEVELdebug8.6 停止代理在运行代理的终端按Ctrl C即可停止。九、常见问题排查9.1EADDRINUSE :4000— 端口被占用原因4000 端口已被其他程序使用可能是上次的 codex-bridge 没关掉。解决方法# Windows PowerShellnetstat-ano|findstr :4000# 找到 PID 后taskkill /PIDPID/F# 或者换一个端口在 .env 中修改PROXY_PORT4001记得同步修改config.toml和 CC Switch 中的端口号。9.2401 Unauthorized— 认证失败原因Codex CLI 使用的密钥和 codex-bridge 的密钥不匹配。解决方法确认~/.codex/auth.json中的OPENAI_API_KEY与.env中的PROXY_AUTH_KEY完全一致。9.3--env-file: not recognized— Node.js 版本太低原因--env-file参数需要 Node.js 20。解决方法升级 Node.js或者用替代命令启动# Windows CMDsetPROXY_AUTH_KEY你的密钥setDEEPSEEK_API_KEY你的密钥nodeproxy.mjs# Windows PowerShell$env:PROXY_AUTH_KEY你的密钥;$env:DEEPSEEK_API_KEY你的密钥;nodeproxy.mjs9.4Model metadata not found警告原因Codex CLI 自带的模型列表里没有 DeepSeek / MiMo 的元数据。影响不影响正常使用只是一个警告。Codex 会使用默认的 fallback 配置。9.5 上游超时原因DeepSeek / MiMo 服务器响应慢。解决方法在.env中增大超时时间UPSTREAM_TIMEOUT_MS3000009.6 模型回答说自己是 OpenAI 的模型原因这是模型自身的自我认知它不知道自己是通过代理调用的。实际上你的请求确实是发给了 DeepSeek / MiMo只是模型的回答文本里会这样自称。影响无影响可以忽略。9.7 Codex CLI 连不上代理检查清单codex-bridge 是否在运行终端里有没有Listening on http://localhost:4000config.toml里的base_url是否正确防火墙是否阻止了本地连接尝试在浏览器打开http://localhost:4000/health如果显示正常说明代理没问题十、完整配置示例10.1.env文件使用 DeepSeek# codex-bridge 配置# 入站认证密钥Codex 连接代理用的PROXY_AUTH_KEYsk-proxy-local-a1b2cxxxxxxxxxxx# DeepSeek API KeyDEEPSEEK_API_KEYsk-79xxxxxxxxxxx# 代理端口PROXY_PORT4000# 日志级别LOG_LEVELinfo# 模型清单文件路径MODEL_CATALOG_PATH./proxy-models.json10.2~/.codex/config.tomlmodel deepseek-v4-flash model_provider local_proxy [model_providers.local_proxy] name local_proxy base_url http://127.0.0.1:4000/v1 wire_api responses requires_openai_auth true10.3~/.codex/auth.json{OPENAI_API_KEY:sk-proxy-local-a1b2c3xxxxxxxxxxx}十一、总结下载codex-bridge填写.env代理密钥 模型 API Key启动node --env-file.env proxy.mjs配置Codex CLI 指向http://127.0.0.1:4000/v1使用codex开始编程