Claude Code용 지식 그래프 도구 'graphify' 개발 (코드베이스 토큰 71배 절감)
핵심 요약
코드베이스를 지식 그래프로 변환해 토큰 사용량을 71배 줄이고 환각 현상을 방지하는 Claude Code용 도구 'graphify'를 소개함.
- 토큰 효율성 — 코드베이스를 지식 그래프로 변환하여 쿼리당 토큰 사용량을 71.5배 절감함.
- 환각 방지 — 원본 파일 대신 구조화된 그래프 데이터를 읽게 하여 Claude의 답변 정확도를 높임.
- 다양한 언어 지원 — tree-sitter를 활용해 Python, TS, Go, Rust 등 25개 언어의 AST를 파싱함.
- 사용 편의성 — uvx를 통해 설치하고 명령 한 번으로 프로젝트의 지식 그래프를 생성할 수 있음.
새로운 코드베이스에 합류할 때마다 첫 주는 Claude에게 'X가 어떻게 작동하는지 설명해줘'라고 묻고, 환각을 일으키는 걸 지켜보다가, 40개의 파일을 읽으며 수정하는 데 시간을 보냈어. 문제는 LLM이 아니야. 원본 파일이 끔찍한 컨텍스트 형식이라는 게 문제지.
그래서 graphify를 만들었어. Claude Code에 한 번 설치하면 저장소의 쿼리 가능한 지식 그래프를 구축해줘. 출시 이후 GitHub 스타 32k개, PyPI 다운로드 250k건을 넘겼어.
기능:
• tree-sitter AST를 통해 25개 언어 파싱 (Python, TS, Go, Rust, Java, C/C++, Swift, Dart, Zig…)
• 문서, PDF, 이미지, 비디오(Whisper)에 대한 의미론적 추출
• 커뮤니티, 핵심 노드, 파일 간 연결 탐지
• GRAPH_REPORT.md 작성 — Claude가 원본 파일 대신 읽는 파일
• 쿼리당 토큰 71.5배 절감
uvx graphifyy install을 실행하고, 어떤 프로젝트에서든 /graphify . 명령어를 입력해봐.
