[한영자막] GitHub 1위 트렌딩 도구가 해결한 AI 에이전트의 치명적인 문제입니다

한 줄 핵심

GitHub에서 주목받는 Graft는 코드베이스의 지식 그래프를 만들어 에이전트의 불필요한 탐색을 줄임으로써 토큰 사용량과 실행 시간을 크게 낮추는 도구다.

시간별 요약

1. 0:00
   소개 좋은 모델일수록 결과는 좋지만 토큰 소모와 지연이 커져 실사용 비용이 급격히 올라간다. Graft는 에이전트의 기본적인 프로젝트 탐색 방식을 바꿔 더 적은 토큰으로 더 빠르게 작업하게 만드는 해법으로 제시된다.
2. 0:55
   에이전트가 토큰을 낭비하는 근본 이유 Claude Code나 Codeex 같은 에이전트는 수정할 파일을 찾기 위해 여러 도구를 반복 호출하고, 그때마다 대화 기록과 도구 결과가 다시 컨텍스트에 쌓인다. 이 반복적인 검색·판단 과정이 토큰 소모와 속도 저하를 만들며, 단순한 벡터 검색은 코드 간 실제 연결 관계를 잘 반영하지 못해 충분한 해결책이 되지 못한다.
3. 3:26
   Graft 소개 및 지식 그래프 방식 Graft는 설치형 터미널 도구로, 프로젝트를 지식 그래프로 분석해 어떤 코드가 서로 연결되는지 기록한다. 벡터 유사도가 아니라 실제 참조 관계를 저장하기 때문에 변경 영향 범위를 더 정확히 파악하고, 테스트 기준으로 토큰 사용량과 실행 시간을 크게 줄였다.
4. 5:20
   Graft 작동 원리와 노드/엣지 연결 구조 Graft는 코드 항목을 node, 연결을 edge로 저장하고 JSON 파일과 브라우저 뷰어로 맵을 관리한다. Claude Code와 연결되면 프롬프트에 맞는 최대 3개 위치를 먼저 붙여 주어 모델이 적은 턴 수로 필요한 파일에 도달하게 하며, MCP 버전은 필요할 때만 조회해 정확도를 높이는 대신 CLI보다 느릴 수 있다.
5. 7:15
   설치 및 Claude Code 연동 설정 설치는 사이트의 명령어 또는 에이전트용 setup prompt를 통해 진행할 수 있고, 프로젝트 폴더에서 init을 실행해야 해당 프로젝트 전용 설정이 유지된다. hooks가 세션 시작, 프롬프트 매칭, 파일 수정 후 맵 갱신을 자동으로 강제하며, 기존 프로젝트는 build로 전체 맵을 먼저 만들고 빈 프로젝트는 파일이 생길 때부터 맵이 자라난다.
6. 9:02
   실제 예약 앱 빌드 테스트 및 결과 Fable 5.1로 예약·일정 앱을 만들며 PRD와 claw.md로 작업 범위를 먼저 고정한 뒤 Graft를 적용했다. 첫 빌드에서는 39분과 약 31% 컨텍스트로 47분·35%의 비적용 버전보다 나았고, 이후 랜딩 페이지 개편처럼 프로젝트 맵이 축적된 상태에서는 2분 미만으로 더 큰 차이를 보였다.

실무 인사이트

• 에이전트 비용 절감은 모델 교체보다 먼저, 검색·탐색을 줄이는 컨텍스트 구조 설계에서 시작해야 한다.
• 코드베이스가 커질수록 벡터 검색보다 실제 참조 관계를 저장하는 지식 그래프가 변경 영향 분석과 파일 선택 정확도에 유리하다.
• 기존 프로젝트에 도입할 때는 PRD, 작업 지침 파일, hooks, 초기 build를 함께 묶어야 실제 체감 효과가 빨리 나온다.