TL;DR

  • UsageGuru는 Claude Code를 비롯한 MCP 지원 도구에서 로그 잡음을 압축해 최대 90% 적은 토큰으로 오류 정보를 유지하는 월 5달러 플러그인임.
  • 반복 로그, 라이브러리 스택 프레임, 중복 트레이스백, 설치·빌드 출력, 터미널 잡음, 공백이 많은 JSON을 줄이고 제거한 항목을 표시함.
  • 실사용 로그 측정에서 Flask 로그는 29,919→3,033토큰, Node 개발 서버 로그는 974→280토큰, 실패 테스트 출력은 788→315토큰으로 감소함.
  • 설치에는 Node.js 20 이상과 라이선스 키가 필요하며, 로그 압축은 로컬에서 실행되고 코드와 소스 파일은 바이트 단위로 그대로 유지됨.
  • 월 요금에는 무제한 로컬 로그 압축과 절감 보고서가 포함되며, 선택형 AI 프롬프트 재작성은 월 700회 제공됨.

UsageGuru 개요

  • UsageGuru는 Claude Code용으로 설계된 MCP 서버 플러그인으로, Claude가 디버깅 중 읽는 반복 로그와 프레임워크 스택 프레임, 설치 출력을 먼저 줄이는 도구임.
  • 최대 90% 적은 토큰으로 로그를 전달하면서 오류는 유지하며, Claude Pro·Max에서는 사용량 한도에 도달하기까지 더 많은 작업을 할 수 있고 Claude API에서는 비용 절감 효과를 기대할 수 있음.
  • 설치는 약 1분이 걸리고 코드를 수정하지 않으며 언제든 취소할 수 있음.
  • Claude Code, Codex, Cursor, VS Code 및 MCP 도구와 함께 사용할 수 있음.
  • 큰 로그와 스택 트레이스에서는 토큰이 최대 90% 감소하고, 한도에 도달하기 전 최대 10배 더 많은 로그를 처리할 수 있다는 설명임.

제거하는 로그 잡음

  • 반복 로그 줄: 동일한 상태 확인 메시지 382개를 모두 나열하는 대신 첫 줄과 마지막 줄, 생략된 줄 수 표시를 남김.
  • 라이브러리 스택 프레임: express, node_modules, site-packages 프레임을 줄이고 사용자 코드의 프레임과 소스 줄을 유지함.
  • 중복 트레이스백: 같은 오류가 아홉 번 더 출력되면 전체 트레이스백 한 건과 중복 표시를 남김.
  • 설치·빌드 출력: npm WARN, pip의 이미 설치됨 메시지, Docker 이미지 가져오기 출력에서 첫 줄과 마지막 줄을 남겨 시작과 결과를 확인할 수 있게 함.
  • 터미널 잡음: 색상 코드, 진행 막대, Base64 데이터 덩어리를 제거하고 터미널에 실제로 표시된 내용을 유지함.
  • 불필요한 JSON 공백: 들여쓰기와 공백을 줄이되 모든 키와 값을 유지함.
  • 삭제된 부분마다 무엇이 제거됐는지 표시를 남기며, 값이 서로 다른 줄은 병합하지 않음. 따라서 수천 개의 200 응답 사이에 있는 단일 500 오류도 그대로 보임.

로그 압축 측정치

  • UsageGuru 엔진으로 실제 로그를 측정한 결과는 다음과 같음.
  • Flask 서버 로그: 29,919→3,033토큰, 90% 감소.
  • Node 개발 서버 로그: 974→280토큰, 71% 감소.
  • 실패 테스트 실행 출력: 788→315토큰, 60% 감소.
  • 더 크고 잡음이 많은 로그일수록 더 많이 줄어드는 경향이 있음.

사용 방법

  • 1단계 — AI 도구에 추가: 결제 후 발급되는 라이선스 키를 설정에 넣고 한 줄 명령이나 설정 블록으로 연결함. Node.js 20 이상이 필요함.
  • Claude Code, Codex, Cursor, VS Code에서 사용할 수 있으며, 각 도구의 MCP 설정에 usage-guru 서버와 라이선스 키를 등록함.
  • 2단계 — 로그 읽기: Claude가 큰 로그나 빌드 출력을 열 때 compress_file 도구로 압축본을 받음. 직접 붙여 넣을 텍스트는 trim_prompt로 처리함.
  • 예시 출력에서는 로그가 29,853토큰에서 2,969토큰으로 줄어 26,884토큰, 90.1%를 절감함. 제거 항목에는 반복 줄 382개, 라이브러리 스택 프레임 24개, 중복 트레이스백 줄 28개 등이 포함됨.
  • 3단계 — 절감량 확인: savings_report를 요청하면 실제 Claude 가격을 기준으로 이 컴퓨터에서 절감한 토큰과 비용을 확인함. 예시 보고서에는 Claude Opus 5.5의 백만 토큰당 4달러 기준으로 전체 214회 호출, 3,412,880토큰 절감, 최근 30일 96회 호출, 1,508,302토큰 절감이 표시됨.

절감액 계산기

  • 계산기는 Anthropic이 공개한 API 가격을 사용하며, 하루 작업 중 큰 로그·출력 수, 일반적인 토큰 크기, 대화에 남아 있는 후속 응답 수, Claude 모델을 입력값으로 받음.
  • 예시 기본값은 하루 큰 로그 4개, 로그당 15,000토큰, 대화에서 다시 읽히는 응답 10회임. 1,000줄 로그는 대략 15,000~30,000토큰으로 제시됨.
  • Haiku 4.5, Sonnet 5.5, Opus 5.5, Fable 5.1 모델을 선택할 수 있음.
  • 계산 예시는 월 절감액, 제거된 토큰 수, 최초 읽기 비용, 재읽기 비용, UsageGuru 요금을 보여줌.
  • 추정치는 로그당 85%가 제거되고 한 달에 21일 일한다고 가정하며 결과는 달라질 수 있음. Claude Pro·Max는 토큰별 비용을 내지 않지만 사용량 한도에 더 늦게 도달하는 방식으로 효과를 얻음.

가격

  • 요금제는 월 5달러 하나이며 언제든 취소할 수 있음.
  • 요금에는 무제한 로컬 로그 압축, compress_file과 trim_prompt, 월 700회의 AI 프롬프트 재작성, 절감 보고서, 모든 Claude 모델 사용이 포함됨.
  • Stripe로 결제하며 라이선스 키는 즉시 표시됨.
  • Opus 5.5의 백만 토큰당 4달러 기준으로 30,000토큰 로그에서 27,000토큰을 줄이면 최초 읽기에서 약 0.11달러, 대화에서 열 번 다시 읽힐 경우에도 약 0.11달러를 절감함. 이를 하루 한 번, 월 21일 반복하면 계산상 월 4.62달러 절감으로 월 요금에 가까운 수준임.

자주 묻는 질문

  • UsageGuru의 기능: AI 코딩 도구가 잡음이 줄어든 로그, 스택 트레이스, 명령 출력을 읽도록 하는 플러그인(MCP 서버)임.
  • 데이터 처리: 압축은 사용자 컴퓨터에서 실행됨. 서비스로 전송되는 것은 trim_prompt로 다듬도록 요청한 프롬프트의 일반 문장 부분뿐이며 코드나 로그는 전송되지 않음. 이 전송도 끌 수 있음.
  • 오류 보존: 실제로 반복되는 줄만 축약함. 값이 다른 줄은 유지하고 오류는 제거하지 않으며, 각 생략 부분에 제거 내용을 표시함.
  • 코드와 비밀 정보: 코드와 소스 파일은 바이트 단위로 그대로 통과함. .env 파일, SSH 키 및 기타 비밀 정보는 읽지 않음.
  • Claude Pro·Max 사용: 토큰별 요금은 없지만 사용량 한도와 컨텍스트 창이 있으므로, 로그가 작아지면 한도에 도달하기 전 더 많은 작업을 할 수 있고 컨텍스트가 차기까지 세션을 더 오래 이어갈 수 있음.
  • 월 700회 재작성 초과: 로그 압축은 제한 없이 계속 작동하며 선택형 AI 프롬프트 재작성만 다음 달 1일까지 중단됨.
  • 필요 조건과 호환 도구: Node.js 20 이상과 MCP 지원 AI 도구가 필요함. Claude Code, Codex, Cursor, VS Code의 Copilot 에이전트 모드, Windsurf, Gemini CLI 등을 지원함.
  • 취소와 환불: 결제에 사용한 이메일로 로그인해 결제 포털에서 언제든 취소하거나 카드 변경 및 청구서 다운로드가 가능함. 첫 결제 후 7일 이내에는 사유를 묻지 않고 환불하며, 지원 티켓을 열어야 함.
  • 한 번의 명령으로 설치한 뒤 로그를 원래보다 훨씬 작은 크기로 처리하는 방식임.