낯선 코드를 지식그래프로 — Understand-Anything, 그리고 서브에이전트 골라 담기 (클로드·코덱스 둘 다)
낯선 저장소에 던져졌을 때 파일·함수·의존성을 그래프로 훑는 도구와, 필요한 전문가만 골라 담는 서브에이전트 모음 두 갈래를 정리한다. 클로드 코드와 코덱스를 오가며 쓸 수 있다.
[1] Understand-Anything — 코드베이스를 대화형 지식그래프로
- 대상: 공통(Claude Code / Codex 둘 다 지원, 이 밖에 Cursor·Copilot·Gemini CLI 등도)
- repo: Egonex-AI/Understand-Anything (https://github.com/Egonex-AI/Understand-Anything)
※ 원저자는 Lum1104이고 현재는 Egonex-AI 저장소가 정식(canonical). 예전 Lum1104 경로를 안내한 글이 아직 많으니 주의.
- 하는 일: Tree-sitter로 파일·함수·클래스·의존성 구조를 뽑고 LLM으로 의미를 붙여 지식그래프(.ua/knowledge-graph.json)를 만든다. React 대시보드로 시각 탐색·자연어 질의를 하고, 온보딩 문서와 변경 영향 분석까지 슬래시 커맨드로 뽑는다.
- 설치·사용(Claude Code):
1) /plugin marketplace add Egonex-AI/Understand-Anything
2) /plugin install understand-anything
3) /understand 로 전체 분석 → /understand-dashboard 로 대시보드 열기
- 설치·사용(Codex):
1) curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s codex
2) 커맨드 접두사가 / 대신 $ 라 $understand, $understand-chat 형태로 호출
- 주요 커맨드: /understand-chat("결제 흐름 어디서 처리?" 식 질의), /understand-diff(커밋 전 변경 영향), /understand-explain(특정 파일·함수 심층), /understand-onboard(온보딩 가이드), /understand-domain(비즈니스 도메인 추출)
- 팁: 커밋 전 /understand-diff 로 손댄 코드가 어디까지 파급되는지 먼저 확인하면 리뷰 왕복이 준다.
- 주의: 이름이 같은 포크·미러가 여럿 떠 있다. 설치 전 owner가 Egonex-AI 인지 확인하고, curl | bash 실행 전에는 install.sh 내용을 직접 읽어보라.
[2] VoltAgent 서브에이전트 컬렉션 — 필요한 전문가만 골라 담기
- 대상: 클로드 코드용과 코덱스용이 별도 저장소로 나뉘어 있어 양쪽 다 커버
- repo(Claude): VoltAgent/awesome-claude-code-subagents, 158종·10개 카테고리 (https://github.com/VoltAgent/awesome-claude-code-subagents)
- repo(Codex): VoltAgent/awesome-codex-subagents, 171종·13개 카테고리 (https://github.com/VoltAgent/awesome-codex-subagents)
- 하는 일: 백엔드·보안·성능·i18n 같은 역할별 서브에이전트를 격리된 컨텍스트로 실행하도록 미리 정의해 둔 모음. 필요한 파일만 복사해 쓴다.
- 설치·사용(Claude Code): 서브에이전트는 마크다운(YAML 프런트매터: name·description·tools·model) 파일.
· 대화형: git clone 후 ./install-agents.sh 로 카테고리 골라 설치
· 수동: 원하는 .md 를 ~/.claude/agents/(프로젝트 한정은 .claude/agents/)에 두면 자동 인식. 이름이 겹치면 프로젝트 쪽이 우선한다.
- 설치·사용(Codex): 서브에이전트는 .toml 파일.
1) mkdir -p ~/.codex/agents
2) cp categories/01-core-development/backend-developer.toml ~/.codex/agents/
3) 코덱스는 커스텀 서브에이전트를 자동 소환하지 않으니 프롬프트에서 해당 에이전트에게 명시적으로 위임하라. 프로젝트 한정은 .codex/agents/ 가 우선한다.
- 팁: 통째로 넣지 말고 지금 하는 일에 맞는 3~5개만 담아라. 서브에이전트도 과다하면 선택 정확도가 떨어진다.
두 저장소 모두 갱신이 잦으니, 커맨드명·경로가 바뀌었는지 설치 전 각 README를 한 번 열어보는 습관만 챙기면 된다.
출처:
https://github.com/Egonex-AI/Understand-Anything
https://github.com/Lum1104/Understand-Anything
https://dev.to/arshtechpro/understand-anything-turn-any-codebase-into-an-interactive-knowledge-graph-37ed
https://github.com/VoltAgent/awesome-codex-subagents
https://github.com/VoltAgent/awesome-claude-code-subagents
https://github.com/openai/codex/discussions/16329
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록