Codex技能包快速卸载:清理无效扩展释放空间
彻底卸载 Codex 技能包(即通过 CLI 安装的 Superpowers 插件)时,仅执行默认卸载流程会遗留配置文件、缓存数据甚至 API 密钥,导致系统响应变慢或带来安全风险。核心操作只有一句:必须手动删除用户数据目录中的插件子目录及关联缓存,普通卸载命令无法完成。
具体操作为:删除 Windows 下 %USERPROFILE%\.codex\superpowers 或 macOS/Linux 下 ~/.codex/superpowers 整个目录,同时清除 .cache、index.json 等缓存文件,最后执行 codex superpower list --refresh 重建索引。按以下步骤操作即可确保无残留。
确认 Superpowers 插件安装目录
Codex CLI 的 Superpowers 插件默认存放在用户主目录配置文件夹的 .codex/superpowers 子目录中。Windows 路径为 %USERPROFILE%\.codex\superpowers,macOS/Linux 路径为 ~/.codex/superpowers。务必先确认该路径,避免误删其他配置。打开终端(PowerShell / Terminal)并执行以下命令检查:
Windows:echo %USERPROFILE%\.codex\superpowers
macOS/Linux:echo ~/.codex/superpowers
若返回有效路径且文件夹非空,说明插件已安装;若提示目录不存在,则无需继续。
删除插件主目录并清理运行时缓存
Superpowers 插件本质上是本地 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 永久删除
【注意:此操作不可逆,删除前请确认该目录不包含个人开发的技能代码】
清除 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 superpower list --refresh
该命令会强制重建 index.json,跳过已不存在的插件路径。若提示 command not found,说明 CLI 本身已卸载,跳过此步。
第三步:验证清理效果
运行 codex superpower list,输出应为空或仅显示内置基础能力(如 shell、git),不再出现任何第三方插件名称。至此才算彻底卸载。
