写好claude.md，核心四件事，让Claude Code变成老司机

CLAUDE.md 是 Claude Code里最核心的项目记忆，也是和常驻系统提示文件。

它让 Claude code像一个资深工程师一样工作，而不是每次对话都从零开始。

Claude Code在每个会话开始时，会自动读取项目根目录下的 CLAUDE.md 文件，以及更深层目录里的嵌套 CLAUDE.md，把它作为默认上下文加载进来。

官方文档里把它描述为：persistent instructions for a project（项目的持久指令），是给 Claude 提供“项目专属宪法”的方式。

它通常包含四方面内容

【WHY】项目整体目的、业务价值、要解决什么问题 【WHAT / 地图】仓库结构、关键模块位置、主要技术栈、文件组织逻辑 【HOW / 规则】编码规范、命名约定、禁区（比如别直接改 auth/billing 相关）、偏好库、Review Checklist 【工作流】常用命令、调试路径、发版流程、测试要求

建议：

1. 保持简短，理想 300–800 字，超长会让 Claude “注意力分散”或丢关键信息
2. 用它做路由。指向 docs/ 里的 ADR、架构图、Runbook。
3. 支持嵌套：在高危模块（src/auth/CLAUDE.md） 放局部规则，Claude 进入该目录时优先读。
4. 如果你在用 Claude Code，强烈建议先跑 /init 命令，它会自动扫描项目生成一个基础 CLAUDE.md，然后手动精修一下——这可能是提升体验性价比最高的一步。

---

原文链接：https://mp.weixin.qq.com/s/S2whUQkkYUMTRu-dwfNtbA