第3章 规则文件 AGENTS.md——把 CLAUDE.md 搬到 Codex
必读 想跟着这个阶段学下去,一定要读这一章。一句话总结:Codex 在开始工作之前会读取
AGENTS.md。Claude Code 的CLAUDE.md,Codex 如果不做处理就不会读。 把整理工具文件夹的规则搬到AGENTS.md,然后在新对话里测试,不用说出规则它是否也会遵守。
本章依据 2026 年 11 月 1 日确认过的 Codex 官方文档,以及本指南在整理工具文件夹里亲手试过的结果写成。为什么需要规则文件,Claude Code 第6章里已经讲过。这里只讲在 Codex 里不一样的地方。
Codex 不读 CLAUDE.md
Codex 的规则文件名叫 AGENTS.md。[1] 如果想把其他名字的文件当作规则,需要在设置里另外登记,没有登记的名字会被忽略。[2] 所以 CLAUDE.md 如果不做处理,就不会被当作规则来读。
在第2章的运行记录里也能确认这一点。Codex 在文件夹里找了 AGENTS.md,没有找到,就只读了模板(templates/)。它没有打开 CLAUDE.md。
即便如此,第2章的会议纪要还是遵守了 (备忘录里没有) 这条规则。因为同样的规则也写在模板说明(templates/README.md)里。反过来说,只写在 CLAUDE.md 里的规则,Codex 是不知道的。
理解检查
没有 AGENTS.md,Codex 却遵守了“(笔记里没有)”这条规则。在这份指南的实操里,原因是什么?
把 CLAUDE.md 搬到 AGENTS.md
搬的工作也交给 Codex。本章的运行和第2章一样,是在终端里运行同一个 Codex。这次新增了一条规则。之后看这条规则有没有被遵守,就能相当可信地推断它有没有读 AGENTS.md。
CLAUDE.md 是 Claude Code 读取的规则文件。请把同样的规则搬到 AGENTS.md,让 Codex 也能读到。规则内容不要改,只增加一条规则:'在整理好的文件最下面设一节「与原件核对」,把数字、名字、日期中需要再次确认的内容写在 3 条以内。' CLAUDE.md 保持原样。Codex 把 CLAUDE.md 的五条规则原样搬了过来,并把新规则作为第 6 条加了上去。然后它报告说"已验证,除了新增的规则,内容与原文完全一致"。
结果:AGENTS.md
没有删除 CLAUDE.md 是有原因的。这是为了让同一个文件夹在 Claude Code 里也能继续使用。代价是两个文件要一起修改。如果只改一边,两个工具就会按不同的规则工作。
理解检查
为了让 Claude Code 和 Codex 共用同一个文件夹,你创建了 AGENTS.md,同时也保留了 CLAUDE.md。以后要注意什么?
不说出规则来测试
打开一个新对话,不提规则,只请它整理学习笔记。
把 inbox/study-2026-10-28-prompt-lecture.txt 整理成学习笔记,保存到 notes/ 里。结果的最下面多了新规则的那一节。
## 与原件核对
- 授课日期:10/28(周三)。原件上写的是 10/28,年份以文件名里的 2026 年为准。
- 授课时长:1 小时。
- 讲师介绍的写提示词的方法:5 种。结果:只靠规则写出的学习笔记
| 什么时候生成的文件 | 「与原件核对」一节 |
|---|---|
| AGENTS.md 之前(第2章会议纪要) | 没有 |
| AGENTS.md 之后(这份学习笔记) | 有 |
来源:本指南的实操结果(2026-11-01,各 1 次)
新规则只在 AGENTS.md 里有,所以可以认为 Codex 读了那个文件并照做了。这不保证它每次都遵守,所以每次看结果时都要确认。
这个实验的局限(点击展开)
- 这只是各做一次的结果。
- 前后的笔记种类(会议纪要、学习笔记)不同。
- 模板的检查清单里也有"和原始笔记核对过一次"这样类似的项目。
想更确定的话,请用同一份笔记,没有 AGENTS.md 跑一次,有 AGENTS.md 跑一次,比较一下。
理解检查
想确认 AGENTS.md 是否真的被读取了。这份指南用的是什么方法?
读取 AGENTS.md 的顺序
AGENTS.md 可以放在两个地方。[3]
| 位置 | 适用范围 | 例子 |
|---|---|---|
~/.codex/AGENTS.md | 我的所有文件夹 | "用韩语回答" |
项目文件夹里的 AGENTS.md | 只限那个文件夹 | 整理工具的规则 |
来源:Codex 官方文档(只摘录了一部分)[3:1]
两个都有的话,会连起来当成一个来读。这时离当前文件夹更近的文件排在后面,排在后面的指令优先于前面的指令。[4]
比如,~/.codex/AGENTS.md 里写着"用韩语回答",整理工具文件夹的 AGENTS.md 里写着"用英语回答"。整理工具文件夹的文件排在后面,所以在这个文件夹里,"用英语回答"胜出。
能连起来的量是有上限的。合并后的大小达到默认的 32KiB(KiB,文件大小的单位)时,后面的就不再追加了。[5] 换成韩语大约是 1 万字出头。规则请保持简短。
如果改了规则却好像没有生效,请开始一个新对话,或者重新启动 Codex。Codex 每次开始运行时都会重新读取规则。[6]
如果文件夹里还没有 AGENTS.md,也可以在应用输入框里输入 /init,生成一个框架。[7]
理解检查
~/.codex/AGENTS.md 和“整理工具”文件夹里的 AGENTS.md 说的不一样。哪一个优先?
导入(Import)和记忆
也有一次性完成本章手动做的这些事的功能。导入是把其他智能体的设置一次性搬过来的功能。在应用里,可以从 Claude Code、Claude Cowork、Cursor 导入。[8] 从应用设置里的 Import 菜单开始。[9]

在本指南的界面(2026-11-01)中,设置左侧列表里有 Import,在这台电脑上找到的 Claude Code、Claude Cowork、Cursor 各自带着 Import 按钮显示出来。本指南没有点这些按钮。
本指南没有执行导入。因为导入不只查看一个文件夹,还会一并查看我电脑上的个人设置。[10] 而且它会把规则文件、技能、斜杠命令、设置文件换成 Codex 这边对应的东西,一次性搬过去。比如 CLAUDE.md 会变成 AGENTS.md。[11] 因为一次会搬很多东西,如果想一个一个亲眼看看搬了什么,像本章这样手动搬会更好。
导入会搬什么、要检查什么(点击展开)
| Claude Code 这边 | 到了 Codex 变成 |
|---|---|
规则文件(CLAUDE.md 等) | AGENTS.md |
| 技能 | 技能 |
斜杠命令(/名称) | 技能($名称) |
settings.json | config.toml |
来源:Codex 官方文档(只摘录了一部分)[11:1]
settings.json 和 config.toml 是记录各个工具设置的文件。只是名字不同,作用是一样的。
导入之后,原来的设置不会被更改或删除。[12] 不过官方文档说,导入之后一定要检查这些东西。[13]
- 限制了技能能用的工具或权限的部分
- 钩子(hook,到了规定的时候自动运行的脚本)
- 往空格里填值来用的命令(使用参数的命令)
如果设置里没有 Import 菜单,就在 General 里找 Import other agent setup。[9:1]
记忆(Memories)是把以前工作的上下文带到下一次工作里的功能。[14] 我电脑上的 Codex 记忆默认是关闭的。[15] 官方文档只把记忆看作"辅助回想",说一定要遵守的规则不要交给记忆。[16] 它说一定要遵守的规则要写在 AGENTS.md 里。[17]
理解检查
官方文档建议把必须遵守的整理规则放在哪里?
亲手试一试
- 用上面的请求,让它把
CLAUDE.md搬到AGENTS.md。同时加上一条新规则。 - 打开
AGENTS.md,看看原来的规则是否原样保留,新规则是否加上了。 - 打开一个新对话,不提规则,让它整理学习笔记。
- 检查结果里新规则有没有被遵守。
连续任务:第4章会学习决定 Codex 自己做什么、问什么的权限菜单,以及撤销更改内容的方法。
小结
- Codex 读取
AGENTS.md,而CLAUDE.md如果不做处理就不会读。 - 两个工具一起用的话,两个文件一起修改。
- 加入一条新规则,在不说出来的情况下测试,就能知道规则文件有没有被读到(本次练习:之前 0 → 之后 1)。
- 个人规则放在
~/.codex/AGENTS.md,文件夹规则放在文件夹里的AGENTS.md。离得近的优先。 - 导入可以一次性搬设置,但会看到个人设置。一定要遵守的规则,写在
AGENTS.md里,而不是记忆里。
术语整理
| 术语 | 中文名称 | 一句话解释 |
|---|---|---|
| Import | 导入 | 把其他智能体的设置搬到 Codex 的功能 |
| Memories | 记忆 | 回想以前工作上下文的功能 |
/init | 初始化命令 | 生成 AGENTS.md 框架的命令 |
这一章读完了吗?
学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。
下一章:第4章. 权限与撤销
参考资料(17 条)
Codex 官方文档,「Custom instructions with AGENTS.md」. "Codex reads
AGENTS.mdfiles before doing any work." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Custom instructions with AGENTS.md」. "Filenames not on this list are ignored for instruction discovery." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Custom instructions with AGENTS.md」. "In your Codex home directory (defaults to
~/.codex, unless you setCODEX_HOME), Codex readsAGENTS.override.mdif it exists." / "Starting at the project root (typically the Git root), Codex walks down to your current working directory." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Custom instructions with AGENTS.md」. "Files closer to your current directory override earlier guidance because they appear later in the combined prompt." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Custom instructions with AGENTS.md」. "Codex skips empty files and stops adding files once the combined size reaches the limit defined by
project_doc_max_bytes(32 KiB by default)." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Custom instructions with AGENTS.md」. "If instructions look stale, restart Codex in the target directory." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Slash commands」. "Generate an
AGENTS.mdscaffold for the current project." learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Import from another agent」. "The desktop app can import from Claude Code, Claude Cowork, or Cursor." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Import from another agent」. "If Import isn't available as a settings section yet, open General and find Import other agent setup." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Import from another agent」. "The import flow checks both your user-level setup and your existing projects." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Import from another agent」. 表「What ChatGPT can import」中 Instruction files、
settings.json、Skills、Slash commands 这几行。 learn.chatgpt.com (确认日期 2026-11-01) ↩︎Codex 官方文档,「Import from another agent」. "Importing doesn't change or delete your existing agent setup." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Import from another agent」. "Tool restrictions or permissions in imported skills and agents." / "Hooks whose behavior may differ after import." / "Prompt templates or command-style prompts that depend on arguments, shell interpolation, or file-path placeholders." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Memories」. "Memories let ChatGPT and Codex carry useful context from earlier work into future work." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Memories」. "Local Codex memories are off by default." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Memories」. "Treat memories as a helpful recall layer, not as the only source for rules that must always apply." learn.chatgpt.com (确认日期 2026-11-01) ↩︎
Codex 官方文档,「Memories」. "Keep required team guidance in
AGENTS.mdor checked-in documentation." learn.chatgpt.com (确认日期 2026-11-01) ↩︎