Claude Code /memory 详解：让 AI 真正记住你的项目
为什么需要 /memory
用 Claude Code 做开发，最让人抓狂的事之一就是：每次开新会话，Claude 什么都不记得了。
上一轮对话里你告诉它”项目用 TypeScript strict 模式”、“提交信息用 conventional commits”、“别动 legacy 目录的代码”。关掉终端再打开，一切归零。你又得重新说一遍。
更要命的是团队协作——你花了半小时教 Claude 项目规范，但这些规范只存在那一轮对话里。换个人、换个会话，全部从头来过。
Claude 的每一轮对话都是一张白纸，但你的项目规范不应该是。
这时候你需要 /memory。
/memory 是什么
/memory 是 Claude Code 的内置命令，用来查看和管理所有记忆文件。
在交互模式下输入：
/memory它会列出当前会话加载的所有记忆文件，包括：
- CLAUDE.md 文件：你手动写的项目指令，分布在不同层级
- Auto Memory 文件：Claude 自动记录的笔记和偏好
- 规则文件：
.claude/rules/下的模块化指令
你还可以通过 /memory 切换 Auto Memory 的开关，或者直接打开记忆文件夹进行编辑。
简单说，/memory 回答的是一个问题：Claude 现在记住了什么？
两套记忆系统
Claude Code 有两套互补的记忆机制，共同解决”跨会话记忆”的问题：
CLAUDE.md——你写给 Claude 的指令
CLAUDE.md 是一个 Markdown 文件，放在项目根目录。Claude Code 启动时会自动加载它到系统提示词里。你写什么，Claude 就遵守什么。
# CLAUDE.md
## 代码规范
- 使用 TypeScript strict 模式
- 提交信息遵循 conventional commits
- 缩进用 2 空格，行宽 120
## 项目结构
- src/api/ 是后端代码
- src/components/ 是前端组件
- 不要修改 legacy/ 目录下的任何文件核心特点：你写的、你控制的、可以提交到 Git 的、团队共享的。
Auto Memory——Claude 自己记的笔记
Auto Memory 是 Claude 在工作过程中自动记录的笔记。比如你纠正了它一个错误，它会默默记下来；你告诉它”以后都用 bun 不要用 npm”，它也会记住。
笔记存在 ~/.claude/projects/<项目>/memory/MEMORY.md 里，是普通的 Markdown 文件，你随时可以查看、编辑或删除。
核心特点：Claude 写的、自动积累的、不提交到 Git 的、个人私有的。
两者的区别
| 维度 | CLAUDE.md | Auto Memory |
|---|---|---|
| 谁写的 | 你手动写 | Claude 自动写 |
| 存储位置 | 项目根目录 | ~/.claude/projects/ |
| 是否提交 Git | 是，团队共享 | 否，个人私有 |
| 加载时机 | 每次会话启动时 | 每次会话启动时（仅 MEMORY.md） |
| 适合存什么 | 项目规范、架构说明、团队约定 | 个人偏好、调试经验、踩坑记录 |
CLAUDE.md 的层级与加载
CLAUDE.md 不是只有一个文件——它有多个层级，从全局到项目到个人，层层叠加。
层级一：全局记忆
~/.claude/CLAUDE.md适用于你所有的项目。放一些通用偏好，比如：
- 用中文回复
- 提交信息用英文
- 偏好函数式编程风格层级二：项目记忆
./CLAUDE.md项目根目录的文件，最常用的一级。跟着 Git 走，团队所有人共享。放项目规范、架构说明、技术栈约定等。
层级三：个人本地记忆
./CLAUDE.local.md个人本地文件，加到 .gitignore 里，不提交到仓库。适合放一些个人偏好，比如你习惯的调试方式、偏好的测试框架配置等。
层级四：模块化规则
.claude/rules/*.md这是最灵活的一级，后面单独讲。
加载顺序
Claude Code 启动时，会从当前目录向上遍历到文件系统根目录，加载沿途所有的 CLAUDE.md。这意味着在 monorepo 里，子包目录下的 CLAUDE.md 会在你进入该子包时自动生效。
重要：CLAUDE.md 在上下文压缩后会被重新从磁盘读取并注入，不会丢失。如果某条规则在压缩后消失了，说明它只存在对话里，没写进 CLAUDE.md。
Auto Memory 的工作原理
Auto Memory 不需要你做任何事——Claude 会在工作过程中自己判断哪些信息值得记住。
什么会被记住
- 你的纠正：你说”这个不对，应该用 X 而不是 Y”，Claude 会记下来
- 明确的指令：你说”记住以后都用 bun”或”别忘了测试要跑 coverage”
- 反复出现的模式：同一个问题你纠正了多次，Claude 会意识到该记录下来
- 项目关键信息：构建命令、架构决策、重要文件路径
存储结构
~/.claude/projects/<项目>/memory/
MEMORY.md # 主记忆文件，每次会话启动时加载
debugging.md # 调试经验（按主题拆分）
patterns.md # 代码模式
api-conventions.md # API 约定MEMORY.md 是主文件，会在每次会话启动时自动加载到上下文。建议控制在 200 行以内。
主题子文件（如 debugging.md）不会在启动时加载，而是 Claude 需要时按需读取。这样既能保存详细信息，又不会浪费上下文窗口。
触发关键词
想让 Claude 记住某件事？用这些关键词：
记住：以后所有新文件都用 .tsx 扩展名别忘了：测试命令是 npm run test -- --coverageClaude 识别到”记住”、“别忘了”、“remember”、“don’t forget”等关键词时，会主动写入 MEMORY.md。
.claude/rules/ 模块化规则
当项目变大、规范变多，一个 CLAUDE.md 文件会变得越来越臃肿。.claude/rules/ 提供了模块化的解决方案。
基本用法
.claude/
rules/
code-style.md # 代码风格规范
testing.md # 测试规范
security.md # 安全规范
api-design.md # API 设计规范每个 .md 文件就是一组独立的规则，Claude Code 会自动发现并加载。
条件加载：glob 匹配
这是 .claude/rules/ 最强大的功能——根据文件路径按需加载规则。
在规则文件的 frontmatter 里加 paths 字段：
---
paths:
- src/api/**/*.ts
---
## API 规范
- 所有接口必须有入参校验
- 错误码使用统一的枚举类型
- 响应格式统一为 { code, data, message }这条规则只在 Claude 处理 src/api/ 下的 TypeScript 文件时才会加载。编辑前端组件时，这些规则不会出现，不浪费上下文。
实际组织方式
.claude/
rules/
frontend/
react.md # paths: src/components/**/*.tsx
styling.md # paths: src/**/*.css
backend/
api.md # paths: src/api/**/*.ts
database.md # paths: src/models/**/*.ts
general/
code-style.md # 无 paths，全局加载
security.md # 无 paths，全局加载没有 paths 的规则文件在启动时全局加载；有 paths 的文件按需加载。
实际使用场景
场景一：团队规范沉淀
把团队的编码规范、提交规范、架构约定写进 CLAUDE.md，提交到 Git：
# CLAUDE.md
## 提交规范
- 使用 conventional commits
- feat/fix/refactor/docs/test/chore
## 代码规范
- TypeScript strict 模式
- 禁止使用 any
- 组件用函数式写法新人加入团队，git clone 下来就自动生效。规范从口口相传变成代码即文档。
场景二：个人偏好持久化
在 Auto Memory 或 CLAUDE.local.md 里记录个人偏好：
记住：我喜欢在函数前加注释说明参数含义
记住：调试时优先用 console.table 而不是 console.log这些偏好不会影响团队其他人，但每次你开新会话都会自动生效。
场景三：Monorepo 分域管理
大型 monorepo 里，不同子包有不同的技术栈和规范：
.claude/
rules/
react-app.md # paths: packages/web/**/*
node-api.md # paths: packages/api/**/*
shared-utils.md # paths: packages/shared/**/*Claude 在不同子包里工作时，自动加载对应的规范。前端规则不会污染后端代码，后端约定不会干扰前端组件。
场景四：新人快速对齐
新人第一天：git clone → 打开 Claude Code → 所有项目规范自动加载。
不需要读完几十页的 Wiki，不需要老人手把手教。Claude 已经知道项目的所有规范，新人只要正常和 Claude 协作，产出的代码就自动符合团队标准。
实用技巧
技巧一：200 行法则
CLAUDE.md 和 MEMORY.md 都建议控制在 200 行以内。超过 200 行，Claude 的遵守度会下降——上下文太长，注意力会分散。
详细内容拆到 .claude/rules/ 的子文件里，或者拆到 Auto Memory 的主题文件里。主文件只放最核心的规则。
技巧二：用命令式写规则
不要写描述性的句子，写命令式的指令：
❌ 项目使用 TypeScript
✅ 所有新文件必须使用 TypeScript strict 模式Claude 把命令式语句当作规则执行，把描述性语句当作可选参考。想让 Claude 严格遵守，就用命令式。
技巧三：定期清理 Auto Memory
Auto Memory 会不断积累，时间长了难免有过时或错误的记录。定期用 /memory 查看，删掉不再准确的内容。如果某条 Auto Memory 很稳定很重要，考虑把它”升级”到 CLAUDE.md 里。
技巧四：用 /init 快速生成 CLAUDE.md
新项目不知道 CLAUDE.md 怎么写？直接用：
/initClaude 会分析你的项目结构、技术栈、配置文件，自动生成一份 CLAUDE.md 初稿。你在这个基础上修改就行。
写在最后
/memory 解决的问题很简单：让 Claude 的记忆不再随会话消失。
用 Claude Code 做开发，最大的浪费不是 Claude 写错了代码，而是你每次开会话都要重复同样的话。项目规范说了十遍，个人偏好强调了八次，架构约定每次都要重新解释。
把它们写进 CLAUDE.md，让 Auto Memory 自动积累，用 .claude/rules/ 按需加载。说一次就够了，Claude 会一直记着。
一个命令，让每次对话都站在上次的肩膀上。
相关推荐
AI-first 创业公司，为什么只需要一种编程语言？
技术架构越简单 = AI Coding 效率越高。从 Java 的"防人"设计到 TypeScript 全栈通吃，聊聊 AI 时代创业公司的编程语言选择。
cc-ping：一行命令 Ping 所有 Claude Code 配置
用多个 Claude Code API Key 或中继？cc-ping 帮你管理配置、一键切换，还能并行 Ping 所有节点比速度。
震惊！程序员用这个工具，4分钟干完95分钟的活！效率暴涨24倍
躺床上发3条消息，4分钟搞定3个项目。传统方式需要95分钟，这就是冷兵器和热兵器的差距。
CCBot - 研发提效 24 倍
通过 IM 机器人控制 Claude Code，3 个项目 4 分钟全部搞定。传统编程需要 95 分钟，效率提升 24 倍。
Claude Code /add-dir：被低估的 Monorepo 神器
Claude Code 默认只能看到当前目录。/add-dir 打破这个限制——分享我每天跨 5 个仓库使用的经验。
Claude Code 省 Token 小技巧：感叹号的妙用
一个简单却容易被忽略的技巧——用感叹号直接执行命令，省 token、提速度、更可控。
我做了个机器人，让团队在飞书里用 Claude Code
CCBot 让你的团队在飞书群聊里直接用 Claude Code——不需要终端、不需要 SSH。开源、自部署、五分钟搞定。
Claude Code /btw 命令详解：不打扰主线的快问快答
详细介绍 Claude Code 的 /btw 命令——它是什么、怎么用、什么时候该用，以及它和子代理、/compact 的区别。
Claude Code /compact：释放上下文，不丢进度
任务做到一半上下文满了？/compact 帮你压缩对话继续干活——和 /clear、/rewind 的区别一次讲清。
Claude Code /config：一文搞懂所有可调设置
用 Claude Code 却从没打开过 /config？这篇带你逐项拆解——从权限模式到自动压缩，从主题切换到通知配置，帮你打造最顺手的 AI 编程环境。
Claude Code /context：你的上下文都被什么吃了？
对话到一半 Claude Code 说上下文不够了？/context 用一张可视化网格告诉你：上下文被什么占了、占了多少、怎么优化。
Claude Code /diff：这次对话改了什么，一目了然
Claude Code 帮你改了一堆文件，但你不确定到底改了什么？/diff 用交互式界面展示所有改动——既有 git 视角的全量 diff，也有按对话轮次拆分的逐步 diff。
Claude Code /fast：同样的 Opus，两倍速——值不值？
/fast 不会降级模型，还是 Opus，只是更快。什么时候该开、什么时候该关，以及实际体验差异。
Claude Code 引用外部知识的最佳实践：GitHub MCP + Context7
用 GitHub MCP 和 Context7 MCP 两个工具组合，解决 Claude Code 知识过时导致的代码错误问题。
Claude Code /hooks：让 AI 按你的规矩办事
想在 Claude Code 执行命令前自动检查？想在任务完成后自动通知？/hooks 让你用脚本、AI 甚至 HTTP 请求，在关键节点插入自定义逻辑。
Claude Code /init：10 秒自动生成 CLAUDE.md
别再手写 CLAUDE.md 了。看看 /init 自动生成的效果、怎么自定义输出，以及一个让 Claude Code 效率翻倍的小技巧。
Claude Code MCP：让 AI 连接 GitHub、数据库等一切工具
MCP 把 Claude Code 从代码阅读器升级为全栈 Agent。哪些 MCP 服务器值得装、配置怎么写，实测分享。
Claude Code /model：Opus、Sonnet、Haiku 怎么选？
不是每个任务都需要 Opus。怎么切换模型、哪个场景用哪个、怎么省 token 又不掉质量。
Claude Code /permissions：谁能干什么，你说了算
每次 Claude Code 要跑命令都弹窗问你？嫌烦又不敢全放开？/permissions 帮你精细控制每个工具的权限——该放的放，该拦的拦。
Claude Code /plan 详解：先想清楚再动手
详细介绍 Claude Code 的 /plan 命令和 Plan Mode——只读规划模式，让 Claude 先分析代码、制定方案，确认后再动手，避免复杂任务翻车。
Claude Code + Playwright MCP：AI 终于能"看见"页面了
一个 Modal 溢出的 bug，Claude Code 反复修了 5 次都没搞定。直到接入 Playwright MCP 让它真正看到页面，一次定位，一次修复。
Claude Code /resume 命令详解：别让对话白聊
详细介绍 Claude Code 的 /resume 命令——恢复历史对话、管理会话、实用技巧，让你的每一轮对话都不浪费。
Claude Code /review：让 AI 帮你做 Code Review
提了 PR 没人看？想在合并前多一道把关？/review 让 Claude Code 像一个资深开发者一样审查你的代码——还有 /ultrareview 和 /security-review 两个进阶选择。
Claude Code Skills 详解：打造你的专属命令库
详细介绍 Claude Code 的 Skills 功能——创建自定义斜杠命令、复用提示词模板、共享团队最佳实践，让 AI 编程更高效更一致。
Claude Code /stats：看看 AI 到底帮你写了多少代码
好奇 Claude Code 到底写了多少行代码？/stats 给你完整数据——token、编辑次数、工具调用，教你怎么看。
Claude Code /status 命令详解：一眼看清会话全貌
详细介绍 Claude Code 的 /status 命令——它是什么、怎么用、能看到哪些信息，以及它在日常工作流中的实际价值。
Claude Code /tasks 命令详解：后台任务尽在掌控
详细介绍 Claude Code 的 /tasks 命令——查看后台任务、管理并行 Agent、掌控长时间运行的进程，让多任务开发井井有条。
Claude Code /usage 命令详解：你的额度还剩多少
详细介绍 Claude Code 的 /usage 命令——查看用量、了解限额、避免突然被限速，让你对自己的额度心中有数。
Claude Code /vim：在 AI 编程助手里用 Vim 键位
习惯了 Vim 的操作方式？/vim 让你在 Claude Code 的输入框里用 hjkl 移动、dd 删行、ciw 替换单词——不用改变肌肉记忆。
Claude Code 使用指南：从安装到实战，一篇就够（2026）
用了半年 Claude Code 的经验总结——5 分钟安装配置、最常用的命令、CLAUDE.md 编写技巧，以及没人告诉你的实战心得。
Claude 全家桶：从聊天到写代码到自动办公，一文讲清楚
一篇文章带你了解 Anthropic 的 Claude 全家桶——Claude.ai、Claude Code、Claude Cowork，以及 Opus、Sonnet、Haiku 三大模型家族。
Claude Code /agents 详解：自定义 AI 子代理，各司其职
详细介绍 Claude Code 的 /agents 命令——查看、管理和创建自定义 Agent，让不同任务由专门的 AI 角色来执行，从代码探索到架构规划各司其职。
Claude Code /doctor 详解：一键诊断你的开发环境
详细介绍 Claude Code 的 /doctor 命令——自动检测安装状态、API 连接、MCP 配置、上下文用量等问题，帮你快速定位和修复环境故障。
Claude Code /effort 详解：控制 AI 思考的深度
详细介绍 Claude Code 的 /effort 命令——调节 Claude 的推理努力程度，在速度和质量之间找到最佳平衡点，让每一次对话都恰到好处。
Claude Code /cost 详解：你的 AI 编程到底花了多少钱
详细介绍 Claude Code 的 /cost 命令——实时查看会话 API 成本，了解各模型定价和 Token 消耗明细，让每一分钱都花得明明白白。
Claude Code /export 详解：把 AI 对话带走
详细介绍 Claude Code 的 /export 命令——将对话导出为文件或复制到剪贴板，方便分享、存档和复盘，让每一次有价值的对话都不浪费。
Claude Code /rewind 详解：AI 改错了？一键回退
详细介绍 Claude Code 的 /rewind 命令——将代码和对话回退到任意历史节点，支持只回退代码、只回退对话、或两者同时回退，是你和 AI 协作时的后悔药。
Claude Code /plugin 详解：给你的 AI 编程助手装插件
详细介绍 Claude Code 的 /plugin 命令——管理插件的安装、启用、禁用和更新，通过插件扩展 Claude Code 的命令、技能、Agent 和 Hook，打造你专属的 AI 编程工具链。
Claude Code /theme 详解：给你的终端换个好看的皮肤
详细介绍 Claude Code 的 /theme 命令——6 种预设主题 + 自动模式，支持深色/浅色、色盲友好、ANSI 兼容，60+ 色值覆盖终端全部 UI 元素。
Claude Code /insights 详解：用 AI 分析你自己用 AI 的方式
详细介绍 Claude Code 的 /insights 命令——五阶段数据分析流水线、七大洞察章节、多维度会话统计，用 Claude Opus 生成专属 HTML 使用报告。
Claude Code /rename 详解：给你的会话取个有意义的名字
详细介绍 Claude Code 的 /rename 命令——手动命名、AI 自动生成（Haiku 模型）、启动参数命名、Plan 模式自动命名，以及双标题系统与 Bridge 同步机制。
Claude Code settings.json 配置详解：5 层优先级、3 种文件路径，一篇搞懂
Claude Code 的 settings.json 到底放哪里？用户级、项目级、本地级有什么区别？什么是 managed-settings.json？一篇讲清 5 层配置的优先级规则、合并逻辑和实际使用场景。
Claude Code settings.json 详解（二）：permissions 权限系统全解析
深入解析 Claude Code 的 permissions 配置——allow/deny/ask 三类规则、通配符语法、MCP 工具权限、defaultMode 各模式含义，以及 additionalDirectories 的作用。
Claude Code settings.json 详解（三）：hooks 钩子全解析
深入解析 Claude Code 的 hooks 配置——四种钩子类型、核心事件（PreToolUse/PostToolUse/Stop/Notification）、stdin/stdout 协议、exit code 语义，以及实用配置示例。
Claude Code settings.json 配置模板：env、模型、认证等实用字段速查
Claude Code settings.json 常用字段速查表：env 环境变量、模型切换、apiKeyHelper 动态认证、Git 署名、思考深度、语言与界面、自动更新等，附可直接复制的配置示例。
Claude Code Agent Loop：拆解 AI 编程助手的心脏
Claude Code 是怎么一步步理解你的需求、调用工具、自我修复的？从源码角度拆解 Agent Loop 的核心架构——流式响应、并行工具执行、自动压缩、错误恢复，一次讲透。