graphify 설치법: 코드를 지식 그래프로 바꾸는 AI 코딩 스킬
클로드 코드한테 “이 함수 어디서 불려?” 하고 물으면, 대답이 나오기 전에 파일을 하나씩 열어 보는 게 화면에 줄줄이 찍히죠. 프로젝트가 크면 그 과정만 한참이고 사용량도 같이 줄어요. 오늘 오후 깃허브 급상승 목록에 이 부분을 아예 다르게 풀겠다는 도구가 올라와 있었습니다. 이름은 graphify(그래피파이), 별이 13만 개를 넘었어요.
방식은 단순해요. 코드를 매번 다시 읽게 하지 말고, 한 번 지도(지식 그래프)를 만들어 두고 거기에 물어보게 하자는 거예요. 공식 README와 문서를 끝까지 읽고 설치 방법, 실제로 쓰는 명령, 그리고 쓰기 전에 알아 둘 점을 적어 봅니다.

graphify는 뭘 하는 도구인가요
AI 코딩 도구 안에서 /graphify . 한 줄을 치면, 지금 폴더의 코드·문서·PDF·이미지까지 훑어서 지식 그래프로 만들어 줍니다. 지식 그래프는 함수·클래스·파일 같은 것들을 점으로 두고, “이게 저걸 부른다”, “이게 저걸 가져다 쓴다” 같은 관계를 선으로 이어 둔 지도라고 보시면 돼요.

만든 곳은 Graphify Labs이고 README 배지에 Y Combinator S26이라고 적혀 있어요. 저장소는 2026년 4월에 열렸고, 10월 21일 기준 별 130,555개, 포크 1만 2천여 개입니다. 최신 버전은 10월 20일에 나온 v0.9.93이에요. 깃허브 API에 잡힌 라이선스는 Apache-2.0이라 무료로 쓸 수 있습니다.
README가 강조하는 건 세 가지예요. 코드는 tree-sitter(코드 문법을 분석하는 도구)로 내 PC에서 AI 없이 분석한다는 것, 그래프의 선마다 “원본에 직접 적혀 있음(EXTRACTED)”인지 “graphify가 추론함(INFERRED)”인지 표시한다는 것, 그리고 벡터 DB(문장을 숫자로 바꿔 비슷한 걸 찾는 저장소) 방식이 아니라 실제로 따라갈 수 있는 그래프라는 것이에요.

위 그림이 README에 실린 예시예요. 파이썬 웹 프레임워크 FastAPI의 코드를 graphify로 돌린 결과인데, 색깔별로 서로 많이 엮인 덩어리(커뮤니티)를 묶어 보여 주고 graph.html을 브라우저로 열면 점을 눌러 볼 수 있다고 해요.
설치는 두 줄, 이름만 조심하세요
준비물은 파이썬 3.10 이상과 uv(또는 pipx)예요. 공식 빠른 시작 문서 기준으로 이렇게 합니다.
# 1. 설치 (패키지 이름은 y 가 두 개: graphifyy)
uv tool install graphifyy
graphify --version
# 2. 쓰는 AI 코딩 도구에 스킬 등록 (자동 감지)
graphify install
# 3. AI 코딩 도구 안에서 지금 폴더를 그래프로
/graphify .

여기서 제일 중요한 한 가지. 파이썬 패키지 이름은 graphifyy(y 두 개)예요. 명령어는 그대로 graphify고요. README에 “PyPI의 다른 graphify 이름 패키지는 우리와 관계없다”고 따로 경고까지 해 뒀어요. 이름 비슷한 가짜 패키지에 악성 코드를 심는 일이 실제로 종종 있어서, 복사해서 붙여 넣는 게 안전합니다.

윈도우는 winget install astral-sh.uv로 uv부터 깔면 되고, 설치 후 graphify 명령을 못 찾으면 uv tool update-shell을 한 번 실행하라고 안내돼 있어요. 지원하는 도구는 클로드 코드·커서·코덱스·제미나이 CLI·깃허브 코파일럿 CLI·오픈코드 등 20개가 넘고, 도구별 명령은 graphify install --platform codex처럼 뒤에 이름을 붙이면 됩니다. 코덱스에서는 /graphify 대신 $graphify를 써요.
만들고 나면 뭐가 생기나
graphify-out/ 폴더에 파일 세 개가 생겨요.
| 파일 | 내용 |
|---|---|
| graph.html | 브라우저로 여는 그래프. 점 클릭·필터·검색 |
| GRAPH_REPORT.md | 핵심 개념, 의외의 연결, 추천 질문을 정리한 보고서 |
| graph.json | 그래프 전체. 파일을 다시 안 읽고 질문할 때 씀 |
그다음부터는 파일 대신 그래프에 물어봅니다. 명령은 세 개예요. query는 평소 말로 질문하면 관련된 부분만 잘라서 보여 주고, explain은 개념 하나의 위치와 연결을, path는 두 개가 어떤 길로 이어지는지를 보여 줘요.
graphify query "인증과 세션 저장은 어떻게 연결돼?"
graphify explain "APIRouter"
graphify path "FastAPI" "ModelField"

README에 실린 FastAPI 예시를 보면 graphify explain "APIRouter"가 routing.py 2210번째 줄에 있다는 것과 연결 47개를 보여 주고, path는 FastAPI에서 ModelField까지 3단계 경로를 찾아 줍니다. 질문 이름이 여러 개와 겹치면 아무거나 고르지 않고 후보를 보여 주며 거절한다는 점도 적혀 있어요.
한 번 더 해 두면 좋은 게 graphify claude install이에요. 클로드 코드·제미나이 CLI에는 훅을 걸어서, AI가 파일을 검색하거나 하나씩 읽으려 할 때 그래프를 먼저 보라고 슬쩍 알려 준다고 해요. 코드가 바뀌면 /graphify . --update로 바뀐 파일만 다시 읽히고, graphify hook install을 해 두면 커밋할 때마다 자동으로 다시 만든다고 합니다.
어떤 파일까지 읽나요?

코드는 파이썬·자바스크립트·타입스크립트·자바·C/C++·Go·러스트 등 약 40개 언어를 내 PC에서 분석해요. SQL 스키마, 테라폼 설정, 워드·엑셀(office 추가 설치), PDF(pdf), 유튜브 영상 받아쓰기(video)까지 붙일 수 있는데, 이런 건 uv tool install "graphifyy[pdf]"처럼 필요한 것만 추가로 깔게 돼 있어요.
공개된 벤치마크도 있어요. 긴 대화 기억 시험인 LOCOMO에서 recall@10(찾아야 할 내용을 상위 10개 안에 찾아낸 비율) 0.497, ERPNext 프로젝트 질문 6개에서 핵심 사실 82.0%를 맞혀 grep·파일 읽기 방식(70.8%)보다 높았다고 해요. 다만 이건 만든 쪽이 직접 잰 숫자이고, ERPNext 쪽은 질문이 6개뿐이라 참고만 하시는 게 좋겠습니다.
쓰기 전에 알아 둘 점

“내 PC에서만 돈다”는 말은 코드 파일에만 해당해요. 문서·PDF·이미지는 의미를 뽑아내려고 지금 쓰고 있는 AI 모델(클로드 코드라면 클로드)로 보냅니다. 회사 문서가 섞인 폴더라면 --code-only로 코드만 분석하거나, 로컬 모델인 올라마(--backend ollama)를 쓰라고 README에 나와 있어요. 그리고 API 키로 돌릴 때 Kimi 키가 잡혀 있으면 중국 Moonshot AI 서버로 간다는 안내도 있으니 환경 변수를 한 번 확인하세요.
사용 통계는 안 모은다고 명시돼 있지만, 내가 던진 질문은 ~/.cache/graphify-queries.log에 기록으로 남아요. 끄려면 GRAPHIFY_QUERY_LOG_DISABLE=1을 설정하면 됩니다. 지우고 싶을 땐 graphify uninstall, 결과 폴더까지 지우려면 --purge를 붙이면 돼요.

홈페이지에 들어가 보면 무료 오픈소스 엔진 말고 유료 서비스 Graphify Cloud가 따로 있어요. 여러 저장소를 한 그래프로 묶고 상시로 업데이트해 준다는 기업용이고 14일 무료 체험이 있습니다. README에 “에이전트 토큰 80% 절감”이라는 문구가 여러 번 나오는데, 이건 이 유료 클라우드 쪽 홍보 문구예요. 무료 버전을 깔았다고 사용량이 80% 준다는 뜻으로 읽으면 안 됩니다.
개인적으로는 이 도구가 제일 쓸모 있는 건 처음 보는 큰 프로젝트를 파악할 때라고 봐요. 남이 만든 오픈소스를 고쳐야 하거나, 오래된 회사 코드를 물려받았을 때 GRAPH_REPORT.md 하나로 큰 그림을 먼저 보는 거죠. 반대로 파일 몇 개짜리 작은 스크립트라면 그래프를 만드는 수고가 더 클 것 같습니다. 토큰을 아끼는 쪽으로는 지난번에 다룬 Headroom, AI가 코드를 덜 쓰게 하는 포니테일과 성격이 달라서 같이 써 볼 만해요.
저는 이 블로그 자동화 폴더처럼 스크립트가 여기저기 흩어진 곳에 코드 전용(--code-only)으로 돌려 보고, 그래프가 실제로 쓸 만한지 후기로 정리해 볼 생각이에요. 여러분은 AI 코딩 도구가 파일을 뒤지느라 시간을 쓰는 게 더 아까우세요, 사용량이 더 아까우세요? 클로드 코드 관련 다른 글도 같이 보시면 고르는 데 도움이 될 거예요.
출처
· Graphify-Labs/graphify 깃허브 README
· graphify 공식 문서 — Your first knowledge graph
· graphify 공식 문서 — Installation
· graphify 공식 문서 — Ask better graph questions
· graphify 공식 문서 — Supported inputs
· graphify BENCHMARKS.md
· graphify.com 공식 홈페이지
(2026년 10월 21일 확인)
컴퓨터가 고장 났다면 부산 컴퓨터수리 · 출장수리 부컴에 맡겨 주세요. 부산·울산·김해·양산 어디든 직접 방문합니다.
