Codex / Claude Code · 高级

Codex 官方 Plugins 与 Codex++ 有什么区别

Codex 已有官方 Plugins 和 Skills;Codex++ 则是会修改桌面应用的第三方 tweak runtime。小白先用官方扩展,只有官方设置无法满足特定 UI 需求时才评估 Codex++。

  • Codex Plugins
  • Codex++
  • Codex Desktop
  • Tweak
  • Skills
  • 安全
更新于 2026-08-13

一句话结论

要复用工作流、连接服务或分发 Skills,先选官方 Plugins;要改 Codex 桌面 UI 才考虑 Codex++,并接受 patch、签名和更新失效风险。

适用场景

  • 想给 Codex 安装可复用工作流、Skills、连接器或 MCP 工具,不确定该用官方 Plugins 还是第三方补丁
  • 你已经重度使用 Codex Desktop,想要快捷键、Better Terminal、Better Browser、Tab Switcher 或额外目标 UI
  • 你想理解 Codex++ Tweak Store 里的插件都在做什么,哪些适合装,哪些要谨慎
  • 你遇到 Codex Desktop 缺某个小功能,想知道能不能用本地 tweak 补上
  • 你愿意承担第三方补丁、App 重新签名、Codex 更新后 repair 的维护成本

常见现象

  • 官方 `/goal` 已可用,但你仍想要第三方 active-goal UI 或其他增强设置
  • 想改快捷键、隐藏干扰项、增强终端或浏览器面板,但官方设置里没有
  • 看到别人说安装 Codex++ 后 Settings 里多了 Tweaks / Tweak Store,不知道是否安全
  • Codex 更新后 Codex++ 失效,或者出现 failed to patch Codex after update / Codex is damaged 之类提示

原因解释

  • 官方 Plugin 是可安装的能力包,可以包含 Skills、连接器、MCP 配置、Hooks 等,并通过受支持的 Plugin 目录或 marketplace 分发。
  • Codex++ 不是官方 Plugin 系统,而是会 patch 本地 Codex.app 或旧 Windows Store 版 Codex 可写副本的第三方 tweak runtime。
  • 它通过 loader + runtime 的方式启动:loader 被注入到 app.asar,runtime 放在用户目录,tweaks 放在 tweaks 目录。
  • tweak 本质是本地代码,可以改 Codex UI,部分还能运行 main process、访问文件或同步 MCP,所以必须只装可信来源。
  • Codex Desktop 更新会覆盖本地 patch,Codex++ 需要 watcher 或手动 repair 重新打补丁。

解决步骤

  1. 先判断需求:复用指令用 Skill;需要安装、分享多个 Skills 或连接外部服务用官方 Plugin;只有修改桌面 UI 才进入 Codex++ 路线。
  2. 官方路线先在 ChatGPT 桌面应用或 Codex CLI 的 Plugins 入口查看来源、权限和包含内容;安装后新开会话,用一个不含敏感数据的最小任务验证。
  3. 如果 Plugin 含连接器、MCP、Browser extension、Hook 或计划任务模板,逐项确认数据去向、认证、工具审批和卸载影响,不要把安装等同于授权所有动作。
  4. 安装前备份重要工作,关闭 Codex,确认你知道如何卸载和进入 safe mode。
  5. 优先使用 Homebrew 或 Bun 的 release 安装方式,不建议一上来执行 curl 管道脚本,除非你能看懂脚本做了什么。
  6. 安装后先运行 codexplusplus status 和 codexplusplus doctor,确认 patch、签名、watcher、runtime 状态正常。
  7. 第一批只装低风险 tweak:Keyboard Shortcuts、UI Improvements、Goal。涉及文件编辑、MCP、主进程、网络权限的 tweak 先不要装。
  8. 每次 Codex 官方更新后,如果 Codex++ 消失或 Tweaks 不见,先跑 codexplusplus repair;严重异常就 safe-mode 或 uninstall。
  9. 长期使用时,把 Codex++ 当成可撤回的增强层,不要把关键生产流程完全依赖在某个未审查 tweak 上。

可复制命令

# macOS 推荐安装路径:Homebrew
brew install b-nnett/codex-plusplus/codexplusplus
codexplusplus install
codexplusplus status
codexplusplus doctor
# Bun 安装方式。适合已经在用 Bun 的用户
bun install -g github:b-nnett/codex-plusplus
codexplusplus install
codexplusplus status
# Windows:先打开官方 v1.0.0 Release 和 README,下载并检查安装脚本后再运行
# https://github.com/b-nnett/codex-plusplus/releases/tag/v1.0.0
# 不要直接执行 main 分支的远程脚本管道
codexplusplus status
codexplusplus doctor
# 日常维护:更新、修复、检查
codexplusplus status
codexplusplus doctor
codexplusplus repair
codexplusplus update
# Codex 官方更新前后。macOS 上 Codex++ 修改过 App,官方 updater 需要先恢复签名版 Codex
codexplusplus update-codex
# Codex 更新完成后,如果 watcher 没自动修复,再手动跑
codexplusplus repair
# 出问题时先进入安全模式,不删除 tweak,只暂停加载
codexplusplus safe-mode
codexplusplus status

# 退出安全模式
codexplusplus safe-mode --off
# 卸载并恢复 Codex
codexplusplus uninstall

# 连同 Codex++ 用户数据和 tweaks 一起清理(不可恢复,先备份需要保留的内容)
codexplusplus uninstall --purge
# tweak 开发者常用命令
codexplusplus create-tweak ./my-tweak --id com.you.my-tweak --name "My Tweak" --repo you/my-tweak --scope renderer
codexplusplus validate-tweak ./my-tweak
codexplusplus dev ./my-tweak --replace
{
  "id": "com.you.my-tweak",
  "name": "My Tweak",
  "version": "0.1.0",
  "githubRepo": "you/my-tweak",
  "description": "Adds one small UI improvement.",
  "scope": "renderer",
  "main": "index.js"
}
module.exports = {
  start(api) {
    api.settings.register({
      id: "main",
      title: "My Tweak",
      description: "A tiny test section.",
      render(root) {
        root.innerHTML = "<p>hello from Codex++</p>";
      }
    });
  },
  stop() {}
};

仍然不行怎么办

  • 只是想复用一套提示词或脚本:先建本地 Skill,不需要 Plugin,更不需要 patch 客户端。
  • 需要连接 GitHub、Slack、Google Drive 等服务:先查官方 Plugin 目录;连接器仍要单独认证和审批。
  • Codex 提示 damaged 或打不开:先跑 codexplusplus doctor,备份 Codex++ 配置和 tweaks,再按当前项目文档尝试普通 repair;`repair --force` 只作为确认备份可恢复后的高级兜底。
  • Settings 里看不到 Tweaks:先打开 DevTools 看是否有 [codex-plusplus] 日志,再检查 codexplusplus status;可能是 Codex UI 更新后 Settings DOM 变了。
  • Codex 更新后 Codex++ 消失:这是常见情况,先等 watcher 自动 repair;不行就手动 codexplusplus repair。
  • 某个 tweak 装完后 Codex 异常:先 codexplusplus safe-mode,确认是 tweak 问题后再逐个禁用或删除对应 tweak 目录。
  • Windows 上装完没效果:确认启动的是 Codex++ 快捷方式,不是 Microsoft Store 原 Codex 快捷方式。
  • 你只是想稳定写代码,不想维护补丁:不要装 Codex++,优先用官方 Codex Desktop / CLI 和 AGENTS.md。

先走官方 Plugins / Skills 路线

  • Skill 是聚焦单个任务的说明、参考资料和可选脚本;适合个人或仓库内持续迭代。
  • Plugin 是可安装分发包,可组合 Skills、连接器、MCP、Browser extension、Hooks 和计划任务模板;适合团队共享或连接外部服务。
  • ChatGPT 与 Codex 使用统一的公开 Plugin 目录;Codex CLI 也提供 Plugin 浏览入口。官方当前说明不把 IDE extension 列为 Plugin 使用入口。
  • 安装 Plugin 后通常要新开会话;含连接器或 MCP 的 Plugin 可能还需要登录和单独设置工具审批。
  • 用 OpenAI API Key 登录 Codex 时只能使用受支持的 OpenAI curated Plugins;依赖不受支持 OAuth 流程的 Plugin 可能不可用。
  • 官方 Plugin 仍是可执行扩展:检查来源、权限、Hooks、数据去向和卸载影响,不要因为在目录里就默认零风险。

三种扩展方式怎么选

  • 本地 Skill:适合固定审查流程、写作模板、项目命令和小型脚本;影响范围最小。
  • 官方 Plugin:适合分发多个 Skills、连接服务或统一配置 MCP;优先于第三方 UI patch。
  • Codex++ tweak:只用于官方能力无法提供的桌面 UI、快捷键、终端或浏览器面板改造;需要备用环境、回滚和兼容性维护。

它到底改了你电脑上的什么

  • macOS 上会定位 /Applications/Codex.app,备份原文件,然后修改 Contents/Resources/app.asar 的入口,让 Codex 启动时先加载 Codex++ loader。
  • 它会重新计算 app.asar 的 integrity hash,写回 Info.plist,并处理 Electron asar integrity 相关设置。
  • macOS 上需要重新签名 Codex.app。项目默认使用 ad-hoc 签名,也可以用 --local 选择稳定本地签名身份。
  • runtime、配置、日志、tweaks 都放在用户目录,macOS 通常是 ~/Library/Application Support/codex-plusplus/。
  • Windows Store 版 Codex 不容易直接写入,所以 Codex++ 会把 Store app 镜像到 %LOCALAPPDATA%/codex-plusplus/ 下的可写副本,并创建 Codex++ 启动器。
  • 这就是为什么它很强,也为什么它比普通 VS Code 插件、npm 包或 AGENTS.md 风险更高。

目录位置小抄

  • macOS 用户数据:~/Library/Application Support/codex-plusplus/
  • Linux 用户数据:~/.local/share/codex-plusplus/,或 $XDG_DATA_HOME/codex-plusplus/
  • Windows 用户数据:%APPDATA%/codex-plusplus/
  • Windows 管理版 Codex 副本:%LOCALAPPDATA%/codex-plusplus/store-apps/
  • runtime:<user-data-dir>/runtime/
  • tweaks:<user-data-dir>/tweaks/
  • 每个 tweak 自己的数据:<user-data-dir>/tweak-data/<tweak-id>/
  • 日志:<user-data-dir>/log/
  • 备份:<user-data-dir>/backup/
  • 配置:<user-data-dir>/config.json

安装前安全清单

  1. 确认你下载的是 b-nnett/codex-plusplus 官方仓库,不是别人复制的同名仓库。
  2. 先读 README、SECURITY.md、Troubleshooting,至少知道 uninstall、repair、safe-mode 三个命令。
  3. 不要在生产机器、公司受管机器、承载关键服务的机器上先试。
  4. 不要一次安装很多 tweak,先装一个、重启、观察一天。
  5. 安装 tweak 前看 manifest.json:scope 是 renderer / main / both;permissions 是否包含 filesystem、network、mcp、codex.windows。
  6. Tweak Store 里的 approvedCommitSha 说明它按固定 commit 审核;但审核不等于零风险,仍然要看源码和 release。
  7. 涉及文件编辑、MCP、主进程、网络访问的 tweak,要比单纯 UI tweak 更谨慎。
  8. 任何时候发现 Codex 异常,先 safe-mode,不要继续叠加新 tweak。

小白最稳的试用路线

  1. 先不安装,写清自己需要的是工作流、外部连接还是桌面 UI 改造。
  2. 工作流先试本地 Skill;需要分发或连接服务再试官方 Plugin。
  3. 只有前两种都解决不了具体 UI 需求,才继续评估 Codex++。
  4. 新建一个测试 macOS 用户或备用 Windows 环境,避免影响主工作环境。
  5. 用 Homebrew / Bun / PowerShell 安装,不要同时混用多种安装方式。
  6. 安装后只运行 status 和 doctor,不急着装新 tweak。
  7. 先试 Custom Keyboard Shortcuts 或 UI Improvements 这类低风险 UI tweak。
  8. 需要长任务目标时先用官方 `/goal`;只有确实需要额外 active-goal UI,且已核对当前兼容性时,才评估 Goal tweak。
  9. 最后才考虑 Better Terminal、File Editor、Windows Computer Use 这类权限更重的 tweak。
  10. 跑一周稳定后,再决定要不要装到主力机器。

tweak 是怎么被加载的

  • 每个 tweak 是一个文件夹,里面至少有 manifest.json 和 index.js / index.mjs / index.cjs。
  • manifest 必须有 id、name、version、githubRepo;githubRepo 用来检查 GitHub release 更新。
  • scope 默认是 renderer;main 或 both 表示它会进入更高权限的主进程侧。
  • runtime 会扫描 tweaks 目录,读取 manifest,再 require 入口文件,调用 start(api)。
  • renderer 侧 api 包括 settings、react、ipc、fs、storage、log;main 侧可注册 IPC handler。
  • Codex++ 不会自动更新 tweak,它只提示有新 release,让用户自己审查后手动替换。

Tweak Store 的审核模型

  • Codex++ 的 Tweak Store 从 https://b-nnett.github.io/codex-plusplus/store/index.json 读取注册表。
  • 每个条目会固定 approvedCommitSha,也就是管理员审核过的精确 commit。
  • 安装时按 commit archive 下载,而不是直接拉默认分支最新代码,这比随时跟 main 安全。
  • 发布新 tweak 的流程是提交 GitHub repo,生成 issue,让管理员按 commit 审核 manifest、源码和图标。
  • 这能降低供应链风险,但不能代替你自己判断:本地插件仍然是可执行代码。

它和 /goal 命令有什么关系

  • 当前官方 Codex 已内置 `/goal`;目标管理先用官方命令,不需要第三方补丁。
  • Codex++ Store 的 Goal tweak 属于历史补充路线,当前主要价值只可能是额外 active-goal UI,不能再宣传为 `/goal` 的来源。
  • 如果你只需要理解 Codex 里的 `/goal`,查看当前 Codex 手册和 `/help`,不要安装 Codex++。
  • 只有官方目标功能已满足不了具体 UI 需求,且你愿意承担 patch 风险时,才评估 Goal tweak。
  • 安装 Goal tweak 前,打开当前 Store 条目核对 minRuntime;不要把旧教程记录的最低版本当成长期有效值。

常见问题怎么判断

  • Codex is damaged and can't be opened:先用 doctor 确认签名或 Gatekeeper 等具体原因,备份后尝试普通 repair;`repair --force` 只作为确认可恢复后的高级兜底。
  • App 启动但 Settings 没有 Tweaks:可能 loader 没执行,也可能 Settings DOM 变了。先看日志和 DevTools。
  • Codex 自动更新后 patch 没了:这是预期风险,先 repair;Watcher 正常时会自动处理。
  • 某个 tweak 失败:多半是 manifest JSON 不合法、入口文件路径不对、用了错误模块格式,或者 start() 抛错。
  • Windows 安装后还是原版 Codex:检查你打开的是 Codex++ 启动器,不是 Microsoft Store Codex。
  • uninstall 不完整:项目文档建议必要时重新安装官方 Codex,再重新 install / uninstall。

当前版本状态

  • 截至 2026-08-13,Codex++ GitHub 标记的 latest release 仍是 1.0.0,发布于 2026-05-31;项目将它称为本地 tweak/runtime 层的首个稳定版。
  • Codex 0.146—0.147 已加入官方 Agent Plugins、多个 marketplace 来源、Cursor-managed Skills 导入与 MCP 2026-07-28 支持;这改变了默认选择顺序,但不会自动取代 Codex++ 的 UI tweak。
  • 1.0.0 改进了 Codex 更新后的 patch / re-patch 流程,并新增 codexplusplus debug,便于查看安装路径、runtime、数据目录和 bridge 状态。
  • 这一版不再默认安装 tweak,并强化了 Windows 卸载清理;需要清空 Codex++ 用户数据时可以使用 uninstall --purge。
  • “稳定版”不等于官方插件:它仍会修改本地 Codex App,Codex 官方更新后也可能需要 repair。小白不要先在生产机器或公司受管设备上试。
  • 仓库热度、issue 数量和兼容状态会变化;安装前再看最新 release、README、Security Policy 和未解决问题。

参考来源

相关问题

还卡着?

仅把删除凭证、客户数据和环境变量值后的必要截图、日志片段、需求说明或当前页面链接发到 zhemuy@gmail.com。