Codex Patched：gpt5.6补丁包
Codex Patched：让 API Key 用户获得更完整的 Codex App 体验
Codex Patched 是一个面向 Windows 用户的开源补丁与安装工具。它以电脑中已经安装的官方 Codex App 为基础，创建一个完全独立的副本，并为 API Key 登录、GPT-5.6 模型、Fast Mode 和远程插件目录提供兼容支持。
项目不会修改C:\Program Files\WindowsApps中的官方安装，也不会重新分发 OpenAI 的应用程序文件。安装程序只负责复制用户电脑上的正版 Codex App，然后对副本执行补丁。
- 项目主页：Codex Patched Installer
- GitHub 仓库：xianyu110/codex-patched-installer
- 最新安装包：下载 CodexPatched-Installer.zip
为什么需要 Codex Patched
官方 Codex App 的部分功能通常与 ChatGPT 账户登录方式绑定。使用 OpenAI API Key 登录时，即使模型和接口本身支持相应能力，应用界面仍可能隐藏 Fast Mode、部分推理等级或账户插件。
Codex Patched 的目标不是绕过服务端权限，而是解决客户端功能判断和界面兼容问题，让应用按照模型实际支持的能力工作。
它不会赋予用户原本没有的模型、套餐或插件权限。最终是否可以调用某项服务，仍取决于 OpenAI 账户、API Key、模型权限和相关外部服务的授权状态。
主要功能
API Key Fast Mode
补丁允许 API Key 登录方式使用模型支持的 Fast Mode。
开启后，请求会发送：
{"service_tier":"priority"}补丁仍然保留模型自身的serviceTiers和additionalSpeedTiers棒查，不会把不支持 Fast 的模型伪装成支持。
GPT-5.6 模型适配
模型数据来源于 OpenAI 官方openai/codex仓库中的模型目录，而不是手工猜测。目前适配的模型包括：
| 模型 | 推理等级 |
|---|---|
gpt-5.6-sol | low、medium、high、xhigh、max、ultra |
gpt-5.6-terra | low、medium、high、xhigh、max、ultra |
gpt-5.6-luna | low、medium、high、xhigh、max |
其中，Max 和 Ultra 是推理等级，不是模型名称后缀。项目不会创建不存在的gpt-5.6-pro。
生成的model-catalog.json会保留原有模型，并合并官方 GPT-5.6 模型及其完整元数据，包括上下文长度、工具模式、Responses Lite、Fast tier 和多代理配置。
WebView 兼容
补丁会优先使用 Codex App 原生返回的模型数据。只有当前版本尚未提供 GPT-5.6 时，才会条件式补充 Sol、Terra 和 Luna。
当官方后续正式支持这些功能时，补丁会保留官方实现，避免重复注入或覆盖新版逻辑。
模型列表会按照每个模型实际支持的推理等级显示。例如 Luna 不支持 Ultra，因此界面不会为 Luna 提供 Ultra 选项。
账户可见插件同步
API Key 登录状态下，用户可以通过一份独立的 ChatGPT OAuth 凭据同步账户可见的远程插件目录，而无需改变 Codex App 当前的 API Key 登录状态。
项目支持：
- 从另一份 ChatGPT 登录生成的
auth.json读取凭据 - 同步账户已授权的远程插件目录
- 复用已有远程目录缓存和本地 Bundle 缓存
- 为有可用 Bundle 的插件生成本地 Marketplace
- 可选下载服务端提供了
bundle_download_url的缺失 Bundle
同步脚本会拒绝以sk-开头的 API Key。OAuth Token 不会显示在终端或日志中，也不会被写入项目发布包。
需要注意，插件出现在列表中只代表其 Bundle 可以被 Codex 加载，不代表 GitHub、Figma 等外部服务已经完成授权。连接器仍可能要求用户单独执行 OAuth 登录。
独立运行与更新
安装完成后，程序会创建：
Codex Patched.lnk该快捷方式指向补丁副本中的Codex.exe。官方 Codex App 与 Codex Patched 可以保持相互独立，原始安装不会被替换。
项目还会保留可重复运行的：
Patch-CodexApp.ps1补丁采用代码特征搜索，不依赖固定的 JavaScript 哈希文件名，并且具有幂等性，多次执行不会重复注入。
由于 Codex Patched 是官方应用的独立副本，官方 App 更新后不会自动更新这个副本。用户需要重新运行安装或补丁脚本，从新版官方应用重新复制并应用补丁。
真实请求验证
项目不仅检查界面显示，还使用只监听127.0.0.1的模拟/v1/responses服务验证 Codex CLI 实际发送的请求。
Terra 使用 xhigh 和 Fast Mode 时，请求包含：
{"model":"gpt-5.6-terra","reasoning":{"effort":"xhigh"},"service_tier":"priority"}Sol 使用 Ultra 时，按照当前 Codex 的设计，客户端会启用主动多代理，并在 Responses 请求中规范化为：
{"model":"gpt-5.6-sol","reasoning":{"effort":"max","context":"all_turns"},"service_tier":"priority"}也就是说，Ultra 是客户端层面的高级执行模式，不应错误地强制上游接口直接接收"effort": "ultra"。
安装方法
- 在 Windows 上安装并至少启动一次官方 Codex App。
- 下载最新的
CodexPatched-Installer.zip。 - 解压压缩包。
- 运行其中的 PowerShell 安装脚本。
- 安装完成后，通过
Codex Patched.lnk启动独立副本。
最新版本下载地址：
下载 Codex Patched 安装包
当前中文版安装包 SHA256：
30CD936329A529C19001D1150AC0C557E6B3A27DCAD5FDE75D91CF047F148163用户可以通过 PowerShell 校验文件：
Get-FileHash.\CodexPatched-Installer.zip-Algorithm SHA256安全与免责声明
Codex Patched 是社区项目，并非 OpenAI 官方产品。
项目不包含官方 Codex App 二进制文件，也不会修改 WindowsApps 中的原始安装。安装时使用的应用文件来自用户自己的官方 Codex 安装。
使用者仍需遵守 OpenAI 服务条款、API 使用政策以及相关第三方连接器的授权规则。模型访问、Fast tier、插件目录和外部服务能否使用，最终均由服务端权限决定。