프로젝트 소개

TraceFrugal은 개발자가 AI 코딩 워크플로우에서 토큰 사용량을 이해하고 최적화할 수 있도록 돕는 로컬 단일 바이너리 Go 애플리케이션으로, 특히 Claude Code와 Codex를 대상으로 합니다. 이 도구는 큰 도구 결과, 반복 호출, 컨텍스트 재사용 등 워크플로우가 많은 입력을 소모하는 이유를 시각화하는 통합 대시보드를 제공합니다. 사용자는 더 작은 컨텍스트 규칙을 실험하고, 시간별 가시성을 추적하며, 답변 만족도를 측정할 수 있으며, 원하는 결과를 얻지 못할 경우 변경 사항을 되돌릴 수 있습니다. 주요 기능으로는 큰 읽기 전용 결과를 보관하고 정확한 재호출을 제공하는 선택적 MCP 프록시가 있으며, 효율성을 유지하기 위해 24시간 후 데이터 패킹을 중지합니다. TraceFrugal은 복사된 응답을 중복 제거하고 지난 7일 동안의 사용량 데이터를 표시하며, 30초마다 새로 고칩니다. 이 도구는 Claude Code와 Codex의 네이티브 로컬 로그 가져오기와 JSONL 트레이스를 사용하는 API 애플리케이션 개발자를 위한 별도의 워크플로우를 명확히 구분합니다. 또한, 비용-성공 회귀 게이트와 자동 평가자 기반 실험을 포함하여 최적화가 작업 품질을 저하시키지 않도록 보장합니다. 이 애플리케이션은 개인 정보 보호를 우선시하며, API 키, 원격 측정, 런타임 종속성이 필요하지 않습니다. 달러 금액은 목록 가격을 기반으로 한 추정치이며, 캐시 재사용이 손실되거나 작업 품질이 저하될 경우 낮은 토큰 수가 자동으로 절약으로 이어지지 않는다는 점을 강조합니다. TraceFrugal은 다양한 공급업체를 어댑터를 통해 지원하며, 사용자가 JSONL 형식의 사용량 데이터를 직접 가져올 수 있어 프롬프트와 자격 증명이 로컬에 유지됩니다. 이 도구는 CI 파이프라인에 적합하며, 기준 실행과 후보 실행을 비교하여 비용이나 결과 회귀를 감지할 수 있습니다.