Win/Mac版Codex插件卸载残留清理最新最全高效方法指南：彻底释放系统空间
卸载Codex插件后磁盘空间未释放？重装时旧技能仍被加载，CLI提示“superpower not found”，根本原因在于插件主目录虽被删除，但缓存、索引、会话日志与用户配置仍然占据几百MB至数GB空间。彻底清理需按顺序操作，遗漏任一环节都会导致残留。
在动手前，先确认技能包是否真实安装。Codex CLI的Superpowers（技能包）默认不独立安装，而是以.codex/superpowers子目录形式嵌套在用户主目录的配置文件夹内。
Windows用户打开PowerShell，执行：
echo %USERPROFILE%\.codex\superpowers
macOS/Linux用户打开终端，执行：
echo ~/.codex/superpowers
回车后若返回路径且目录非空（例如C:\Users\Name\.codex\superpowers），说明技能包已安装；若提示“目录不存在”或返回空行，则无需继续。
核实 Codex 技能包是否实际部署
该步骤不可跳过，否则后续删除可能误伤无关文件。上述验证命令已给出：技能包路径为空时直接终止流程。
移除技能包主目录与运行时缓存
技能包本质为本地Node.js模块集合，卸载时只需删除整个superpowers文件夹，但必须同步清理其生成的临时缓存——否则下次Codex CLI启动仍会尝试加载失效模块并引发错误。
方法一：命令行一键清理（推荐）
Windows（PowerShell管理员模式）：
Remove-Item -Recurse -Force "$env:USERPROFILE\.codex\superpowers"
macOS/Linux：
rm -rf ~/.codex/superpowers
方法二：手动定位删除
1. 打开文件资源管理器（Windows）或访达（macOS）
2. 地址栏粘贴 %USERPROFILE%\.codex\superpowers（Windows）或 ~/.codex/superpowers（macOS/Linux）→ 回车
3. 选中整个superpowers文件夹 → Shift+Delete（Windows）或Command+Delete（macOS）永久删除
注意：此操作不可逆，删除前请确认该目录下无自定义开发的技能代码。
清除 CLI 运行时残留缓存与插件索引
Codex CLI启动时读取.codex/cache和.codex/index.json以加速插件加载。技能包删除后这些缓存不会自动更新，导致命令卡顿或报“superpower not found”。
第一步：清空缓存目录
Windows：
del /s /q "%USERPROFILE%\.codex\cache"
macOS/Linux：
rm -rf ~/.codex/cache
第二步：删除插件索引文件
直接删除~/.codex/index.json（Windows对应路径为%USERPROFILE%\.codex\index.json）
该文件是CLI加载插件时的元数据快照，残留会导致list命令始终显示已卸载的技能。
第三步：重建插件索引
执行codex superpower list --refresh
这会强制CLI扫描当前可用技能，确认superpowers目录为空后，输出应为“No superpowers installed.”
清理 Codex 会话配额与本地日志
Codex Quota功能通过读取~/.codex/sessions/下的本地会话日志，检查OpenAI Codex CLI的速率限制状态（按日/周配额）。这些日志文件不随插件卸载自动清除，长期积累可达数十MB，且包含时间戳与API调用摘要。
执行：
rm -rf ~/.codex/sessions/
Windows用户对应路径为：
del /s /q "%USERPROFILE%\.codex\sessions"
该目录仅存储只读日志，删除不影响当前CLI功能，但会重置本地配额统计——下次调用codex quota将从零开始计数。
验证卸载是否彻底
执行codex superpower list
输出应为“No superpowers installed.”，且无任何路径报错。
检查用户主目录下是否还存在以下任一残留：
• %USERPROFILE%\.codex\superpowers（Windows）
• ~/.codex/superpowers（macOS/Linux）
• %USERPROFILE%\.codex\cache（Windows）
• ~/.codex/cache（macOS/Linux）
• %USERPROFILE%\.codex\index.json（Windows）
• ~/.codex/index.json（macOS/Linux）
• %USERPROFILE%\.codex\sessions（Windows）
• ~/.codex/sessions（macOS/Linux）
任一路径存在且非空，说明清理未完成，需要返回对应步骤重新操作。