caveman: 코딩 에이전트가 덜 말하고 덜 읽게 하는 도구
에이전트 답을 원시인 말투로 줄여요. 같은 React 버그 설명이 63토큰에서 20토큰이 돼요
- 누가
- Julius Brussee가 2026년 4월에 농담으로 시작했어요. 코딩 에이전트의 긴 답과 긴 도구 출력에 토큰을 많이 쓰는 사람을 위한 도구예요.
- 언제
- 2026년 4월 4일에 저장소가 열렸고, 최신 릴리스는 11월 8일에 나온 4.1.0이에요.
- 어디서
- Mac, Linux, Windows에서 돌아요. Claude Code, Codex, Gemini CLI, OpenCode 등 30개 넘는 에이전트에 붙고, 내 PC에서 내 키와 Claude Pro/Max 로그인으로 돌아요.
이게 불편했어요
에이전트에게 버그 하나를 물으면 원인 한 줄에 인사, 설명, 정리가 붙어 길게 돌아와요. 테스트 출력이나 로그를 읽힐 때는 수만 토큰이 그대로 모델에 들어가서, 같은 일을 해도 한도가 빨리 닳았어요.
그래서 이렇게 풀어요
caveman은 두 곳을 줄여요. 답은 결론부터 한 문장에 한 가지씩 말하게 하되, 코드와 경로, 오류 문구, not 같은 부정어는 글자 그대로 남겨요. 에이전트가 읽는 로그, JSON, CSV, 테스트 출력은 모델로 가기 전에 내 PC의 프록시가 줄이고, 원본은 디스크에 남아 에이전트가 언제든 다시 꺼내 볼 수 있어요.

이걸로 만든 사람들

caveman 방식을 Elasticsearch용 에이전트 스킬 elastic-caveman으로 다시 만들어, 실제 MCP 시나리오에서 응답 토큰이 얼마나 줄었는지 쟀어요.
The findings: 63.6% average token reduction, 817 tokens saved, and zero loss of technical accuracy.

프롬프트 24개를 claude -p로 돌려 caveman 세 강도와 'Be brief.' 두 단어를 비교했어요. 4월 버전 기준으로 토큰과 품질은 비슷했고, 남는 장점은 일정한 답 형식과 세션 중에 바꾸는 강도라고 봤어요.
The two-word prompt matched it on tokens and quality.
Spatie 개발자가 매일 코딩에 caveman을 써 보고, 토큰은 작업에 따라 5~20% 정도 줄었으며 작고 익숙한 작업에서 가장 쓸모 있었다고 적었어요.
Yes. But not as much as I expected or wanted to.
안에서는 이렇게 돌아가요
- 1
나 → caveman CLI
npx @caveman-ai/cli@latest찾은 에이전트와 로그인, 설치가 할 일을 한 화면에 보여 주고, 내가 계속을 누르기 전에는 아무것도 쓰지 않아요.packages/cli/src/modules/onboard.ts - 2
caveman CLI → Claude Code
ANTHROPIC_BASE_URL을 로컬 프록시로Claude Code는 환경 변수로 요청 주소만 바꿔 붙이고, 스킬은 ~/.claude/skills에 넣어요.agents/profiles/claude.json - 3
caveman SKILL.md → Claude Code
답 먼저, 코드·경로·오류는 글자 그대로인사와 정리는 빼고 한 문장에 한 가지만 말해요. 보안 경고나 되돌릴 수 없는 일 앞에서는 다시 완전한 문장으로 말해요.plugins/caveman/skills/caveman/SKILL.md - 4
Claude Code → caveman 로컬 프록시
tool_result에 실린 로그·JSON·테스트 출력프록시가 요청에서 아직 캐시되지 않은 최신 부분의 도구 결과만 골라 줄일 후보로 모아요.proxy/providers/anthropic/content_compress.go - 5
caveman 로컬 프록시 → 짧은 답과 줄어든 토큰
형식별 압축기로 줄인 요청로그, JSON, 표 같은 형식마다 압축기가 따로 있어요. README 기준 CSV 한 파일이 28,041토큰에서 314토큰이 돼요.engine/compressors/log.go - 6
caveman CLI → 짧은 답과 줄어든 토큰
caveman stats프록시가 기록한 토큰과 비용을 기간, 모델, 에이전트별로 묶어 오프라인 HTML 보고서로 보여 줘요.packages/cli/src/stats-cli.ts
넣으면 이렇게 나와요
나한테 맞을까요
이럴 때 좋아요
- 구독 한도나 API 비용이 빨리 닳는데 에이전트 답이 길다고 느낄 때
- 로그, CSV, 테스트 출력을 에이전트에게 자주 읽히는 작업
- Claude Code, Codex, Gemini CLI를 섞어 쓰면서 설정은 한 번에 하고 싶을 때
- 설명보다 바뀐 코드를 먼저 보고 싶은 익숙한 작은 작업
이건 안 돼요
- README 기준 '간결하게' 위로 /caveman은 중앙값 3%, /ultracave는 35%를 더 줄였고, 규칙이 입력 토큰 약 1,160개를 써요. 요청 수로 값을 매기는 GitHub Copilot에선 아끼는 게 없어요.
- HTML은 아직 압축기가 없어 세션 토큰이 9.9% 늘었어요. 세션 측정은 2026년 8월의 이전 엔진 기준이에요.
- CLI는 기본으로 사용 통계(토큰 수, 설치 ID, OS, IP)를 보내요. 프롬프트와 코드는 보내지 않고, DO_NOT_TRACK=1로 끌 수 있어요.
- Apache-2.0이라 회사도 쓰고 고치고 호스팅할 수 있어요. 다만 'Caveman' 이름과 바위 로고는 Julius Brussee의 상표예요.
발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요