이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.
TL;DR
Claude Code와 같은 코딩 에이전트가 프로젝트 수정 전 수행하는 반복적인 파일 검색으로 인해 토큰 사용량이 급증하고 추론 속도가 저하되는 문제가 지속되고 있다. 이를 해결하기 위해 오픈소스 도구인 Graft는 프로젝트의 코드 구조를 지식 그래프로 맵핑하여 에이전트에게 정확한 컨텍스트를 주입하는 방식을 제안한다. 실제 벤치마크 결과 토큰 사용량은 42%, 작업 시간은 60%까지 단축되었으며, 특히 대규모 코드베이스에서 에이전트의 사용 비용을 32% 이상 절감하는 효과가 입증되었다. Graft는 지식 그래프와 자동화 훅을 통해 에이전트가 불필요한 탐색 없이 즉시 핵심 로직에 접근할 수 있도록 지원하는 강력한 컨텍스트 엔지니어링 솔루션이다.
챕터별 상세
에이전트의 토큰 낭비 구조와 병목 현상
코딩 에이전트가 프로젝트를 수정하기 전 터미널 명령어로 파일을 검색하는 과정에서 막대한 토큰이 소모된다. 검색을 반복할 때마다 전체 대화 기록과 이전 도구 실행 결과가 모델에 재전송되어 컨텍스트 윈도우가 급격히 비대해지기 때문이다. 이로 인해 Opus나 Fable 5.1 같은 고성능 모델의 추론 속도가 느려지고 사용 한도에 빠르게 도달하는 문제가 발생한다. 결과적으로 모델이 컨텍스트 과부하로 인해 특정 작업에 집중하지 못하고 출력 품질이 저하되는 구조적 한계가 확인됐다.
지식 그래프를 활용한 컨텍스트 최적화 원리
Graft는 단순한 벡터 유사도 검색 대신 프로젝트 전체의 연결 구조를 노드와 엣지로 표현한 지식 그래프를 구축하여 이 문제를 해결한다. 벡터 검색은 '계정 생성'과 '계정 삭제'처럼 의미가 비슷한 코드를 혼동하기 쉽지만, Graft의 맵은 실제 코드 간의 의존 관계를 기록하여 정확한 위치를 찾아낸다. 생성된 맵은 JSON 파일로 저장되며 브라우저 뷰어를 통해 시각적으로 탐색할 수 있다. 에이전트가 프로젝트 구조를 처음부터 탐색하는 대신 미리 정의된 지도를 사용하게 함으로써 불필요한 시행착오와 토큰 낭비를 제거한다.
벡터 검색은 텍스트의 의미적 유사성에 의존하지만, 지식 그래프는 코드의 실제 호출 구조와 논리적 연결을 기반으로 한다.
Graft 설치 및 자동화 훅 메커니즘
`graft init` 명령어를 실행하면 Claude Code가 세션 시작 시 로드할 수 있는 전용 스킬 폴더가 자동으로 생성된다. 이 과정에서 특정 시점에 자동으로 실행되는 스크립트인 '훅(Hook)'이 설치되어 컨텍스트 주입 과정을 자동화한다. 세션 시작 시 지침 전달, 프롬프트마다 관련 코드 위치 첨부, 파일 수정 후 맵 업데이트 등 세 단계의 자동화가 이루어진다. 이를 통해 사용자가 수동으로 컨텍스트를 관리할 필요 없이 에이전트가 항상 최신 상태의 프로젝트 지도를 참조하도록 보장한다.
bash
npm install -g @nanonets/graft
graft initGraft CLI 설치 및 현재 프로젝트에 초기화하는 명령어
bash
graft build기존 코드베이스를 분석하여 지식 그래프 맵을 생성하는 명령어
벤치마크 수치와 실제 앱 빌드 성능 비교
Calendly 스타일의 예약 앱을 Fable 5.1 모델로 빌드한 결과, Graft 사용 시 작업 시간이 47분에서 39분으로 단축되었으며 컨텍스트 사용량도 35%에서 31%로 줄어들었다. 162회의 벤치마크 테스트에서는 도구 호출 46% 감소, 토큰 사용량 42% 절감, 평균 비용 32% 감소라는 구체적인 성능 향상이 확인됐다. 특히 프로젝트 규모가 커질수록 에이전트가 수행해야 할 검색량이 많아지므로 Graft를 통한 효율 개선 효과는 더욱 극대화된다. 다만 현재 Graft는 코드 파일만 맵핑하며 PRD나 일반 문서 파일은 기존 방식으로 처리한다는 한계가 있다.
Fable 5.1은 Anthropic의 모델 중 하나로, 복잡한 코딩 작업에 최적화되어 있으나 토큰 소모가 빠른 편이다.
용어 해설
- 컨텍스트 엔지니어링(Context Engineering)
- — 모델에 입력되는 정보를 최적화하여 추론 효율을 높이는 기술이다. 에이전트가 스스로 정보를 찾게 두는 대신, 필요한 정보만 선별해 주입함으로써 토큰 낭비를 줄이고 정확도를 높인다.
- 지식 그래프(Knowledge Graph)
- — 개체 간의 관계를 노드와 엣지로 연결하여 표현한 데이터 구조이다. 코딩 에이전트가 프로젝트 내 파일 간의 의존성과 호출 관계를 한눈에 파악할 수 있게 돕는 지도 역할을 한다.
- 훅(Hook)
- — 특정 이벤트가 발생할 때 자동으로 실행되도록 설정된 스크립트나 프로그램이다. Graft에서는 세션 시작이나 파일 수정 시점에 맞춰 프로젝트 맵을 업데이트하거나 컨텍스트를 주입하는 용도로 사용된다.
- 모델 컨텍스트 프로토콜(MCP)
- — Model Context Protocol의 약자로, 에이전트가 외부 도구나 데이터 소스와 통신하는 표준 방식이다. 에이전트가 필요한 시점에만 특정 정보를 요청할 수 있게 하여 효율적인 상호작용을 지원한다.
언급된 리소스
AI 분석 전체 내용 보기
AI 요약 · 북마크 · 개인 피드 설정 — 무료
출처 · 인용 안내
원문 발행 2026. 09. 09.수집 2026. 09. 09.출처 타입 YOUTUBE
인용 시 "요약 출처: AI Trends (aitrends.kr)"를 표기하고, 사실 확인은 원문 보기 기준으로 진행해 주세요. 자세한 기준은 운영 정책을 참고해 주세요.
