用途：为 Claude Code 建立和整理项目记忆系统，让助手了解特定代码库的工作方式，从而给出更准确、一致的回答。
记忆层级（优先级从高到低）：企业策略、用户记忆（~/.claude/CLAUDE.md）、项目记忆（项目根目录 CLAUDE.md）、模块化规则（.claude/rules/*.md）、本地记忆（CLAUDE.local.md，应加入 gitignore）。冲突时后加载的来源覆盖先前的。
文件类型：CLAUDE.md 存放项目概述、架构、开发命令、编码约定、关键文件链接，纳入 git 共享；.claude/rules/*.md 为按路径自动加载的模块化规则，支持子目录和 YAML frontmatter 的 globs 定位；CLAUDE.local.md 存放个人偏好、本地路径、机器特定配置，不提交。
用法：先创建 CLAUDE.md，写入构建/测试/lint 命令、目录结构、约定与关键文件；可选在 .claude/rules/ 下按 api.md、tests.md、components/forms.md 等分类添加规则，用 YAML frontmatter 的 paths 字段（如 "src/api/**/*.ts"）限定生效范围；在 CLAUDE.md 中用 @docs/API.md 语法导入其他文档，被导入内容视为直接上下文。
最佳实践：保持简洁，用可执行、具体的指令而非泛泛表述；命令写成实际可运行的代码块；长内容用导入拆分；路径特定规则优先于通用规则，而非全部堆在 CLAUDE.md。
更新时机：新成员入职暴露缺失上下文、重复提问、约定变化、架构重大调整时补充；代码变化或团队反馈表明过时时修订。
常见模式：monorepo 按 packages 说明各包命令与各自 .claude/rules/；环境相关说明放 CLAUDE.local.md。
与 Han 插件集成：SessionStart 钩子可注入插件上下文，UserPromptSubmit 钩子可添加约定提醒，Blueprints 补充详细系统文档。
排查：若 Claude Code 忽略指令，检查文件是否位于项目根、YAML frontmatter 是否合法、glob 是否匹配编辑文件；层级中更具体、更靠后的规则优先。若 CLAUDE.md 过大，可用导入拆分并将细节移入 .claude/rules/。
限制：资料未提供具体价格、平台支持范围或效果数据。