MINDUNG 채널의 쇼츠 **「이 코드가 어디에 쓰이는지 지도로 보여 주는 스킬 알려줌」**에서는 대규모 프로젝트의 코드 구조를 그래프로 시각화해 Claude Code가 더 빠르게 이해하도록 돕는 **Graphify**를 소개합니다. ## 코드 전체를 한 장의 지도처럼 보여준다 Graphify는 프로젝트 안의 함수, 클래스, 모듈 같은 코드 조각을 **점(node)** 으로 표현하고, 서로 호출하거나 참조하는 관계를 **선(edge)** 으로 연결해 보여주는 방식입니다. 그래프를 보면 다음과 같은 내용을 한눈에 파악할 수 있습니다. - 어떤 함수와 클래스가 서로 연결되어 있는지 - 특정 코드가 프로젝트 어디에서 사용되는지 - 어떤 기능들이 서로 강하게 묶여 있는지 - 프로젝트의 핵심 모듈과 중심 코드가 어디인지 ## 점 하나를 누르면 관련 코드가 이어서 보인다 특정 노드를 선택하면 해당 코드와 연결된 함수, 클래스, 모듈이 연속해서 표시됩니다. 같은 색으로 표시된 노드들은 서로 연관성이 높은 기능 묶음으로 볼 수 있어, 복잡한 프로젝트에서 **기능 단위 구조를 빠르게 이해하는 데 도움**이 됩니다. ## Claude Code가 파일을 하나씩 뒤지는 대신 구조부터 본다 AI 코딩 도구는 일반적으로 질문을 받으면 관련 파일을 하나씩 찾아 읽습니다. Graphify를 함께 사용하면 Claude Code가 먼저 전체 코드 맵을 참고한 뒤 필요한 파일과 연결 관계를 따라갈 수 있어, 질문에 대한 탐색 범위를 더 빠르게 좁힐 수 있습니다. 예를 들어 다음과 같은 질문에 유용합니다. - 이 함수는 프로젝트 어디에서 호출되는가? - 로그인 기능과 권한 처리 코드는 어떻게 연결되는가? - 이 모듈을 수정하면 어떤 기능에 영향이 가는가? - 특정 버그가 어느 경로에서 발생할 가능성이 높은가? ## 대규모 프로젝트에서 특히 유용 영상에서는 100만 줄 규모의 프로젝트를 대상으로 한 테스트에서, Graphify를 함께 사용했을 때 AI가 핵심을 짚는 비율이 개선됐다고 소개합니다. 이 수치는 영상에서 소개한 제작 측 테스트 기준이므로, 실제 효과는 코드베이스 구조와 질문 유형에 따라 달라질 수 있습니다. ## 로컬에서 코드 구조를 읽어 지도 생성 영상에서는 프로젝트 코드를 로컬에서 읽어 그래프를 만든다고 설명합니다. 즉, 단순히 LLM에 전체 코드를 길게 입력하는 방식보다 **구조 정보를 먼저 만들어 AI가 참고하도록 하는 접근**입니다. 이 방식은 대형 저장소에서 불필요한 토큰 사용을 줄이고, AI가 코드 관계를 이해하는 데 도움을 줄 수 있습니다. ## 활용 포인트 Graphify는 특히 다음 상황에서 유용합니다. - 오래된 레거시 프로젝트 처음 분석할 때 - 대규모 오픈소스 구조를 파악할 때 - 함수·클래스 의존 관계를 추적할 때 - 리팩터링 전 영향 범위를 확인할 때 - Claude Code가 프로젝트 맥락을 더 빠르게 이해하게 할 때 핵심은 단순한 코드 검색이 아니라, **코드 전체의 관계를 그래프로 만들어 AI가 구조부터 이해하도록 하는 것**입니다.