nervx: 코드베이스 구조를 분석하여 Claude Code 토큰 사용량을 줄이는 CLI 도구

nervx의 기능

nervx는 Claude Code의 비효율적인 코드베이스 탐색 문제를 해결하는 CLI 도구(pip 설치 가능)입니다. 개발자는 Claude가 단순한 쿼리에 대해 과도한 grep 검색(60회 이상)을 수행하고 파일을 다시 읽어 실제 작업을 시작하기 전에 컨텍스트 창의 절반을 소비하는 것을 관찰한 후 이 도구를 구축했습니다.

작동 방식

이 도구는 tree-sitter를 사용하여 전체 저장소를 파싱하고, 모든 함수, 클래스, 호출 체인, 임포트의 SQLite 그래프를 구축한 다음, 프로젝트의 구조 지도를 포함하는 NERVX.md 파일을 생성합니다. 이 지도에는 진입점, 실행 흐름, 핫 파일, 취약한 코드가 포함됩니다.

핵심 기능: nervx build .를 실행하면 Claude가 nervx를 사용하는 방법을 가르치는 지시사항이 CLAUDE.md 파일에 자동으로 추가됩니다. 그런 다음 Claude는 grep 검색 전에 자체적으로 nervx nav를 실행하고, 리팩터링 전에 영향 범위를 확인하며, 일반적으로 수동 프롬프트 없이 더 효율적으로 탐색합니다.

기술적 세부사항

• MCP 서버 구성 불필요
• API 키 불필요
• 빌드 과정 중 LLM 호출 없음
• 순수 tree-sitter + git 구현
• 5초 이내 빌드
• 분석에 대한 LLM 비용 제로

성능 결과

동일한 3가지 질문으로 FastAPI 저장소에서 테스트:

• 도구 호출: 93 → 56 (-40%)
• 출력 토큰: 15,694 → 8,196 (-48%)
• Grep 검색: 63 → 22 (-65%)

추가 기능

• 데드 코드 감지
• 호출자가 오류 처리에 대해 불일치하는 함수 플래그 지정
• 그래프 형태에서 팩토리 및 이벤트 버스와 같은 패턴 감지
• 생성된 그래프에 대한 시각화 포함
• Python, JS/TS, Java, Go, Rust, C/C++, C#, Ruby 지원

차별점

개발자는 토큰 낭비 문제를 해결하기 위해 더 많은 토큰 사용을 추가하는 것을 피하기 위해, 그래프 생성에 LLM을 사용하거나 MCP 설정이 필요한 접근 방식을 특별히 피하고 순수 정적 분석에 집중했습니다.