它到底是什么

/memory 是 Claude Code 的会话内 Slash 命令,用于查看和管理当前会话加载的所有记忆文件。执行后会显示:

• 当前会话已加载的全部 CLAUDE.md、CLAUDE.local.md、.claude/rules/*.md 文件列表
• Auto memory 的开关状态,可在界面中直接切换
• Auto memory 目录的快捷入口,选中任意文件可在编辑器中打开并编辑

Claude Code 的跨会话记忆由两套机制共同承担:

Auto memory 需要 Claude Code v2.1.59 或更高版本。

怎么触发 / 怎么使用

在会话中直接输入,命令只在消息开头被识别:

/memory

在面板中操作

打开 /memory 面板后可以:

1. 查看当前会话所有已加载的记忆文件列表
2. 选中某个文件,在编辑器中打开并编辑内容
3. 切换 Auto memory 开关(on / off)
4. 通过快捷入口打开 Auto memory 目录

让 Claude 写入 Auto memory

在对话中直接表达意图即可,Claude 会自动保存到 auto memory:

记住:这个项目始终使用 pnpm,不用 npm
remember that the API tests require a local Redis instance

若要写入 CLAUDE.md 而非 auto memory,需明确说:

把这条加到 CLAUDE.md

或通过 /memory 面板打开 CLAUDE.md 文件手动编辑。

保存 / 配置 / 集成

CLAUDE.md 文件位置与加载优先级

加载顺序从宽到窄,范围越宽越先注入上下文;同目录内 CLAUDE.local.md 紧随 CLAUDE.md 之后。

文件导入语法

在任意 CLAUDE.md 中使用 @path/to/file 引入外部文件,被导入文件可再次导入其他文件,最多支持 4 层(4-hop)递归(官方原文 'a maximum depth of four hops')。注意:此 4-hop 上限仅针对 CLAUDE.md 的 @path 导入语法,.claude/rules/ 路径规则文件不受该层数限制:

See @README for project overview and @package.json for available npm commands.

# Git workflow
@docs/git-instructions.md

路径限定规则(.claude/rules/)

将 Markdown 文件放入 .claude/rules/ 目录可实现模块化管理。可在文件头部添加 YAML frontmatter,使规则只在 Claude 处理匹配文件时才加载,节省上下文空间:

---
paths:
  - "src/api/**/*.ts"
---

# API 开发规则
- 所有接口必须做输入校验
- 使用标准错误响应格式

不带 paths 字段的规则文件等同于 .claude/CLAUDE.md,每次会话均加载。

Auto memory 配置

三种关闭方式:

会话内通过 /memory 面板切换,或写入 settings.json:

{
  "autoMemoryEnabled": false
}

或设置环境变量:

CLAUDE_CODE_DISABLE_AUTO_MEMORY=1

自定义存储路径(必须是绝对路径或以 ~/ 开头):

{
  "autoMemoryDirectory": "~/my-custom-memory-dir"
}

默认存储结构:

~/.claude/projects/<project>/memory/
├── MEMORY.md          # 简洁索引,每次会话加载(前 200 行或 25KB)
├── debugging.md       # 调试规律详情(按需读取)
├── api-conventions.md # API 设计记录(按需读取)
└── ...

<project> 路径由 git 仓库派生,同一 repo 下所有 worktree 和子目录共享同一个 auto memory 目录。

排除特定 CLAUDE.md(monorepo 场景)

claudeMdExcludes 可在任意设置层配置(user / project / local / managed policy),且数组会跨层合并(官方原文 'You can configure claudeMdExcludes at any settings layer: user, project, local, or managed policy. Arrays merge across layers.')。monorepo 场景下官方推荐写在 .claude/settings.local.json,使用 glob 匹配绝对路径:

{
  "claudeMdExcludes": [
    "**/monorepo/CLAUDE.md",
    "/home/user/monorepo/other-team/.claude/rules/**"
  ]
}

托管策略层的 CLAUDE.md 无法被排除。

组织级集中下发

通过 managed-settings.json 的 claudeMd 字段可将指令直接内嵌,无需单独部署文件:

{
  "claudeMd": "Always run `make lint` before committing.\nNever push directly to main."
}

此字段仅在 managed / policy 设置层有效,用户或项目层设置会被忽略。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 诊断 Claude 为何不遵守规则:先跑 /memory,确认相关 CLAUDE.md 是否出现在已加载列表中;若未出现则说明文件路径有误或被 claudeMdExcludes 过滤
• 快速编辑项目规则:通过 /memory 列表直接打开 CLAUDE.md,比手动找路径更快
• 审查 Auto memory 内容:查看 Claude 自动积累了哪些学习记录,删除错误或过时的条目
• 临时关闭 Auto memory:在不希望 Claude 保存任何记忆的会话中,通过 /memory 面板即时切换开关

常见坑

1. CLAUDE.md 超过 200 行仍期望完整遵循:官方文档明确指出过长文件会降低遵循率,应拆分为路径限定规则(.claude/rules/)或精简内容;使用 @import 拆文件只帮助组织,不减少上下文占用

2. /compact 后指令消失:仅项目根目录的 CLAUDE.md 会在 compact 后自动重新注入;子目录中的 CLAUDE.md 需等 Claude 再次读取该子目录文件才会重载——若指令重要,应移入根目录 CLAUDE.md

3. 以为 CLAUDE.md 是强制执行层:官方文档说明 CLAUDE.md 内容以 user message 形式注入(非 system prompt),Claude 会尽力遵循但不保证严格执行;需要强制执行的操作(如"提交前必须跑 lint")应写成 Hook 而非 CLAUDE.md 指令

4. Auto memory 跨机器不同步:auto memory 为机器本地存储,切换到不同机器或云环境时记忆不随之迁移

来源

• How Claude remembers your project — Claude Code 官方文档
• Commands — Claude Code 官方文档