不要一开始就删除整个 .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 配置。
为什么卸载后还有文件
通常有三类残留:
- 用户配置和认证数据:用于保留设置。
- npm 或其他包管理器缓存:不等于仍然安装。
- 旧 PATH 项或多个可执行文件:导致命令仍指向旧版本。
先使用 Get-Command codex -All、npm list -g --depth=0 和 Windows 已安装应用列表确认来源,再处理对应残留。
彻底重置配置
只有在配置损坏、账号状态异常或明确希望从零开始时才重置 .codex:
- 退出所有 Codex、终端和 Manager 窗口。
- 把
.codex改名为.codex.backup。 - 重新安装并启动 Codex,让它生成新目录。
- 确认问题解决后,只迁回确实需要的配置。
- 不要把旧
auth.json与新登录状态盲目混合。
卸载不掉怎么办
- 在任务管理器中确认 Codex 和 Manager 已退出。
- 重启 Windows 后再次从“已安装的应用”卸载。
- 记录安装器或
winget的完整错误。 - 检查企业策略和安全软件是否阻止安装服务。
- 不要使用来源不明的“强制卸载工具”清理注册表。
重新安装
完成卸载后,重新选择对应渠道:
- 桌面安装与 Code8 Manager:Codex Windows 安装包下载
- 命令行:Codex CLI 安装教程
- 安装前兼容性检查:Codex Windows 系统要求
重装完成后先验证启动和版本,再恢复配置。这样可以区分“程序损坏”和“旧配置导致问题”。