Codex++ 图标

Codex++ 是一个面向 Codex App 的外部增强启动器。它不修改 Codex App 原始安装文件,而是通过外部 launcher 启动 Codex,并使用 Chromium DevTools Protocol 向渲染进程注入增强脚本。

• 功能
• 痛点
• 解决效果
• 讨论交流
• 友情链接
• 工作方式
• 环境要求
• Windows 使用
  • 图形菜单安装/卸载
  • 命令行安装
  • 命令行卸载
• 自动更新
• macOS 使用
  • 安装
  • 卸载
• 直接启动
• 数据与备份
• 常见问题

当前功能:

• 在会话列表悬停显示"删除"按钮
• 删除前确认,支持撤销
• 优先尝试服务端删除;不可用时删除本地 Codex SQLite 会话记录
• 在顶部菜单栏加入 Codex++ 菜单
• 支持开关:
  • 插件选项解锁
  • 特殊插件强制安装
  • 会话删除
• 支持 Windows 快捷方式安装/卸载
• 支持 macOS 生成 /Applications/Codex++.app
• 支持基于 GitHub Release 检查和更新 Codex++

API Key 登录模式下,Codex 原生插件入口会提示需要登录 ChatGPT,导致插件功能无法正常使用:

API Key 模式下插件入口不可用

同时,Codex 原生会话列表只有归档入口,没有真正的删除按钮:

原生会话列表缺少删除能力

Codex++ 启动后会解锁插件入口,并在会话列表悬停时显示删除按钮:

Codex++ 解锁插件入口并添加删除按钮

顶部菜单栏会出现 Codex++,点击后可以打开配置界面:

Codex++ 后端状态指示灯

Codex++ 配置界面

欢迎扫码加入 Codex++ 交流群,反馈问题、交流使用体验或提出新功能建议:

Codex++ 交流群二维码

• LINUX DO

Codex++ 使用外部启动方式运行 Codex:

1. 启动 Codex App,并附加:
   • --remote-debugging-port=9229
   • --remote-allow-origins=http://127.0.0.1:9229
2. 启动本地 helper 服务,保留健康检查和运行生命周期。
3. 通过 CDP 注入 renderer-inject.js。
4. 渲染端通过 CDP bridge 调用本地删除服务;默认不开放 HTTP 删除/撤销入口,避免本机其他页面误触发删除类操作。
5. 启动 Codex 时会继承现有 HTTP_PROXY / HTTPS_PROXY / ALL_PROXY;如果这些环境变量未设置,会自动探测常见本地代理端口(如 127.0.0.1:7897),帮助 Codex 加载需要访问 GitHub 的技能资源。

这种方式不会修改 Codex 的 app.asar,也不需要往 Codex 安装目录写 DLL。

• Python 3.11+
• Windows 或 macOS
• 已安装 Codex App

安装依赖:

python -m pip install -e .

如需运行测试:

python -m pip install -e .[test]
python -m pytest -q

双击项目根目录的:

setup.bat

然后按菜单选择:

[1] Install Codex++
[2] Uninstall Codex++
[3] Update Codex++
[4] Exit

在项目目录执行:

python -m codex_session_delete setup

安装后会在桌面生成:

Codex++.lnk

双击该快捷方式启动 Codex++。

可以在系统"设置 → 应用 → 已安装的应用"里卸载 Codex++。

也可以在项目目录执行:

python -m codex_session_delete remove

如需同时删除 Codex++ 自己的日志和备份数据:

python -m codex_session_delete remove --remove-data

Codex++ 会在启动时检查 GitHub Release。如果发现比本地版本更新的 Release,会在控制台提示版本号、Release 地址和更新命令;检查失败不会影响 Codex++ 启动。

手动检查更新:

python -m codex_session_delete check-update

从最新 GitHub Release 更新:

python -m codex_session_delete update

更新流程:

1. 请求 https://api.github.com/repos/BigPizzaV3/CodexPlusPlus/releases/latest。
2. 比较最新 Release tag 与本地版本。
3. 优先下载 Release 中的 .whl asset。
4. 执行 python -m pip install --upgrade <wheel>。
5. 自动重新执行 python -m codex_session_delete setup,刷新快捷方式、Windows 卸载项或 macOS app bundle。

发布新版本时,请在 GitHub Release 里附加 wheel 文件,例如:

python -m build

然后把 dist/codex_session_delete-<version>-py3-none-any.whl 上传到对应 Release。

python -m codex_session_delete setup

默认会自动查找 /Applications/Codex.app、/Applications/OpenAI Codex.app 或用户 Applications 目录下的 Codex 应用,并生成:

/Applications/Codex++.app

python -m codex_session_delete remove

不安装快捷方式时,也可以直接运行:

python -m codex_session_delete launch

常用参数:

python -m codex_session_delete launch \
 --app-dir "/Applications/OpenAI Codex.app" \
 --debug-port 9229 \
 --helper-port 57321

Windows 也可以手动指定 Codex 安装目录:

python -m codex_session_delete launch \
 --app-dir "C:/Program Files/WindowsApps/OpenAI.Codex_xxx/app" \
 --debug-port 9229 \
 --helper-port 57321

Codex++ 默认读取 Codex 本地数据库:

~/.codex/state_5.sqlite

删除前会把相关记录备份到:

~/.codex-session-delete/backups

隐藏启动失败日志位于:

~/.codex-session-delete/launcher.log

默认情况下 Codex++ 只在你从 Codex++ 快捷方式启动时生效。如果你从开始菜单、任务栏或系统原生入口直接启动 Codex,那一次不会有注入,Codex++ 菜单和插件解锁都不会出现。

Windows 可以注册一个常驻 watcher 解决这个问题。它会每 3 秒探测一次本机 CDP 端口,发现 Codex 在跑但 CDP 没起来,会先短暂等待并二次确认,确认仍没有 CDP 后再把这一批 Codex 进程杀掉、通过 launcher 重拉一次带注入的版本。这样不管你从哪里打开 Codex,都会被自动接管。

注意代价:

• 每次 Codex 通过原生路径启动,仍可能先打开一瞬间,再被 kill,再被 launcher 带 CDP 重开;watcher 会通过等待、二次确认和失败 backoff 尽量减少频繁闪烁。
• watcher 以 pythonw.exe 常驻运行,登录时自动启动(通过 HKCU\...\Run 和 Startup 文件夹双路径注册,后者防止某些注册表清理工具干扰)。

python -m codex_session_delete watch-install

安装完成后 watcher 会立即启动,无需重启。

python -m codex_session_delete watch-remove

remove / 系统卸载 Codex++ 时会自动连带执行 watch-remove,不需要手动处理。

保留自启项、但让 watcher 不再自动接管:

python -m codex_session_delete watch-disable
python -m codex_session_delete watch-enable

%USERPROFILE%\.codex-session-delete\watcher.log

示例:

[...] watcher started (interval=3.0s)
[...] Codex running without CDP (pids=[...]); attempting takeover
[...] takeover: killing 4 codex pid(s): [...]
[...] takeover: CDP is up on 9229 (launcher pid=...)

先查看日志:

%USERPROFILE%\.codex-session-delete\launcher.log

常见原因:

• Codex App 没有安装或路径变化
• 9229 端口被占用
• Python 环境不可用

如果技能页提示 git fetch failed、unable to access 'https://github.com/openai/skills.git/' 或无法连接 GitHub,通常是本机网络不能直连 GitHub。Codex++ 启动时会优先继承现有代理环境变量;如果未设置,会自动探测常见本地代理端口。也可以手动指定:

$env:HTTP_PROXY="http://127.0.0.1:7897"
$env:HTTPS_PROXY="http://127.0.0.1:7897"
python -m codex_session_delete launch

确认是从 Codex++ 快捷方式启动,而不是直接启动原版 Codex。

也可以检查 Codex 是否带了 CDP 参数:

--remote-debugging-port=9229

请先更新到当前版本后重新安装一次:

python -m codex_session_delete setup

新版会写入稳定的系统卸载项,并使用绝对 Python 路径执行卸载。

运行测试:

python -m pytest -q

项目结构:

codex_session_delete/
 cli.py CLI 入口
 launcher.py 启动 Codex 并注入脚本
 cdp.py CDP 通信与 bridge
 helper_server.py 本地 helper 服务
 storage_adapter.py 本地 SQLite 删除/撤销
 windows_installer.py Windows 快捷方式与卸载项
 macos_installer.py macOS app bundle 安装
 watcher.py Windows 常驻 watcher(可选,原生启动接管)
 inject/renderer-inject.js
tests/ 自动化测试
docs/ai/ 项目级 AI 协作状态和 skills 配置中枢

Codex++ 是外部增强工具,不修改 Codex App 原始文件。Codex App 更新后,如果页面结构变化,可能需要更新注入脚本。