为什么需要
用 Claude Code 做独立开发的人都有这个痛点:每次开新 Session 都要重新交代项目背景——目录结构、上次改到哪、下一步打算干嘛。手动维护 CLAUDE.md 麻烦,--resume 重放全量 transcript 又贵又笨。Recall 是 Claude Code 的本地记忆插件,自动把每次会话追加到项目里的 .recall/history.md,再用一个完全本地的 TF-IDF + TextRank 算法(不调 LLM)压缩成 ~1-2K token 的 context.md。下次开 Session 自动注入,Claude 直接接上你上次的位置。
怎么用
作为 Claude Code 插件安装:
# 在项目根目录
git clone https://github.com/raiyanyahya/recall.git .recall-plugin
# 然后在 Claude Code 中加载插件
启动后 Claude Code 会在每次 Session 结束(Stop/SessionEnd 钩子)自动追加会话记录到 .recall/history.md。下次开 Session 时 SessionStart 钩子会问你"要不要从保存的 context 续上"。
需要保存时跑一次 /recall:save,summarizer 重写 context.md。也可以设 auto_save_context: "on_end" 让每次 Session 结束自动更新 context。
不需要任何 API key、不需要本地模型,完全离线。
使用案例
你用 Claude Code 做一个 SaaS 项目,已经持续 3 个月。每次开新 Session 都要花 5-10 分钟跟 Claude 重新介绍项目背景:用的什么框架、当前在写哪个 feature、上次卡在哪。装上 Recall 之后,新 Session 自动加载 context.md,Claude 直接进入状态,省掉这 5-10 分钟。三周下来省下来的 token 费够再续一个月 Claude 订阅。
另一个场景:团队里 2 个开发者都用 Claude Code。开发者 A 离职前把 .recall/ 文件夹 commit 进 repo,开发者 B 接过来跑 /recall:save 续写,A 的项目上下文无缝继承给 B。
注意事项
- 严格限于 Claude Code,不像 Supermemory 那种通用记忆层
- 总结用 TF-IDF + TextRank 是抽取式(不是 LLM 生成式),偶尔会漏掉关键点
- 数据存在项目里的
.recall/目录,记得加.gitignore或按需 commit - MIT 协议,0 成本,0 token 消耗