claude-find

claude-find

必要なときに、Claude Code のセッション全体から詳細な記憶を呼び出します。

過去のすべての Claude Code セッションを対象にしたセマンティック検索です。意味とキーワードから関連するコンテキストを見つけます。圧縮された要約ではなく、生の会話トランスクリプトを検索するため、Claude は推論、制約、失敗した方法、決定事項を含む全体像を把握できます。

セットアップ

brew install bun ollama
bunx claude-find setup

setup は Ollama を起動し、埋め込みモデルをダウンロードして、セッションの保持期間を無期限に設定し、MCP サーバーを Claude Code に登録します。起動時にセッションはバックグラウンドでインデックス化されます。検索はすぐに利用でき、インデックス化が進むにつれて、より完全な結果が順次返されます。

Linux / Windows

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. 検索：セマンティック検索とキーワード検索（FTS5）を組み合わせ、Reciprocal Rank Fusion で統合します
6. 返却：生の会話チャンクを返し、Claude が完全なコンテキストをもとに統合できるようにします

アップグレード後は、bunx claude-find index を実行して、最新の改善内容でインデックスを再構築してください。

このツールの特長

• 生のトランスクリプトを検索します。圧縮によって失われる情報はありません。
• 既存のセッションにも対応します。フックの設定は不要で、すべての既存セッションをすぐに利用できます。
• 履歴を無期限に保持します。セットアップによって Claude Code の30日間のセッション削除が無効になり、セッションをいつまでも検索できます。
• 処理を妨げません。起動時にバックグラウンドでインデックス化します。インデックス化の途中でも、検索はすぐに利用できます。
• 簡潔な要約を活用します。Claude 自身によるセッションの理解を、ランキングで優先します。
• ツール呼び出しのメタデータをインデックス化します。変更したファイルや発生したエラーから検索できます。
• 高速です。Ollama と GPU により、インデックス化を高速に保ち、メモリ使用量を抑えます。

必要条件

• Bun ランタイム
• Ollama（初回使用時にモデルが自動ダウンロードされます）
• Claude Code

ライセンス

MIT