升级与卸载

升级到最新版本

codex-notify update

升级会：

查询最新 GitHub Release；
下载当前平台的发行包和 SHA256SUMS；
验证文件没有损坏或被替换；
停止后台 watcher；
备份并替换程序；
刷新已有 Codex 集成，再重新启动 watcher。

消息平台配置、凭据、通知链和已记录的多套 Codex 配置都会保留。升级失败时会自动恢复旧程序和后台服务。

升级会自动重启 watcher，不会重启 ChatGPT。已经打开的旧任务即使没有重新加载 notify，升级后的 watcher 也会从本地任务记录补获后续完成事件，因此通常不需要手动退出 ChatGPT。首次启用 Hook 后仍需按提示完成信任。

从系统凭据库迁移

从旧版本首次升级时，codex-notify 会先把旧应用数据复制到 ~/.codex-notify，再读取一次系统凭据库中的 App Secret，将旧配置备份后写成新版格式，最后尝试删除旧凭据。macOS 可能为这次读取显示一次钥匙串授权窗口。迁移完成后，后续运行不再访问系统凭据库；原应用数据目录暂时保留作为升级回退保障。

只检查是否有更新：

codex-notify update --check

通过代理升级

Windows 会自动使用“设置 → 网络和 Internet → 代理”中已启用的手动系统代理。也可以在任意平台为本次升级明确指定 HTTP 或 HTTPS 代理：

codex-notify update --proxy http://127.0.0.1:7890

程序也支持标准的 HTTP_PROXY、HTTPS_PROXY 和 ALL_PROXY 环境变量。需要排查代理影响时，可以强制直连：

codex-notify update --no-proxy

代理优先级依次为 --proxy、代理环境变量、Windows 系统代理、直连。连接超时时，程序会根据当前连接方式提示检查代理软件或网络设置。

从旧版本首次升级到支持系统代理的版本时，如果 codex-notify update 仍然超时，可以重新运行上方的 Windows 安装命令。安装脚本会读取已启用的系统代理并把升级交给现有程序；完成这次升级后，后续运行 codex-notify update 会直接自动发现系统代理。

重新运行安装脚本

已有安装时，安装脚本会自动调用同一套安全升级流程。

macOS / LinuxWindows PowerShell

curl -fsSL https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.sh | sh

powershell

irm https://raw.githubusercontent.com/JunieXD/codex-notify/main/scripts/install.ps1 | iex

安装指定版本

codex-notify update --version v0.4.0

默认不允许降级。只有明确理解影响时，才使用 --force 安装旧版本：

codex-notify update --version v0.4.0 --force

卸载

codex-notify uninstall

卸载会移除：

由 codex-notify 添加的 Hook；
后台启动项；
消息平台配置、凭据和本地运行状态；
codex-notify 管理的通知链。

它会恢复已记录配置原有的 notifier，并保留 Computer Use 和其他用户配置。确认前会显示变更摘要；添加 --yes 可以跳过确认。

程序文件可能仍然保留

卸载命令负责移除集成和本地数据。若还要删除可执行文件，请根据 codex-notify status 或终端中的安装位置手动删除。

升级与卸载 ​

升级到最新版本 ​

通过代理升级 ​

重新运行安装脚本 ​

安装指定版本 ​

卸载 ​

升级与卸载

升级到最新版本

通过代理升级

重新运行安装脚本

安装指定版本

卸载