Codex Customization：提示词、AGENTS.md、配置、Skills 和 Plugins 怎么分工

适用场景

这篇手册适合想系统管理 Codex 行为的用户。Codex 有多个自定义入口：提示词、AGENTS.md、配置文件、Rules、Hooks、MCP、Skills、Plugins。关键是把规则放在正确层级。

OpenAI 官方 Customization 页面介绍了 Codex 自定义相关概念。具体能力以当前官方文档为准。

步骤 1：先判断规则作用范围

按作用范围选择入口：

• 只影响本次任务：提示词。
• 影响某个项目：AGENTS.md。
• 影响 Codex 运行方式：config.toml。
• 影响团队常用约束：Rules。
• 需要自动检查：Hooks。
• 需要外部工具：MCP。
• 需要复用流程：Skills。
• 需要安装分发能力：Plugins。

不要把所有东西都塞进一个文件。

步骤 2：临时要求放在提示词

示例：

这次只新增文章，不修改组件。
如果没有官方截图，不要配图。
完成后运行 lint 和 build。

这些要求只服务当前任务，不应写进长期配置。

步骤 3：项目规则放进 AGENTS.md

适合写：

• 目录结构。
• 命令。
• 测试要求。
• frontmatter 规范。
• 禁改文件。
• 团队输出格式。

AGENTS.md 应短而可维护。

步骤 4：运行行为放进配置

适合 config.toml：

• 模型默认值。
• profile。
• 权限和沙箱。
• MCP server。
• hooks。

如果是“Codex 怎么运行”，通常是配置；如果是“项目怎么开发”，通常是 AGENTS.md。

步骤 5：可复用流程用 Skill 或 Plugin

Skill 适合：

• 固定写作流程。
• 审查流程。
• 文档生成流程。
• 需要引用模板或脚本的任务。

Plugin 适合：

• 分发给别人安装。
• 包含 Skills、MCP、命令或 assets。
• 需要统一安装和启用的能力包。

常见错误

不要把密钥写进任何自定义入口。

不要让 AGENTS.md 过长。

不要把一次性任务沉淀成长期规则。

不要让多个入口写互相冲突的要求。

小结

Codex 自定义的关键是分层：提示词管当前任务，AGENTS.md 管项目规则，config.toml 管运行方式，Skill 管复用流程，Plugin 管安装分发能力。