自定义配置
Codex 提供多种分层的自定义方式，可以协同工作，将工具适配到你团队的工作流中。
自定义层级总览
按推荐实施顺序：
- AGENTS.md — 仓库级持久化指引
- Skills（技能） — 可复用的工作流包
- MCP（模型上下文协议） — 连接外部系统
- 多智能体 — 专业化子智能体分工
第一层：AGENTS.md（项目指引）
AGENTS.md 是随仓库一起维护的持久化指引文件，提供项目级别的约定和规范。
包含内容
保持简洁，建议包含：
- 构建和测试命令
- 代码审查期望
- 仓库特定约定
- 目录级别的特殊说明
层级结构
系统支持以下层级，靠近工作目录的文件优先级更高：
| 位置 | 作用范围 |
|---|---|
~/.codex/AGENTS.md | 全局，适用所有项目 |
<仓库根目录>/AGENTS.md | 仓库级，覆盖全局设置 |
<子目录>/AGENTS.md | 子模块级，用于特定子系统（如支付服务） |
何时更新
- 发现 Codex 反复犯同类错误
- 需要减少不必要的文件读取
- 注意到 PR 审查中出现重复反馈模式
详见 AGENTS.md 完整指南。
第二层：Skills（技能）
Skills 是可复用的工作流包，避免在不同会话中重复类似对话。
技能结构
一个 Skill 通常包含：
skill-name/
├── SKILL.md # 指令和元数据（必需）
├── scripts/ # 可执行脚本（可选）
├── references/ # 参考文档（可选）
└── assets/ # 模板和资源（可选）
Skills 的加载方式
采用渐进式披露：元数据优先加载（用于发现），完整内容只在被选中时加载。
调用方式：
- 显式调用：使用
/skills命令或$skill-name语法 - 隐式调用：Codex 根据任务描述自动匹配合适的 Skill
Skill 存储位置
| 位置 | 路径 |
|---|---|
| 仓库级 | .agents/skills/（在工作目录、父目录或仓库根目录） |
| 用户级 | ~/.agents/skills/ |
| 管理员级 | /etc/codex/skills/ |
详见 Skills 完整指南。
第三层：MCP（模型上下文协议）
MCP 是连接 Codex 与外部系统的标准协议，支持 Figma、Linear、Jira、GitHub、文档服务器等工具。
MCP 服务器可以暴露：
- Tools（工具）：可执行的操作
- Resources（资源）：可读取的数据
- Prompts（提示模板）：可复用的提示词模板
详见 MCP 配置指南。
第四层：多智能体
创建具有不同角色和工具访问权限的专业化子智能体，将聚焦任务委派给合适的智能体处理。
典型应用场景：
- 并行运行多个代码分析任务
- 将探索性工作与实现工作分开
- 专门的测试智能体 + 实现智能体协作
详见 多智能体配置。