Caveman 토큰 절약: AI 코딩 에이전트 설명만 줄이는 오픈소스 스킬
코딩 에이전트가 같은 처방인데 설명만 길게 쓰면, 출력 토큰과 요금이 같이 쌓입니다. Caveman(캐브맨)은 AI 코딩 에이전트가 설명 문장만 짧게 말하게 해 출력 토큰을 줄이는 깃허브 오픈소스입니다. 저장소는 JuliusBrussee/caveman, 라이선스는 Apache-2.0이며, 발행 시점(2026-10-03) GitHub API 기준 스타는 약 10.9만 개(109,095)입니다. 이 글은 README·공식 퀵스타트·인용된 Adobe·JetBrains 자료를 다시 확인한 사실만으로 설치법·수치·주의점을 정리합니다. 저장소 설명의 「65%」는 코딩 에이전트 스킬 단독 실측과 다르므로, 아래에서 출처별로 구분합니다.
한 줄로 켜기: 계정·API 키 없이 30+ 에이전트
공식 퀵스타트 기준, Claude Code 외 대부분 환경에서는 아래 한 줄로 스킬을 설치합니다.
npx skills add JuliusBrussee/caveman -g
-g는 사용자 스킬 디렉터리 전역 설치이고, 빼면 현재 프로젝트에만 설치합니다. 계정·API 키는 필요 없습니다. README·INSTALL 기준으로 Claude Code, Cursor, Codex, Gemini, Copilot 등 30+ 에이전트와 맞는다고 안내합니다. Claude Code는 플러그인 설치도 지원합니다. 에이전트가 바로 반응하지 않으면 세션에서 /caveman을 치고, /caveman lite·/caveman ultra로 강도를 바꿀 수 있습니다(기본은 full).
쇼츠로 1분 요약 보기 → https://youtu.be/p7do1qww5LQ
무엇이 줄고 무엇이 안 줄어드나
README See-it 예시는 같은 useMemo 처방에서 Normal agent 69 토큰 → Caveman agent 19 토큰입니다. 진단·수정 내용은 같고, 장황한 설명만 사라집니다. 중요한 한계도 공식에 명시돼 있습니다. 코드·명령·파일 경로·정확한 에러 문자열은 caveman 대상이 아니며, 보안 경고·확인 질문은 완전한 문장으로 돌아옵니다. 스킬은 에이전트가 말하는 쪽(출력 산문)을 줄이는 「small rock」이고, 로그·JSON·디프 등 읽는 쪽을 줄이는 proxy·middleware는 별도 구성입니다. 이 글의 설치·실측 수치는 우선 스킬 기준입니다.
AI 도구·운영 사이트 모음 한곳에서 보기 → 나두AI 링크 허브
수치를 출처별로 읽기 (65% 오해 방지)
저장소 설명·일부 헤드라인에는 「cuts 65% of tokens」가 나오지만, 코딩 에이전트 스킬만의 외부 실측은 이와 다릅니다.
- Adobe Research CAVEWOMAN(arXiv 2606.24083): 출력 쪽 caveman 스타일이 실현 비용을 모델별로 1.4~2.4배 줄이고, 최선 사례에서는 최대 3배까지 줄였다고 측정했습니다.
- JetBrains(2026-07, 86개 코딩 과제, 스킬만·proxy 이전): 출력 토큰 8.5% 감소, 품질 변화는 감지되지 않음(sign test p=0.82). 블로그 제목에 「Saves 65%」가 있어도, 스킬 단독 실측치는 8.5%입니다.
- README: 에이전트 코딩처럼 코드·툴 호출이 많은 세션에서는 스킬이 건드리지 않는 토큰이 많아, 체감 절감이 Q&A 예시(69→19)보다 작을 수 있다고 스스로 설명합니다. 스킬 문서 자체도 매 호출 입력 토큰을 쓰므로, 한 줄 질문에서는 절감보다 비용이 클 수 있습니다(퀵스타트 Limits).
proxy의 입력 토큰 벤치마크(예: 합계 −33.2%)는 별도 측정이며, 초보 설치 안내에서는 스킬과 섞지 않는 편이 안전합니다.
지금 해볼 체크리스트 (예시)
- 자주 쓰는 에이전트(Claude·Cursor 등)에
npx skills add JuliusBrussee/caveman -g로 스킬만 먼저 켜 보기 (예시) - 같은 질문을 켠 상태·끈 상태에서 한 번씩 물어 출력 길이를 비교하기 (예시)
- 코드·에러·경로가 그대로인지 확인한 뒤, 불필요하면
stop caveman또는npx skills remove caveman으로 되돌리기 (예시)
핵심 3줄 요약
- Caveman은 Apache-2.0 오픈소스로, 코딩 에이전트 설명만 짧게 줄여 출력 토큰을 아끼는 스킬입니다(스타 약 10.9만, 2026-10-03).
- 설치는
npx skills add JuliusBrussee/caveman -g한 줄이며 계정·API 키 없이 30+ 에이전트에 맞춘다고 안내합니다. - README 예시는 69→19 토큰, Adobe는 비용 1.4~2.4배(최대 3배), JetBrains 스킬 단독은 출력 8.5%·품질 변화 없음이며, 「65%」를 스킬 단독 실측으로 단정하지 않습니다.
함께 보면 좋은 글
출처
GitHub — JuliusBrussee/caveman (스타·라이선스·README, 2026-10-03 API 재확인)
Caveman Docs — Quickstart
Adobe Research — CAVEWOMAN (arXiv 2606.24083)
JetBrains — Speaking to AI Agents like Cavemen… We Test (2026-07)
이 글은 캐러셀 캡션을 그대로 옮기지 않고, GitHub·공식 문서·인용 연구로 재확인한 사실만으로 재구성한 큐레이션입니다. 체크리스트는 예시입니다.
AI 운영·도구 링크 더 보기 → 나두AI 링크 허브
댓글
댓글 쓰기