CLAUDE.md:让你的 AI 助手秒懂项目

你大概率每天都在做这件事——

打开 Claude Code，开始一个新的对话，然后花十分钟解释你的项目结构、你的代码规范、你的工作流程。

就这样，重复着。

没关系，大多数人都是这样用的。但问题不在于你不够耐心——而在于你从一开始就用错了方法。

一、你缺的不是工具，是”说明书”

说实话，我之前也是这样。

每次开始新对话，我都要重新告诉 Claude：这个项目的核心模块在哪、测试怎么跑、代码风格是什么。有一次我甚至把同样的话复制粘贴了五遍。

后来我才明白，问题不在于 Claude 记不住，而在于我从来没给过它一个”说明书”。

CLAUDE.md 就是干这个的。

二、一个文件，省下无数口舌

CLAUDE.md 是什么？

简单说，它就是放在你代码库里的一个配置文件。每次你和 Claude 对话，它都会自动读取这个文件。

你可以在里面写：

• • 项目的目录结构
• • 常用的命令（构建、测试、部署）
• • 代码规范和风格指南
• • 团队的工作流程

配置一次就行。

三、别自己写，让 Claude 帮你写

听到这，你可能想：“行，我这就去写一个。”

别急。

Claude Code 有个命令叫 /init。运行它，Claude 会自动分析你的项目，然后生成一个 CLAUDE.md 文件。

它会读取你的 package.json、README、配置文件，然后生成一个包含核心信息的配置。

你需要做的，只是检查一下生成的内容，做点微调。

四、这东西该怎么写？

一个好的 CLAUDE.md，不需要面面俱到。

我看过很多项目，CLAUDE.md 写了几千字。说实话，Claude 不会读那么长，而且每次对话都会加载这个文件，太长反而影响效率。

重点写这几件事：

1. 项目地图

告诉 Claude 你的代码结构。一个简单的树状图就够了：

src/├── components/├── utils/└── api/

2. 工具清单

如果你有自定义的脚本或工具，告诉 Claude 怎么用。

比如：“部署脚本在 scripts/deploy.sh，参数是环境名称。”

3. 工作流程

你希望 Claude 先做什么，后做什么？

比如：“改代码前先理解现有逻辑”、“跑测试前先确认测试覆盖范围”。

这些规则写在 CLAUDE.md 里，Claude 每次都会遵守。

五、三个你一定要知道的功能

除了 CLAUDE.md，Claude Code 还有几个能提升效率的功能：

1. /clear – 清空上下文

当你从一个任务切换到另一个任务时，用 /clear 清空对话历史。

为什么？因为之前的对话会干扰新的思考。

就像你不会把上个会议的笔记带到下个会议一样。

2. Subagents – 独立的”专家”

有些工作需要不同的视角。

比如你刚写完一段代码，现在需要安全审查。这时候让 Claude 用 subagent 去审查，它会用全新的视角看你的代码，不会受之前对话的影响。

3. 自定义命令

有些提示词你会反复用。比如”检查这段代码的性能问题”、“审查这个功能的安全性”。

把它们保存成自定义命令，下次只需要输入 /performance-check 就能直接调用。

最后

如果你看到这里，我建议你做一件事：

在项目根目录创建一个 CLAUDE.md 文件。

不需要很久，10分钟就够了。

但这10分钟，可能会让你接下来每次对话都省下10分钟。

Claude Code 的价值，不在于它多聪明——而在于你能不能让它更好地理解你的世界。

一个简单的 CLAUDE.md 文件，就是那把钥匙。