你可能会说:
- “每次开新对话都要把项目要求重讲一遍,有没有办法省掉?”
- “仓库里那个 CLAUDE.md、AGENTS.md 是干什么的?”
它是什么
Codex 会读项目里的 AGENTS.md,Claude Code 会读 CLAUDE.md。每开一个新会话,这些内容都会进到它的上下文里,不用你每次重讲。
适合写进去的是长期有效的东西:项目结构、写法约定、不许碰的目录、怎么构建和测试。只对这一次任务有用的进度和计划,写进单独的交接文档,做完就更新或删掉。
每个会话都会读到它,所以写错了危害也大:过时的规则会被当真。改动它要像改代码一样留记录,并且经你确认。
打个比方
像贴在工位上的一张便条:不管谁来坐这个位子,第一眼都能看到。
在这个网站里
这个网站的仓库里有一份 .claude/CLAUDE.md,规定每个文件夹都要有一份三行以内的说明、每个文件开头都要写三行注释(依赖什么、提供什么、在哪一层)。在这个仓库里开工的每个 AI 会话,都会读到它(第 20 课)。
容易搞混的地方
常见误解
AI 会记住上次对话里定下的规矩
正确理解
新会话只知道规则文件和你这次说的话。要它一直遵守的,写进规则文件。
你可以这样告诉 AI
复制下面这段,贴给你的 AI
把这个项目长期有效的约定整理进规则文件:结构、写法、禁区、构建与测试命令。只和这次任务有关的进度,另写一份交接文档。
接下来去哪
先知道
- 上下文窗口——模型一次能"看见"的文字上限。超出的部分,要么被截掉,要么被压缩成摘要。
接着看
- Skill——一份写好的"遇到这类任务就这样做"的说明书,AI 在需要时自己读取、照着执行。
在这些课里出现