Repository navigation
CodexBridger 1.1.0
把第三方模型提供商接进 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 个模型)导入后全部通过表单校验。