07-CLAUDE.md 和 rulesCLAUDE.md 是什么CLAUDE.md 是 Claude Code 的项目记忆文件。你可以把它理解为 Claude Code 关于你项目的长期记忆——它会在每次对话开始时自动加载告诉 Claude 你的项目背景、技术栈、编码规范和约定。你可以手动创建 CLAUDE.md也可以在 Claude Code 的终端中输入/init让它自动生成。随着项目的演进CLAUDE.md 会像你的记忆一样不断迭代和丰富。CLAUDE.md 应该放什么好的 CLAUDE.md 应该包含以下内容项目概述项目是做什么的目标用户是谁技术栈使用的框架、库、构建工具和版本编码规范命名约定、代码风格、文件组织方式目录结构关键目录的用途说明常用命令构建、测试、部署等常用命令团队约定分支策略、提交信息格式、PR 流程CLAUDE.md 的大小控制CLAUDE.md 不是越大越好。因为所有大模型的上下文容量都有限一个过于冗长的 CLAUDE.md 会占用宝贵的上下文空间反而降低 Claude 的执行效率。建议将 CLAUDE.md 控制在200 行以下。只记录长期稳定、反复有用的内容。那些一次性的、临时的指令不应该放在这里。CLAUDE.md 的放置位置CLAUDE.md 可以放在多个位置优先级从高到低为位置作用域是否加入版本控制子目录/CLAUDE.md仅该目录可选择加入项目根目录/CLAUDE.md当前项目建议加入与团队共享项目根目录/CLAUDE.local.md当前项目不加入放入 .gitignore~/.claude/CLAUDE.md所有项目不加入重要规则如果多个位置的 CLAUDE.md 存在冲突优先级高的会覆盖优先级低的。例如项目根目录的 CLAUDE.md 会覆盖用户目录的同名设置。rules 规则文件对于较大的项目单一的 CLAUDE.md 可能不足以组织所有的项目规则。这时你可以使用.claude/rules/目录将指令组织到多个文件中。rules 的文件组织每个文件应涵盖一个主题并使用描述性文件名。例如your-project/ ├── .claude/ │ ├── CLAUDE.md # 主项目指令 │ └── rules/ │ ├── code-style.md # 代码样式指南 │ ├── testing.md # 测试约定 │ └── security.md # 安全要求所有.md文件都会被递归发现因此你可以将规则组织到子目录中如frontend/、backend/、database/等。rules 的加载机制Claude Code 会根据规则配置和当前上下文有选择地加载rules 文件。这意味着当你处理前端代码时主要加载frontend/下的规则当你处理 API 开发时自动加载api-design.md规则文件只有在相关时才占用上下文这种按需加载的机制比把所有内容都塞进 CLAUDE.md 要高效得多。最佳实践总结根据万少的经验推荐以下分层管理策略第一层CLAUDE.md记忆层存放长期稳定的项目信息项目名称和一句话描述核心技术栈最常用的构建和测试命令团队协作约定分支策略、PR 规范第二层.claude/rules/规则层存放分类管理的项目规则代码风格规则测试规则安全规则数据库设计规范API 设计规范第三层CLAUDE.local.md个人层存放个人专属的偏好设置个人常用的编辑器设置个人工作流偏好注意此文件应加入 .gitignore核心原则只记录长期有用的信息一次性的指令不要写进记忆文件按主题拆分不同领域的内容放到不同的规则文件控制文件大小CLAUDE.md 不超过 200 行规则文件不超过 100 行定期维护随着项目演进定期清理过时的内容团队共享项目级别的 CLAUDE.md 和 rules 应提交到版本控制这样组织的好处是Claude 在需要的时候能快速找到准确的信息不会被无关内容干扰工作效率自然更高。