AI 코딩 에이전트가 코드 구조를 파악하는 데 드는 토큰과 시간을 크게 줄여주는 로컬 인덱싱 도구
에이전트가 파일을 하나씩 뒤지며 호출 관계를 추측하는 대신, 미리 그려둔 그래프에서 필요한 코드만 바로 가져오게 됩니다. CodeGraph는 프로젝트의 심볼과 의존성을 분석해 로컬에 저장하고, 에이전트가 질문할 때 정답에 필요한 소스와 경로를 한 번에 전달합니다. 덕분에 토큰 소모와 도구 호출 횟수가 줄어듭니다.
탐색 대신 직접 답을 얻는 방식
기존 방식에서는 AI 에이전트가 grep이나 파일 읽기 도구로 코드베이스를 천천히 탐색해야 했습니다. CodeGraph는 이 과정을 생략하고, 에이전트가 한 번의 도구 호출로 관련 소스, 호출 경로, 변경 영향 범위를 얻게 합니다. 2026년 8월 재측정 결과, 7개 벤치마크 저장소에서 평균 44% 비용 절감과 62% 토큰 절감을 확인했습니다. 특히 파일 탐색에 28~43회의 도구 호출이 필요했던 복잡한 질문에서 절감 효과가 가장 컸습니다.
머신 사양에 맞춰 돌아가는 Rust 엔진
CodeGraph는 20개 이상의 언어를 지원하는 네이티브 Rust 커널로 구동됩니다. 이 엔진은 시스템의 실제 코어 수와 가용 메모리를 감지해 워커 풀과 캐시 크기를 자동으로 조정합니다. 워크스테이션에서는 전체 병렬 파이프라인을, 2코어 VPS에서는 완료를 보장하는 튜닝된 파이프라인을 사용합니다. 파일 저장 시 300ms 후 변경된 부분만 동기화되어, 4,400개 파일 프로젝트에서 약 0.3초 만에 인덱스가 갱신됩니다. 모든 데이터는 SQLite 데이터베이스에 로컬로 저장되며 외부 서비스로 전송되지 않습니다.
프레임워크 라우팅과 크로스 플랫폼 흐름 추적
웹 프레임워크의 라우팅 파일을 인식해 URL 패턴과 핸들러를 연결합니다. Django, Flask, FastAPI, Express, NestJS 등 17개 프레임워크의 라우트 구조를 파악합니다. iOS와 React Native, Expo 프로젝트에서는 Swift와 Objective-C 브리징, TurboModules, Fabric 뷰 컴포넌트 등 정적 분석이 놓치는 크로스 언어 흐름을 추적합니다. Tauri 데스크톱 앱의 웹 프론트엔드와 Rust 코어 간 invoke 호출도 그래프에 포함됩니다. 이러한 기능은 에이전트가 앱의 전체 흐름을 이해하는 데 도움을 줍니다.
도입 전 알아야 할 점
CodeGraph는 에이전트가 직접 쿼리할 때만 효과를 발휘하므로, 파일 읽기 서브에이전트로 탐색을 위임하는 설정에서는 오히려 오버헤드가 될 수 있습니다. 또한 응답이 컨텍스트 윈도우에 오래 머무르며, 세션 종료 시 파일 읽기 에이전트보다 약 80% 더 많은 잔여 컨텍스트를 차지합니다. 작은 윈도우에서 긴 세션을 실행할 경우 이를 고려해야 합니다. 설치 시 Node.js가 필요 없으며, codegraph install 명령으로 에이전트 연동과 codegraph init으로 프로젝트 인덱싱을 수행합니다. 현재 베타 단계의 호스티드 플랫폼도 준비 중입니다.
