夜雨聆风许多开发者在使用 Codex 时，会发现“Harness”这个词反复出现。实际上，Codex Harness 并非单一工具，而是指 OpenAI 官方 CLI 工具以及围绕它开发的诸多社区插件（如自动化工作流、MCP 协议服务器等）。
本文将主流工具的安装与卸载方法一网打尽，建议收藏备用。
一、基石：安装 OpenAI 官方 Codex CLI
这是所有后续操作的基础环境，绝大部分功能都依赖它。
🛠️ 安装步骤
• 前提条件：请确保系统已安装 Node.js 18 或更高版本。
npm install -g @openai/codex
codex --version 若终端返回版本号数字，则代表安装成功。
🗑️ 卸载方法如需完全移除，执行全局卸载命令即可：
npm uninstall -g @openai/codex
二、常用社区扩展包安装与卸载（按需操作）
以下插件各有侧重，您可以根据实际项目需求选择安装。
1. 初始化工具包：@pzy560117/codex-harness
• 作用：用于快速初始化和驱动特定项目结构。
npx @pzy560117/codex-harness init
npm install -g @pzy560117/codex-harness 安装完成后，使用
harness init命令即可。
npm uninstall -g @pzy560117/codex-harness
2. 工程化服务器：codex-harness-mcp（MCP协议）
• 作用：为 Codex CLI 提供更强大的工程上下文能力。
npx skills add chapzin/codex-harness-mcp -g -a codex -y --copy
node scripts/install-codex-harness-mcp.mjs
• 验证：执行 codex mcp list 查看是否在列表中。
• 卸载：通常在其项目目录内，移除 node_modules 或查阅其 package.json 中提供的卸载脚本。
3. 规范驱动工作流：zxdxjtu/harness
• 作用：适用于 Spec-Driven（规范驱动）的开发流程。
git clone https://github.com/zxdxjtu/harness ~/.codex/plugins/harness
rm -rf ~/.codex/plugins/harness
三、重要一步：手动清理残留配置文件
⚠️ 请注意：执行上述卸载命令后，程序本体虽然没了，但用户配置和数据文件并不会自动删除。如果您需要彻底重置或释放空间，请务必手动清理以下目录。
• ~/.codex —— 官方 CLI 的本地配置与历史
• ~/.codex-harness/ —— 部分插件的独立配置
• ~/.agent-bridge/ —— 代理桥接残留
• ~/.arize/ —— 追踪工具残留
🖥️ Mac / Linux 用户 可使用命令行删除（请替换为您实际存在的路径）：
rm -rf ~/.codex
🖥️ Windows 用户 注意：路径通常在 C:\Users\你的用户名\ 下。若为桌面应用版，请前往“控制面板 -> 卸载程序”进行常规卸载。
四、特殊工具一键“深度卸载”
如果您安装过以下特定工具，直接使用官方提供的专用脚本更彻底。
• 卸载 codex-agent-bridge
npx -y codex-agent-bridge uninstall
npx -y codex-agent-bridge uninstall --purge
• 卸载 coding-harness-tracing
curl -sSL https://raw.githubusercontent.com/Arize-ai/coding-harness-tracing/main/install.sh | bash -s – uninstall codex
iwr -useb https://raw.githubusercontent.com/Arize-ai/coding-harness-tracing/main/install.bat -OutFile $env:TEMP\install.bat & $env:TEMP\install.bat uninstall codex
五、IDE 内置插件卸载（JetBrains 系）
如果您是在 IntelliJ IDEA 等 IDE 中通过插件市场安装的，完全不需要敲命令：
• 在 IDE 中双击 Shift 键，呼出“Search Everywhere”全局搜索框。
• 输入 Cleanup Codex Installation 并选择该功能，即可一键移除插件并附带清理配置。
六、极简速查清单（给赶时间的你）
• 🆕 初次安装官方 CLI：直接复制 npm install -g @openai/codex
• 🚫 彻底卸载官方 CLI：执行 npm uninstall -g @openai/codex，再手动删掉 ~/.codex 文件夹
• 🧹 清理所有相关配置：检查并删除 ~/.codex、~/.codex-harness、~/.agent-bridge、~/.arize
• 🧩 卸载 IDE 插件版：使用 IDE 自带的 Cleanup Codex Installation 功能
💡 最后提示
如果在终端操作时遇到 EACCES 权限错误：
• Mac / Linux 用户请在命令前加上 sudo。
• Windows 用户请以“管理员身份”运行终端（CMD 或 PowerShell）。
若您安装的是其他小众变体版本，建议优先查阅对应工具的 GitHub 仓库首页说明，以获取最精准的维护信息。