claude-find

在需要时，从你所有的 Claude Code 会话中提取深度记忆。

对你过去所有的 Claude Code 会话进行语义搜索。通过含义和关键词查找上下文。搜索原始对话记录，而不是压缩后的摘要，因此 Claude 可以获得完整的图景：推理过程、约束条件、失败的方法和决策。

设置

brew install bun ollama
bunx claude-find setup

setup 会启动 Ollama，拉取嵌入模型，将会话保留设置为永久，并向 Claude Code 注册 MCP 服务器。会话在启动时会在后台进行索引。搜索功能可立即使用，并随着索引的持续进行，返回的结果会越来越完整。

安装 Bun 和 Ollama，然后运行 bunx claude-find setup。它会自动检测你的平台并引导你完成缺失的配置。

使用方法

在任何 Claude Code 会话中：

/find that database migration we discussed last week
/find why we chose websockets over polling
/find the session where we kept getting timeout errors
/find refactoring the payment module across all projects

Claude 会对你过去的会话进行语义搜索，找到相关的对话，并综合上下文：尝试过什么、什么失败了、你设置了哪些约束条件以及做出了哪些决策。

工作原理

1. 索引：从 ~/.claude/projects/ 中索引所有 Claude Code 会话的 JSONL 文件

2. 提取：提取用户和助手的消息、紧凑摘要以及工具调用中的文件路径

3. 丰富：使用元数据上下文（项目、分支、文件、日期）丰富每个数据块，以实现更好的检索

4. 嵌入：通过 Ollama 使用 qwen3-embedding 对对话块进行嵌入（GPU 加速）

5. 搜索：通过倒数排名融合（Reciprocal Rank Fusion）合并混合语义 + 关键词（FTS5）搜索

6. 返回：返回原始对话块，以便 Claude 可以利用完整上下文进行综合

升级后，运行 bunx claude-find index 以使用最新的改进重建索引。

差异之处

• 搜索原始记录：不会因压缩而丢失任何信息。

• 追溯性：立即适用于所有现有会话。无需挂钩。

• 永久历史记录：设置会禁用 Claude Code 的 30 天会话清理功能，因此你的会话可以永久搜索。

• 非阻塞：在启动时于后台进行索引。搜索功能即时可用，即使在索引过程中也是如此。

• 使用紧凑摘要：Claude 自身的会话理解，在排名中得到提升。

• 索引工具调用元数据：按触及的文件、遇到的错误进行搜索。

• 快速：Ollama + GPU 保持索引快速且内存受限。

要求

• Bun 运行时

• Ollama（首次使用时自动下载模型）

• Claude Code

许可证

MIT