Skip to content

CodexBridger 1.1.0

Choose a tag to compare

@panando panando released this 07 Oct 04:45
· 5 commits to main since this release

把第三方模型提供商接进 ChatGPT / Codex 的 macOS 配置管理工具。

在界面里填好提供商地址、API Key 和模型列表,点「启用」就会写入 ChatGPT 实际读取的三个文件,不需要手动编辑配置,也不用自己记着备份。

这一版新增

1. 改完模型参数,保存就会生效

以前会遇到这样一件事:在界面里改完一个提供商(正是 ChatGPT 当前在用的那个)的模型参数、点了「保存」,但 ChatGPT 实际读取的模型参数文件没有被更新。

原因不是「保存漏了一步」,而是唯一会写那个文件的动作是「启用」,而「启用」按钮对当前正在使用的提供商是灰的 —— 于是那条路被关死了。

这一版:

  • 点「保存」时,如果这个提供商正是 ChatGPT 在用的,模型参数文件会一起重写;
  • 「启用」按钮对当前在用的提供商不再变灰,文案改为**「更新配置」**,可以随时手动重写一次(改了地址或密钥时用它);
  • 参数文件写失败不会让你的编辑丢失,但会明确提示「模型参数文件没更新」,而且这条提示不会自动消失。

2. 可以直接从模型参数文件导入模型

不用再一个一个手敲:

  • 「模型配置」区块标题行新增**「从文件导入」;「新建提供商」里也新增一项「从模型参数文件导入」**;
  • 来源两种:系统文件选择器,或直接列出本机 ~/.codex/model-catalogs/ 里已有的文件(带模型数量和体积);
  • 导入前给一份勾选清单,默认一个都不勾;
  • 同名的模型会被文件里的参数覆盖,并标出「已存在 · 会覆盖」。

说明:模型参数文件里只有模型清单,没有地址和密钥。所以「从文件新建提供商」只帮你把模型列表填好,地址与密钥仍需自己填。

下载

  • CodexBridger-1.1.0.dmg — 推荐。打开后把 CodexBridger 拖进「应用程序」。
  • CodexBridger-1.1.0.zip — 压缩包版本。

两个都同时支持 Apple 芯片和 Intel(arm64 + x86_64)。

⚠️ 首次打开会被系统拦下

本版本使用临时签名,没有 Apple 开发者证书,也没有公证。macOS 可能提示:

"CodexBridger"已损坏,无法打开。你应该将它移到废纸篓。

这不代表软件真的损坏了,是 macOS 给「从网上下载、又没经过公证」的 App 打上了隔离标记。

方法一(推荐,不用命令行):先双击一次 → 打开系统设置 → 隐私与安全性 → 在「安全性」里点仍要打开。

方法二:把 App 拖进「应用程序」文件夹,然后在「终端」执行:

sudo xattr -dr com.apple.quarantine /Applications/CodexBridger.app

输入密码时终端不显示字符是正常的。

它做什么

写入 ChatGPT 实际读取的三个文件:

文件 位置
config.toml ~/.codex/config.toml
auth.json ~/.codex/auth.json
<提供商>-model-catalog.json ~/.codex/model-catalogs/
  • 支持多个提供商共存、随时切换;每个提供商可配多个模型,逐模型设置上下文窗口、推理强度等。
  • 内置 DeepSeek、Moonshot 月之暗面、MiniMax、智谱 GLM、OpenRouter 预设,也可完全自定义。
  • 三种认证方式(Bearer Token / 环境变量 / 登录命令)按官方文档互斥,选了哪个就只写哪个。

不会弄坏你的配置

  • 先备份再写入(切换本软件自己生成的配置时跳过,界面会说明原因)。
  • 原子写入:先写临时文件再整体替换,中途断电不会留下半份配置。
  • 只动自己的键:不重新序列化整个 config.toml,插件、MCP、hooks、skills 配置原样保留。
  • 顶掉正在使用的提供商会先确认。

从 1.0.0 升级

直接覆盖安装即可。配置格式没有变化(schema 仍是 1),原有提供商、模型和认证信息不受影响。

系统要求

macOS 14 或更高版本。

本版验证

自动化测试 352 项,全部通过(1.0.0 时为 276 项)。其中包含:参数文件写入路径重构前后生成的配置逐字节比对一致,以及用本机 4 份真实模型参数文件(共 28 个模型)导入后全部通过表单校验。