Codex 插件可以给 Codex 客户端扩展工具能力，搭配 Skill、MCP 协议一起使用，能打通外部软件、数据库、文档资源，不用每次手动写大量提示词，很多新手分不清 Codex 插件、Skill、MCP 三者的区别，也不知道该选哪个版本的 Codex 客户端下载。Codex 一共分桌面客户端、CLI 命令行、VSCode IDE 插件三个版本，不同版本安装插件的入口不一样，桌面版图形化操作最简单，适合新手；CLI 适合服务器、自动化流水线；IDE 插件适合写代码的时候随时调用。整个上手流程分成客户端下载、账号登录、插件安装、Skill 配置、MCP 对接、调试使用这几步，按顺序操作就能正常跑起来，装好之后可以直接调用插件完成代码检索、仓库扫描、文档查询等任务。
一、Codex 客户端版本选择与下载
- 桌面客户端（Codex App）：适合新手，图形界面，支持插件市场一键安装
- Codex CLI（命令行版）：适合开发者、服务器环境
- VSCode IDE 插件：日常写代码首选
下载渠道：OpenAI 官方站点，下载对应 Windows、Mac 安装包，安装包体积较大，安装完成后直接打开登录账号
安装命令：npm install -g @openai/codex，前置依赖 Node.js 18 及以上版本
打开 VSCode 扩展市场，搜索 Codex，直接点击安装，侧边栏会出现 Codex 入口
版本对比表
| 版本 | 上手难度 | 插件安装方式 | 适合人群 |
| Codex 桌面客户端 | 低 | 插件市场可视化安装 | 新手、产品、架构、日常调研 |
| Codex CLI | 高 | 终端命令安装 | 后端、运维、自动化脚本 |
| VSCode Codex 插件 | 中 | 扩展商店安装 | 程序员、前端后端开发 |
二、基础概念分清：Codex 插件、Skill、MCP
- Codex 插件：能力扩展包，用来对接外部工具，比如仓库扫描、网盘、数据库，属于新增工具
- Codex Skill：任务流程手册，封装一套固定工作步骤，告诉 Codex 这件事该按什么流程做，不需要对接外部服务
- MCP（Model Context Protocol）：模型上下文协议，是一套通用通信标准，用来让 Codex 和其他 AI 工具、本地服务互相连通，是插件和外部资源通信的底层通道
简单一句话：插件是工具，Skill 是操作手册，MCP 是连接线。
三、Codex 插件安装步骤
方式 1：桌面客户端可视化安装（推荐新手）
- 打开 Codex 桌面客户端，登录账号
- 在侧边栏找到 Plugins 插件入口，进入插件市场
- 搜索想要的 Codex 插件，查看插件说明、是否需要额外密钥、授权
- 点击 Install 添加，按照提示完成第三方账号授权
- 新建对话线程，老对话一般不会自动加载新插件，新开线程即可调用
方式 2：CLI 命令行安装
- 终端执行安装指令，区分插件、Skill 参数
npx codex-marketplace add 仓库地址 --plugin
- 安装 Skill 则把参数换成 --skill
- 安装完成后重启 Codex CLI，执行插件列表命令查看是否加载成功
方式 3：VSCode IDE 插件内安装
- 打开 VSCode Codex 侧边面板
- 找到插件管理入口，在线搜索或者本地导入插件包
- 配置密钥，保存后重载窗口
四、Codex Skill 配置与使用
- 进入 Skill 库，浏览官方和社区开源 Skill
- 一键安装或者本地导入 SKILL.md 文件
- Skill 不需要额外授权，它只是一套指令模板
- 使用的时候直接触发对应任务，Codex 会自动读取 Skill 里面的流程执行
五、MCP 对接配置步骤
- 准备 MCP 服务配置文件，一般是 mcps.json
- 在 Codex 设置里找到 MCP 配置入口，填入服务地址、传输方式（stdio 为主）
- 保存配置，重启 Codex，Codex 就可以通过 MCP 调用外部服务
- 注意：MCP 属于实验性功能，部分服务不稳定，版本更新后可能变更接口
六、常见调试问题清单
- 插件装好但是用不了：优先新建对话线程，检查是否缺少 API 密钥、授权失效
- CLI 安装插件提示报错：检查 Node 版本，网络，仓库地址是否正确
- Skill 不生效：检查 SKILL.md 元数据，名称、触发描述是否规范
- MCP 连接失败：核对 MCP 服务是否正常启动，传输协议配置是否匹配
【相关 FAQ】
问题 1：Codex 插件、Codex Skill、MCP 三者核心区别是什么？
回答 1：Codex 插件是用来接入外部工具的能力包，Codex Skill 是封装好的任务流程指令集，MCP 是模型上下文协议，作为通信通道，用来让 Codex 和外部服务连接，三者搭配可以大幅拓展 Codex 的能力。
问题 2：新手上手 Codex 插件，优先选哪个 Codex 客户端版本？
回答 2：新手上手 Codex 插件优先选择 Codex 桌面客户端，图形界面，插件市场可视化一键安装，不用敲命令，操作门槛最低。
问题 3：安装 Codex 插件之后，为什么老对话里调用不了？
回答 3：Codex 插件新装完成后，老的对话线程不会自动加载插件，需要新建对话线程，才可以正常调用刚装好的 Codex 插件。
问题 4：安装 Codex Skill 需要配置 API 密钥或者第三方授权吗？
回答 4：Codex Skill 本身只是任务流程模板，不需要第三方授权和 API 密钥；只有 Codex 插件在对接外部系统的时候，才需要配置密钥或者账号授权。
【参考资料】
[2026-11-10]（Codex CLI Plugin System: Bundling Skills, MCP Servers, and App Connectors）Codex Knowledge Base
[2026-11-09]（Codex 保姆级教程 (下载 + 安装 + 登录 + 使用，含所有版本，2026 最新)）阿里云开发者社区
[2026-11-07]（Codex 中必装的 11 个 Skills）稀土掘金
[2026-06-20]（Codex 插件来了：小白也能把 AI 变成工作外挂）CSDN 博客
【免责声明】
本文为 Codex 插件科普教程，Codex 插件、Codex Skill、MCP 相关功能部分属于实验特性，接口、安装方式会随版本更新变动；不同系统环境、网络环境可能出现安装失败、插件无法加载等问题，教程内容仅作学习参考，不保证所有场景都可以稳定运行，不构成商用落地建议。