claude-code-memory-setup 是一套面向 Claude Code 的持久记忆完整配置方案，通过 CLAUDE.md 规则、/save、/resume会话命令、Obsidian 笔记库与 Graphify 代码知识图谱，让 AI 在每次新会话中自动"想起"你的项目背景、历史决策和代码结构，官方示例中每会话 token 消耗最高可减少数十倍。本文为你整理出 4 个最核心的技巧，新手也能照做落地。

为什么 Claude Code 需要一套记忆方案？🧠

使用 Claude Code 时，有两个问题在悄悄"吃掉"你的 token：

这套方案用两层互补系统解决：Obsidian 负责"决定了什么"（声明式记忆），Graphify 负责"代码长什么样"（结构地图），再配合/save、/resume两个命令实现会话无缝衔接。

需要获取本仓库中的现成脚本时，可先克隆到本地：git clone https://gitcode.com/gh_mirrors/cl/claude-code-memory-setup

技巧一：先写好 CLAUDE.md 规则，给 Claude Code 一本"标准记忆手册"📖

CLAUDE.md是 Claude Code 自动读取的指令文件，整套方案的地基。官方建议在 Obsidian 库（vault）根目录放一份全局 CLAUDE.md，在代码仓库根目录放一份项目级 CLAUDE.md。

全局 CLAUDE.md 要写清楚四件事（参考示例：README.md）：

1. 这个库是干什么的——所有项目的集中知识库，跨会话持久记忆；
2. 各项目的技术栈——例如"Project X: React + Supabase"，让 AI 不用问就知道背景；
3. Zettelkasten 笔记规则——强制每张笔记带 YAML frontmatter、文件名用 kebab-case、一记一事（原子性）、每篇至少 2 个 wikilinks（密集链接）；
4. "绝不做"清单——例如"不经过询问不删除笔记"、"内部笔记一律用 wikilinks"。

库的推荐目录结构如下，单库（single vault）管理所有项目，跨项目的笔记可以互相链接，图谱视图里会出现意想不到的关联：

~/vault/ ├── CLAUDE.md # 给 Claude Code 的全局指令 ├── permanent/ # 沉淀后的原子笔记 ├── logs/ # 全局会话日志（/save 产物） ├── my-project/ # 每个项目一个文件夹 │ └── architecture/ # 架构、决策、约定 ├── chats/ # 导入的历史聊天 └── graphify/ # 代码知识图谱笔记

⚠️ 官方特别提醒：代码仓库必须放在 vault 之外，否则 Obsidian 会去索引node_modules/和构建产物，拖垮体验（见 CHANGELOG.md 1.0.0 版本说明）。

技巧二：/save 与 /resume 两个命令，实现会话无缝续写⚡

这是整套方案体验提升最明显的部分。把下面两节命令语义写进 CLAUDE.md，AI 收到对应指令就会自动执行固定流程：

/resume——开工前加载上下文

1. 读取logs/中最近的 3 份会话日志；
2. 读取当前项目的architecture/decisions.md；
3. 总结当前状态和待办事项，直接开工。

/save——收工前存档

1. 在logs/YYYY-MM-DD-description.md创建会话日志；
2. 记录：做了什么、做了哪些决策、还有哪些遗留项；
3. 为新建/修改的笔记添加 wikilinks，方便后续跳转；
4. 若处于 git 仓库中，顺手git commit + push。

于是典型的每次会话变成一条顺畅的流水线：

打开 Claude Code 会话 ├── /resume ← 加载库上下文（近期日志、决策、进度） ├── 查 graph.json ← 不重读全部文件就理解代码结构 ├── 干活 ← 功能、修 bug、重构 ├── /save ← 在 vault 中生成会话日志 └── git commit ← hook 自动重建图谱

一个进阶技巧（1.0.0 新增）：把/save和/resume注册为~/.claude/下的全局 skill，让它们在输入框里成为真正的斜杠命令，而不只是 CLAUDE.md 里的文字描述。

技巧三：用 Graphify 代码知识图谱，告别"重读整个代码库"🕸️

Graphify 把代码库转成可查询的知识图谱：AI 不再逐个文件重读，而是查图谱拿结构信息——结果可跨会话持久保存，且只花极少 token。官方历史示例中，一次源码检索约 20,000 tokens，改为图谱查询后约 280 tokens。

快速上手三步：

pip install graphifyy graphify install --platform claude # 安装到 ~/.claude/skills/graphify/

然后在 Claude Code 内执行（skill 形式支持 Obsidian 直出）：

/graphify . --obsidian --obsidian-dir ~/vault/graphify/project-name

关键点：

• 默认 AST 模式 0 token——纯本地 tree-sitter 解析，代码内容不出机器；
• 增量更新——SHA256 缓存，graphify update .只处理改动过的文件，图谱是持久的，不需要每个会话都重建；
• **配合"三层查询规则"**写进项目 CLAUDE.md：先查graphify-out/graph.json→ 再查 Obsidian 库 → 最后才读原始代码文件。完整示例见 README.md。

技巧四：自动保存 Hook——忘了 /save 也有兜底🛡️

/save虽然强大，但依赖你记得执行它。官方提供了一个零 LLM 调用的安全网脚本 scripts/session_autosave.py：Claude Code 关闭会话时触发SessionEnd事件，脚本纯机械地解析 JSONL 会话记录，把"目标、动过的文件、执行过的命令、统计信息"写成一条最简日志进 vault。

设计上的几个优点：

• 零 API 调用：毫秒级完成，不需要 API key；
• 静默失败：出错只写~/scripts/autosave.log，绝不打断你的会话；
• 噪音过滤：用户消息少于 2 条的会话直接跳过。

注册方式是在~/.claude/settings.json里为SessionEnd事件挂上脚本命令，并按会话的工作目录自动把日志路由到<vault>/<项目名>/logs/（无对应项目文件夹则落到全局logs/）。过滤自动日志可用 Obsidian 搜索：tag:auto-log只看自动日志，-tag:auto-log隐藏它们。

这样即使忘打/save，会话也不会"消失"：/save继续负责富含决策与链接的详细日志，自动日志保证每次会话都有迹可循。

常用文件路径速查表📚

💡 关于"71.5x token 节省"的说明：README 中对这一历史数据持审慎态度——它是作者报告值，公开材料不足以复现完整的会话级节省，具体论证见 benchmarks/README.md，建议把它理解为"方向性参考"而非承诺。

小结

这套 claude-code-memory-setup 的记忆方案可以浓缩为一句话：用 CLAUDE.md 定规则、用 /resume 续写、用 /save 存档、用 Graphify 省 token、用自动保存兜底。全部组件免费，落地成本主要是一份耐心——先搭好库结构和全局 CLAUDE.md，再从/save、/resume两个命令开始用，你会发现 Claude Code 像换了一个"有记性"的同事。