AI 사용량 70배 아끼는 법 (Graphify 완전 초보 가이드)

코딩을 해본 적 없어도 따라올 수 있게 썼습니다.

한 줄 요약

내 폴더를 딱 한 번 읽어서 지도 한 장을 만들어 둡니다. 다음부터 AI는 파일을 하나씩 열어보는 대신 그 지도만 보고 답합니다.

만든 쪽이 공개한 실험에서 파일 52개짜리 폴더 기준으로 같은 질문에 쓰이는 양이 71.5분의 1로 줄었습니다.

시작 전에 딱 하나만 확인하세요

내 폴더에 파일이 몇 개인가요. 이게 전부입니다. 효과 크기가 여기서 갈립니다.

파일이 몇 개 없으면 AI가 어차피 한 번에 다 읽어버립니다. 지도를 만들 이유가 없어요.

1단계. 설치하기

설치는 검은 창에 명령어를 치는 방식입니다. 부담스러우면 AI한테 시키세요. 아래 글을 통째로 복사해서 클로드나 GPT에 붙여넣으면 알아서 해줍니다.

복사해서 붙여넣을 글

내 컴퓨터에 graphify라는 도구를 설치하려고 해. 나는 개발자가 아니니까 하나씩 알려줘.

1. 먼저 내가 맥을 쓰는지 윈도우를 쓰는지 확인해줘. 모르면 나한테 물어봐.
2. 파이썬 3.10 이상이 깔려 있는지 확인해줘. 없으면 설치 방법을 알려줘.
3. 그다음 아래 두 줄을 순서대로 실행하는 방법을 알려줘.
   uv tool install graphifyy
   graphify install
   (uv가 없으면 대신 pipx install graphifyy 로 해도 돼)
4. 설치가 끝나면 graphify --version 을 쳐서 정상 설치됐는지 확인해줘.
5. "graphify: command not found" 같은 오류가 나면 PATH 설정 문제니까 해결 방법까지 알려줘.
6. 각 단계마다 내가 뭘 복사해서 어디에 붙여넣어야 하는지 정확히 알려주고, 다 끝나면 성공했는지 결과를 정리해서 알려줘.

검은 창 여는 법

• 맥: 화면 오른쪽 위 돋보기(스포트라이트)를 누르고 터미널이라고 치면 나옵니다

• 윈도우: 시작 버튼 누르고 PowerShell이라고 치면 나옵니다

설치가 끝났다는 신호

검은 창에 graphify --version을 치고 엔터를 눌렀을 때 숫자가 나오면 성공입니다.

2단계. 처음 돌려보기

1. 클로드 코드(또는 커서, 코덱스)를 내 프로젝트 폴더에서 엽니다

2. 채팅창에 이렇게 칩니다

/graphify .

맨 뒤의 점 하나까지 포함해서 칩니다. "지금 이 폴더 전체"라는 뜻입니다.

1. 폴더 크기에 따라 몇 분 걸립니다. 그냥 두세요.

3단계. 결과 확인하기

다 끝나면 내 프로젝트 폴더 안에 graphify-out 이라는 새 폴더가 생깁니다. 이게 다 됐다는 신호입니다.

먼저 graph.html을 더블클릭해보세요. 내 프로젝트가 어떻게 생겼는지 처음 눈으로 보게 되는데, 이것만으로도 돌린 값을 합니다.

4단계. 실제로 써먹기

이제부터가 진짜입니다. AI한테 그냥 물어보면 예전처럼 파일을 뒤집니다. 지도를 보게 만들어야 합니다.

그냥 물어보기 (한글로 물어봐도 됩니다)

/graphify query "로그인이랑 데이터베이스는 어디서 연결돼?"

두 개가 어떻게 이어지는지 보기

/graphify path "UserService" "DatabasePool"

이게 뭐 하는 놈인지 물어보기

/graphify explain "RateLimiter"

더 잘 쓰는 법

여기부터가 진짜 차이가 나는 부분입니다.

1. AI가 알아서 지도를 보게 만들기

매번 /graphify query를 치기 귀찮습니다. 아래 명령어를 프로젝트 폴더에서 한 번만 돌려두면, 그다음부터는 그냥 평소처럼 물어봐도 AI가 알아서 지도를 먼저 봅니다.

2. 코드가 바뀌면 지도도 갱신하기

파일을 고치고 나면 지도가 옛날 것이 됩니다. 바뀐 파일만 다시 읽는 명령어가 있습니다.

/graphify . --update

매번 치기 귀찮으면 자동으로 만들어두세요. 커밋할 때마다 알아서 갱신됩니다.

graphify hook install

3. 폴더를 잘 고르기

이게 가장 큰 차이를 만듭니다.

코드만 있는 폴더보다, 코드와 문서와 PDF가 섞인 폴더에서 훨씬 크게 줄어듭니다. 71.5배가 나온 실험도 코드 파일에 논문 5편과 이미지 4장을 같이 넣은 폴더였습니다.

그러니까 흩어져 있던 기획서, 회의록, 참고 논문, 화면 캡처를 같은 폴더에 모아놓고 돌리세요. AI가 코드와 문서를 하나로 엮어서 봅니다.

4. 논문이나 유튜브 영상 끌어오기

인터넷에 있는 자료를 지도에 바로 추가할 수 있습니다.

/graphify add https://arxiv.org/abs/1706.03762
/graphify add (유튜브 주소)

5. 돈 한 푼 안 쓰고 싶으면

코드 파일은 내 컴퓨터 안에서만 처리돼서 사용량이 전혀 안 듭니다. 문서와 PDF와 이미지만 AI를 씁니다. 완전 무료로만 돌리고 싶으면 이렇게 하세요.

/graphify . --code-only

대신 문서는 지도에 안 들어갑니다.

6. 큰 폴더에서 브라우저가 버벅이면

점이 5000개를 넘어가면 graph.html이 무거워져서 잘 안 열립니다. 그럴 땐 그림을 아예 안 만들면 됩니다. 요약본과 지도 본체는 그대로 만들어집니다.

/graphify . --no-viz

막혔을 때

솔직하게 알아두실 것

• 71.5배는 만든 쪽이 공개한 자체 실험 수치입니다. 실험에 쓴 폴더와 결과물을 전부 공개해놔서 직접 검증은 가능하지만, 독립적인 제3자 검증은 아닙니다.

• 파일이 적으면 정말로 효과가 없습니다. 위의 표대로입니다. 작은 개인 프로젝트라면 그냥 안 쓰는 게 시간을 아끼는 길입니다.

• "AI가 매 세션 코드 전체를 다시 읽는다"는 말은 사실이 아닙니다. AI는 필요한 파일만 그때그때 찾아 읽습니다. 다만 그 찾는 과정에서 사용량이 나가는 건 맞고, 지도는 그 부분을 줄여줍니다.

• 문서와 PDF, 이미지를 넣으면 사용량이 듭니다. 코드만 무료입니다.

어디서 받나요

깃허브에서 무료로 공개되어 있습니다.

github.com/Graphify-Labs/graphify

만들다 막히면 무드모드 DM으로 편하게 물어보세요. 매주 이런 AI 정보를 가장 빠르게 전해드리고 있어요. @moodmode.ai