教程卸载Codex 2026-06-18 1315 次阅读

Codex 完全干净卸载教程：彻底清理所有组件

Codex 多平台卸载教程（macOS/Windows/Linux），彻底清理所有组件。
Codex 完全干净卸载教程：彻底清理所有组件



macOS 卸载教程

删除配置目录会清除所有会话、记忆、权限设置、API Key 配置。卸载前建议备份：cp -r ~/.codex ~/.codex.bak

备份文件中同样含有 API Key 配置，卸载完成后请一并删除：rm -rf ~/.codex.bak（详见第六步验证）。

第一步：停止 Codex 进程

# 停止所有 Codex 进程
pkill -x codex 2>/dev/null || true
killall codex 2>/dev/null || true

第二步：卸载 Codex CLI

方式一：官方脚本安装的

# 删除主程序
rm -f "$HOME/.local/bin/codex"

# 删除 standalone 包
rm -rf "$HOME/.codex/packages"

方式二：npm 安装的

# NodeSource 安装的 Node，npm 全局目录归 root 所有，需要 sudo
sudo npm uninstall -g @openai/codex
sudo npm uninstall -g codex 2>/dev/null

注意： 如果执行 npm uninstall -g 报 The operation was rejected by your operating system（exit 243），就是因为没加 sudo。

第二条命令用于清理旧版 npm 包名 codex；未安装时输出 up to date 且不报错，属正常现象。注意两条都要加 sudo，否则旧包名装了却属于 root 时，错误会被 2>/dev/null 吞掉，包就静默残留下来了。

方式三：Homebrew 安装的

brew uninstall --cask codex 2>/dev/null
brew uninstall codex 2>/dev/null

第三步：删除配置文件和数据

# 删除整个 .codex 目录（包含会话、配置、API Key、缓存等）
rm -rf "$HOME/.codex"

这一步会删除所有配置，包括 ~/.codex/config.toml 中的模型服务商配置（如小米 MiMo）。

第四步：清理环境变量

检查并删除 ~/.zshrc 或 ~/.bash_profile 中的 Codex 相关配置：

# 查看是否有残留（模式要覆盖实际使用的模型服务商，不要只搜 codex）
grep -i -E "codex|deepseek|mimo|_API_KEY|CODEX_HOME" ~/.zshrc
grep -i -E "codex|deepseek|mimo|_API_KEY|CODEX_HOME" ~/.bash_profile

如果有，编辑删除类似这样的行：

# Codex
export PATH="$HOME/.local/bin:$PATH"

# DeepSeek API Key
export DEEPSEEK_API_KEY="***"

# 小米 MiMo API Key
export MIMO_API_KEY="***"

按不同模型服务商的教程安装时，环境变量名也不同（DeepSeek 是 DEEPSEEK_API_KEY，小米 MiMo 是 MIMO_API_KEY）。只搜 codex 会漏掉它们，务必用上面的组合模式检查。

保存后重新加载：

source ~/.zshrc

第五步：清理 npm 缓存（可选）

npm cache clean --force

第六步：验证卸载完成

# 确认命令已不存在
which codex  # 应该输出空或提示 not found

# 确认配置目录已删除
ls ~/.codex  # 应该提示 No such file or directory

# 确认卸载前建的备份也已清理（备份中含有 API Key 配置，不要遗留在机器上）
ls ~/.codex.bak 2>/dev/null && rm -rf ~/.codex.bak && echo "备份已清理" || echo "无备份残留"

# 刷新 shell 缓存
hash -r

卸载完成。如需重装，请参考 Codex 安装与配置完全指南。

Windows 卸载教程

删除配置目录会清除所有会话、记忆、权限设置、API Key 配置。卸载前建议备份：cp -r ~/.codex ~/.codex.bak

备份文件中同样含有 API Key 配置，卸载完成后请一并删除：rm -rf ~/.codex.bak（详见第六步验证）。

请以管理员身份运行 PowerShell

第一步：停止 Codex 进程

# 停止所有 Codex 进程
Get-Process -Name "codex*" -ErrorAction SilentlyContinue | Stop-Process -Force

第二步：卸载 Codex CLI

方式一：官方脚本安装的（Standalone）

# 删除 standalone CLI 二进制文件
Remove-Item -Path "$env:LOCALAPPDATA\Programs\OpenAI\Codex" -Recurse -Force -ErrorAction SilentlyContinue

方式二：npm 安装的

npm uninstall -g @openai/codex
npm uninstall -g codex 2>$null

请按教程开头的要求以管理员身份运行 PowerShell；如仍报权限错误，请检查 npm 全局目录归属。

方式三：桌面应用

# 删除桌面应用
Remove-Item -Path "$env:LOCALAPPDATA\OpenAI\Codex" -Recurse -Force -ErrorAction SilentlyContinue

# 或通过设置卸载
# 设置 → 应用 → 搜索 "Codex" → 卸载

第三步：删除配置文件和数据

# 删除整个 .codex 目录（包含会话、配置、API Key、缓存等）
Remove-Item -Path "$env:USERPROFILE\.codex" -Recurse -Force -ErrorAction SilentlyContinue

第四步：清理环境变量

  1. 按 Win + R，输入 sysdm.cpl，回车
  2. 点击 高级 → 环境变量
  3. 在 用户变量 中检查是否有以下条目：
  4. DEEPSEEK_API_KEY
  5. MIMO_API_KEY（小米 MiMo）
  6. CODEX_HOME
  7. CODEX_API_KEY
  8. OPENAI_API_KEY（如果只给 Codex 用）
  9. 如果有，选中并删除
  10. 在 系统变量 的 Path 中检查是否有 Codex 相关路径，如有则删除
  11. 点击确定保存

第五步：验证卸载完成

# 确认命令已不存在
where.exe codex 2>$null || Write-Host "Codex CLI 已移除"

# 确认配置目录已删除
Test-Path "$env:USERPROFILE\.codex"  # 应该输出 False

# 确认卸载前建的备份也已清理（备份中含有 API Key 配置，不要遗留在机器上）
if (Test-Path "$env:USERPROFILE\.codex.bak") { Remove-Item -Path "$env:USERPROFILE\.codex.bak" -Recurse -Force; Write-Host "备份已清理" } else { Write-Host "无备份残留" }

卸载完成。如需重装，请参考 Codex 安装与配置完全指南。

WSL2 方式卸载

如果你是通过 WSL2 安装的 Codex，按以下步骤卸载。

# 停止进程
pkill -x codex 2>/dev/null || true

# 卸载 CLI
rm -f "$HOME/.local/bin/codex"
sudo npm uninstall -g @openai/codex 2>/dev/null

# 删除配置
rm -rf "$HOME/.codex"

# 清理环境变量（模式要覆盖实际使用的模型服务商）
grep -i -E "codex|deepseek|mimo|_API_KEY|CODEX_HOME" ~/.bashrc
# 如果有，编辑删除后重新加载
source ~/.bashrc

# 验证
which codex 2>/dev/null || echo "Codex CLI 已移除"

Linux 卸载教程（Ubuntu / Debian）

删除配置目录会清除所有会话、记忆、权限设置、API Key 配置。卸载前建议备份：cp -r ~/.codex ~/.codex.bak

备份文件中同样含有 API Key 配置，卸载完成后请一并删除：rm -rf ~/.codex.bak（详见第六步验证）。

第一步：停止所有相关进程

# 停止所有 Codex 进程
pkill -x codex 2>/dev/null || true
killall codex 2>/dev/null || true

第二步：卸载 Codex CLI

方式一：官方脚本安装的

# 删除主程序
rm -f "$HOME/.local/bin/codex"

# 删除 standalone 包
rm -rf "$HOME/.codex/packages"

方式二：npm 安装的

# NodeSource 安装的 Node，npm 全局目录归 root 所有，需要 sudo
sudo npm uninstall -g @openai/codex
sudo npm uninstall -g codex 2>/dev/null

注意： 如果执行 npm uninstall -g 报 The operation was rejected by your operating system（exit 243），就是因为没加 sudo。

第二条命令用于清理旧版 npm 包名 codex；未安装时输出 up to date 且不报错，属正常现象。注意两条都要加 sudo，否则旧包名装了却属于 root 时，错误会被 2>/dev/null 吞掉，包就静默残留下来了。

第三步：删除配置文件和数据

# 删除整个 .codex 目录（包含会话、配置、API Key、缓存等）
rm -rf "$HOME/.codex"

这一步会删除所有配置，包括 ~/.codex/config.toml 中的模型服务商配置（如小米 MiMo）。

第四步：清理环境变量

检查并删除 ~/.bashrc 中的 Codex 相关配置：

# 查看是否有残留（模式要覆盖实际使用的模型服务商，不要只搜 codex）
grep -i -E "codex|deepseek|mimo|_API_KEY|CODEX_HOME" ~/.bashrc

如果有，编辑删除类似这样的行：

# Codex
export PATH="$HOME/.local/bin:$PATH"

# DeepSeek API Key
export DEEPSEEK_API_KEY="***"

# 小米 MiMo API Key
export MIMO_API_KEY="***"

按不同模型服务商的教程安装时，环境变量名也不同（DeepSeek 是 DEEPSEEK_API_KEY，小米 MiMo 是 MIMO_API_KEY）。只搜 codex 会漏掉它们，务必用上面的组合模式检查。

保存后重新加载：

source ~/.bashrc

第五步：清理 npm 缓存（可选）

npm cache clean --force

第六步：验证卸载完成

# 确认命令已不存在
which codex  # 应该输出空或提示 not found

# 确认配置目录已删除
ls ~/.codex  # 应该提示 No such file or directory

# 确认卸载前建的备份也已清理（备份中含有 API Key 配置，不要遗留在机器上）
ls ~/.codex.bak 2>/dev/null && rm -rf ~/.codex.bak && echo "备份已清理" || echo "无备份残留"

# 刷新 shell 缓存
hash -r

卸载完成。如需重装，请参考 Codex 安装与配置完全指南。

卸载 cc-connect（飞书接线用户）

如果你按 Codex 安装与配置完全指南 的「对接飞书」一节安装过 cc-connect，仅卸载 Codex 是不够的：cc-connect 的守护进程会继续在线，但每条消息都会因找不到 codex 而报错（实测报错：exec: "codex": executable file not found in $PATH）。请继续以下步骤：

1. 停止并卸载守护进程

cc-connect daemon stop
cc-connect daemon uninstall

2. 卸载 npm 包

# NodeSource 安装的 Node，全局目录归 root，需要 sudo
sudo npm uninstall -g cc-connect

3. 删除配置和数据

rm -rf ~/.cc-connect

4. 删除 systemd drop-in（按教程创建过的话）

rm -f ~/.config/systemd/user/cc-connect.service.d/env.conf
systemctl --user daemon-reload

5. 验证

which cc-connect                              # 应无输出（命令已移除）

ls ~/.cc-connect 2>/dev/null || echo "无残留"  # 应提示无残留

systemctl --user status cc-connect 2>&1 | head -1   # 应提示 could not be found（服务已移除）

6. 飞书侧清理（可选）

到 飞书开放平台 停用或删除对应的自建应用，避免机器人凭证残留。

Windows 用户将 rm -rf ~/.cc-connect 换成 Remove-Item -Path "$env:USERPROFILE\.cc-connect" -Recurse -Force；守护进程同样用 cc-connect daemon uninstall 移除（Windows 下通过任务计划程序实现）。

.codex 目录结构说明

卸载时删除的 ~/.codex 目录通常包含以下内容（以 0.157.x、npm 安装、正常使用过为例实测）：

~/.codex/
├── config.toml                          # 主配置文件（模型、服务商、审批策略等）
├── installation_id                      # 安装实例 ID
├── sessions/                            # 会话历史（按年/月归档）
├── skills/                              # 技能配置（含 .system 内置技能）
├── shell_snapshots/                     # 每次会话的 shell 环境快照
├── state_*.sqlite（含 -shm/-wal 伴生文件）        # 主状态数据库
├── logs_*.sqlite（含 -shm/-wal 伴生文件）         # 日志数据库
├── goals_*.sqlite（含 -shm/-wal 伴生文件）        # 目标数据库
├── memories_*.sqlite（含 -shm/-wal 伴生文件）     # 记忆数据库
├── queue_*.sqlite（含 -shm/-wal 伴生文件）        # 队列数据库
├── thread_history_*.sqlite（含 -shm/-wal 伴生文件）# 线程历史数据库
├── .tmp/ 和 tmp/                        # 临时文件
├── thread-writer-locks/                 # 线程写入锁
└── .sandbox_migration                   # 沙箱迁移标记

SQLite 数据库文件直接平铺在 ~/.codex/ 根目录下（不在 sqlite/ 子目录里），每个库附带 -shm 和 -wal 两个伴生文件，删除时不用管，rm -rf 会一并清掉。

不同版本、安装方式和使用时长会让目录内容有差异：官方脚本 standalone 安装还会有 packages/ 子目录；执行过 codex login 会生成 auth.json。无需逐项核对。

如果你只想重置配置但保留会话历史，可以只删除 config.toml 而保留其他目录。

如需重装

卸载完成后，参考 Codex 安装与配置完全指南 重新安装。

重装后需要重新配置模型服务商（如小米 MiMo）的 API Key 和 config.toml，之前的会话和记忆无法恢复。

#Codex #卸载 #教程
← 上一篇
Codex 安装与配置完全指南：多平台安装到小米模型接入

评论 (0)

0 / 1000