CLAUDE.md：让AI编程助手真正理解你的项目

什么是 CLAUDE.md？

Anthopic 官方近期发布了一段介绍视频，详细讲解了 Claude Code 中一个极为实用的功能——CLAUDE.md 文件。简单来说，它是一份放在项目根目录下的 Markdown 文件，能让 Claude Code 对你的项目保持持久的记忆。

没有 CLAUDE.md 的时候，每次打开 Claude Code 就像迎来一个新同事：它需要重新熟悉代码库结构、了解依赖关系、搞清楚已有功能和各种隐含假设。这个过程不仅浪费时间，还容易让 AI 走偏方向。而有了 CLAUDE.md，Claude Code 启动时会自动读取这份文件，宛如一份代码库的入职指南，帮助 AI 快速理解项目全貌。

宛如代码库入职指南

从技术实现上看，CLAUDE.md 的内容会被拼接到你每次提问的前面，作为背景上下文信息传递给模型。你甚至可以运行一个 init 命令，让 Claude 根据现有代码库自动生成一份初始的 CLAUDE.md 文件。

CLAUDE.md 里该写什么？

以一个具体的 Next.js 15 应用为例，假设项目使用了 App Router、Tailwind CSS 和 Drizzle ORM，一份典型的 CLAUDE.md 可能包含以下内容：

命令定义：启动、测试、代码检查等常用命令
代码规范：缩进使用两个空格、尽量使用具名导出
架构约定：API 路由放在 app/api 目录下，尽量用服务端操作（Server Actions）替代 API 路由
技术栈说明：使用 Tailwind 编写样式，而非其他 CSS 方案

尽量用服务端操作

这些规则直接明了，效果立竿见影。比如当你让 Claude Code 创建一个 React 组件时，它会自动知道用 Tailwind 写样式，而不需要你额外解释。Claude 能立马上手干活，表现也会明显更好。

更重要的是，CLAUDE.md 可以提交到版本控制系统，这样整个团队都能共享同一份 AI 协作规范。

记忆文件的优先级体系

Claude Code 的记忆文件并非只有一种，它们分为不同的优先级层次，服务于不同的使用场景：

项目级 CLAUDE.md

放在项目根目录下，针对特定项目的配置。包含项目的技术栈、架构规范、命令定义等信息，团队所有成员共享。

首先是项目级MD文件

个人配置级 CLAUDE.md

放在用户配置文件夹中（如 ~/.claude/CLAUDE.md），专为个人使用，适用于所有项目。在这里可以记录个人偏好，比如代码注释习惯、命名风格等。

这种分层设计非常合理：项目级文件确保团队一致性，个人级文件保留个性化空间。

三个实用建议

Anthopic 官方给出了三条关于 CLAUDE.md 的最佳实践：

1. 及时纠正，写入记忆

当你发现 Claude 做错了某件事并需要纠正时——比如它总想用 Server Actions 而不是 API 路由——可以告诉 Claude "记到记忆里"。下次再回到项目时，它就能立刻知道正确的做法，不需要你重复纠正。

2. 引用项目文档

如果项目中有文档希望 Claude 参考，可以在 CLAUDE.md 中使用 @ 导入符号配上文件路径，直接引用相关文档。这样 Claude 就能在需要时查阅这些资料。

直接在前面加个导

3. 先别急着建文件

这一条可能出乎意料：官方建议一开始先不要创建 CLAUDE.md 文件。原因很简单——先裸跑一段时间，你就能清楚地看到在哪些地方不得不一遍遍地纠正 Claude 的方向。这样做能让你的 CLAUDE.md 保持精简，只留下 Claude 真正能用上的必要信息，避免塞入大量无用的上下文。

总结：上下文决定体验

想让 Claude Code 用起来顺手还是抓狂，关键就在于上下文的质量，而 CLAUDE.md 正是管理上下文最核心的工具。

具体的起步方法也很简单：

从基础开始：写下你的技术栈、个人偏好和常用命令
边用边加：在实际使用中发现需要纠正的地方，逐步补充
保持精简：只保留真正有用的信息，避免信息过载

这种渐进式的构建方式，既降低了上手门槛，又确保了文件内容的高质量。对于正在使用或计划使用 Claude Code 的开发者来说，花几分钟了解和配置 CLAUDE.md，可能是提升 AI 编程效率最划算的投入。