Codex Plugins 插件机制与本地安装教程关键词Codex Plugins、OpenAI 插件系统、Codex plugin.json、Codex 本地插件安装、marketplace 插件目录、Codex skills、MCP 插件、AI 工作流插件化 这篇内容基于 OpenAI Codex 官方 Plugins 文档整理重点从“能实际用起来”的角度解释插件是什么、怎么安装、本地怎么跑通以及 plugin.json 的结构到底在干什么。一、Codex Plugins 是什么先建立正确认知Codex Plugins 本质不是“浏览器插件”或“IDE 扩展”而是一个更偏工程化的概念一套可复用的 AI 工作流打包方案Workflow Bundle可以把它理解成一套 prompt 规则 工具调用方式的封装可跨项目安装复用类似“npm 包”但内容是 AI 工作流能力一个插件通常可以包含Skills具体任务执行规则核心Apps外部应用集成可选MCP servers外部工具/上下文服务可选二、官方插件目录长什么样官方文档里的插件目录更像一个“能力市场”它不是简单列表而是Codex 能力的可安装集合类似工作流商店三、6 个关键结论建议先记住Codex Plugin 可安装的 AI 工作流包一个插件 skills apps MCP组合CLI / UI 都可以安装插件小需求先写 skill不一定要做 plugin需要跨项目复用时才升级为 plugin官方公共插件发布能力仍在逐步开放四、普通用户怎么使用插件1在 Codex App 中安装官方提供插件目录入口可以直接安装选择插件一键启用自动加载 skills / 工具配置这一步的意义是不需要手写 prompt 体系直接用别人封装好的工作流2CLI 方式使用插件在命令行中codex /plugins界面效果如下说明一点Codex 插件体系是 CLI GUI 双入口的而不是只服务网页端五、本地插件怎么创建核心重点方式1使用 plugin-creator推荐官方推荐方式是plugin-creator它可以自动帮你生成plugin.json本地插件结构marketplace 配置用于测试效果方式2手动创建理解结构用一个最小插件结构如下my-plugin/ ├── .codex-plugin/ │ └── plugin.json ├── skills/ │ └── demo-skill/ │ └── SKILL.md六、plugin.json 是什么核心配置最简版本{name:my-first-plugin,version:1.0.0,description:一个可复用工作流插件,skills:./skills/}常见字段解释字段作用name插件唯一标识version版本控制description插件说明skillsskills 目录入口七、marketplace 是什么容易误解点很多人会误以为 marketplace 是“插件商店”实际上marketplace 插件索引 JSON 文件Codex 通过它来加载插件列表。1Repo marketplace仓库级适用于项目内插件$REPO_ROOT/.agents/plugins/marketplace.json插件目录$REPO_ROOT/plugins/my-plugin示例结构{name:local-repo,interface:{displayName:项目插件集},plugins:[{name:my-plugin,source:{source:local,path:./plugins/my-plugin},policy:{installation:AVAILABLE,authentication:ON_INSTALL},category:Productivity}]}2Personal marketplace个人级适用于跨项目复用~/.agents/plugins/marketplace.json插件目录~/.codex/plugins/my-plugin八、插件缓存机制理解安装过程Codex 安装后会缓存插件~/.codex/plugins/cache/$MARKETPLACE/$PLUGIN/$VERSION/本地插件版本通常是local启用状态记录在~/.codex/config.toml九、完整插件目录结构一个标准插件通常如下my-plugin/ ├── .codex-plugin/ │ └── plugin.json ├── skills/ │ └── my-skill/ │ └── SKILL.md ├── .app.json ├── .mcp.json └── assets/ ├── icon.png └── logo.png关键点.codex-plugin/是入口skills 是核心逻辑mcp/app 是扩展能力assets 是展示资源十、什么时候需要做 plugin✔ 适合做 plugin多项目复用同一套工作流需要团队统一能力skills MCP 工具链组合使用✔ 不适合单项目临时逻辑还在试验阶段只需要一个 prompt十一、最小可运行路径建议流程一个比较稳的实践路径先写SKILL.md在当前项目验证效果再封装 plugin.json加入 marketplace最后扩展 MCP / Apps十二、官方当前状态根据文档插件目录已存在本地插件支持完整marketplace支持本地公共发布仍在推进中coming soon总结Codex Plugins 本质上是在做一件事把 AI 使用方式从“写 prompt”升级为“安装工作流能力包”它更接近npm代码依赖docker image环境封装workflow engine流程封装三者的结合体。如果后面要进一步落地通常会延伸到两个方向MCP 服务体系工具扩展skills 工程化拆分类似微服务如果你需要我可以再补一篇更偏实战的「Codex Plugin 从0到1完整开发示例含 MCP 接入」