停用与卸载
恢复官方 Codex 原来的配置,或彻底卸载 ReCodex。
只想恢复官方 Codex
不卸载 ReCodex,只想让官方 Codex 回到接入前的样子:
- 只用过 CLI:运行
gcodex logout,~/.codex会恢复成接入前的配置和登录。 - 用过 Desktop:先完全退出 Desktop(macOS 按
⌘Q),再运行gcodex desktop disable。它会还原~/.codex、关闭网络接管并移除证书,你在使用期间新增的 MCP 和技能会保留。
之后再运行 gcodex 时,会重新接管 ~/.codex。
彻底卸载
按顺序执行。任何一步失败都会停下来,并保留恢复所需的文件,不会让你的配置处于半恢复状态。
结束正在进行的会话
保存手头的工作,完全退出 Codex Desktop(macOS 按 ⌘Q,Windows 从系统托盘退出)。卸载会停止后台服务,正在运行的 Codex CLI 会话也会中断。
运行卸载命令
gcodex uninstall它会先恢复 ~/.codex 和 Desktop 配置,再移除后台网络组件(会再请求一次管理员授权)和证书,然后停止后台服务,删除 gcodex 和本地数据。执行前会询问「确认继续? [y/N]」,在脚本里运行时加 --yes。
- 用
gcodex update下载过官方 codex 并想保留它:加--keep-codex。用 npm、Homebrew 等方式自己安装的 codex 不受影响。 - 想保留日志:加
--keep-logs。
清理剩余的文件(可选)
以下内容不会被自动删除,需要时可以手动清理:
- shell 配置文件里加载 ReCodex 的那几行(以
# ReCodex CLI开头),以及~/.recodex/env、~/.recodex/env.fish; - Windows 用户环境变量
PATH里的 ReCodex 目录; ~/.recodex-desktop里的配置备份。
确认已经恢复干净
command -v gcodex # 无输出 = 已删除(需在新终端里检查)
launchctl print system/com.recodex.net-helper # 提示找不到 = 后台组件已移除
dscacheutil -q host -a name chatgpt.com # 返回公网 IP,而不是 127.0.0.1卸载 ReCodex 不会取消你的订阅,以后重新安装并登录即可继续使用。卸载也不会释放控制台里的设备名额;想让这台电脑在服务端也失去访问权限,到控制台「设备」页解绑它。