Codex 插件是一套打包了 Skill 技能、MCP 服务连接、工具连接器的 AI 能力包，支持桌面客户端、CLI 命令行、VSCode 扩展三种使用形态，新手优先下载桌面客户端，从插件市场一键安装，再理解 MCP 协议和 Skill 的作用，就能快速打通代码读取、工具调用、外部服务对接能力，不用手动写复杂配置。很多新手容易混淆 Codex 插件、Skill、MCP 三者的关系，简单来说 MCP 是统一通信协议，用来让 Codex 和外部工具、数据库、文档服务通信；Skill 是封装好的任务流程、提示词规则；插件是打包好的合集，里面可以同时包含 MCP 服务配置、Skill 脚本、连接器，一次安装就能获得整套能力。整套上手流程是先下载并登录 Codex 客户端，再选择插件市场安装插件，按需配置 MCP 服务，测试 Skill 执行，最后在对话里直接调用工具，适合开发、代码审查、对接各类第三方 AI 工具场景。
Codex 三种客户端形态清单
- 桌面客户端 App：Windows/macOS 图形界面，自带插件市场，适合新手，可视化安装管理插件
- Codex CLI 命令行：适合服务器、自动化脚本、批量任务，全部插件操作靠命令执行
- VSCode 扩展：编辑器内直接调用 Codex，和开发工作流结合，需要提前装好 CLI
Codex 插件、Skill、MCP 概念对照表
| 名词 | 含义 | 作用 |
|---|---|---|
| Codex 插件 | 能力合集包 | 打包 MCP 配置、Skill、连接器、脚本，一键安装启用 |
| Skill | 任务技能单元 | 固定流程、提示词、执行逻辑，用来完成一类任务，比如代码评审、接口生成 |
| MCP | Model Context Protocol | 模型上下文协议，统一接口标准，Codex 通过 MCP 对接外部工具、服务、文档 |
完整上手操作步骤
- 前往官方下载页，选择对应系统版本下载 Codex 桌面客户端，mac 区分 Apple Silicon 和 Intel 版本，Windows 直接下通用版
- 安装完成后打开客户端，执行登录，CLI 用户在终端执行codex login完成账号认证
- 进入插件市场，浏览官方和社区插件，点击安装；CLI 用户可以用codex plugin marketplace list查看，codex plugin add 插件名安装
- 插件安装完成后，新开对话线程加载插件，部分插件需要手动配置 MCP 服务地址、密钥、OAuth 授权
- 查看已安装 Skill：桌面端可以在技能面板查看，CLI 用ug skills add管理技能包
- 测试调用：直接用自然语言下达指令，Codex 自动加载对应插件、通过 MCP 调用外部工具、执行 Skill 流程
- 排错：插件异常时，重启 Codex，检查~/.codex/config.toml配置文件，核对 MCP 服务连通性
常用 Codex 命令清单（CLI）
- codex plugin list：查看本地已安装插件
- codex plugin add xxx：安装指定插件
- codex plugin remove xxx：卸载插件
- codex mcp add：添加自定义 MCP 服务
- ug skills add：添加 Skill 技能包
- codex login：账号登录认证
常见踩坑与限制说明
- 插件安装后需要新开对话线程，旧会话不会自动加载新插件
- MCP 服务依赖网络，部分自建 MCP 服务需要填写 Token、鉴权信息才能连通
- Skill 是固定任务逻辑，不支持无限制自由修改，需要自定义流程要自己编写 Skill 文件
- VSCode 扩展需要保证 CLI 版本和扩展版本匹配，否则会找不到 Codex 运行时
- 不要一次性安装大量无关插件，容易造成加载变慢、冲突报错
【常见问题】
问题 1：Codex 插件使用指南，从下载到上手全流程，Codex 插件、Skill、MCP 三者是什么关系？
回答 1：Codex 插件使用指南，从下载到上手全流程里，MCP 是通信协议，Skill 是封装好的任务技能，Codex 插件是打包 MCP 配置、Skill、连接器的能力包，一次安装就能获得整套能力。
问题 2：Codex 插件使用指南，从下载到上手全流程，Codex 客户端有哪几种版本？
回答 2：Codex 插件使用指南，从下载到上手全流程，Codex 包含桌面图形客户端、CLI 命令行工具、VSCode 编辑器扩展三种形态，可以按需选择。
问题 3：Codex 插件使用指南，从下载到上手全流程，新手推荐怎么安装 Codex 插件？
回答 3：Codex 插件使用指南，从下载到上手全流程，新手优先下载桌面客户端，在内置插件市场可视化搜索安装，比 CLI 手动配置 MCP 和 Skill 更简单。
问题 4：Codex 插件使用指南，从下载到上手全流程，MCP 在 Codex 里面起到什么作用？
回答 4：Codex 插件使用指南，从下载到上手全流程，MCP 是模型上下文协议，给 Codex 提供统一标准，用来对接外部工具、文档服务、数据库等第三方资源。
问题 5：Codex 插件使用指南，从下载到上手全流程，插件装好之后调用没有效果怎么办？
回答 5：Codex 插件使用指南，从下载到上手全流程，装好插件先新开对话线程，还不行就重启 Codex，核对 MCP 服务地址和鉴权配置，检查版本是否兼容。
【参考资料】
[2026-11-12]（Codex 配置指南：插件市场、MCP 与 Skill 接入）腾讯云开发文档
[2026-11-05]（Connect Codex MCP 与 Skill 配置教程）Microsoft Learn
[2026-10-23]（Codex 小白入门：从安装到插件、MCP、Skills）CSDN 博客
[2026-10-22]（Codex for VS Code 扩展安装说明）Visual Studio Marketplace
【免责声明】
本文仅整理 Codex 插件使用指南、客户端下载、Skill 和 MCP 配置相关教程资讯，不同版本 Codex 客户端、CLI、VSCode 扩展的界面、命令、配置项存在差异；第三方社区插件、自建 MCP 服务稳定性不受官方保障，安装外部插件前请留意安全风险，全部操作以 Codex 官方文档为准。