Claude Code 대화 기록 전체를 검색하는 오픈소스 도구 Flex 공개

실용적 조언

curl 명령어를 통해 로컬에 Flex를 설치하고 Claude Code와 연동하여 즉시 과거 세션 검색을 시작할 수 있다.
검색 시 'suppress' 키워드를 활용하여 불필요한 문서나 기획안 클러스터를 제거하고 실제 코드 구현 세션을 빠르게 찾아낼 수 있다.

섹션별 상세

기존 벡터 검색 시스템이 검색어와 관련된 문서(About X)는 잘 찾지만 정작 필요한 실제 내용(Is X)을 놓치는 문제를 해결하고자 했다. 작성자는 Docker 환경 설정 세션을 찾을 때 기획 문서나 README가 우선순위에 밀려 정작 중요한 디버깅 로그를 찾지 못했던 경험을 바탕으로, 검색 결과에서 특정 클러스터를 제외하는 'suppress' 기능을 구현했다.

sql

SELECT v.id, v.score, c.content FROM vec_ops('similar:how we set up the docker environment suppress:planning notes documentation suppress:readme deployment instructions') v JOIN chunks c ON v.id = c.id ORDER BY v.score DESC LIMIT 10

특정 키워드를 억제(suppress)하면서 유사한 맥락의 세션을 검색하는 SQL 쿼리 예시

Flex는 검색 시 전체 청크의 원시 점수(raw scores)를 유지하며 에이전트가 쿼리별로 점수 표면을 재구성할 수 있도록 설계됐다. 일반적인 시스템이 근사 클러스터링을 통해 속도를 높이는 대신 세밀한 점수를 잃는 것과 달리, Flex는 약 30만 개의 청크(약 5,000개 세션)를 대상으로 네트워크 오버헤드 없이 로컬에서 약 20ms 내에 검색을 수행한다.

사용자의 모든 Claude Code 세션 데이터를 SQLite 데이터베이스로 컴파일하고 이를 단일 MCP 도구로 노출하여 Claude가 직접 쿼리하게 만든다. 프롬프트, 응답, 도구 호출, 파일 수정 내역은 물론 서브 에이전트에게 위임한 내용까지 모두 인덱싱되며, 파일 이름이 변경되거나 이동되어도 식별자가 유지되어 추적이 가능하다.

모든 처리는 사용자의 로컬 환경(GPU 또는 CPU)에서 이루어지며 외부 서버로 데이터가 전송되지 않는 프라이버시 우선 구조를 채택했다. 설치 시 기존 세션들을 소급하여 인덱싱하는 데 시스템 사양에 따라 10분에서 35분 정도 소요되며, 이후 발생하는 새로운 세션들은 실시간으로 업데이트되어 즉시 검색 가능한 상태가 된다.

용어 해설

모델 컨텍스트 프로토콜(MCP): — AI 모델이 로컬 도구, 데이터 소스 및 서비스와 표준화된 방식으로 상호작용할 수 있도록 Anthropic에서 공개한 개방형 프로토콜이다. 이를 통해 Claude와 같은 모델이 외부 데이터베이스나 파일 시스템에 직접 접근하여 정보를 검색하거나 작업을 수행할 수 있다.
벡터 검색(Vector Retrieval): — 텍스트를 고차원 벡터로 변환하여 의미적 유사성을 기반으로 정보를 찾는 기술이다. 키워드가 정확히 일치하지 않아도 맥락상 유사한 정보를 찾을 수 있게 해주며, RAG 시스템의 핵심 구성 요소로 활용된다.
임베딩 공간(Embedding Space): — 단어나 문장 같은 데이터를 수치화된 벡터로 표현했을 때, 이 벡터들이 위치하는 다차원 수학적 공간이다. 의미가 유사한 데이터일수록 공간상에서 가까운 거리에 위치하게 되어 모델이 개념 간의 관계를 파악하는 기초가 된다.

언급된 도구

Flex추천링크

Claude Code 세션 기록 검색 및 관리 도구

Claude Code중립

Anthropic의 CLI 기반 코딩 에이전트

언급된 리소스

DemoFlex 공식 웹사이트

논문Flex 기술 논문 (arXiv)