UsageGuru가 AI 코딩 도구의 로그 입력을 줄인다

UsageGuru는 큰 로그와 스택 추적에서 토큰을 최대 90% 줄인다고 소개한다. 더 크고 잡음이 많은 로그일수록 더 많이 줄어든다는 설명이다.

이 도구는 로그에서 반복되는 줄과 라이브러리 스택 추적 등을 압축해 AI 코딩 도구에 전달한다. Claude Code를 주 대상으로 하지만 Codex, Cursor, VS Code를 비롯해 MCP(인공지능 도구를 연결하는 표준)를 지원하는 도구에서도 쓸 수 있다.

UsageGuru는 무엇을 하는 도구인가?

로그 압축은 책에서 되풀이되는 문장을 한 번만 남기고 나머지를 표시하는 일에 빗대면 이해하기 쉽다. UsageGuru는 로컬에서 로그와 명령 출력의 반복·불필요한 부분을 줄이고, 무엇을 덜어냈는지 표시를 남긴다.

반복된 로그 줄은 첫 줄과 마지막 줄, 생략한 줄 수를 남긴다. 라이브러리 코드의 스택 프레임은 제외하고 사용자의 코드에 해당하는 프레임과 소스 줄은 보존한다. 중복된 예외 추적은 한 번만 온전히 남긴 뒤 앞서 나온 것과 같다는 표시를 붙인다. 설치·빌드 출력은 시작과 결과를 남기며, 색상 코드와 진행 막대, 들여쓰기 등도 줄인다. 서로 다른 값을 가진 줄은 합치지 않아 수천 건의 200 응답 사이에 있는 500 오류도 남는다고 업체는 설명한다.

UsageGuru가 제시한 실제 로그 측정 결과는 다음과 같다.

업체는 자체 엔진으로 실제 로그를 측정했다고 밝힌다. 큰 로그에서는 compress_file을 사용하고, 직접 붙여 넣는 내용은 trim_prompt로 줄인다. 예시 출력에는 logs/server.log가 29,853토큰에서 2,969토큰으로 줄어 26,884토큰, 즉 90.1%를 절약한 것으로 나온다.

어떻게 설치하고 사용하나?

설치에는 Node.js 20 이상이 필요하다. 결제 뒤 받은 라이선스 키를 포함해 사용하는 도구에 명령어나 설정을 한 번 등록한다. 원문에 나온 설정은 다음과 같다.

$ claude mcp add usage-guru -e USAGEGURU_LICENSE_KEY=your-key -- npx -y usage-guru
# ~/.codex/config.toml
[mcp_servers.usage-guru]
command = "npx"
args = ["-y", "usage-guru"]
startup_timeout_sec = 60

[mcp_servers.usage-guru.env]
USAGEGURU_LICENSE_KEY = "your-key"
 // ~/.cursor/mcp.json
{ "mcpServers": { "usage-guru": {
 "command": "npx",
 "args": ["-y", "usage-guru"],
 "env": { "USAGEGURU_LICENSE_KEY": "your-key" }
} } }
 // .vscode/mcp.json
{ "servers": { "usage-guru": {
 "type": "stdio",
 "command": "npx",
 "args": ["-y", "usage-guru"],
 "env": { "USAGEGURU_LICENSE_KEY": "your-key" }
} } }

설정 뒤 AI 도구가 큰 로그나 빌드 출력을 열면 압축된 내용을 받는다. 저장소 파일을 지정하는 호출 예시는 다음과 같다.

compress_file("logs/server.log")
[Usage Guru] logs/server.log
Tokens: 29,853 -> 2,969 (saved 26,884, 90.1%)
Removed: 382 repeated lines, 24 library stack
frames, 28 repeated traceback lines, ...

절약량은 savings_report로 확인한다. 원문 예시에는 모든 기간과 최근 30일의 호출 횟수, 절약 토큰이 나온다.

Usage Guru savings (claude-opus-5-5, $4.00/M)
All time: 214 calls, 3,412,880 tokens saved
Last 30 days: 96 calls, 1,508,302 tokens saved
(example output)

요금과 데이터 처리는 어떤가?

월 구독료는 5달러다. 가격 안내에는 로컬 로그 압축은 무제한, compress_file과 trim_prompt 포함, 절약 보고서 포함, AI 프롬프트 재작성은 월 700회로 구분돼 있다. AI 재작성 횟수를 다 써도 로그 압축은 계속 작동하고, 재작성 기능만 다음 달 1일까지 멈춘다. 언제든 해지할 수 있고 첫 결제 뒤 7일 이내 환불을 요청할 수 있다고 업체는 안내한다.

UsageGuru는 압축을 사용자 컴퓨터에서 처리하며 코드나 로그를 업체에 보내지 않는다고 설명한다. trim_prompt로 다듬어 달라고 요청한 프롬프트의 일반 문장 부분만 전송될 수 있고, 이 전송도 끌 수 있다. 코드는 바이트 단위로 변경 없이 통과하며 .env 파일과 SSH 키 등 비밀 정보는 읽지 않도록 거부한다고 밝힌다.

API를 토큰 단위로 결제하는 경우에는 로그를 줄여 비용을 아낄 수 있다. 업체 계산기는 로그의 85%가 제거되고 한 달에 21일 일한다고 가정한다. 예를 들어 30,000토큰 로그에서 27,000토큰을 줄이고, Opus 5.5의 토큰 100만 개당 4달러 가격을 적용하면 최초 입력과 이후 열 번의 재읽기에서 각각 약 0.11달러를 절약해 월 4.62달러가 된다는 계산이다. 실제 결과는 달라질 수 있다고 안내한다. Claude Pro나 Max 구독자는 토큰별 비용을 내지 않지만, 업체는 로그가 작아지면 사용량 한도에 도달하기까지 더 많은 작업을 할 수 있고 대화 맥락 한도도 더 오래 유지할 수 있다고 설명한다.

써 보려면 Node.js 버전과 사용하는 도구의 MCP 지원 여부, 월 700회인 AI 재작성 한도를 확인하면 된다. 원문은 최대 90% 감소 수치의 측정 대상별 조건이나 독립적인 검증 결과를 밝히지 않는다.