Anthropic 官方课程第 8 课,3 分 1 秒。Claude Code 里最有用的一样东西是 CLAUDE.md——它给 Claude Code 一份关于你项目的持久记忆。

没有它,Claude Code 每次都像从零开始:重新探索代码库、弄清要哪些依赖、哪些功能已经实现。有时它只能靠假设,而那会让你更难把它引到正确方向上。

CLAUDE.md 就是来解决这个的。它是放在项目根目录的一个 Markdown 文件,每次开会话 Claude Code 都会自动读它——相当于你代码库的入职脚本。它的内容会被附加到你自己的提示词上。不想手写就跑 /init,让 Claude 照着代码库生成一份。

视频里那份长这样——项目:一个用 App Router、Tailwind 和 Drizzle ORM 的 Next.js 15 应用;命令:开发服务器、跑测试、lint;代码风格:两个空格缩进、优先具名导出、API 路由都放 app/api、能用 server actions 就别用 API 路由。

有了这份,再让它建一个 React 组件,它已经知道用 Tailwind 写样式、照你的规范来。

记忆文件按服务对象分两层。项目级放在项目根目录,可以也应该提交进版本控制,让团队一起受益;用户级放在你的配置文件夹里,只归你自己、对所有项目生效——个人偏好放这儿,比如注释怎么写。

三个小贴士。一、把纠正存进记忆:发现自己在反复纠正它(比如「一律用 server actions,别用 API 路由」),就明确让 Claude 把这条规则记下来,下次再开这个项目它就知道了。

二、引用项目文档:有想让它参考的文档,用 @ 加上文件路径指过去。

三、从空白开始:建议一开始先别写,这样你能看清自己到底在哪些地方需要不断纠正它。CLAUDE.md 才留得住精简,只装必要的信息。

一次让人烦躁的会话和一次顺畅的会话,差别往往就在上下文——而 CLAUDE.md 正是你提供上下文的方式。从技术栈、偏好和命令写起,之后再往上加。

视频来自 Anthropic 官方频道 @claude《The CLAUDE.md file》,Claude Code 101 第 8 课,中文字幕是我做的。