codexfast - OpenAI Codex.app runtime patch launcher

English README

一个面向 OpenAI Codex.app 的 macOS runtime launcher，用于在已验证兼容的版本上临时启用 custom API 用户需要的隐藏能力，并且不修改已安装 app bundle。

codexfast 会启动一个带 runtime patch 的 Codex 会话。它不会修改原始 app.asar、Info.plist、app bundle 或 app 签名。

• Settings 里的 Fast 控制项
• 输入框里的 /fast slash command
• composer 里的 Speed 菜单
• 面向 custom API 用户的 GPT-5.5 / GPT-5.6 模型目录兼容：旧版支持 build 注入 Sol/Terra/Luna 元数据，当前 build 使用官方 GPT-5.6 路径
• Settings > General 里的 Disable automatic updates 开关

npx codexfast launch

最新完成本地验证的版本：ChatGPT.app / Codex.app 26.715.21425（build 5488）。

已验证支持 ChatGPT.app / Codex.app 26.707.91948（build 5440）、26.707.72221（build 5307）、26.707.71524（build 5263）、26.707.61608（build 5200）、26.707.41301（build 5103）、26.707.31428（build 5059）、26.623.141536（build 4753）、26.623.101652（build 4674）、26.623.81905（build 4598）、26.623.70822（build 4559）、26.623.61825（build 4548）、26.623.42026（build 4514）、26.623.31921（build 4452）、26.623.31443（build 4441）、26.616.81150（build 4306）、26.616.71553（build 4265）、26.616.51431（build 4212）、26.616.31447（build 4133）、26.611.62324（build 4028）、26.611.61753（build 4008）、26.611.61049（build 3996）、26.609.71450（build 3965）、26.609.41114（build 3888）、26.609.30741（build 3808）、26.608.12217（build 3722）、26.602.71036（build 3685）、26.602.40724（build 3593）、26.602.30954（build 3575）、26.601.21317（build 3511）、26.527.60818（build 3437）、26.527.31326（build 3390）、26.519.81530（build 3178）、26.519.41501（build 3044）、26.519.31651（build 3017）、26.519.22136（build 3003）、26.513.31313（build 2867）、26.513.20950（build 2816）、26.506.31421（build 2620）、26.506.21252（build 2575）、26.429.61741（build 2429）、26.429.30905（build 2345）、26.429.20946（build 2312）、26.422.71525（build 2210）、26.422.62136（builds 2180, 2176）、26.422.30944（build 2080）、26.422.21637（build 2056）、26.417.41555（build 1858）和 26.415.40636（build 1799）。功能范围见 docs/feature-scope.md。

工作方式

Codex.app 的前端 bundle 里已经包含 Fast、/fast、Speed 和 updater 相关 UI 路径。codexfast 只 patch 已验证 build 上仍然需要的本地 gate。它不新增后端服务，也不调用 OpenAI 私有 API。

codexfast launch 会用本地 Chrome DevTools Protocol endpoint 启动 Codex，通过 browser-level CDP target 在 renderer JavaScript 执行前挂载拦截，拦截当前会话里匹配的 renderer JavaScript 响应，并在内存里应用窄范围 patch。使用 Codex 时需要保持 codexfast launch 进程运行；Settings 和被 patch 的功能 chunk 都可能懒加载，首次窗口打开后仍然需要 runtime interceptor。

Settings > General 里的 Disable automatic updates 开关会写入 Codex desktop 配置 [desktop].disableAutomaticUpdates。codexfast 会给当前进程注入 main-process hook，按源码签名在 .vite/build/*.js 中发现 updater 和 desktop settings 模块，并在每次 Sparkle 后台更新检查和自动强制安装调度前读取最新配置。因此即使 bundle chunk 改名，在一次 codexfast launch 会话中打开开关后，后续自动更新行为仍会被跳过；手动 Check for Updates 和安装更新动作仍然可用。注入到 Settings 的这一行会按常见 Codex app 语言显示对应文案。

26.707.41301+5103 是官方 GPT-5.6 阈值。该 build 以及数值上更新的 build 只有在各自加入严格 version/build 白名单后，才会跳过 GPT-5.6 model-list 注入和 query-selector 放行；未知后续版本仍会被拦截。

launcher 会发送轻量 browser-level CDP heartbeat。runtime patch session 断开时最多做三次 bounded reconnect，仍失败则打印 Runtime patch session lost，并关闭本次启动的 Codex 进程、以非 0 退出，避免未受 runtime patch 保护的会话继续运行。如果 launch 进程本身被外部杀掉，需要完全退出 Codex 并重新用 codexfast 启动后，再依赖后续懒加载功能的 patch。

如果旧版 codexfast 安装过 launchd auto-repair watcher，launch 会在启动 Codex 前自动移除这个 legacy watcher。

使用

仅支持 macOS。需要 /Applications/Codex.app 或 /Applications/ChatGPT.app，以及 Node.js >=18.12.0。

推荐：

npx codexfast launch

从仓库 clone 运行：

./bin/codexfast launch

查看帮助或版本：

npx codexfast help
npx codexfast version

交互菜单只保留 launch：

1) Launch Codex with runtime patches
q) Quit

命令

| Command | 说明 | | --- | --- | | npx codexfast launch | 启动当前前台 Codex runtime patch 会话。使用 Codex 时保持该命令运行。 | | npx codexfast help | 显示帮助。 | | npx codexfast version | 显示 codexfast 版本。 |

兼容性

脚本匹配的是 Codex 前端构建产物里的代码签名，所以 Codex 更新后可能失效。

• launch 只允许在白名单里的 version/build 上执行
• Runtime launch 不会改写 app.asar、Info.plist、app bundle、备份、app 签名或 macOS 隐私权限
• 自动更新开关会在当前 codexfast launch 会话中禁用后续后台更新检查和自动强制安装调度；手动更新检查和安装仍然可用
• 26.707.41301+5103 以及后续单独加入白名单的版本使用官方 GPT-5.6 model list 和 selector，不再应用兼容注入

排查

脚本立即失败 - 检查 /Applications/Codex.app 或 /Applications/ChatGPT.app 是否存在，以及 node -v 是否为 18.12.0 或更高。

Runtime launch 显示 Codex failed to start / ERR_FAILED - 完全退出 Codex，然后重新运行最新的 npx codexfast launch。失败的 runtime launch 不应该修改 app.asar、Info.plist、app bundle、备份、app 签名或 macOS 隐私权限。

launch 后 Settings Fast 或被 patch 的功能仍然缺失 - 确认 codexfast launch 终端进程仍在运行。关闭它会结束 CDP interception，后续懒加载的 chunk 就无法继续被 patch。

修改开关后仍出现一次自动更新检查 - updater 可能在打开 Settings 页面前已经触发一次启动/后台检查，已经开始的检查无法撤回。打开开关后，同一次 codexfast launch 会话里的后续后台检查和自动强制安装调度会被跳过。

出现 Runtime patch session lost after reconnect attempts - codexfast 会关闭本次启动的 Codex，因为 runtime patching 已经不再活跃。完全退出任何残留的 Codex 进程，然后重新运行 npx codexfast launch 启动新的 patched session。

以前安装过 auto-repair watcher - 执行一次 npx codexfast launch。launcher 会在启动 Codex 前移除 ~/Library/LaunchAgents/com.codexfast.watcher.plist 和旧的本地 watcher runtime。

License

MIT. See LICENSE.