Skill · Anthropic Official Documentation - Using CLAUDE.md files
让 Claude 保持专注:CLAUDE.md 技巧
图片: Mohammad Rahmani 来自 Unsplash
在项目根目录创建 CLAUDE.md 文件,即可省下数小时重复解释的时间。Claude Code 会在每次会话时自动加载这份持久配置,记住你的技术栈、编码规范和工作流程规则,无需你反复说明。
当你在多个 Claude Code 会话之间切换时,通常需要从头重新解释项目结构、编码约定和架构决策。这不仅浪费时间,还会导致输出不一致。CLAUDE.md 文件通过充当 Claude 的持久记忆解决了这一问题。
CLAUDE.md 是一个放置于项目根目录(./CLAUDE.md)的 Markdown 文件。Claude Code 会在每次会话开始时自动读取它,并将其作为常驻指令整合进上下文窗口。你可以在其中写入技术栈、命名约定、测试要求、安全策略以及团队遵循的任何架构规则。
要开始使用,请创建一个包含核心信息的 CLAUDE.md 文件:项目名称、技术栈(React 18、Node.js、PostgreSQL)、关键目录,以及任何不可协商的约定(“始终使用 TypeScript 严格模式”“先写测试再写代码”)。请将其控制在 300 至 800 词之间。对于较大的团队,可在 .claude/rules/ 子目录中创建项目专属规则,并维护一个较小的根文件。Claude 还会加载全局的 ~/.claude/CLAUDE.md,用于在所有项目中应用个人偏好。
示例工作流程:一个支付处理团队在他们的 CLAUDE.md 中添加:“后端:Node.js + Express。数据库:带行级安全性的 PostgreSQL。安全:所有金额字段必须为整数(以分为单位,而非小数)。所有 API 都需要身份验证令牌。”如今,与 Claude Code 的每次会话都会自动了解这些约束。当你让 Claude 编写一个新端点时,它生成的代码会遵守这些规则,而无需你每次都提及。