Caveman: 코딩 에이전트의 토큰 사용을 줄이는 스킬과 프록시

Caveman은 코딩 에이전트가 쓰는 토큰을 줄이는 도구 모음이에요. 처음에는 “원시인처럼 짧게 말하게 하는 스킬”로 시작한 농담 같은 프로젝트였는데, 지금은 에이전트의 답변, 입력, 모델 선택, 반복 스크립트까지 여섯 갈래로 나눠 토큰을 줄이는 도구로 커졌어요. 저장소 설명은 “토큰 65% 절감”을 내세우지만, README가 직접 보여 주는 측정값은 훨씬 조심스러워요. 이 글은 두 가지를 나란히 놓고 정리했어요.

무엇을 해 주나요

README는 4.0부터 Caveman을 “여섯 개의 돌(rock)”로 설명해요. 설치하면 모두 켜지고, 하나씩 끌 수 있어요.

  • Say less (짧게 말하기): 에이전트가 군더더기 없이 짧게 답해요. 코드, 명령어, 경로, 오류 메시지는 한 글자도 건드리지 않아요. README 예시에서는 같은 React 재렌더링 답이 63토큰에서 20토큰으로 줄어요. 보안 경고나 되돌릴 수 없는 작업은 일부러 풀어서 말하고, 사용자가 쓴 프롬프트는 고치지 않아요.
  • Read less (덜 읽기): 로그, JSON, CSV, 테스트 출력이 모델에 들어가기 전에 압축돼요. 원본은 디스크에 남아 있어서 에이전트가 필요하면 다시 꺼내 볼 수 있어요.
  • Auto: 요청마다 모델과 노력 수준을 골라 줘요. 어려운 일에는 큰 모델, 쉬운 일에는 가벼운 설정을 쓰는 방식이에요. 무료 계정 로그인이 필요해요.
  • Blocks: 에이전트가 매번 새로 짜던 스크립트를 저장소에 보관해서 다시 쓰게 해요. json-peek, test-summary, first-error, wait-for 같은 블록 8개가 들어 있어요.
  • Waste fixes: 토큰이 어디서 새는지 찾고, 잠깐 자리를 비운 동안 제공자의 프롬프트 캐시가 식지 않게 유지해 줘요.
  • Browse: 웹 페이지를 압축된 형태로 에이전트에게 줘요.

이 밖에 /caveman-commit(한 줄 커밋 메시지), /caveman-review(한 줄 리뷰 코멘트), /caveman-compress(CLAUDE.md 같은 메모리 파일 압축, 원본 백업)도 들어 있어요. 맨 위에는 “Caveman Code”라는 새 무료 코딩 에이전트 앱 소개가 붙어 있는데, 이 글에서는 다루지 않았어요.

설치와 사용

README가 안내하는 기본 설치는 한 줄이에요. Node.js 22.13 이상이 필요해요.

npx @caveman-ai/cli@latest

실행하면 컴퓨터에 있는 에이전트와 로그인 상태를 찾아서 무엇을 바꿀지 보여 주고, 확인하면 적용해요. 이후에는 평소처럼 claude를 켜도 Caveman이 적용돼요. Codex, Gemini CLI, OpenCode 등 30개 이상의 에이전트를 지원한다고 해요. 답변을 짧게 하는 스킬만 쓰고 싶다면 아래처럼 스킬만 설치할 수도 있어요.

npx skills add JuliusBrussee/caveman -g

에이전트 안에서는 /caveman(기본), /ultracave(더 짧게), /megacave(한자 문어체) 세 단계를 고를 수 있고, stop caveman이라고 하면 원래대로 돌아와요.

숫자는 어떻게 읽어야 하나요

README는 측정값을 많이 보여 주는데, 대부분 제작자가 직접 잰 값이에요. 그리고 불리한 결과도 함께 적어 둔 점이 눈에 띄어요.

  • 입력 토큰 33.2% 감소: Claude Code 세션 54회 실행 기준이에요. 파일 종류별 차이가 커서 CSV는 55.1%, 로그는 50.2% 줄었지만 HTML은 압축기가 아직 없어서 오히려 9.9% 늘었어요. 이 실험은 2026년 8월의 이전 엔진으로 한 거라고 README가 밝혀요.
  • Auto 54% 절감: 코딩 과제 85개에서 Opus 5.5(xhigh)와 비교했을 때 비용이 0.46배였어요. 다만 README가 “실험이 절반만 끝났고, 점수 차이 0.5%포인트는 이 규모에서 구분되지 않는다”고 적어요. 절감의 대부분은 쉬운 요청에서 노력 수준을 낮춘 효과라고도 해요.
  • 짧은 답변의 실제 효과: 개발 질문 10개에서 아무 지시가 없으면 출력 6,983토큰, “간결하게 답해”만 붙이면 4,334토큰, /caveman은 4,119토큰이에요. 즉 “간결하게”라는 기본 지시에 비하면 /caveman이 더 줄이는 건 약 3%이고, 큰 차이는 /ultracave(2,693토큰)에서 나와요. 이 규칙 자체가 입력 토큰을 약 1,160개 늘리기 때문에, GitHub Copilot처럼 요청 횟수로 과금하는 곳에서는 절약 효과가 없다고 README가 직접 말해요.
  • 외부 검증: README는 Adobe Research 논문(여덟 개 모델에서 비용 1.4~2.4배 절감), JetBrains의 86개 과제 A/B 실험(품질 차이 없음, 출력 토큰 8.5% 감소), Elastic의 변형 사례(응답 토큰 63.6% 감소)를 인용해요. 인용 링크는 확인하지 않았어요.
  • Blocks는 시험 단계: 현재 v0.1.0-rc.5이고 Python만 지원하며 샌드박스가 아직 없다고 해요.

정리하면, “65%”는 가장 좋은 경우를 모은 대표 문구에 가깝고, 일상 사용에서는 입력 3분의 1 안팎 절감과 조건부 효과로 보는 편이 안전해요.

누구에게 쓸모 있나요

Claude Code나 Codex를 하루 종일 긴 세션으로 쓰면서 토큰 비용이나 사용 한도가 부담인 사람에게 가장 맞아요. 로그와 테스트 출력이 길게 쏟아지는 작업일수록 “Read less” 효과가 커요. 반대로 요청 한 번에 정해진 금액을 내는 정액·요청 단위 과금이라면 이점이 작아요.

쓰기 전에 알아 둘 점

  • 사용 통계 전송이 기본값이에요. 실행한 명령, 토큰 수, 설치 ID, 운영체제, IP를 보내고, 프롬프트와 코드, 파일 경로는 보내지 않는다고 해요. caveman telemetry off 또는 환경 변수 DO_NOT_TRACK=1로 끌 수 있어요.
  • Auto는 데이터를 외부로 보내요. 로그인하고 Auto를 고르면 최근 요청과 에이전트가 붙인 CLAUDE.md, 메모리, 멘션한 파일, 직전 답변의 끝부분이 Caveman Cloud로 전송돼요. 무료 요금제에서는 라우팅 개선을 위해 보관될 수 있다고 적혀 있어요. caveman off routing으로 끌 수 있어요.
  • 설치 스크립트를 받아서 바로 실행하는 방식(curl로 받아 bash에 넘기는 한 줄)도 안내돼요. 이런 방식은 내용을 먼저 열어 보고 실행하는 게 안전해요. README는 버전을 v4.1.0으로 고정한 주소를 쓰고 있어요.
  • 기능이 많은 만큼 바뀌는 범위도 넓어요. 설치하면 컴퓨터의 여러 에이전트 설정을 건드려요. 되돌리는 방법(--uninstall)도 README에 있어요.

저장소 상태

  • 별 120,287개, 포크 7,011개 (2026-11-15 기준)
  • 열린 이슈·PR 88건
  • 언어: Go (GitHub 표시 기준). 폴더 구성상 TypeScript와 Python 패키지도 함께 있어요.
  • 라이선스: Apache-2.0 (MIT 라이선스 파일도 함께 있고, 오래된 릴리스와 서드파티 고지는 LICENSING.md에 따로 정리돼 있어요)
  • 만든 날: 2026-04-04 (7개월 남짓 된 프로젝트예요)
  • 마지막 커밋: 2026-11-13. 최근 커밋은 README 배너 수정과 Go 도구 체인 보안 패치 선택 같은 유지보수 내용이에요.
  • 최신 릴리스: v4.1.0 (2026-11-08)
  • 최상위 폴더: skills, hooks, proxy, shrink, browse, engine, mcp, packages, evals, benchmarks, installer 등. README가 말하는 구성요소(스킬, 프록시, 압축, 브라우저, 벤치마크)에 대응하는 폴더가 실제로 있어요.

확인 범위

2026-11-15에 GitHub의 저장소 정보, README 전체, 최근 커밋 5개, 최신 릴리스, 최상위 폴더 구조를 읽었어요. 코드를 분석하지 않았고, 설치하거나 실행해 보지도 않았어요. 글에 나온 절감률은 모두 저장소 README가 밝힌 값이고 제가 다시 재현한 값이 아니에요.

출처

JuliusBrussee/caveman (README, 릴리스, 커밋 기록)

Similar Posts