Codex Base URL 填写器

macOS 上双击就能改 Codex config.toml 里 openai_base_url 的小工具。 自动备份、自动验语法、写坏了自动还原、顺手测一下地址通不通。

解决什么问题

Codex 桌面版没有图形化的 Base URL 输入框，改地址只能手动开 ~/.codex/config.toml。 而这个目录在访达里是隐藏的，TOML 少个引号整个文件就废、Codex 直接起不来。

这个脚本把这件事变成：双击 → 粘贴地址 → 回车。

用法

1. 下载后把 Codex地址.command 放到桌面（或任何你喜欢的位置）

2. 首次使用先给执行权限：

   chmod +x Codex地址.command

3. 双击，粘贴地址，回车

首次双击如果被 Gatekeeper 拦下，在「系统设置 → 隐私与安全性」里点「仍要打开」。

输入可以很随便

以下几种写法效果一样，缺的部分会自动补：

192.168.1.100:3333
http://192.168.1.100:3333
http://192.168.1.100:3333/v1
"http://192.168.1.100:3333/v1/"

多余的引号、空格、结尾斜杠都会被清掉。

每次它都会做这些

步骤	说明
备份	存成 ~/.codex/config.vN.toml，N 自动递增，不会覆盖旧的
写入	有 openai_base_url 就替换，没有就插到文件开头
验语法	用 Python tomllib 解析一遍
出错还原	语法不过就把备份复制回去，等于没改过
连通测试	请求 {URL}/models，HTTP 200/401/403 都算服务在跑

直接回车、或者填的跟当前一样，都不会动文件。

改完记得在 Codex 里按 Cmd+Q 完全退出再打开，关窗口不生效。

图标（可选）

想让它在桌面上好认，双击 设置图标.command。

需要 pyobjc（pip3 install pyobjc-framework-Cocoa）。不想装的话手动贴也行：

1. 用「预览」打开 assets/icon.png，Cmd+A 全选，Cmd+C 拷贝
2. 选中 Codex地址.command，Cmd+I 打开简介
3. 点左上角那个小图标，Cmd+V 粘贴

图标存在文件的扩展属性里（com.apple.ResourceFork + com.apple.FinderInfo）。 之后改脚本请原地改（用编辑器或 sed -i ''）。删了重建、或者从别处覆盖过去，图标会丢。

环境要求

• macOS
• Python 3.11+ 且带 tomllib（用于验语法；没有的话跳过这步，其余功能不受影响）
• curl（系统自带）

免责

脚本会改你的 ~/.codex/config.toml。每次都会先备份，但请自行确认备份存在。 作者不对任何数据丢失负责。

License

PolyForm Noncommercial 1.0.0 —— 见 LICENSE

可以：自己用、改、学习、非商业地分享。 需要事先取得作者书面同意：任何商业用途（含内部商用、打包进付费产品、作为收费服务的一部分）。