Skip to content

本页由 AI 根据韩语原文翻译,可能存在错误。

第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]

ChatGPT 应用的 Settings → Import 界面:「Import from another AI app」下面有 Claude Code、Claude Cowork、Cursor,每个都有 Import 按钮

在本指南的界面(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.jsonconfig.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]

理解检查

官方文档建议把必须遵守的整理规则放在哪里?

亲手试一试 ​

  1. 用上面的请求,让它把 CLAUDE.md 搬到 AGENTS.md。同时加上一条新规则。
  2. 打开 AGENTS.md,看看原来的规则是否原样保留,新规则是否加上了。
  3. 打开一个新对话,不提规则,让它整理学习笔记。
  4. 检查结果里新规则有没有被遵守。

连续任务:第4章会学习决定 Codex 自己做什么、问什么的权限菜单,以及撤销更改内容的方法。

小结 ​

  • Codex 读取 AGENTS.md,而 CLAUDE.md 如果不做处理就不会读。
  • 两个工具一起用的话,两个文件一起修改。
  • 加入一条新规则,在不说出来的情况下测试,就能知道规则文件有没有被读到(本次练习:之前 0 → 之后 1)。
  • 个人规则放在 ~/.codex/AGENTS.md,文件夹规则放在文件夹里的 AGENTS.md。离得近的优先。
  • 导入可以一次性搬设置,但会看到个人设置。一定要遵守的规则,写在 AGENTS.md 里,而不是记忆里。

术语整理 ​

术语中文名称一句话解释
Import导入把其他智能体的设置搬到 Codex 的功能
Memories记忆回想以前工作上下文的功能
/init初始化命令生成 AGENTS.md 框架的命令

这一章读完了吗?

学习记录只保存在这个浏览器中。整体进度可以在 全部目录中查看。

下一章:第4章. 权限与撤销

参考资料(17 条)
  1. Codex 官方文档,「Custom instructions with AGENTS.md」. "Codex reads AGENTS.md files before doing any work." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  2. Codex 官方文档,「Custom instructions with AGENTS.md」. "Filenames not on this list are ignored for instruction discovery." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  3. Codex 官方文档,「Custom instructions with AGENTS.md」. "In your Codex home directory (defaults to ~/.codex, unless you set CODEX_HOME), Codex reads AGENTS.override.md if 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) ↩︎

  4. 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) ↩︎

  5. 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) ↩︎

  6. Codex 官方文档,「Custom instructions with AGENTS.md」. "If instructions look stale, restart Codex in the target directory." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  7. Codex 官方文档,「Slash commands」. "Generate an AGENTS.md scaffold for the current project." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  8. Codex 官方文档,「Import from another agent」. "The desktop app can import from Claude Code, Claude Cowork, or Cursor." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  9. 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) ↩︎

  10. Codex 官方文档,「Import from another agent」. "The import flow checks both your user-level setup and your existing projects." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  11. Codex 官方文档,「Import from another agent」. 表「What ChatGPT can import」中 Instruction files、settings.json、Skills、Slash commands 这几行。 learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  12. Codex 官方文档,「Import from another agent」. "Importing doesn't change or delete your existing agent setup." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  13. 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) ↩︎

  14. Codex 官方文档,「Memories」. "Memories let ChatGPT and Codex carry useful context from earlier work into future work." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  15. Codex 官方文档,「Memories」. "Local Codex memories are off by default." learn.chatgpt.com (确认日期 2026-11-01) ↩︎

  16. 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) ↩︎

  17. Codex 官方文档,「Memories」. "Keep required team guidance in AGENTS.md or checked-in documentation." learn.chatgpt.com (确认日期 2026-11-01) ↩︎