The CLAUDE.md file

Claude.md 文件学习笔记

核心概念：

• 作用 (Function): Claude. md 文件为 Claude 代码提供项目的“持久记忆”（persistent memory）。
• 必要性 (Necessity): 没有此文件，Claude 每次启动时都需要重新探索代码库、理解依赖和已实现的功能，这会导致它需要做出假设，影响指导方向。
• 工作原理 (Mechanism):
• 它是一个放置在项目根目录下的 Markdown 文件。
• Claude 代码在每次会话开始时会自动读取它。
• 其内容会被附加到你的提示（prompt）中，相当于代码库的“入职脚本”（onboarding script）。
• 生成方式 (Generation): 可以运行斜杠命令（slash init command）让 Claude 根据代码库自动生成 Claude. md。

记忆文件层级 (Memory Hierarchy):

• 项目级 (Project Level):
• 位置：项目根目录。
• 用途：定义特定项目的技术栈、偏好和命令。
• 用户级 (User Level):
• 位置：用户配置文件夹。
• 用途：存储跨所有项目的个人偏好（如代码注释风格）。

使用最佳实践 (Best Practices):

• 明确指令 (Explicit Instruction): 如果需要纠正 Claude 的行为（例如，始终使用 Server Actions 而非 API Routes），必须明确要求 Claude 将此信息保存到记忆中。
• 引用文档 (Referencing Docs): 如果项目中有需要 Claude 参考的文档，可以使用“@”符号加上文件路径进行引用。
• 从小处开始 (Start Lean): 建议先在一个没有 Claude. md 的项目中开始，观察需要不断修正的地方，从而确保最终的记忆文件只包含必要的、能让 Claude 有效工作的上下文。

总结：

• 效率提升： Claude. md 提供了必要的上下文（Context），是区分“令人沮丧的会话”和“高效的会话”的关键。
• 构建顺序： 从技术栈（Stack）→ 偏好（Preferences）→ 命令（Commands）开始构建文件。

Takeaways

• Claude. md 是 Claude 代码的“持久记忆”，用于提供项目上下文，避免 Claude 每次启动时重复探索代码库和做出假设。
• 该文件放置在项目根目录，每次会话开始时自动读取，相当于项目的“入职脚本”。
• 记忆分为项目级（定义特定项目的技术栈和偏好）和用户级（存储跨所有项目的个人偏好）。
• 提高效率的关键在于明确指令，并按照技术栈 → 偏好 → 命令的顺序构建记忆文件。