AI 칼럼

코딩@donghyeok99운영진

caveman: 코딩 에이전트가 덜 말하고 덜 읽게 하는 도구

에이전트 답을 원시인 말투로 줄여요. 같은 React 버그 설명이 63토큰에서 20토큰이 돼요

/caveman 뒤로 바위가 떨어지면 긴 답이 useMemo 한 줄로 줄어 63토큰이 20토큰이 되고, 로그 더미 같은 28,041토큰짜리 CSV는 314토큰으로 눌려요.
/caveman 뒤로 바위가 떨어지면 긴 답이 useMemo 한 줄로 줄어 63토큰이 20토큰이 되고, 로그 더미 같은 28,041토큰짜리 CSV는 314토큰으로 눌려요.
누가
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 learn 보고서: 토큰이 가장 많이 가는 곳과 고칠 방법 하나
caveman learn 보고서: 토큰이 가장 많이 가는 곳과 고칠 방법 하나

이걸로 만든 사람들

elastic.coSri Kolagani2026-04-29

caveman 방식을 Elasticsearch용 에이전트 스킬 elastic-caveman으로 다시 만들어, 실제 MCP 시나리오에서 응답 토큰이 얼마나 줄었는지 쟀어요.

The findings: 63.6% average token reduction, 817 tokens saved, and zero loss of technical accuracy.
maxtaylor.meMax Taylor2026-04-29

프롬프트 24개를 claude -p로 돌려 caveman 세 강도와 'Be brief.' 두 단어를 비교했어요. 4월 버전 기준으로 토큰과 품질은 비슷했고, 남는 장점은 일정한 답 형식과 세션 중에 바꾸는 강도라고 봤어요.

The two-word prompt matched it on tokens and quality.
spatie.beMarceli Wilczynski2026-05-06

Spatie 개발자가 매일 코딩에 caveman을 써 보고, 토큰은 작업에 따라 5~20% 정도 줄었으며 작고 익숙한 작업에서 가장 쓸모 있었다고 적었어요.

Yes. But not as much as I expected or wanted to.

안에서는 이렇게 돌아가요

  1. 1

    나 → caveman CLI

    npx @caveman-ai/cli@latest찾은 에이전트와 로그인, 설치가 할 일을 한 화면에 보여 주고, 내가 계속을 누르기 전에는 아무것도 쓰지 않아요.packages/cli/src/modules/onboard.ts
  2. 2

    caveman CLI → Claude Code

    ANTHROPIC_BASE_URL을 로컬 프록시로Claude Code는 환경 변수로 요청 주소만 바꿔 붙이고, 스킬은 ~/.claude/skills에 넣어요.agents/profiles/claude.json
  3. 3

    caveman SKILL.md → Claude Code

    답 먼저, 코드·경로·오류는 글자 그대로인사와 정리는 빼고 한 문장에 한 가지만 말해요. 보안 경고나 되돌릴 수 없는 일 앞에서는 다시 완전한 문장으로 말해요.plugins/caveman/skills/caveman/SKILL.md
  4. 4

    Claude Code → caveman 로컬 프록시

    tool_result에 실린 로그·JSON·테스트 출력프록시가 요청에서 아직 캐시되지 않은 최신 부분의 도구 결과만 골라 줄일 후보로 모아요.proxy/providers/anthropic/content_compress.go
  5. 5

    caveman 로컬 프록시 → 짧은 답과 줄어든 토큰

    형식별 압축기로 줄인 요청로그, JSON, 표 같은 형식마다 압축기가 따로 있어요. README 기준 CSV 한 파일이 28,041토큰에서 314토큰이 돼요.engine/compressors/log.go
  6. 6

    caveman CLI → 짧은 답과 줄어든 토큰

    caveman stats프록시가 기록한 토큰과 비용을 기간, 모델, 에이전트별로 묶어 오프라인 HTML 보고서로 보여 줘요.packages/cli/src/stats-cli.ts

넣으면 이렇게 나와요

React 컴포넌트가 왜 계속 다시 렌더링돼요? (보통 답 63토큰)New object ref each render, so React re-renders. Wrap the prop in `useMemo`. (20토큰)
28,041토큰짜리 CSV 파일caveman을 거쳐 314토큰 (README 기준)
go test -v ./... 326개 테스트 출력, 10,561토큰test-summary 블록으로 76토큰 (README 기준, 블록은 정식 출시 전)
/caveman-commit한 줄짜리 Conventional Commit 메시지

나한테 맞을까요

이럴 때 좋아요

  • 구독 한도나 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 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기