6만 스타 깃허브 오픈소스! AI 코드를 한눈에 파악하는 지도 플러그인 🚨

코드를 한눈에 볼 수 있게 도와주는 마법 도구, Understand-Anything!

코드를 보는데 뭐가 뭔지 하나도 모르겠을 때 있지? 남이 짜놓은 코드나 AI가 만들어준 코드인데, 딱 한 줄 고쳤는데 엉뚱한 화면이 튀어나오는 경험, 개발 좀 해봤다면 한 번쯤 있을 거야. 오늘은 이런 막막한 코드를 클릭하면서 둘러볼 수 있는 '지도'로 바꿔주는 오픈소스 도구를 소개할게. 이름은 Understand-Anything이고, GitHub에서 몇 달 만에 스타를 6만 8천 개 넘게 받은 엄청난 플러그인이야. 특히 마지막에는 커밋하기 전에 내가 고친 코드가 어디를 망가뜨릴지 미리 보여주는 기능까지 있으니 끝까지 봐줘!

Understand-Anything, 대체 뭘 해주는 걸까?

이 도구는 네 프로젝트 전체를 인터랙티브 지식 그래프로 바꿔줘. 쉽게 말해서, 파일, 함수, 클래스 하나하나가 동그란 점으로 찍히고, 그 점들을 잇는 선을 따라 마우스로 클릭해가며 돌아다니는 거대한 지도라고 생각하면 돼.

• 어디서든 사용 가능: Claude Code 플러그인으로 가장 잘 맞고, Cursor, Copilot, Codex, Gemini CLI 같은 다른 AI 코딩 도구에서도 쓸 수 있어. 라이선스도 마음대로 쓸 수 있는 MIT라 회사 프로젝트에 써도 부담 없어.
• 똑똑한 지도 그리기: 그냥 점과 선으로만 이루어진 지도가 아니야. 먼저 Tree-sitter라는 파서가 코드를 기계적으로 훑어서 뼈대를 뽑아내. 그다음 LLM (AI)이 그 뼈대 위에 "이 함수는 무슨 일을 하는지", "어느 계층에 속하는지" 같은 의미를 더해줘. 그래서 로그인 처리, 사용자 관리처럼 사람이 알아듣는 말로 정리된 지도가 나오는 거지.

이 지도로 뭘 할 수 있을까?

1. 지식 그래프와 가이드 투어

• 웹 대시보드를 열면 지도가 쫙 펼쳐져. 점을 클릭하면 그 파일이 어떤 함수랑 연결되어 있는지 단계별로 파고들 수 있어.
• 가이드 투어를 켜면 AI가 "이 프로젝트는 여기서 시작해서 이렇게 흘러갑니다" 하고 짧은 견학 코스를 알아서 짜줘. 처음 보는 코드나 오랜만에 보는 옛날 프로젝트를 볼 때 시간을 엄청 아낄 수 있어!

2. 똑똑한 검색 & 코드한테 직접 질문하기

• 보통은 함수 이름을 정확히 알아야 검색되잖아? 근데 이 도구는 의미로 찾아줘. "결제 처리하는 데가 어디였더라?" 하고 떠올리기만 해도 이름이 달라도 그 일을 하는 코드를 찾아줘.
• 챗 기능을 쓰면 "이 프로젝트에서 사용자 로그인은 어떻게 동작하나요?" 하고 사람한테 묻듯이 물어볼 수 있어. 그러면 AI가 실제 코드 구조를 근거로 관련된 파일과 흐름을 짚어가며 답해줘.

3. 코드를 비즈니스 언어로 풀어주는 도메인 뷰

• 개발을 잘 모르는 기획자나 대표가 코드 그래프를 보면 외계어처럼 느껴질 때가 많지. 이 도구는 흩어진 코드를 회원 가입, 주문, 결제 같은 실제 업무 흐름으로 묶어서 보여줘.
• API, 서비스, 데이터, 화면처럼 역할이 비슷한 코드끼리 계층으로 자동 분류해줘서 전체 구조가 한눈에 들어와. SQL이나 설정 파일, 문서까지 26가지 넘는 종류를 함께 읽어준다는 것도 장점이야.

가장 강력한 기능: 변경 영향 분석 (Diff 분석)

아까 약속했던 가장 강력한 기능이야! 코드를 고치고 커밋하기 직전에 이걸 돌리면, 내가 방금 바꾼 부분이 프로젝트 어디까지 영향을 미치는지 지도 위에 표시해줘. 한 줄 고쳤다가 엉뚱한 화면이 터지는 사고를 커밋 전에 미리 확인하고 막을 수 있다는 거지!

설치는 얼마나 쉬울까?

정말 간단해! Claude Code를 쓴다면 터미널에 명령어 두 줄만 붙여넣으면 돼.

1. git clone https://github.com/UnderstandAnything/understand-anything.git
2. cd understand-anything && pip install -e .

Claude Code가 아니어도 맥이나 리눅스라면 안내된 설치 한 줄을 복사해서 붙여넣는 방법도 있어. 화면에 정확한 명령을 띄워줄 테니 그대로 복사해서 붙여넣기만 하면 돼!

사용법도 간단!

설치가 끝나면 사용법도 외울 게 거의 없어.

1. understand 명령을 한 번 실행하면 프로젝트 전체를 분석해서 지도를 만들어줘.
2. 그다음은 dashboard 명령으로 웹 화면을 열어 둘러보고, chat 명령으로 코드에 질문하고, diff 명령으로 변경 영향을 확인하는 식이야.

참고: 큰 프로젝트를 처음 분석할 때는 토큰을 꽤 써. 하지만 그다음부터는 바뀐 파일만 다시 보니까 비용이 확 줄어. 그것마저 걱정되면 Ollama 같은 무료 로컬 AI 모델을 연결해서 쓸 수도 있어.

정리하자면...

Understand-Anything은 막막한 코드를 클릭으로 둘러보는 지도로 바꿔주고, 의미로 검색하고, 코드에 질문하고, 커밋 전에 변경 영향까지 미리 보여주는 오픈소스 도구야. 거창한 준비 없이, 오늘 당장 제일 막막했던 프로젝트 폴더 하나 열어서 understand 명령을 한 번 돌려보길 추천해! 그래프가 직접 그려지는 걸 보면, 이 코드가 왜 이렇게 동작했는지 그제야 손에 잡히는 느낌이 들 거야.

질문: 낯선 코드를 만나면 직접 먼저 읽는 편이야, 아니면 AI한테 먼저 물어보는 편이야? 직접파는 A, AI파는 B, 댓글에 한 글자만 남겨줘!

오늘 영상이 도움이 되었다면 좋아요와 구독 부탁해!