claude-find

필요할 때 언제든지 Claude Code 세션 전체에서 Deep Memory를 불러오세요.

과거의 모든 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