4.3 CLAUDE.md 的定义、作用域与最小模板
面向经管学生、研究者与从业者的 AI 智能体设计教材
有了目录之后，下一步要解决的是稳定规则写在哪里。在 Claude Code 中，这个文件叫 CLAUDE.md，它是项目 memory 的重要入口，承担的核心工作是：把长期有效、会反复影响结果的项目规则落成文件。
跨平台命名对照
本书以 Claude Code 的 CLAUDE.md 作为项目规则文件的标准名称。在 Opencode 中，同一功能的文件叫 AGENTS.md；在 Codex 中也是 AGENTS.md。三者格式和作用完全相同，只是文件名随平台不同。如果你的项目需要同时兼容多个平台，只需维护一份 CLAUDE.md，再用软链接生成副本：
ln -s CLAUDE.md AGENTS.md这样两个平台都能识别，而规则内容只需维护一处。
这类规则文件最适合写五类内容。
- 项目背景：这个项目是做什么的，核心产出是什么。
- 目录约定：输入在哪里，输出写到哪里，参考资料放在哪。
- 工作方式：先探索、再计划、再执行，还是先核对资料、再生成结果。
- 关键约束：不要改哪些目录，哪些信息不能臆造，什么情况下必须停下来确认。
- 验证方式：完成前需要自查什么，最终交付应包含哪些内容。
同样要明确哪些内容不该写进去。
- 一次性任务目标，不该长期留在规则文件里。
- 高频变动的临时细节，不该塞进主规则。
- 自动触发、外部接口、环境变量、权限策略这类运行细节，不该混进规则正文。
下面是一份适合初学者的最小模板：
# 项目背景
- 本项目用于整理行业研究资料并生成课程讲稿。
# 目录约定
- 原始材料在 `inputs/`
- 输出写入 `outputs/`
- 模板和术语表放在 `references/`
# 工作规则
- 先探索目录和材料，再开始生成正文
- 资料不足时先指出缺口，不自行臆造
- 不改动 `inputs/` 中原始文件
# 输出要求
- 输出前给出使用材料清单
- 结果写入指定文件，并附简短状态说明这份模板有效，不是因为它全面，而是因为它覆盖了会反复影响结果的关键点。对项目规则来说，精简比求全更重要。
CLAUDE.md 的核心定位
CLAUDE.md 不是说明文档，也不是任务清单。它的职责是记录长期有效、会反复影响执行结果的项目规则。写进去的每一条，都应该在多轮会话中持续生效。