Claude Code의 토큰 낭비를 줄이는 코드베이스 구조 분석 도구 'nervx'

Claude Code의 비효율적인 탐색 방식에 공감하는 사용자들이 많으며, MCP 설정 없이도 즉시 적용 가능한 경량화된 접근 방식에 대해 긍정적인 반응을 보이고 있다.

• Claude Code 사용 시 토큰 소모가 심하다면 nervx를 설치하고 'nervx build .'를 실행하여 구조 지도를 생성해라.
• CLAUDE.md 파일에 생성된 지침을 포함시켜 Claude가 Grep 대신 구조 지도를 먼저 참조하도록 설정해라.

Tree-sitter

— 프로그래밍 언어의 소스 코드를 구문 트리로 파싱하는 증분 파싱 라이브러리이다. 코드의 구조적 관계를 빠르고 정확하게 분석하여 함수, 클래스, 변수 간의 의존성을 파악하는 데 필수적인 역할을 한다.

Context Window

— LLM이 한 번의 추론 과정에서 동시에 처리하고 기억할 수 있는 텍스트의 최대 범위이다. 코드베이스 탐색 시 불필요한 파일을 많이 읽으면 이 공간이 낭비되어 실제 문제 해결에 필요한 정보가 누락될 수 있다.

Static Analysis

— 프로그램을 실제로 실행하지 않고 소스 코드 자체를 분석하여 구조와 잠재적 오류를 파악하는 기법이다. LLM 호출 없이 로컬 연산만으로 코드의 호출 그래프나 의존 관계를 생성할 수 있어 비용 효율적이다.

Call Graph

— 프로그램 내의 함수나 서브루틴 간의 호출 관계를 나타낸 유향 그래프이다. 어떤 함수가 어디에서 호출되는지 시각화하여 코드 변경 시의 영향 범위(Blast Radius)를 파악하는 데 사용된다.