그래피파이로 클로드 코드가 grep 대신 지식 그래프를 보게 설치하는 법

그래피파이(graphify)는 프로젝트 폴더를 지식 그래프로 바꿔, 에이전트가 grep 없이 그래프에 물어 코드를 찾게 하는 오픈소스 도구다. 코드는 tree-sitter로 로컬에서 파싱하니 LLM을 부르지 않는다. 문서·PDF·이미지는 쓰고 있는 어시스턴트 모델이 한 번 더 읽는다. 10월 16일 0.9.92가 나왔고, 깃허브 별은 12만 개를 넘었다.

1. CLI를 설치하고 스킬을 등록한다. 파이썬 3.10 이상과 uv(또는 pipx)가 필요하다. PyPI 패키지 이름은 y가 두 개인 graphifyy이고, 다른 graphify* 패키지는 공식이 아니다.

uv tool install graphifyy
graphify install

코덱스는 --platform codex를 붙이고, 지금 저장소에만 넣으려면 --project를 붙인다.

graphify install --platform codex
graphify install --project

1. 클로드 코드에서 그래프를 만든다. 코덱스에서는 $graphify .로 부른다.

/graphify .

graphify-out/ 폴더에 graph.html(브라우저로 여는 그래프), GRAPH_REPORT.md(핵심 개념과 질문 거리 요약), graph.json(전체 그래프)이 생긴다.

1. 터미널에서도 그래프에 바로 묻는다.

graphify query "how requests are validated"
graphify path "FastAPI" "ModelField"
graphify explain "APIRouter"

1. 에이전트가 늘 그래프부터 보게 하려면 프로젝트에서 한 번 돌린다. 클로드 코드에서는 검색 도구를 부르거나 Read·Glob로 소스를 하나씩 읽으려 할 때 훅이 먼저 끼어들어 그래프를 쓰라고 알려 준다.

graphify claude install

코덱스에서 병렬 추출을 쓰려면 ~/.codex/config.toml의 [features]에 multi_agent = true를 넣는다. 코드 그래프는 로컬에서 무료로 만들지만, 문서·미디어를 읽는 단계는 어시스턴트 모델이나 따로 설정한 API 키를 쓴다.