配置、安全与排错

Codex 卸载干净与重新安装

Codex Windows 桌面应用、CLI 和 Code8 Manager 卸载教程,说明残留配置、备份、重装及卸载不干净的处理方法。

编辑:Codex Guide 编辑

不要一开始就删除整个 .codex 文件夹。先判断要卸载的是桌面应用、Codex CLI 还是 Code8 Manager,再决定是否保留配置和会话数据。

卸载前先备份

Windows 原生环境的 Codex 配置通常位于:

%USERPROFILE%\.codex

WSL 或 Linux 中通常位于:

~/.codex

这里可能包含 config.toml、认证配置和本地状态。需要彻底重置时,先把目录改名为备份,而不是直接删除。例如:

Rename-Item "$env:USERPROFILE\.codex" ".codex.backup"

执行前确认目标备份目录不存在。不要把包含 API Key 的备份上传到公开仓库或发给他人。

卸载 Windows 桌面应用

可以在 Windows 的“设置 → 应用 → 已安装的应用”中找到 ChatGPT/Codex 桌面应用并卸载。

如果应用由 Microsoft Store 安装,也可以让 winget 查找后卸载:

winget list --id 9PLM9XGG6VKS -s msstore
winget uninstall --id 9PLM9XGG6VKS -s msstore

先运行 list 确认匹配对象,再运行卸载命令。

卸载 Codex CLI

npm 安装

npm uninstall -g @openai/codex

Homebrew 安装

brew uninstall --cask codex

卸载后检查命令是否还有其他副本:

Get-Command codex -All

如果仍能找到 codex,说明电脑上可能还存在脚本安装版、其他包管理器版本或旧 PATH 项。不要直接删除搜索结果中的第一个文件,先确认它属于哪个安装渠道。

卸载 Code8 Manager

在 Windows“已安装的应用”中找到 Code8 Manager 并卸载。卸载 Manager 不等于自动删除 Codex CLI、桌面应用或 %USERPROFILE%\.codex 配置。

如果只是 Manager 更新失败,可以先覆盖安装当前版本,不必先清空 Codex 配置。

为什么卸载后还有文件

通常有三类残留:

  1. 用户配置和认证数据:用于保留设置。
  2. npm 或其他包管理器缓存:不等于仍然安装。
  3. 旧 PATH 项或多个可执行文件:导致命令仍指向旧版本。

先使用 Get-Command codex -Allnpm list -g --depth=0 和 Windows 已安装应用列表确认来源,再处理对应残留。

彻底重置配置

只有在配置损坏、账号状态异常或明确希望从零开始时才重置 .codex

  1. 退出所有 Codex、终端和 Manager 窗口。
  2. .codex 改名为 .codex.backup
  3. 重新安装并启动 Codex,让它生成新目录。
  4. 确认问题解决后,只迁回确实需要的配置。
  5. 不要把旧 auth.json 与新登录状态盲目混合。

卸载不掉怎么办

  1. 在任务管理器中确认 Codex 和 Manager 已退出。
  2. 重启 Windows 后再次从“已安装的应用”卸载。
  3. 记录安装器或 winget 的完整错误。
  4. 检查企业策略和安全软件是否阻止安装服务。
  5. 不要使用来源不明的“强制卸载工具”清理注册表。

重新安装

完成卸载后,重新选择对应渠道:

重装完成后先验证启动和版本,再恢复配置。这样可以区分“程序损坏”和“旧配置导致问题”。