Claude Code 的记忆系统Claude Code 没有跨会话的自动记忆——每个新会话都从一个全新的上下文窗口开始。记忆系统通过两种互补机制让知识能够跨会话持久保存并在每次对话开始时自动加载机制谁来写适合什么CLAUDE.md 文件开发者手动编写项目规范、团队约定、构建命令等Auto Memory自动记忆Claude 自动写入从开发者的纠正和偏好中积累的经验两种机制在每次会话开始时都会被加载到上下文中。Claude 将它们作为参考上下文而非强制配置——指令越具体、越简洁Claude 遵循得越一致。记忆文件的层级结构Claude Code 采用四层记忆层级优先级从高到低1. 企业级配置Enterprise policy ← 最高优先级只读 2. 用户级 CLAUDE.md ← ~/.claude/CLAUDE.md对所有项目生效 3. 项目级 CLAUDE.md ← 项目根目录随 Git 提交共享给团队 4. 子目录级 CLAUDE.md ← src/、api/、tests/ 等子目录按上下文加载最具体的规则优先子目录的 CLAUDE.md 会覆盖上层的同类规则。CLAUDE.md推荐的 CLAUDE.md 结构# 项目约定 ## 技术栈 - 前端Next.js 15、TypeScript 5.7、Tailwind CSS 4 - 后端Node.js 22、Prisma 6 - 测试Vitest 3.2 ## 代码规范 - 始终使用函数式 React 组件 - 文件名使用 kebab-case - 测试文件与源码放在同一目录 ## 常用命令 - 构建pnpm build - 测试pnpm test - 启动开发服务器pnpm dev ## API 约定 - 所有 API 路由以 /api/v1/ 开头 - 错误响应格式{ error: string, code: number }写好 CLAUDE.md 的黄金法则✅ 要这样写使用祈使句和简短列表而非叙述性段落包含具体的版本号和命令加入代码示例5 行示例胜过 50 字说明控制在200 行以内超过部分不会在会话开始时加载❌ 避免这样写模糊指令如遵循最佳实践或写干净的代码过多通用规则只放这个项目独有的约定过时的信息建议每月审查一次子目录 CLAUDE.mdmy-project/ ├── CLAUDE.md # 全局项目规范 ├── src/ │ └── CLAUDE.md # 仅在处理 src/ 文件时加载 ├── api/ │ └── CLAUDE.md # API 特定约定 └── tests/ └── CLAUDE.md # 测试特定规则Claude Code 只在处理对应目录的文件时加载子目录的 CLAUDE.md节省 token 的同时提供更精准的上下文。Auto Memory自动记忆Auto Memory 让 Claude 能够跨会话自我积累知识无需你手动编写任何内容。Claude 会在工作过程中自动保存笔记包括构建命令和调试技巧架构决策笔记代码风格偏好工作流习惯Claude 并不会每次都保存内容它会判断哪些信息在未来会话中有用才写入。自动记忆的文件结构~/.claude/projects/project/memory/ ├── MEMORY.md # 简洁的索引文件每次会话开始时加载前 200 行 ├── debugging.md # 调试模式的详细笔记 ├── api-conventions.md # API 设计决策 └── ... # Claude 创建的其他主题文件MEMORY.md是整个记忆目录的索引Claude 通过它来追踪各文件中存储的内容。触发自动记忆当你告诉 Claude 某些事情时它会自动保存到记忆中你始终使用 pnpm不要用 npm 你记住 API 测试需要本地运行 Redis 实例 你我们的日期格式统一用 ISO 8601想保存到 CLAUDE.md 而不是 Auto Memory明确说明你把这条加到 CLAUDE.md开启 / 关闭 Auto Memory方式一通过/memory命令切换见下节方式二在项目设置中配置// .claude/settings.json { autoMemoryEnabled: false }方式三环境变量export CLAUDE_CODE_DISABLE_AUTO_MEMORY1注意Auto Memory 是本地机器级别的同一 Git 仓库的所有 worktree 和子目录共享一个记忆目录但不会跨机器或云环境同步。/memory命令使用/memory是管理记忆系统的核心命令。/memory命令的功能在 Claude Code 会话中输入/memory可以查看当前会话加载的所有 CLAUDE.md 和规则文件列表切换Auto Memory 的开启/关闭状态打开Auto Memory 文件夹链接选择任意文件在编辑器中打开编辑#快捷键——快速添加记忆这是一个隐藏的效率神器# 始终在函数参数中使用具名参数named parameters按下#键输入你想记住的内容按回车——Claude Code 会自动将其写入对应的 CLAUDE.md 文件。非常适合记录项目约定保存常用 Bash 命令记下代码风格细节
