claude-find 用于跨 Claude Code 会话提取深度记忆，在你需要时随时检索。
用途
- 对过去所有 Claude Code 会话进行语义搜索，按含义和关键词查找上下文。
- 检索原始对话转录，而非压缩摘要，因此 Claude 能获得完整信息：推理过程、约束条件、失败的尝试以及做出的决策。
主要能力
- 索引 ~/.claude/projects/ 下所有 Claude Code 会话 JSONL 文件。
- 提取用户与助手消息、紧凑摘要、来自工具调用的文件路径。
- 为每个片段补充元数据上下文（项目、分支、文件、日期）以改善检索效果。
- 通过 Ollama 使用 qwen3-embedding 对对话片段进行嵌入（支持 GPU 加速）。
- 采用混合语义与关键词（FTS5）搜索，并通过 Reciprocal Rank Fusion 合并结果。
- 返回原始对话片段，便于 Claude 结合完整上下文进行综合分析。
使用方式
- 先安装 Bun 和 Ollama。
- 运行 bunx claude-find setup。该命令会检测你的平台并引导你补齐缺失的依赖。
- setup 会启动 Ollama、拉取嵌入模型、把会话保留期设为永久，并将 MCP 服务器注册到 Claude Code。
- 会话在启动时于后台建立索引。搜索可立即使用，并随着索引继续推进返回逐步更完整的结果。
- 在任意 Claude Code 会话中，Claude 会对你的过往会话进行语义搜索，找到相关对话并综合出上下文：尝试过什么、什么失败了、你设定了哪些约束、做出了哪些决策。
- 升级后运行 bunx claude-find index 以使用最新改进重建索引。
特点与优势
- 搜索原始转录：不会因压缩而丢失信息。
- 回溯式：立即适用于所有现有会话，无需钩子。
- 永久历史：setup 会禁用 Claude Code 的 30 天会话清理，使你的会话可被永久搜索。
- 非阻塞：启动时在后台建立索引，即使索引进行中搜索也能即时工作。
- 使用紧凑摘要：即 Claude 自身的会话理解，并在排序中提升其权重。
- 索引工具调用元数据：可按涉及的文件、遇到的错误进行搜索。
- 快速：Ollama 加 GPU 使索引保持快速且内存可控。
适用场景
- 需要回顾过往 Claude Code 会话中讨论过的方案、约束和决策时。
- 想查找涉及特定文件或错误的历次对话时。
限制与依赖
- 依赖 Ollama（模型在首次使用时自动下载）。
- 需要安装 Bun 和 Ollama。
- 相关资料未提供平台支持范围、收费或价格等信息。
