Codex CLI进阶技巧：利用AGENTS.md定制你的专属代码生成规则

Codex CLI进阶技巧：利用AGENTS.md定制你的专属代码生成规则

你是否已经厌倦了每次使用Codex CLI时，都要在提示词里重复那些“请使用TypeScript”、“函数名用驼峰式”、“记得加单元测试”的约束？当团队协作时，这种重复不仅低效，更可怕的是，不同成员给出的提示词风格迥异，导致生成的代码五花八门，后续的代码审查和合并简直是一场噩梦。

对于已经熟悉codex “帮我生成一个登录组件”这类基础操作的用户来说，真正的生产力飞跃点，在于将你或团队的知识、规范和偏好，从一次性的、易变的提示词中抽离出来，固化为一套可复用、可继承的“智能规则”。这正是AGENTS.md文件存在的核心价值。它不是一个简单的配置文件，而是一个能与Codex进行深度对话的“项目大脑”，让AI助手从一开始就理解你的上下文、你的规矩，从而生成更精准、更符合预期的代码。今天，我们就深入探讨如何驾驭这个强大的工具，打造属于你或团队的专属代码生成引擎。

1. 理解AGENTS.md：不止是配置文件，更是项目“宪法”

很多用户初次接触AGENTS.md，会把它当作一个放大了的.eslintrc或.prettierrc。这种理解低估了它的潜力。传统的lint或格式化工具作用于代码生成之后，是“纠错”和“美化”。而AGENTS.md作用于代码生成之前，是“引导”和“塑造”。它直接影响了Codex的思考过程和决策逻辑。

1.1 AGENTS.md的工作原理与作用域

当你执行codex命令时，CLI会按照一个明确的优先级顺序去查找并合并多个AGENTS.md文件中的指令：

1. 全局级 (~/.codex/AGENTS.md): 这是你的个人“编码人格”档案。在这里定义的规则，适用于你在任何项目中使用Codex CLI。比如，你可能习惯在所有项目中都使用async/await而非回调，或者你个人偏好将工具函数放在src/lib/目录下。
2. 项目级 (./AGENTS.md): 位于项目根目录，定义了整个团队或该项目必须遵守的“宪法”。它覆盖全局规则中冲突的部分。这里通常存放技术栈约定（如React + TypeScript + Tailwind CSS）、项目结构规范、代码风格（命名、注释）、测试框架要求等。
3. 模块级 (./src/components/AGENTS.md等): 针对特定目录或模块的细化规则。例如，在components/目录下的AGENTS.md可以规定“所有组件必须是函数式组件，使用React.memo进行包装，并导出Props接口”；而在api/目录下，则可以规定“所有API调用必须使用项目封装的request工具，错误处理需遵循统一格式”。

这种层级化的设计，实现了规则从通用到特殊的精细控制。Codex在生成代码时，会综合考虑所有适用的规则，就像一个有经验的新员工，既了解公司文化（全局），又熟悉部门规定（项目），还清楚具体任务的操作手册（模块）。

1.2 与普通提示词的本质区别

为了更清晰地理解，我们通过一个表格来对比：