Recall

Recall 快速入门

让 Claude Code 记住上次做到哪了——完全离线、零 token 成本、即装即用

这是什么？适合谁？

Recall 是 Raiyan Yahya 开发的 Claude Code 插件，解决 Claude Code 的”冷启动”问题：每次新会话开始，Claude Code 不记得你上次做了什么，你需要重新解释项目背景。Recall 在本地记录你的会话日志，并用纯 Python 实现的 TextRank 摘要算法自动生成项目上下文摘要，下次启动时 Claude Code 可以直接从摘要中了解项目进展。

核心机制：Recall 通过 Claude Code 的 Hook 系统（SessionStart/Stop/End）在后台记录每次会话的对话内容、修改的文件和执行的命令，保存到 .recall/history.md。当你运行 /recall:save 时，内置的 TF-IDF + TextRank 摘要器会从历史日志中提取最关键的句子，生成 .recall/context.md。新会话启动时，Claude Code 加载这个仅 1-2K token 的摘要，就能快速恢复上下文——不需要重放完整对话，不需要消耗 API token 做摘要，完全在你的机器上运行。

与 Claude Code 内置记忆功能的区别：

• CLAUDE.md / # 快捷键是你手写的规范和偏好，Recall 是自动记录的”上次做到哪了”
• --continue / --resume 重放整个对话，token 消耗大；Recall 只提供约 1-2K token 的精简摘要
• Context compaction 是会话内的压缩，不持久化；Recall 提供跨会话的持久记忆

Recall 适合两类人：一是经常用 Claude Code 做多会话项目的开发者，用它避免每次都重新解释项目；二是对隐私要求极高的团队——Recall 完全不联网，对话数据不会离开你的机器。

不适合的场景：如果你只用 Claude Code 做简单的一次性任务，或需要多模型支持的跨平台记忆（Mem0 更合适），Recall 的 Claude Code 专属定位可能不够用。

准备工作

• 前置依赖：已安装 Claude Code（桌面版或 CLI 版），Recall 作为插件运行在 Claude Code 之上
• Python 环境：需要 Python 3.8+。Recall 的摘要器使用纯 Python 标准库（numpy 是可选的加速器，不是必需）
• 付费要求：零费用。Recall 完全免费，MIT 开源协议。不调用任何外部 API，不消耗额外 token
• 网络要求：完全离线可用。Recall 不发起任何网络请求
• 存储空间：每个项目的 .recall/ 目录通常几 KB 到几十 KB，取决于会话历史长度

3 步快速上手

第 1 步：安装插件

在 Claude Code 中运行：

/plugin marketplace add raiyanyahya/recall
/plugin install recall@recall

不需要 pip install——摘要器代码已内置在插件中。安装完成后，Recall 的 Hook 会在后台自动运行。

第 2 步：正常工作一个会话

像往常一样使用 Claude Code 写代码、调试、讨论项目。Recall 在后台自动将你的对话、修改的文件、执行的命令追加到 .recall/history.md。你可以运行 /recall:log 查看当前的会话日志。

如果你不想记录某个会话，可以创建 .recall/.capture-paused 文件来暂停日志记录，删除该文件即可恢复。

第 3 步：保存摘要，下个会话恢复

会话结束前，运行 /recall:save，Recall 的本地摘要器会分析 history.md 并生成 .recall/context.md。你也可以在 recall.config.json 中设置 "auto_save_context": "on_end"，让 Recall 在每次会话结束时自动生成摘要。

下次启动 Claude Code 进入同一项目时，Recall 会自动加载 context.md，Claude Code 会询问你是否要从上次的上下文恢复。你不需要重新解释项目——Claude 已经知道上次的目标、进度和下一步计划。

常见踩坑

踩坑 1：在 Windows 上 python3 找不到

• 症状：运行 /recall:save 时报错 “python3 not found”
• 原因：Windows 上 Python 命令通常是 python 而非 python3
• 解决：Recall v0.3.6 已修复此问题（自动检测 python vs python3）。如果你用的是更早版本，升级到最新版即可；或者在 PowerShell 中创建 python3 别名

踩坑 2：摘要内容看起来”断断续续”

• 症状：生成的 context.md 中句子不连贯，像从不同地方抽出来的
• 原因：TextRank 是抽取式摘要——它从原文中挑选重要句子，而不是重写。如果会话本身跳跃性很大，摘要也会反映出这种跳跃
• 解决：这不是 bug，是抽取式摘要的特性。如果你需要更连贯的摘要，可以手动编辑 context.md，或者在会话中使用更结构化的对话（明确说出目标、进展、下一步）

踩坑 3：context.md 在 Git 中被忽略

• 症状：想把 .recall/ 提交到团队仓库做共享记忆，但 .gitignore 默认忽略了它
• 原因：Recall 的默认 .gitignore 配置将 .recall/ 排除在外，因为对话历史可能包含敏感信息
• 解决：编辑 .gitignore，注释掉 .recall/ 那一行。但提交前务必检查 history.md 中是否包含 API key 或密码（Recall 的 redact 功能会尽力过滤，但不是 100% 可靠）

踩坑 4：ANTHROPIC_API_KEY 导致 Claude Code 报错

• 症状：安装 Recall 后 Claude Code 显示 “Invalid API key”
• 原因：这与 Recall 无关——是你环境中的 ANTHROPIC_API_KEY 环境变量过期了，覆盖了 Claude Code 的订阅登录
• 解决：unset ANTHROPIC_API_KEY（或 env -u ANTHROPIC_API_KEY claude ...）清除这个环境变量

初级用法

1. 三个核心命令：/recall:save（生成摘要）、/recall:show（查看摘要）、/recall:log（查看会话日志）。这是你日常用得最多的三个操作。

2. 配置文件定制：在项目根目录创建 recall.config.json，可以调整摘要长度（summary_sentences，默认 8 句）、自动保存（auto_save_context）、敏感信息过滤（redact，默认开启）、以及是否包含 git diff --stat（include_git）。完整配置项见 README。

3. 暂停日志记录：有时候你可能在做探索性的临时操作，不想污染项目记忆。在 .recall/ 目录下创建空文件 .capture-paused 即可暂停记录，删除该文件恢复记录。

高级玩法

1. 共享团队记忆：将 .recall/ 提交到 Git 仓库，团队成员都能从彼此的最后进展中恢复上下文。注意：Recall 在 SessionStart 时将 context.md 标记为”不受信任的参考数据”并让 Claude 询问后再使用——这是为了防止恶意提交者通过修改 context.md 进行 prompt injection。如果团队中不是所有人都完全可信，保持 .recall/ 被 git-ignore。

2. 结合 CLAUDE.md 使用：CLAUDE.md 写”项目规范”（如代码风格、测试要求），Recall 记录”项目进展”（上次改了什么、卡在哪里）。两者互补——Claude Code 启动时会同时加载 CLAUDE.md 和 Recall 的 context.md，前者作为指令，后者作为参考。

3. 本地开发调试：如果你想修改 Recall 的功能或调试 Hook 行为，可以绕过市场直接加载本地插件：

claude --plugin-dir /path/to/recall

插件包含完整的测试套件和基准测试：

pip install pytest ruff bandit   # bandit 可选
ruff check scripts tests benchmarks
pytest
python benchmarks/bench.py       # 性能和质量指标

参考链接

• GitHub 仓库：raiyanyahya/recall ★678, 🔱41
• 隐私政策：PRIVACY.md
• 安全策略：SECURITY.md
• 变更日志：CHANGELOG.md
• 贡献指南：CONTRIBUTING.md