在 Codex 的开发工作流中，AGENTS.md 文件扮演着类似“系统指令”或“角色设定”的关键角色。它允许开发者通过自然语言定义 AI 代理的行为规范、代码风格以及访问权限。正确配置该文件，不仅能提升代码生成的准确性，还能有效防止越权操作。本文将通过清晰的步骤清单，指导您完成 Codex 的权限分配与行为约束设置。
第一步：定位并初始化 AGENTS.md 文件
首先，需要在项目的根目录或 `.codex` 目录下创建 AGENTS.md 文件。如果项目已存在此文件，请确保备份现有内容。该文件默认采用 Markdown 格式编写，Codex 引擎会在每次会话开始时读取其中的内容，将其作为上下文注入到大型语言模型（LLM）的系统提示词中。这是建立权限边界的第一步，相当于为 AI 助手划定“活动范围”。
第二步：定义核心权限与角色限制
在文件中，使用明确的指令来指定 AI 可以执行的操作类型。例如，您可以添加如下规则：# 权限控制通过这种细粒度的权限分配，您可以限制 AI 对敏感文件或外部系统的访问，确保开发过程的安全性与可控性。建议将常用权限模板化，以便在不同项目中复用。
- 仅允许修改 src/ 目录下的 TypeScript 文件。
- 禁止直接删除任何配置文件。
- 在运行测试前必须先构建项目。
第三步：优化指令结构以提升响应质量
除了权限限制，AGENTS.md 还用于规范代码风格和交互逻辑。建议在文件中加入具体的编码规范，如“使用 ESLint 标准”、“提交信息需符合 Conventional Commits 规范”。此外，明确指示 AI 在遇到模糊需求时应主动询问而非自行猜测。经过优化的指令结构能显著减少无效迭代，使 Codex 生成的代码更贴合团队标准。保存文件后，重启 Codex 会话即可生效新的权限配置。