Code-Graph-RAG – 모노레포를 지식 그래프로 이해하는 코드 RAG

Code-Graph-RAG는 대형 코드베이스를 단순 청크 검색이 아니라 코드 구조 그래프와 벡터 검색을 결합해 이해하려는 오픈소스 도구다. 함수, 클래스, 파일, 호출 관계를 그래프로 만들고, 자연어 질의와 코드 탐색을 함께 지원한다.

구조

README 기준 핵심 구성은 Tree-sitter 기반 파서, Memgraph, Qdrant다. Tree-sitter가 여러 언어의 구문 구조를 읽고, Memgraph가 관계를 저장하며, Qdrant가 의미 검색을 맡는다.

uvx code-graph-rag stack up
uvx code-graph-rag parse /path/to/repo
uvx code-graph-rag query "Where is authentication handled?"

방식	장점	한계
단순 Vector RAG	빠르게 시작하고 문서 검색에 강하다	호출 관계, 심볼 이동, 영향 범위를 놓치기 쉽다
Code-Graph-RAG	코드 구조와 의미 검색을 함께 본다	인덱싱 비용과 그래프 저장소 운영이 필요하다

모노레포에서 “이 함수가 어디서 호출되는가”, “이 API 변경의 영향 범위는 어디인가” 같은 질문은 그래프가 더 자연스럽다. 반대로 작은 저장소나 문서 중심 질의라면 단순 벡터 검색이 더 가볍다.