Claude Code 사용 시, 사용하지 않는 기능에 약 8k 토큰을 낭비하고 있을 수 있습니다. 이를 해결하기 위한 CLI를 만들었습니다.

여러분 안녕하세요,

저는 Claude Code를 많이 사용해 왔는데, CLI 에이전트가 컨텍스트를 처리하는 방식에서 큰 결함을 발견했습니다. 초기화 시에, 수십 개의 스킬 설명(skill descriptions), MCP 서버 설정(server configs), 사용자 정의 규칙(custom rules)을 프롬프트에 무조건 로드합니다.

제 세션 기록을 확인해 보니 187개의 항목이 로드되었지만, 실제로 사용한 것은 4개뿐이었습니다. 이는 사장된 데이터(dead weight)로 인해 세션당 약 8,000 토큰이 완전히 낭비되는 것이며, 프롬프트 캐시 적중률(prompt cache hit rate)을 떨어뜨리고 비용을 발생시킵니다.

저는 제 지갑을 고치고 싶었기 때문에 reap 🌾를 만들었습니다.

이 도구는 100% 로컬이며 전송되는 데이터가 전혀 없는(zero-telemetry) 도구로, 세션 로그를 스캔하여 사용하지 않는 스킬을 찾아 안전하게 격리합니다.

• reap (낭비되는 것을 보여줍니다)
• reap prune (되돌릴 수 있는 격리 공간으로 이동시킵니다)
• reap restore --all (마음이 바뀌면 모든 것을 되돌려 놓습니다)

Claude Code와 바로 작동합니다.

🛠️ 비하인드 스토리: 제가 이것을 만들게 된 방법과 이유 (동료 개발자들을 위해)

혹시 비슷한 로컬 LLM 도구링(tooling)을 작업하고 있는 분들이 계실까 봐, 제가 이 도구를 만들면서 내린 몇 가지 아키텍처 결정을 공유하고 싶었습니다:

Go를 사용한 이유? 원래는 간단한 Bash나 Python 스크립트를 생각했습니다. 하지만 Python은 종속성(dependencies)/가상 환경(venvs)이 필요하고, Bash는 MacOS와 Linux에서 복잡한 파일 구조를 파싱하기에는 악몽과 같습니다. Go 덕분에 즉시 실행되는 단일의 종속성이 없는 정적 바이너리(static binary)를 컴파일할 수 있었습니다.

동시성 파싱 (Concurrent Parsing): Claude Code는 버전에 따라 JSONL 파일 또는 SQLite 데이터베이스에 기록을 저장합니다. 저는 Go의 동시성 기본 요소(concurrency primitives)를 사용하여 이러한 기록들을 병렬로 파싱하고, 터미널이 느려지지 않도록 tool_use 블록과 명령어 호출을 검색했습니다.

되돌릴 수 있는 상태 (The Quarantine): 가장 큰 난관은 안전성이었습니다. 아무도 자신의 사용자 정의 에이전트 스킬을 삭제하는 도구를 원하지 않을 것입니다. 저는 비파괴적인(non-destructive) 격리 시스템을 구축했습니다: reap prune은 파일을 숨겨진 디렉터리로 이동시키고 버전 관리된 JSON 매니페스트를 작성합니다. reap restore는 단순히 이 매니페스트를 읽어 파일들을 다시 옮길 뿐입니다.

본인만의 토큰 낭비량을 확인하거나 Go 아키텍처를 살펴보고 싶다면, 이 프로젝트는 완전히 오픈 소스입니다.
Repo & Docs: https://github.com/thousandflowers/skillreaper
만약 본인의 토큰 낭비 패턴이 어떤지 알려주시거나 파싱 로직에 대해 질문사항이 있다면 말씀해주세요!
제출자 /u/Worried_Menu4016
[링크] [댓글]