CodeGraph, Claude Code용 로컬 코드 지식그래프 오픈소스 공개
개발자 콜비 맥헨리(colbymchenry)가 Claude Code의 코드베이스 탐색을 가속하기 위한 오픈소스 도구 'CodeGraph'를 공개했다. 깃허브 트렌딩에 진입한 이 프로젝트는 누적 스타 2,060개를 기록 중이며, 하루 397개의 신규 스타를 받았다. 'npx @colbymchenry/codegraph' 한 줄 명령으로 설치되는 대화형 인스톨러가 Claude Code 설정을 자동으로 구성한다.
Claude Code는 코드베이스를 탐색할 때 Explore 에이전트를 띄워 grep, glob, Read로 파일을 훑으며 매 호출마다 토큰을 소비한다. CodeGraph는 이 에이전트에 심볼 관계, 콜 그래프, 코드 구조를 담은 사전 인덱싱된 지식그래프를 제공해, 파일을 일일이 스캔하지 않고 그래프에 즉시 쿼리하도록 만든다.
프로젝트가 공개한 벤치마크는 Claude Opus 4.6(1M 컨텍스트)과 Claude Code v2.1.91 환경에서, 6개 실제 코드베이스마다 동일한 질문으로 단일 Explore 에이전트를 띄워 CodeGraph 사용 여부를 비교했다. 평균은 도구 호출 92% 감소, 응답 시간 71% 단축이었으며, 헤드라인 수치는 도구 호출 94% 감소·탐색 속도 77% 향상·100% 로컬로 정리됐다.
코드베이스별로는 VS Code(TypeScript)에서 CodeGraph 사용 시 3회 호출·17초로 미사용(52회·1분 37초) 대비 94% 적은 호출과 82% 빠른 속도를 보였고, Excalidraw(TypeScript)는 3회·29초로 94% 적고 72% 빨랐다. Claude Code(Python+Rust)는 3회·39초로 93% 감소·43% 단축, Java 코드베이스에서는 단 1회 호출·19초로 96% 감소·77% 단축을 기록했다. Alamofire(Swift)는 3회·22초로 91% 감소·78% 단축, Swift 컴파일러(Swift/C++)는 6회·35초로 84% 감소·73% 단축이었다.
주요 관찰은 CodeGraph를 쓴 에이전트가 끝까지 파일을 다시 읽지 않고 codegraph_explore의 결과를 신뢰했다는 점, 미사용 에이전트는 대부분의 시간을 find·ls·grep으로 디스커버리에 소비한 뒤에야 본격적인 코드 읽기에 들어갔다는 점이다. Swift 컴파일러 벤치마크는 2만 5,874개 파일과 27만 2,898개 노드로 가장 큰 규모였지만 CodeGraph가 4분 이내에 인덱싱을 끝냈고, 에이전트는 35초 만에 파일 읽기 0회로 복잡한 교차 질문에 답했다.
기능은 한 번의 도구 호출로 진입점·관련 심볼·코드 스니펫을 함께 반환하는 '스마트 컨텍스트 빌딩', SQLite FTS5 기반 풀텍스트 검색, 호출자·피호출자·영향 반경을 추적하는 임팩트 분석, FSEvents·inotify·ReadDirectoryChangesW 등 OS 네이티브 이벤트로 디바운스 자동 동기화하는 파일 워처를 포함한다. 지원 언어는 TypeScript, JavaScript, Python, Go, Rust, Java, C#, PHP, Ruby, C, C++, Swift, Kotlin, Dart, Svelte, Liquid, Pascal/Delphi 등 19개 이상이다.
프레임워크 인식 라우팅도 특징이다. CodeGraph는 13개 웹 프레임워크의 라우팅 파일을 감지해 라우트 노드를 만들고, 참조 에지로 핸들러 클래스·함수에 연결한다. 대상은 Django, Flask, FastAPI, Express, Laravel, Rails, Spring, Gin/chi/gorilla/mux, Axum/actix/Rocket, ASP.NET, Vapor, React Router/SvelteKit이다. 뷰·컨트롤러의 호출자를 조회하면 결합된 URL 패턴이 함께 떠오른다.
데이터 처리는 전량 로컬에서 SQLite 데이터베이스에만 저장되며 외부 API 키나 서비스 호출이 없다. 인스톨러는 codegraph CLI를 글로벌 설치하고 '~/.claude.json'에 MCP 서버를 등록하며, '~/.claude/settings.json'의 자동 허용 권한과 '~/.claude/CLAUDE.md' 글로벌 지침까지 함께 설정한다. 프로젝트 디렉터리에 '.codegraph/' 폴더가 생성되면 Claude Code가 CodeGraph 도구를 자동으로 활용한다.