第7章给 Codex 装上更多能力

约 2741 字大约 9 分钟

2026-06-09

这一章来聊聊怎么给 Codex "装插件"——接入外部工具、创建可复用的技能、甚至雇一队 AI 小帮手一起干活。

7.1 MCP 服务器：Codex 的"应用商店"

MCP 是个啥？

MCP = Model Context Protocol（模型上下文协议）

名字听着挺唬人的，但道理特别简单。

你可以把 Codex 想象成一个特别能干的助手，但它一直待在办公室里，只能处理手边的文件。

如果你希望它：

帮你查数据库里的数据 → 做不到
帮你打开浏览器看看某个网页 → 做不到
帮你调用某个在线 API → 做不到

MCP 就相当于给这个助手接上了"电话线"，让它能联系到外面各种服务。

外面的每个服务就是一个 "MCP 服务器"。Codex 通过 MCP 协议跟这些服务器交流，就能获得新的能力。

就像你给手机装 App 一样——装什么 App，手机就能干什么。Codex 也是一样，接上什么 MCP 服务器，它就多一种能力。

一句话搞懂 MCP

MCP 就是 Codex 的"插座"——插上什么设备，Codex 就能用什么能力。

常用的 MCP 服务器

MCP 服务器	能干啥	啥时候用
filesystem	更灵活地读写本地文件	需要更高级的文件操作时
postgres	连接 PostgreSQL 数据库	要查数据库里的数据时
sqlite	连接 SQLite 数据库	用本地数据库做小项目时
github	操作 GitHub（提 Issue、创建 PR 等）	日常用 GitHub 管理代码时
puppeteer	控制浏览器	要自动抓网页或测试网页时
fetch	发送 HTTP 请求	要调用接口或获取网页内容时

7.2 动手试试：接上一个 MCP 服务器

咱们实际操作一下，添加一个 fetch 服务器，让 Codex 能帮我们发 HTTP 请求、获取网页内容。

第一步：添加 MCP 服务器

在终端里执行：

# 添加 fetch 服务，让 Codex 能帮我们发 HTTP 请求
# 具体命令取决于 Codex 的 MCP 管理方式，以下是通用思路

第二步：确认添加成功

看看当前有哪些 MCP 服务器：

/codex mcp list

列表里能看到 fetch 就说明加上了。

第三步：用起来

启动 Codex 后在对话里试试：

帮我获取 https://example.com 的内容

接上 fetch 服务器之后，Codex 就能帮你发 HTTP 请求了。

小建议

个人用的话，命令行添加最省事。如果是团队协作，可以把配置文件共享给大家，这样每个人配置都一样。

7.3 Skills 技能系统：Codex 的"菜谱卡片"

技能是个啥？

你每天可能都在重复这些事：

改完代码 → 跑测试 → 看结果 → 提交
早上上班 → 同步项目 → 安装依赖 → 看看有没有问题

每次都要跟 Codex 完完整整说一遍步骤，说多了自己也烦。

技能就是把这一串步骤打包成一个"快捷按钮"。

没有技能的时候：
"帮我看看 git 状态，然后拉最新代码，然后安装依赖，然后跑测试"
（下次）"帮我看看 git 状态，然后拉最新代码，然后安装依赖……"
（下下次）"帮我……" 😫

有了技能以后：
输入"同步项目"（一句话搞定）😊

技能是怎么实现的？

每个技能就是一个 SKILL.md 文件，放在 ~/.codex/skills/ 目录下。里面写清楚了这个技能叫啥、什么时候触发、按什么步骤执行。

动手做一个技能

咱们做一个 项目同步 技能——一句话完成拉取代码、安装依赖、检查状态。

第一步：创建技能目录

mkdir -p ~/.codex/skills/sync

第二步：写 SKILL.md

在 ~/.codex/skills/sync/SKILL.md 里写上：

# 技能名称
sync

# 触发描述
当用户说"同步项目"、"更新项目"、"sync"时触发

# 技能说明
一键完成项目同步：拉取最新代码、检查状态、安装依赖。

# 执行步骤
1. 运行 git status 查看当前状态
2. 如果有未提交的改动，提醒用户
3. 运行 git pull origin main 拉取最新代码
4. 检查 package.json 是否有变化，如果有则运行 npm install
5. 汇报同步结果

第三步：试试看

重启 Codex，然后在对话里说：

同步项目

Codex 就会按照你定义的步骤一步步自动执行了！

再看几个技能的例子

代码审查技能：

# 技能名称
review

# 触发描述
当用户说"审查代码"、"code review"、"review"时触发

# 执行步骤
1. 运行 git diff --staged 查看暂存区改动
2. 审查代码逻辑、安全性、命名规范
3. 按严重程度分级列出问题
4. 给出改进建议

一键部署技能：

# 技能名称
deploy

# 触发描述
当用户说"部署"、"deploy"、"发布"时触发

# 执行步骤
1. 确认在 main 分支
2. 运行测试，确保全部通过
3. 构建生产版本
4. 执行部署命令
5. 汇报部署结果

其实很简单

做技能的核心就是写 SKILL.md 文件。把名字、触发条件、步骤都写清楚，Codex 就能自动按流程执行。

7.4 Subagents：雇一队 AI 小帮手

啥是 Subagents？

有些任务太复杂了，一个人干不过来。

你想想：如果你要"给整个项目写测试"，一个 AI 从头到尾干，得花好久。但如果能同时派好几个 AI，每人负责一个模块，是不是快多了？

Subagents 就是 Codex 的"分身术"——遇到复杂任务时，Codex 可以派出多个子代理，分工合作。

怎么理解？

比喻	现实
你是项目经理	Codex 是主代理
你安排了 3 个程序员	Codex 派出 3 个子代理
每人负责一个模块	每个子代理处理一部分任务
大家并行干活	子代理同时执行
最后汇总给你	主代理汇总结果

啥时候用 Subagents？

Codex 会在以下情况自动使用子代理：

任务涉及多个模块，需要同时处理
需要多方面分析（比如同时审查安全性和性能）
批量操作太多，一个一个干太慢

提示

Subagents 是 Codex 内部自动调度的，你不需要手动配置。当你给的够复杂时，Codex 会自己判断要不要派分身。

7.5 能力扩展全景图

把 MCP、Skills、Subagents 放在一起看：

它们各自解决什么问题？

扩展方式	解决啥问题	类比
MCP 服务器	让 Codex 能连上外部服务	给手机装 App
Skills 技能	把重复操作打包成一句话	菜谱卡片
Subagents 子代理	复杂任务并行处理	雇一队帮手

搭配使用的威力

这三个能力不是互斥的，而是可以叠加的。比如：

你创建了一个"部署"技能（Skills）
这个技能用到了数据库 MCP 服务器来检查数据迁移（MCP）
Codex 在执行时派出子代理同时跑测试和检查安全（Subagents）

结果就是：你说一句"部署"，Codex 就全自动帮你搞定了。

7.6 实战：装一个 MCP + 建一个技能

来个综合实战——先装个 MCP 服务器，再建个技能把它用起来。

第一步：装一个 fetch MCP 服务器

让 Codex 能发 HTTP 请求。

第二步：创建一个"健康检查"技能

在 ~/.codex/skills/health-check/SKILL.md 里写：

# 技能名称
health-check

# 触发描述
当用户说"健康检查"、"检查服务"、"health check"时触发

# 技能说明
对项目的所有服务进行健康检查，包括本地服务和远程 API。

# 执行步骤
1. 检查本地服务是否在运行（尝试访问 localhost:3000）
2. 检查远程 API 是否正常（使用 fetch 服务器）
3. 检查数据库连接是否正常
4. 汇总所有检查结果

# 输出格式
- ✅ 正常的服务
- ⚠️ 有警告的服务
- ❌ 挂掉的服务

第三步：试试看

健康检查

Codex 就会用你配好的 MCP 服务器和技能，自动帮你检查所有服务了。

7.7 有几点要注意的

MCP 服务器要注意安全

安全提醒

MCP 服务器是跑在你自己电脑上的，理论上它能做电脑能做的所有事。所以，只添加你信得过的 MCP 服务器，来路不明的千万别装。数据库连接信息也尽量别用生产环境的。

技能不是越多越好

每个技能 Codex 都要加载和记忆。技能太多反而会让 Codex 的注意力分散。只建你真正需要、经常用的技能就好。

Subagents 不一定能加速所有任务

简单的任务用子代理反而更慢（因为要协调）。只有真正复杂、可以并行的任务，Subagents 才有明显优势。

MCP 可能不太稳定

MCP 还是个比较新的东西，有些服务器可能偶尔会出问题。遇到问题的话，试试重启 Codex，基本能解决。

7.8 小结

要点	一句话总结
MCP 是啥	Codex 的"应用商店"，接上什么就能用什么能力
怎么加 MCP	命令行添加或写配置文件
Skills 是啥	把重复操作打包成一句话的"菜谱卡片"
怎么创建技能	建文件夹 + 写 SKILL.md
SKILL.md 放哪	`~/.codex/skills/` 全局，或项目目录下
Subagents 是啥	Codex 的"分身术"，复杂任务分工协作
啥时候用	Codex 自动判断，不需要手动配置

一句话： MCP 接外部工具，Skills 复用操作流程，Subagents 并行干活——三个加在一起，Codex 就从"能用"变成"全能"了。

下一章来聊聊 Codex 在实际项目中的实战案例，看看它能帮你干哪些有趣的事：第8章实战案例

第7章 给 Codex 装上更多能力

第7章给 Codex 装上更多能力