새로운 팀에 합류해서 200만 줄의 코드를 마주했을 때, 어떻게 시작해야 할까요? 대부분의 사람들은 첫 입사일부터 막연하게 탐색을 시작하며, 3개월 후에야 시스템이 어떻게 작동하는지 흐릿하게 알게 됩니다.

Understand Anything는 하나의 명령어로 이 문제를 해결합니다: /understand. 이는 여러 Agent 파이프라인을 시작하여 전체 프로젝트를 스캔하고, 상호작용형 지식 그래프를 구축합니다 - 각 파일, 함수, 클래스는 클릭할 수 있는 노드이며, 종속 관계를 명확하게 볼 수 있습니다.

GitHub 23k star, MIT 라이선스, Claude Code, Codex, Cursor, Copilot 등 14개의 코딩 Agent 플랫폼을 지원합니다.

이 글에서 무엇을 다룹니다

• 핵심 기능
• 어떻게 설치하고 사용해야 합니다
• 기술 아키텍처（tree-sitter + LLM 혼합 솔루션）
• 지원 플랫폼
• 적용 시나리오

핵심 기능

1. 구조화 코드 그래프

코드 라이브러리를 상호작용 지식 그래프로 변환합니다. 각 파일, 함수, 클래스는 노드이며, 의존 관계는 엣지입니다. 어떤 노드를 클릭하든 코드, 관계, 영어 설명을 확인할 수 있습니다. 확대, 검색, 탐색을 지원합니다.

2. 비즈니스 도메인 보기

domain 보기로 전환하여 코드가 실제 비즈니스 프로세스에 어떻게 매핑되는지 확인하세요 - 도메인, 프로세스, 단계는 수평 그래프로 표시됩니다. 단순히「이 파일이 그 파일을 호출한다」가 아니라「이 프로세스가 주문 결제 단계에 해당한다」와 같이 표시됩니다.

3. 지식베이스 분석

는 코드뿐만 아니라 Karpathy 모델의 LLM 위키 지식베이스를 분석할 수 있습니다. wikilink와 분류를 파싱하여 LLM이 숨겨진 관계를 발견하고, 위키를 탐색 가능한 지식 그래프로 변환합니다.

4. 가이드드 투어(Guided Tours)

의존성 순서대로 배열된 아키텍처 투어를 자동으로 생성합니다. 가이드처럼 코드베이스를 이해하게 도와줍니다 - 먼저 인프라를 보고, 다음으로 핵심 로직을, 마지막으로 비즈니스 레이어를 살펴봅니다.

5. 변경 영향 분석

커밋 전에 변경 사항이 시스템의 어떤 부분에 영향을 미칠지 확인합니다. 직접적인 의존성뿐만 아니라 케이스케이드 영향도 포함합니다.

6. 의미 검색

흐트러짐 검색 + 의미 검색. "인증을 처리하는 부분은 어디인가요?"라고 검색하면, 그래프를 넘어 관련 결과를 반환합니다.

7. 아키텍처 계층 시각화

API / Service / Data / UI / Utility로 계층화하여 색상 코드로 구분합니다.

8. 다국어 출력

중국어 지식 그래프 생성을 지원합니다:

/understand --language zh

en, zh, zh-TW, ja, ko, ru를 지원합니다.

설치 및 사용

Claude Code(원시 플러그인)

/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything

한 줄 설치(Codex / Cursor / Copilot / Gemini CLI / OpenCode / 기타)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash

# 指定平台
curl -fsSL ... | bash -s codex

# Windows PowerShell
iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex

지원되는 platform 값: codex、gemini、opencodeopenclaw、cursor、vscode、copilot、pi、hermes、cline、kimi、antigravity、vibe。

핵심 명령어

점진적 업데이트

기본적으로 변경된 파일만 다시 분석하고, 매번 전체 스캔하지 않음:

/understand  # 增量更新
/understand src/frontend  # 限定子目录（monorepo 场景）

자동 업데이트

post-commit hook을 활성화하여 매번 커밋 시 그래프를 자동으로 업데이트:

/understand --auto-update

팀 공유

그래프는 JSON 파일(.understand-anything/knowledge-graph.json)이며, Git에 제출 후 팀원들이 직접 사용하여 분석 단계를 건너뜀:

# 提交图谱
git add .understand-anything/

# 大图谱（10MB+）用 Git LFS
git lfs track ".understand-anything/*.json"

기술 아키텍처

tree-sitter + LLM 혼합 솔루션

이것은 프로젝트에서 가장 정교한 설계입니다. 정적 분석과 LLM은 각자의 전문 분야를 수행합니다:

tree-sitter(확정성 계층)
- 소스 코드를 구체적인 문법 트리로 파싱
- 구조화된 사실 추출: import, export, 함수/클래스 정의, 호출 지점, 상속 관계
- 미리 분석하여 importMap로 전달하고 파일 분석기에게 반복 추론을 피하게 함
- 동일한 입력 → 동일한 출력, 매번 실행 시 일관성 유지
- 지문 검출을 통해 변경된 파일을 지원하여 증분 업데이트 구현

LLM(의미 계층)
- 파싱된 구조 + 원시 소스 코드를 읽어들임
- 파서가 제공할 수 없는 내용 생성: 영어 요약, 태그, 아키텍처 계층, 비즈니스 도메인 매핑, 가이드, 프로그래밍 개념 설명

이러한 분업은 그래프가 구조적 측면에서 재현 가능하도록 만들어 (동일한 코드가 동일한 엣지를 생성), 동시에 의미적 측면에서 의도를 포착합니다 (파일이 무엇을 위해 사용되는지 알고, 단지 import한 내용만 알지 않는 것처럼요).

다수 Agent 파이프라인

/understand 명령 배치 6개의 전용 Agent:

파일 분석기는 병렬로 실행됩니다 (최대 5개 동시, mỗi 배치 20-30개 파일), 증분 업데이트를 지원합니다.

지원되는 tree-sitter 언어

C, C++, C#, Go, Java, JavaScript/TypeScript, PHP, Python, Ruby, Rust.

지원되는 플랫폼

기술 스택

• TypeScript — 전역 스택 구현
• pnpm 모노레포 — 패키지 관리
• tree-sitter — 12가지 언어의 확실한 파싱
• Vitest — 테스트 프레임워크
• MIT 계약오픈소스

그리고 다른 코드 이해 도구와의 비교

Understand Anything의 독특한 점은코드를 이해하는 것을 시각적인 학습 과정으로 만드는 것뿐만 아니라 검색 또는 인덱싱 도구로만 사용하지 않는다는 점입니다.

적용 시나리오

• 신입사원 입사：/understand-onboard 의존성 순서에 따른 학습 경로 생성
• 대규모 프로젝트 수행：20만 줄 코드, 한 번의 스캔으로 전체 아키텍처 이해
• 코드 리뷰：/understand-diff 커밋 전 변경 사항 영향 범위 확인
• 비즈니스 이해：/understand-domain 코드와 비즈니스 프로세스의 매핑 확인
• 지식 관리：/understand-knowledge 팀 위키를 탐색 가능한 그래프로 변환
• Monorepo 탐색：/understand src/frontend 한정 범위 분석

작성자: itech001
출처: 공식 계정: AI 인공지능 시대
웹사이트: https://www.theaiera.cn/
매일 최첨단 AI 뉴스 정보와 기술 연구를 공유합니다.

본 글이 처음으로 AI 인공지능 시대에 게재되었으며, 재해도 출처를 명시해 주십시오.