Codex 启动时自动按 AGENTS.md → HANDOFF.md → README.md 顺序读取项目根目录下的这三个文件；需确保文件存在、路径正确、命名规范，其中 AGENTS.md 为强制规则文件，HANDOFF.md 用于中断续跑。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
让 Codex 新任务一启动就自动读取项目说明，避免每次都要手动提醒它“先看 README”“再查 AGENTS.md”，关键在于把说明文件放在 Codex 启动时默认加载的路径，并确保文件名符合它的内置读取规则。
确认 Codex 启动时自动读取哪些文件
Codex 在每次会话开始前，会按固定顺序查找并加载三类项目级说明文件：AGENTS.md → HANDOFF.md → README.md。只要这些文件存在于当前工作目录（即你运行 codex 命令的目录）下，它就会自动读取内容，且优先级从高到低。
这一步不能跳过——如果项目根目录里没有这三个文件中的任何一个，Codex 就会直接进入“空白状态”，相当于一个刚入职、没看过任何入职文档的新人。
把项目说明写进 AGENTS.md（推荐首选）
AGENTS.md 是 Codex 最重视的项目说明书，它不是给人看的备忘录，而是写给 AI 的强制执行规则。只要这个文件存在，Codex 每次启动都会把它当作第一份工作指令来解析。
在项目根目录新建或编辑 AGENTS.md，用纯 Markdown 写明以下四类信息：
• 项目用途（一句话说清它是做什么的）
• 核心技术栈（如 “Next.js 14 + TypeScript + Prisma”）
• 关键路径（如 “登录逻辑在 src/features/auth，API 调用统一走 lib/apiClient.ts”）
• 禁止事项（如 “禁止修改 public/ 下任意文件，所有样式变更必须通过 CSS Modules”）
不需要写得像技术白皮书，一段话能说清就别分点；但禁止事项必须明确到文件路径或行为动词，否则 Codex 可能忽略。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像，然后保存
补充 HANDOFF.md 让中断后快速续跑
如果你的任务经常被会议、报错或上下文溢出打断，HANDOFF.md 就是续跑的“存档点”。它不替代 AGENTS.md，而是记录“当前做到哪一步了”。
方法一：手动维护
每次准备退出 Codex 前，在项目根目录更新 HANDOFF.md，写三行就够了：
① 当前任务目标（例如：“修复导出 CSV 时中文乱码”）
② 已确认的关键事实（例如：“已定位到 utils/export.ts 第 42 行调用 new TextEncoder()”）
③ 下一步待验证项（例如：“需确认 Node.js 版本是否影响编码行为，测试环境为 v20.15.0”）
方法二：用 Codex 自动生成
在当前会话中输入：
“请根据本次对话内容，生成一份 HANDOFF.md，只包含任务目标、已确认事实、下一步动作，不要解释，不要 markdown 标题，纯文本。”
复制输出内容，粘贴覆盖项目根目录下的 HANDOFF.md 文件。
注意：HANDOFF.md 必须放在项目根目录，且文件名全小写、带 .md 后缀，否则 Codex 不会识别。
验证新会话是否真读了说明
启动新 Codex 会话后，立刻输入：
“请复述你从项目说明文件中读到的前三条关键约束。”
如果它准确说出 AGENTS.md 里的禁止事项、技术栈声明或路径约定，说明加载成功。
如果回答含糊（如“我看到一些项目信息”“大概记得是前端项目”），说明文件缺失、路径错误或格式不规范——此时不要继续任务，先检查文件是否存在、是否在正确目录、是否用了 .md 后缀。
