← 返回问题库
问题库项目指令App / CLI / IDE / Cloud入门

全局 AGENTS.md 和项目 AGENTS.md 分别写什么?

全局文件放个人跨仓库偏好,项目文件放团队共享且与代码库有关的可执行约定。

5 分钟阅读核验于 2026/07/16

可共享性

项目文件应随仓库版本控制,让本地和 Cloud 任务都能读到。个人偏好不应强迫团队成员采用,也不应混入项目业务事实。

合并顺序

全局指导先加载,项目路径上的指导随后加载。发生冲突时,更靠近当前工作目录的具体指导优先。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Codex AGENTS.md

    官方来源 · https://learn.chatgpt.com/docs/agent-configuration/agents-md

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。