An unofficial Windows x64 installer, updater, and repair tool for the official OpenAI Codex desktop app.
Windows x64 上简单好用的 Codex 安装、更新与修复工具。
下载 beta.11 · 使用说明 · 常见问题 · 反馈问题
CodexKit 用于在 Windows 10/11 x64 上检查、安装、更新和修复 Codex 桌面应用，也可以处理官方 MSIX/MSIXBundle 软件包、WebView2 运行环境和常见沙箱兼容问题。
它面向希望使用 Codex、但不想研究安装包、系统服务和沙箱配置的 Windows 用户。
打开程序后，你可以直接看到 Codex 是否已经安装。未安装时一键安装，已有安装时可以更新；如果 Codex 打不开或启动异常，也可以从同一个页面进行修复。
CodexKit 是独立开源项目，并非 OpenAI 官方产品。安装时获取的是 OpenAI 官方 Codex 软件包。
当前版本为
0.1.0-beta.11测试版，建议先在非关键电脑或虚拟机中体验。
- Windows 10 版本 1809 或更高版本，x64 架构。
- 能够访问 OpenAI 官方下载服务器；网络受限时也可以手动下载官方安装包后交给 CodexKit 安装。
- CodexKit 界面依赖 Microsoft Edge WebView2 Runtime；缺失或异常时程序会提供维护入口。
- 检查安装状态：自动判断 Codex 是否已安装、正在运行以及当前安装方式。
- 安装或更新 Codex：自动获取适用于 Windows x64 的官方版本。
- 尝试修复常见问题：处理 Codex 无法打开、安装失败或相关 Windows 组件异常等情况。
- 轻量配置 Codex：全新安装可选择官方 ChatGPT 登录或 API Key/中转模式；一级“Codex 配置”页面长期保留入口，方便重新配置。
- 文件配置备份、恢复与重建：按原始字节备份和恢复
config.toml、auth.json，不包含 Windows 凭据管理器；也可先备份再重建官方最小config.toml。 - 使用中文：中文系统默认勾选，也可以随时手动开启或关闭。
- 兼容模式：自动检查当前沙箱状态，仅在可能需要时建议开启，用户仍可自行选择。
- 创建桌面快捷方式：安装时可创建名为
ChatGPT的桌面入口；这是 CodexKit 管理的启动入口， 不会替换官方程序。 - 支持本地安装包：下载较慢时，可以复制官方下载地址，使用其他下载工具完成下载，再交给 CodexKit 安装。
- 中文与英文界面：根据系统语言自动选择，也可以在右上角手动切换。
- 亮色与暗色主题：支持跟随系统、亮色和暗色三种模式。
“任务接力”目前属于测试功能。首个公开版本的重点是把 Codex 安装好、修复好。
进入 beta.11 Release，下载：
CodexKit_0.1.0-beta.11_Portable-x64.exe
目前只提供 Windows x64 单文件绿色版。无需安装 CodexKit，也不需要额外下载 DLL；放在下载、桌面等普通文件夹中， 双击即可运行。
“绿色版”仅表示 CodexKit 本体无需安装。使用安装、更新或深度修复功能时，仍会按用户选择修改 ChatGPT/Codex 的安装状态、相关 Windows 服务或桌面快捷方式；需要系统权限的操作会单独请求管理员权限。
直接双击 CodexKit 即可，不要主动选择“以管理员身份运行”。
当前测试版尚未进行 Windows 代码签名，第一次运行时可能出现 SmartScreen 提示。请确认文件来自本项目的
GitHub Releases，并与同一 Release 中的 SHA256SUMS 核对一致，然后再选择“更多信息”→“仍要运行”。
CodexKit 会先自动检查当前状态：
- 尚未安装：确认中文、兼容模式和桌面快捷方式选项，然后点击“安装”。
- 已经安装：可以继续使用，也可以点击“安装 / 更新”获取最新版。
- Codex 打不开：点击“开始修复”，需要修改系统服务时程序会自动请求管理员权限。
安装完成后，可以点击右上角“打开 Codex”。
如果这是全新安装且本机还没有 Codex 配置，首次点击“打开 Codex”会先出现配置向导：
- 官方模式：打开 Codex，在官方界面完成 ChatGPT 登录。
- API Key / 中转模式：填写模型、HTTPS Base URL 和 API Key；本机回环调试地址可使用 HTTP。模型可自由填写，也可主动获取服务支持的模型；“测试连接”会向兼容
/responses端点发送一条最小测试消息，并在独立弹窗中展示实际响应和耗时。只有点击“测试连接”或“获取支持模型”时，CodexKit 才会把 API Key 发送到所填服务地址。 - 稍后配置：只跳过本次运行；下次重新打开 CodexKit 后仍会显示向导。
之后可以随时进入“Codex 配置”重新选择模式、更新模型或 Base URL、填写新的 API Key， 以及备份、恢复或重建官方最小配置。API Key 默认遮挡，只有点击眼睛按钮时才按需读取并显示；留空时只在已有值 可安全复用的情况下保留。CodexKit 不会把 Key 写入命令行或日志，也不会自动发起第三方网络测试。
API Key 模式下会显示 CoderPlant 可选链接。CoderPlant 由项目维护者运营，非 OpenAI 官方服务；CodexKit 不会自动填入 CoderPlant 地址，也不会上传 API Key。不使用它也不影响安装、修复和官方模式。
首次打开 Codex 时，如果出现 Windows 设置、沙盒初始化或其他启动错误，不必根据某一条固定错误文案判断： 先回到 CodexKit 点击“重新检测”，再根据新的检测结果决定是否启用兼容模式并执行“修复现有安装”。 首次点击修复会连续应用兼容配置，并在同一次管理员授权中自动执行两轮完整系统修复；第二轮会重新创建临时修复服务并完整复跑原先需要手动第二次点击的动作，并以第二轮结果判断本次修复是否成功。回到 Codex 点击“重试”后若仍失败，请再次重新检测并按页面提示处理。 只有连续两次完整修复后仍失败，CodexKit 才会建议检查现有配置，避免过早把系统修复问题误判为配置问题。
默认情况下，CodexKit 会自动下载官方安装包。如果当前网络下载较慢：
- 展开安装页中的“其他下载方式”。
- 复制官方下载地址。
- 使用浏览器、迅雷或其他下载工具完成下载。
- 回到 CodexKit，选择下载好的
.msix或.msixbundle文件进行安装。
无论采用哪种下载方式，CodexKit 都会检查软件包身份和 Windows 签名；无法确认来自 OpenAI 的文件不会安装。
“使用中文”会在下次通过 CodexKit 打开 Codex 时生效。中文 Windows 默认勾选，英文或其他语言的 Windows 默认不勾选，你可以随时修改。
CodexKit 不会修改官方程序的 app.asar。由于中文属于兼容增强功能，Codex 更新后部分文字可能暂时恢复为英文。
CodexKit 会检查 Windows 沙箱是否正常：
- 沙箱正常：默认不勾选兼容模式。
- 沙箱可能异常：默认建议勾选。
- 无论检测结果如何：用户都可以手动开启或关闭。
兼容模式适合强沙箱无法启动的电脑，但隔离能力会弱于默认模式。问题解决后，建议重新关闭兼容模式。
不需要。CodexKit 首版是单文件绿色版，下载 EXE 后直接运行即可。
可以。CodexKit 会识别已有安装，你可以用它检查更新、修复启动问题，并设置中文、兼容模式或桌面快捷方式， 不需要先卸载 Codex。
先在 CodexKit 中重新检查状态并尝试正常安装或更新。如果 Codex 仍然无法启动，再点击“开始修复”；需要调整 Windows 服务或系统组件时，CodexKit 会单独请求管理员权限。修复失败后可以查看下文说明的脱敏日志。
不需要。普通检查、下载、安装和更新都从正常窗口操作。只有执行深度修复、确实需要调整 Windows 系统服务时， CodexKit 才会请求管理员权限。建议先尝试正常安装或更新，确认仍然失败后再使用深度修复。
这些能力由官方 Codex 版本、账号资格、组织策略、所在地区和任务运行环境共同决定。CodexKit 可以安装和修复 Codex，但不能绕过官方限制，也不会显示虚假的“解锁成功”。
CodexKit 不再修改 Codex 界面或添加 CoderPlant 标识。CoderPlant 只在“Codex 配置”的 API Key / 中转模式中 作为可选链接出现，由项目维护者运营，并非 OpenAI 官方服务；CodexKit 不会自动填入地址或上传 API Key。
“立即备份”和从历史列表选择恢复都同时处理 config.toml 与 auth.json，因此恢复会回到所选备份的文件配置和
文件凭据状态；Windows 凭据管理器或其他系统凭据不在备份范围内。恢复前会先保存当前文件作为撤销快照。
Codex 运行时仍可创建只读备份；保存、恢复或重建前必须先手动退出 Codex，避免运行中的 Codex 随后回写认证信息。
CodexKit 不会为了配置维护自动结束当前 Codex 进程。
“备份并重建官方最小配置”只重建 config.toml，保留现有 auth.json 原始内容，适合旧版升级后沙盒仍报错，
或首次配置被关闭、填写错误时重新开始。官方登录会话进行中时，其他配置写入仍会被拒绝以保护登录前快照；
开始、完成或取消官方登录前需要用户手动退出 Codex。
安装与修复流程不会主动删除 Codex 登录信息。涉及旧版 CodexKit 遗留设置时，程序会先识别和备份，无法确认 安全归属的内容不会自动修改。
深度修复日志默认位于：
C:\ProgramData\CodexEnvironmentRepair.log
提交问题前请先检查日志中是否包含账号、路径或其他隐私信息，只提供脱敏后的错误内容。
- 安装与系统修复不要求你在 CodexKit 中输入 API Key、Token、Cookie 或 Session。
- API 模式下输入的 API Key 默认遮挡，可由用户点击眼睛查看；密钥不进入命令行或日志，只有用户主动测试连接或获取支持模型时才发送到所填服务地址。
- 不会修改 Codex 官方程序的
app.asar。 - 不会通过静态配置伪造或解锁浏览器、电脑操控能力。
- 本地安装包必须匹配官方应用身份、官方发布者并通过 Windows 签名检查。
- “任务接力”不会把官方聊天记录、推理内容或认证文件原文作为交接字段。
完整安全说明见 SECURITY.md。
当前公开测试版为 0.1.0-beta.11：
- Windows x64 单文件绿色版
- 无需旁置 DLL
- 当前尚未进行 Authenticode 代码签名
- SHA-256：请以同一 GitHub Release 中的
SHA256SUMS为准
可以使用 PowerShell 核对下载文件：
Get-FileHash .\CodexKit_0.1.0-beta.11_Portable-x64.exe -Algorithm SHA256计算结果应与同一 Release 中的 SHA256SUMS 一致。
当前版本已经通过自动测试和构建检查；单文件隔离启动、最新界面验收及不同 Windows 权限环境下的真实安装、更新和 深度修复结果以同版本交付报告为准。因此本版本作为 GitHub Prerelease 发布，不标记为稳定版。
任务接力可以把本地 Git 仓库的当前状态、任务目标、已完成内容和验收条件整理为一个本地交接包，方便交给 另一位开发者或新的 Codex 任务继续处理。
此功能目前仍在测试阶段：
- 导出前会生成交接说明并执行自动敏感信息扫描。
- 预览页不显示补丁正文，自动扫描不能代替人工检查。
- 只读取 Git 状态和必要的变更信息，不执行 Git 写入命令。
- 不自动读取 Codex 官方任务，也不会自动创建或续接任务。
- 不自动应用补丁，不重新执行历史命令。
交接包可能包含代码差异和本地路径。请只发送给可信对象，并在分享前检查压缩包内容，确认没有敏感信息。
首次使用建议优先体验“安装与修复”。任务接力格式见 TaskPack 格式说明。
如果遇到安装、更新或修复失败，请在 Issues 中提供：
- Windows 版本和系统架构。
- CodexKit 页面显示的错误摘要。
- 已脱敏的修复日志或截图。
- 使用的是自动下载还是本地安装包。
请不要上传 API Key、Token、Cookie、认证文件或包含个人信息的完整配置。
面向开发者的构建方式、模块结构和维护约定已移至：
CodexKit 使用 GNU Affero General Public License v3.0 only 发布，SPDX 标识为
AGPL-3.0-only。