Claude 如何记住你的项目信息

原文：How Claude remembers your project

一句话

让 Claude 在不同会话间记住项目指令和积累的知识，实现持久化记忆。

什么时候翻这页

1. 当需要给 Claude 持久化项目指令和规范时
2. 当 Claude 重复犯同样的错误需要记录纠正方法时
3. 当需要配置自动记忆功能让 Claude 学习你的偏好时
4. 当 Claude 没有遵循 CLAUDE.md 中的指令需要排查时

核心概念

• CLAUDE.md 文件：用户编写的持久化指令文件，包含项目规范、构建命令、工作流程等
• 自动记忆（auto memory）：Claude 根据你的纠正和偏好自动积累的知识和模式
• 作用域（scope）：指令适用的范围，分为组织级、用户级、项目级和本地级
• 规则（rules）：模块化的指令，可以按文件类型或路径限定，减少上下文占用

怎么做

1. 创建项目 CLAUDE.md

   • 在项目根目录创建 CLAUDE.md 或 .claude/CLAUDE.md
   • 运行 /init 自动生成初始文件
   • 编写具体、简洁的指令（如"使用 2 空格缩进"而非"格式化代码"）

2. 组织规则

   • 在 .claude/rules/ 目录创建主题特定的 markdown 文件
   • 使用 YAML 前matter 的 paths 字段限定规则适用范围
   • 使用 glob 模式匹配文件路径（如 src/**/*.ts）

3. 配置自动记忆

   • 默认已启用，可通过 /memory 命令切换
   • 存储在 ~/.claude/projects/<项目>/memory/ 目录
   • 前 200 行或 25KB 的 MEMORY.md 会在每次会话加载

4. 查看和编辑记忆

   • 使用 /memory 命令浏览所有加载的指令文件
   • 直接编辑记忆文件（纯 markdown 格式）
   • 添加个人偏好到 CLAUDE.local.md（应加入 .gitignore）

命令 / 配置速查

初学者易错点

1. CLAUDE.md 文件过长（超过 200 行）会影响上下文窗口，降低指令遵循率
2. 指令过于模糊（如"格式化代码"）可能导致 Claude 不一致地遵循
3. 在大型项目中，不同团队的 CLAUDE.md 可能冲突，需要使用 claudeMdExcludes 排除无关文件
4. 自动记忆只存储在本地，不会跨机器或云环境共享
5. 管理策略级的 CLAUDE.md 无法被个人设置排除，确保组织指令始终生效

相关词条

• settings：Claude Code 配置管理
• skills：可重复的工作流程包
• hooks：在特定生命周期事件执行的命令
• context-window：上下文窗口管理
• sub-agents：子代理及其持久化记忆
• large-codebases：大型代码库中的记忆管理