Claude Code의 컨텍스트 유지 문제를 해결하는 engramx 소개

실용적 조언

Claude Code 사용 시 세션 초기화로 인한 토큰 낭비가 심하다면 engramx를 도입하여 git 히스토리 기반의 컨텍스트 주입을 시도할 것.

Claude Code는 매 세션마다 프로젝트 맥락을 잃어버리는 문제가 있다. 작성자는 87개 파일, 163,122 토큰 규모의 코드베이스에서 이 문제를 겪었다.

engramx는 git 히스토리에서 bi-temporal knowledge graph를 구축하여 이 문제를 해결한다. git-revert miner가 자동으로 실수 기록을 수집하고, 이를 PreToolUse 훅으로 모델에 전달하여 반복적인 실수를 방지한다.

실제 적용 결과, 토큰 사용량이 163,122에서 17,722로 89.1% 감소했다. 이는 관련 파일만 읽는 것보다 6.4배, 전체 저장소를 스캔하는 것보다 25,155배 효율적인 수치이다.

engramx는 로컬 SQLite에 데이터를 저장하며 클라우드 호출이 없다. npx 명령어로 설치 가능하며 Apache 2.0 라이선스로 배포된다.

이중 시간 지식 그래프(Bi-temporal Knowledge Graph): — 데이터의 유효 시간과 트랜잭션 시간을 모두 기록하는 지식 그래프 구조. 코드베이스의 변경 이력을 시점별로 추적하여 과거의 실수나 설계 결정을 모델이 정확히 파악하도록 돕는다.
PreToolUse 훅(PreToolUse Hook): — AI 에이전트가 도구를 실행하기 직전에 특정 로직을 개입시키는 메커니즘. 이 아티클에서는 모델이 도구 실행 전 과거의 실수 기록을 확인하여 반복적인 오류를 방지하는 용도로 사용된다.
토큰 절감(Token Reduction): — LLM의 컨텍스트 윈도우에 입력되는 데이터 양을 최적화하여 비용과 처리 시간을 줄이는 기술. 불필요한 데이터를 제거하고 핵심 정보만 주입하는 것이 핵심이다.

bash

npx [email protected]

engramx 설치 및 초기화 명령어

Claude Code중립

AI 코딩 에이전트

engramx추천링크

Claude Code 컨텍스트 유지 및 토큰 최적화