在 codexapp 中配置 agents.md,就是把项目规则写进仓库根目录或指定子目录,让后续任务自动读取这些长期说明。配置完成后,新任务会按测试命令、代码风格和安全边界执行。
适合什么情况
项目根目录或指定子目录出现 AGENTS.md,并且新任务能按其中规则执行,就算配置完成。
容易卡住的地方
这个操作的核心结果是“让项目规则长期生效”。AGENTS.md 不适合写临时想法,也不适合塞账号密钥;它更像团队交接文档,越稳定越有用。
- 看清入口名称和当前账号权限,避免进到相邻功能页。
- 确认生成、保存或打开后的内容能继续使用。
- 重要文件和设置建议保留记录,后面出错时更容易恢复。
具体操作
步骤一:在仓库根目录创建 AGENTS.md;如果只想约束某个模块,把文件放到对应子目录即可。

步骤二:写入稳定规则,例如测试命令、代码格式、禁止改动的目录、提交前需要运行的检查。

步骤三:回到 CodexApp 打开同一项目,发起一个小任务,让它复述或遵守这些规则来验证读取效果。

补充说明
规则写很多会更好吗? 不一定。写清固定约束即可,临时要求放在当前任务消息里更合适。
规则生效后的复查方式
配置AGENTS.md 卡住时,通常不是重新提问就能解决,而是要补齐当前停在哪一步、用的是什么文件或账号、希望输出成什么样。
如果遇到“规则写很多会更好吗?”这类情况,不要反复提交同一句指令,把账号状态、文件位置、异常提示和希望得到的结果补充清楚,CodexApp 更容易继续处理。











