在使用 Claude Code 进行深度开发时,最常见的问题是:每次重新打开项目,AI 似乎就“忘”了之前的约定。 为了让 Claude 能够持续记住项目背景,并始终按照你要求的代码风格编写程序,最优雅的解决方案不是复杂的脚本,而是官方提供的 CLAUDE.md 机制。
一、 什么是 CLAUDE.md?
CLAUDE.md 是一个存放在项目根目录的特殊说明文件。它是 Claude Code 官方指定的“项目指南”。
每当你在这个目录下启动 Claude 时,它都会自动读取该文件的内容。这相当于为 AI 提供了一个持久化的上下文窗口,让它在无需你反复提醒的情况下,了解项目逻辑和开发禁忌。
二、 如何配置项目记忆与规范
你只需要在项目根目录下创建一个名为 CLAUDE.md 的文件,并按照以下结构进行编写:
1. 项目背景(长期记忆)
在这个部分,描述项目是做什么的,以及核心业务逻辑。这能防止 AI 给出不符合业务场景的建议。
2. 开发规范(行为约束)
明确你的代码风格。例如:是否允许使用某个库、变量命名规则、注释风格等。
3. 常用命令(操作参考)
记录项目特有的构建、测试或部署命令,让 Claude 能准确执行任务。
三、 实战模版
你可以参考以下内容创建你的 CLAUDE.md(建议根据实际项目修改):
四、 为什么使用 CLAUDE.md 而非 Skills?
- 零成本维护:不需要编写任何 JSON 或 JavaScript 逻辑,只需要会写 Markdown。
- 零配置启动:Claude Code 会自动识别并加载,不需要在命令行中添加额外参数。
- 版本控制:该文件可以随代码一起提交到 Git 仓库,团队中的其他成员使用 Claude Code 时也能获得相同的规范约束。
五、 快速生成技巧
如果你不确定该如何写规范,可以先让 Claude 帮你打个样。在 Claude Code 终端输入:
"请分析当前项目的技术栈和代码风格,为我生成一个详细的 CLAUDE.md 文件,包含项目简介、代码规范和常用命令。"
Claude 会扫描你的目录结构,自动生成一份契合你当前项目的文档,你只需要在此基础上微调即可。
六、 总结
通过 CLAUDE.md,你成功地为 Claude Code 安装了一个“项目级大脑”。无论你关闭窗口多少次,只要文件还在,AI 的记忆和对规范的执行力就在。
这是提升 AI 协作体验最简单、也最有效的方法。
希望这篇教程能帮你更好地“调教”你的 AI 助手。如果有其他配置问题,欢迎在评论区交流。
评论区