Graphify: Claude Code를 위한 코드베이스 지식 그래프
Graphify는 리포지토리(코드, 문서, SQL 스키마, 설정, PDF)를 Claude Code 안에서 질의할 수 있는 지식 그래프로 바꿉니다. tree-sitter 로컬 파싱, 모든 간선에 태그, 벡터 스토어는 쓰지 않습니다.
Graphify 한눈에 보기
- 서드파티 오픈소스 프로젝트(Graphify-Labs/graphify, Apache-2.0, Python)이며 Anthropic 제품이 아닙니다. Claude Code, Cursor, Codex, Gemini CLI 등에서 쓰는 `/graphify` 스킬을 제공합니다.
- 코드는 tree-sitter로 AST로 파싱되며, 로컬에서 결정적으로 처리되고 모델 호출이 없습니다. 모든 간선에는 `EXTRACTED`(소스에 명시) 또는 `INFERRED`(Graphify가 해석) 태그가 붙습니다.
- 탐색하는 그래프이지 벡터 인덱스가 아닙니다. 임베딩도 벡터 스토어도 없습니다. `/graphify query`는 답에 필요한 노드와 간선만 돌려줍니다.
- 명령 세 개면 됩니다: `uv tool install graphifyy`, `graphify install`, 리포지토리에서 `/graphify .`. 결과는 `graphify-out/`에 생성됩니다.
Graphify-Labs/graphify — repository and README
출처github.com2026-11-15
Graphify Quickstart
출처docs.graphify.com2026-11-15
GitHub REST API — repos/Graphify-Labs/graphify
출처api.github.com2026-11-15
이 페이지의 명령, 플래그, 파일 이름은 2026-11-15에 위 세 출처에서 읽은 것입니다. 명령과 경로는 의도적으로 번역하지 않았습니다. 번역된 명령은 실행되지 않기 때문입니다.
2026-11-15에 확인했습니다. 리포지토리의 기본 브랜치는 v8이고 마지막 push는 2026-11-14입니다. star와 fork 수치는 매일 달라지므로 인용 전에 API를 다시 읽으세요.
Graphify란 무엇인가
프로젝트 자신의 설명: 어떤 코드베이스든 그 문서, SQL 스키마, 설정, PDF와 함께 질의 가능한 지식 그래프로 바꿉니다. Claude Code, Cursor, Codex, Gemini CLI를 위한 `/graphify` 스킬이며, 로컬 결정적 AST 파싱, 모든 간선의 설명, 벡터 스토어 없음이 특징입니다.
실제 흐름은 이렇습니다. CLI(`graphify`)와 스킬을 설치한 뒤 어시스턴트 안에서 `/graphify`를 입력합니다. 어시스턴트가 detection, extraction, clustering을 수행해 그래프를 `graphify-out/`에 쓰고, 이후에는 트리를 grep하는 대신 그 그래프를 탐색해 답합니다.
- 라이선스
- Apache-2.0
- 언어
- Python(패키지명 graphifyy)
- star / fork
- 147,983 / 14,194 — 2026-11-15 스냅숏
- 상태
- 서드파티, 기본 브랜치 v8, 마지막 push 2026-11-14
Anthropic 프로젝트가 아닙니다
Graphify는 Graphify-Labs 조직이 Apache-2.0으로 공개했습니다(GitHub API의 is_verified는 false). Anthropic이 유지보수하지 않고 Claude Code에 포함되지도 않습니다. 직접 설치하며, 내 파일에 대해 동작합니다.
그래프가 만들어지는 방식
코드는 tree-sitter로 AST로 파싱됩니다. 이 단계는 결정적이며 내 컴퓨터에서 실행됩니다. LLM도, 외부 전송도 없습니다. 파일 간 관계(calls, imports, inherits, mixes_in)는 AST에서 나오며 약 40개 언어를 지원합니다. `# NOTE:` / `# WHY:` 주석과 ADR, RFC 참조도 노드가 됩니다.
문서, PDF, 이미지, 영상은 두 번째 의미 분석 단계로 넘어가며 어시스턴트의 모델이나 설정한 API 키를 사용합니다. 토큰이 드는 부분은 여기이고, 코드 맵 자체는 들지 않습니다.
모든 간선에 설명이 있습니다
연결마다 태그가 붙습니다. 소스에 명시된 관계는 `EXTRACTED`, Graphify가 해석한 것은 `INFERRED`입니다. 코드에서 읽은 것과 추론한 것을 구분할 수 있습니다.
벡터 인덱스가 아닙니다
임베딩도 벡터 스토어도 없습니다. 결과물은 실제 그래프, 즉 노드와 간선, 커뮤니티, god node이며 `query`, `path`, `explain`으로 탐색합니다.
Claude Code에 Graphify 설치하기
명령 세 개면 됩니다. `graphify install`의 기본 대상은 Claude Code이고, 다른 어시스턴트는 플래그 하나만 다릅니다.
CLI 설치
패키지 이름은 `graphifyy`로 y가 두 개입니다. `graphify`와 `graphify-mcp` 명령이 함께 설치됩니다. Python 3.10 이상이 필요하고, 세 가지 패키지 관리자 중 아무거나 괜찮습니다.
# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyy철자를 주의하세요. 설치하는 패키지는 `graphifyy`, 입력하는 명령은 `graphify`와 `graphify-mcp`입니다.
스킬 등록
플래그가 없으면 `graphify install`은 Claude Code를 대상으로 합니다. 스킬을 `~/.claude/skills/graphify/SKILL.md`로 복사하고 `~/.claude/CLAUDE.md`에 등록합니다. 다른 에이전트라면 `--platform`을 넘기세요.
graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codex예: `graphify install --platform codex`. 그래도 `/graphify`가 인식되지 않으면 어시스턴트를 재시작하거나 `~/.claude/skills/graphify/SKILL.md`가 있는지 확인하세요.
리포지토리에서 실행
어시스턴트에서 리포지토리를 열고 `/graphify .`를 실행합니다. 에이전트가 detect, extract, cluster를 수행한 뒤 보고서를 돌려줍니다. 코드는 로컬에서 파싱되고, 문서와 논문은 에이전트 자체 모델을 거칩니다.
/graphify .이제 질문하세요. `/graphify query "how does authentication reach the database"`는 답에 필요한 노드와 간선만 토큰 예산에 맞춰 돌려줍니다.
시작하기 전에
- 1Python 3.10 이상.
- 2uv, pipx, pip 중 하나 — CLI에 이미 쓰고 있는 것으로 충분합니다.
- 3`graphify install`이 지원하는 코딩 어시스턴트(기본은 Claude Code)와 인덱싱할 리포지토리 — 로컬 경로 또는 `/graphify <url>`에 쓸 공개 GitHub URL.
실제로 쓰게 되는 명령
문서의 quickstart와 명령 표에서 그대로 옮겼습니다. `/`로 시작하는 명령은 어시스턴트 안에서, 나머지는 셸에서 실행합니다.
| 명령 | 하는 일 |
|---|---|
/graphify query "…" | 질문합니다. 답에 필요한 노드와 간선만 토큰 예산에 맞춰 돌려줍니다. |
/graphify path "AuthModule" "Database" | 두 노드 사이의 최단 경로를 보여줍니다. 여기서는 AuthModule에서 Database까지입니다. |
/graphify explain "SessionStore" | 노드 하나를 설명합니다. 무엇인지, 무엇과 연결되는지, 왜 그런지. |
/graphify . --update | 기존 그래프를 새로 고칩니다. 처음부터 다시 만들지 않습니다. |
/graphify . --mode deep | 더 깊은 추출 모드로 실행합니다. 느리지만 더 많은 관계가 해석됩니다. |
/graphify . --wiki | 그래프에 대한 위키 형식 설명도 생성합니다. |
/graphify https://github.com/<owner>/<repo> | 로컬 경로 대신 공개 리포지토리 URL을 지정합니다. |
graphify hook install | git 훅(post-commit, post-checkout, post-merge, post-rewrite와 merge driver)을 설치해 그래프가 리포지토리를 따라가게 합니다. `graphify hook status`에 네 개 모두 installed로 표시되어야 합니다. |
graphify god-nodes --top 5 | 가장 많이 연결된 노드를 출력합니다. 그래프가 있고 모양이 정상인지 빠르게 확인하는 용도입니다. |
graphify extract . --code-only | 코드 단계만으로 다시 추출하고 문서와 미디어의 LLM 단계는 건너뜁니다. |
graphify uninstall | 스킬과 그 등록을 제거합니다. |
그래프를 찾지 못하면 `graphify-out/`이 있는 디렉터리에서 실행하거나 `--graph graphify-out/graph.json`을 넘기세요.
graphify-out/에 생기는 것
문서의 트리를 그대로 옮기면:
graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/- 1`graph.json` — 그래프 전체. 다른 도구가 데이터를 읽을 때 쓰는 파일입니다.
- 2`graph.html` — 브라우저 보기: 노드 클릭, 필터, 검색.
- 3`GRAPH_REPORT.md` — 핵심, 의외의 연결, 던져볼 질문.
- 4`manifest.json` — 무엇을 인덱싱했는지에 대한 목록.
- 5`cache/` — 로컬 작업 데이터. 커밋하지 말고 `.gitignore`에 넣으세요.
무엇을 커밋할까
문서는 `graph.json`과 `GRAPH_REPORT.md`를 커밋하고 `cache/`를 `.gitignore`에 넣으라고 권합니다. README의 짧은 설명은 "세 개의 파일"(`graph.html`, `GRAPH_REPORT.md`, `graph.json`)이라고 하고, quickstart는 다섯 항목을 나열합니다. 같은 디렉터리를 자세함만 달리해 설명한 것입니다.
저장된 그래프에는 `graph.schema_version`과 `graph.graphify_version`도 기록됩니다. CLI를 업그레이드한 뒤 확인하세요. 오래된 그래프는 재생성이 필요할 수 있습니다.
그래프를 최신으로 유지하기
그래프는 마지막 빌드 시점의 상태일 뿐입니다. git에 연결하세요:
graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered`graphify hook install`은 post-commit, post-checkout, post-merge, post-rewrite 훅과 merge driver를 연결합니다. 그 뒤 `graphify hook status`는 네 훅이 installed, "merge driver: registered"로 나와야 합니다.
문서나 이미지가 바뀌면 전체 빌드 대신 `/graphify . --update`를 다시 실행하세요.
맞는 경우와 하지 않는 일
Graphify는 코드 지도 도구입니다. 파일 하나의 문장보다 리포지토리의 형태가 중요할 때 설치할 가치가 있습니다.
잘 맞는 경우
- 1낯선 코드베이스에 합류해 파일을 읽기 전에 모듈, god node, 커뮤니티 구조를 먼저 보고 싶을 때.
- 2질문이 관계에 관한 것 — 이것이 어떻게 저기에 닿는가, 누가 이것을 호출하는가 — 이라 grep으로는 답하기 어려울 때.
- 3지도를 커밋해 두고 팀이나 에이전트가 재생성 비용 없이 다시 읽게 하고 싶을 때.
알아둘 제한
- 1무료이고 완전히 로컬인 부분은 코드입니다. 문서, PDF, 이미지, 영상의 의미 분석은 모델을 거치므로 토큰이나 API 키가 듭니다.
- 2`INFERRED` 간선은 Graphify의 해석이지 소스의 사실이 아닙니다. 연결을 신뢰하기 전에 태그를 확인하세요.
- 3그래프는 스냅숏입니다. 훅이나 `--update`가 없으면 README처럼 낡습니다.
- 4젊은 서드파티 프로젝트입니다. 가치 근거는 독립 평가가 아니라 자체 README에서 나옵니다.
프로젝트는 README에 자체 벤치마크 표를 싣습니다. 예를 들어 n=300에서 LOCOMO recall@10이 0.497입니다. 유지관리자의 측정이지 독립 결과가 아니므로, 자기 리포지토리에서 확인할 주장으로 다루세요.
DeepSeek Harness에서의 Graphify
DeepSeek Harness용 서드파티 네이티브 플러그인도 플러그인 디렉터리에 올라와 있습니다. 커뮤니티 작업이며 Graphify-Labs 리포지토리와는 별개입니다.
플러그인 목록 보기