Graft 지식 그래프가 코딩 에이전트의 토큰 낭비를 줄이는 방식 | DAKER 커뮤니티
코딩 에이전트가 똑똑해질수록, 의외로 먼저 커지는 것은 탐색 비용입니다. 간단한 UI 수정처럼 보이는 요청도 실제로는 관련 파일을 찾고, 읽고, 다시 후보를 좁히는 과정을 여러 번 거치기 때문입니다.
Tech Bridge의 「GitHub 1위 트렌딩 도구가 해결한 AI 에이전트의 치명적인 문제입니다」는 이런 비효율을 줄이는 오픈소스 Graft를 소개합니다. 핵심은 수정 전에 검색을 반복하는 대신, 코드의 참조와 의존 관계를 지식 그래프로 정리해 필요한 위치를 더 빨리 찾게 하는 데 있습니다. 사이트는 trailhq.com/graft입니다.
에이전트는 왜 파일을 찾는 데 토큰을 많이 쓰나
에이전트는 버튼 색을 바꾸는 요청처럼 작은 작업에서도 먼저 어느 파일을 봐야 하는지 판단해야 합니다. 이 과정에서 터미널 검색으로 후보를 찾고, 결과를 읽고, 다시 다음 도구를 고르는 흐름이 반복됩니다.
작은 수정이라도 어디를 고쳐야 하는지 찾는 과정이 길어지면, 그 자체가 토큰과 시간의 비용이 됩니다.
원문에 따르면 Claude Code·Codex의 기본 흐름은 이런 식의 터미널 검색에 크게 의존합니다. 문제는 매 턴마다 지금까지의 대화와 도구 결과가 다시 컨텍스트에 들어간다는 점입니다. 컨텍스트가 커질수록 비용과 속도, 그리고 작업의 집중도가 함께 나빠질 수 있습니다.
또한 벡터 검색은 의미가 비슷한 항목을 잘 묶는 장점이 있지만, 「계정」처럼 같은 단어가 들어가도 실제 기능은 반대인 경우를 구분하는 데 한계가 있다고 지적합니다. 예를 들어 생성과 삭제처럼 맥락이 다른 기능이 비슷하게 잡힐 수 있다는 뜻입니다.
Graft는 무엇을 다르게 하나
Graft는 로컬 코드를 읽고, 코드의 부분을 노드로, 실제 사용 관계를 엣지로 정리한 JSON 지도를 만듭니다. 이 구조는 브라우저 뷰어로도 볼 수 있습니다.
이렇게 만들어진 지도는 프롬프트 시점에 관련 위치를 붙이는 데 쓰이거나, MCP 방식에서는 에이전트가 필요할 때만 조회하는 방식으로 활용됩니다. 원문은 이 접근이 불필요한 도구 호출을 줄이는 데 도움이 된다고 설명합니다.
검색을 여러 번 반복하는 대신, 코드의 참조와 의존 관계를 먼저 정리해 필요한 위치를 더 직접적으로 찾게 하는 것이 Graft의 핵심입니다.
CLI와 MCP에서의 동작
원문에 따르면 CLI 연동 시에는 세션 시작 지침이 들어가고, 프롬프트마다 최대 약 3곳의 위치를 첨부하며, 편집 뒤에는 증분 업데이트 훅을 둡니다. MCP는 에이전트가 필요할 때만 조회합니다.
영상 기준 테스트에서는 MCP가 조금 더 정확했고, CLI가 더 빨랐다고 합니다. 또한 별도 API 키 없이 기존 구독 환경에서 쓰도록 설계됐다고 소개합니다. 다만 선택적 설명 페이지 생성에는 모델 사용이 가능하다고 덧붙입니다.
벤치와 데모에서 언급된 수치
원문은 이 수치들이 영상과 벤더 주장임을 전제로 소개합니다. 162회 실행 기준으로 작업 시간 약 60% 감소, 도구 사용 약 46% 감소, 토큰 약 42% 감소, 비용 약 32% 감소라고 합니다. 경우에 따라 토큰이 최대 약 4배 저렴해진 사례도 언급합니다.
예약 앱 빌드 데모에서는 첫 빌드의 차이는 크지 않았지만, 지도가 만들어진 뒤에는 랜딩 개편이 2분 미만으로 줄었다고 설명합니다. 큰 프로젝트일수록 탐색 절감 효과가 더 크다고 말하며, 코드 외 PRD·노트는 지도에 포함되지 않는다고 명시합니다.
모델 성능만 높이는 것이 아니라, 어디를 고칠지 찾는 비용 자체를 줄이자는 접근입니다.
이 도구를 볼 때 함께 확인할 점
Graft의 장점은 탐색 비용을 줄이는 구조에 있습니다. 다만 소개된 수치는 벤더와 영상에서 제시한 결과이므로, 실제 효과는 저장소 구조와 작업 방식에 따라 달라질 수 있습니다.
특히 작은 프로젝트에서는 차이가 크지 않을 수 있고, 파일 간 참조가 복잡한 프로젝트일수록 체감이 커질 가능성이 있습니다. 따라서 도입 여부를 판단할 때는 내 저장소에서 같은 모델과 비슷한 작업으로 비교해 보는 것이 좋습니다.
참고 자료
유튜브: [한영자막] GitHub 1위 트렌딩 도구가 해결한 AI 에이전트의 치명적인 문제입니다 · 채널 Tech Bridge (@TechBridge-KR)
Graft: https://trailhq.com/graft
여러분이 쓰는 저장소에서는 파일 탐색 비용이 실제로 얼마나 큰지, 비슷한 방식으로 비교해 본 적이 있는지 궁금합니다.