跳到正文
ReCodexDocs

停用与卸载

恢复官方 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 不会取消你的订阅,以后重新安装并登录即可继续使用。卸载也不会释放控制台里的设备名额;想让这台电脑在服务端也失去访问权限,到控制台「设备」页解绑它。

本页目录