Codex通过全局和项目级AGENTS.md文件自动加载规则:全局规则存于~/.codex/AGENTS.md,定义跨项目硬性要求;项目级AGENTS.md覆盖同名全局规则,锁定本仓特有边界;验证需执行指令检查输出并测试拒绝违规操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你想让Codex每次打开项目都自动知道该用pnpm而不是npm、改完必须跑哪些测试、哪些文件碰都不能碰,而不是每次对话都得从头解释一遍项目结构和边界规则。
创建全局AGENTS.md:让所有项目共享你的基本习惯
在终端执行 mkdir -p ~/.codex,确保配置目录存在。
用任意文本编辑器新建文件 ~/.codex/AGENTS.md,写入你跨项目通用的硬性要求。
例如,你坚持所有JS文件修改后必须运行测试,且新增依赖前必须人工确认——这两条就该放在这里,因为它们不随项目变化。
【注意:不要写“尽量”“建议”这类模糊词,Codex只认明确动词+宾语的指令】
为当前项目添加专属AGENTS.md:覆盖全局、锁定边界
进入你的项目根目录(即包含package.json或.git的目录)。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
新建文件 AGENTS.md,内容聚焦本仓库特有规则:比如提PR前必须执行npm run lint、src/utils/下的函数禁止调用localStorage、所有API请求必须走apiClient封装。
这一步最关键:Codex启动时会自动合并全局+项目级规则,但项目级同名规则会直接覆盖全局层。比如全局写“用pnpm”,项目级写“用yarn”,Codex就会用yarn。
验证配置是否生效:三步确认法
第一步:在项目根目录下运行 codex --ask-for-approval never "Summarize the current instructions."。
第二步:检查输出是否包含你刚写进AGENTS.md的关键条款,比如“提PR前运行npm run lint”。
第三步:故意让Codex执行一条被禁止的操作(如让它删node_modules),观察它是否拒绝并引用对应规则条目——这是唯一能证明规则真正加载成功的动作。

















