JuliusBrussee/caveman
요약
Claude Code를 포함한 30개 이상의 AI 에이전트에서 출력 토큰을 최대 75% 절감할 수 있는 'caveman' 스킬/플러그인입니다. 기술적 정확도를 유지하면서 불필요한 설명을 압축하여 비용을 줄이고 효율성을 높입니다.
핵심 포인트
- 출력 토큰을 약 75% 절감하여 비용 효율성 극대화
- lite, full, ultra, wenyan 등 다양한 압축 레벨 제공
- MCP 미드웨어 및 커밋/리뷰 전용 명령어 지원
- 기술적 정확도는 100% 유지하며 핵심 정보만 전달
몇 개의 토큰으로 충분할 때 왜 많이 사용하는가
Before/After • 설치 • 제공 기능 • 벤치마크 • 전체 설치 가이드
에이전트(Agent)가 원시인(Caveman)처럼 말하게 만드는 Claude Code 스킬/플러그인 (Codex, Gemini, Cursor, Windsurf, Cline, Copilot 등 30개 이상의 도구 포함). 출력 토큰(Output tokens)을 약 75% 절감하면서도 기술적 정확도는 그대로 유지합니다. 뇌는 여전히 크지만, 입은 작아집니다.
|
|
|
|
동일한 해결책. 단어는 75% 감소. 뇌는 여전히 큼.
┌─────────────────────────────────────┐
│ 절약된 토큰(TOKENS SAVED) ████████ 75% │
│ 기술적 정확도(TECHNICAL ACCURACY) ████████ 100%│
...
원하는 원시인 수준을 선택하세요 — lite
(불필요한 말 제거), full
(기본 원시인 모드), ultra
(전보식), 또는 wenyan
(고전 한문 스타일, 훨씬 더 짧음). 명령어 하나로 전환 가능. 비용이 영원히 내려갑니다.
|
이 스킬은 에이전트가 사용하는 것을 축소합니다: npm install -g @juliusbrussee/caveman-code
|
한 줄이면 됩니다. 모든 에이전트를 찾으세요. 각각 설치하세요.
# macOS / Linux / WSL / Git Bash
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash
# Windows (PowerShell 5.1+)
...
약 30초 소요. Node ≥18 버전이 필요합니다. 사용하지 않는 에이전트는 건너뛰세요. 다시 실행해도 안전합니다.
트리거(Trigger): /caveman 입력
또는 "talk like caveman"이라고 말하세요. "normal mode"라고 말하면 중단됩니다.
단일 에이전트, 수동 명령어, 또는 30개 이상의 다른 에이전트 중 무엇이든 → INSTALL.md.
설치가 실패했나요? 에이전트를 열고, *"Read CLAUDE.md and INSTALL.md, install caveman for me."*라고 말하세요. 에이전트가 스스로 문제를 해결할 것입니다.
| 기술 (Skill) | 내용 |
|---|---|
| `/caveman [lite | full |
/caveman-commit | Conventional Commit 메시지를 생성하며, 제목은 50자 이하로 제한합니다. '무엇(what)'보다 '왜(why)'에 집중합니다. |
/caveman-review | 한 줄 형태의 PR (Pull Request) 코멘트를 작성합니다: L42: 🔴 bug: user null. Add guard. |
/caveman-stats | 실제 세션 토큰 사용량 + 누적 절감량 + USD(달러) 가치를 보여줍니다. --share 옵션을 통해 트윗 가능한 한 줄 문구를 생성합니다. |
/caveman-compress <file> | 메모리 파일(예: CLAUDE.md)을 caveman-speak(원시인 화법)로 다시 작성합니다. 매 세션마다 입력 토큰을 약 46% 절감합니다. 코드/URL/경로는 바이트 단위로 보존됩니다. |
caveman-shrink | MCP (Model Context Protocol) 미들웨어입니다. 모든 MCP 서버를 래핑(wrap)하여 도구 설명을 압축합니다. npm을 통해 제공됩니다. |
cavecrew-* | Caveman 서브 에이전트들 (investigator/builder/reviewer). 일반적인 에이전트보다 토큰을 약 60% 적게 사용하며, 메인 컨텍스트(main context)를 더 오래 유지합니다. |
상태 표시줄 배지 (Statusline badge) — Claude Code에 [CAVEMAN] ⛏ 12.4k가 표시됩니다.
(누적 절감 토큰량). /caveman-stats를 실행할 때마다 업데이트됩니다. 표시를 원치 않으면 CAVEMAN_STATUSLINE_SAVINGS=0으로 설정하세요.
매 세션 자동 활성화: Claude Code, Codex, Gemini (내장됨). Cursor / Windsurf / Cline / Copilot은 --with-init을 통해 항상 켜져 있는 규칙 파일(rule files)을 적용받습니다. 기타 에이전트들은 세션당 /caveman 명령어로 트리거합니다. 전체 기능 매트릭스는 INSTALL.md에서 확인할 수 있습니다.
Claude API의 실제 토큰 수를 기준으로 합니다. 10개의 프롬프트에 걸쳐 평균 65%의 출력 감소를 기록했습니다 (범위 22-87%).
| 작업 (Task) | 일반 (Normal) | Caveman | 절감량 (Saved) |
|---|---|---|---|
| React 리렌더링 버그 설명 | 1180 | 159 | 87% |
| ... | 평균 (Average) | 1214 | 294 |
원시 데이터 및 재현 스크립트: benchmarks/. 세 가지 방식의 평가 하네스 (baseline / terse / skill)는 evals/에 위치합니다. — caveman은 장황한 기본 설정(verbose default)이 아닌 Answer concisely.(간결하게 답변하라)와 비교되었으므로, 그 차이는 정직합니다.
caveman-compress 영수증 (실제 메모리 파일):
| 파일 | 원본 | 압축됨 | 절약됨 |
|---|---|---|---|
claude-md-preferences.md | 706 | 285 | 59.6% |
project-notes.md | 1145 | 535 | 53.3% |
claude-md-project.md | 1122 | 636 | 43.3% |
todo-list.md | 627 | 388 | 38.1% |
mixed-with-code.md | 888 | 560 | 36.9% |
| 평균 | 898 | 481 | 46% |
중요 사항
Caveman은 출력 토큰 (output tokens)에만 영향을 미치며, 사고/추론 토큰 (thinking/reasoning tokens)은 건드리지 않습니다. Caveman은 뇌를 작게 만드는 것이 아닙니다. Caveman은 입을 작게 만듭니다. 가장 큰 이점은 **가독성 (readability) 및 속도 (speed)**이며, 비용 절감은 보너스입니다.
2026년 3월 논문인 "Brevity Constraints Reverse Performance Hierarchies in Language Models"에 따르면, 대규모 모델에 간결한 응답 제약을 가했을 때 특정 벤치마크에서 정확도가 26포인트 향상되었다는 사실이 밝혀졌습니다. 장황함이 항상 더 나은 것은 아닙니다. 때로는 단어가 적을수록 더 정확합니다.
- 에이전트(agent)에 스킬 드롭(drop skill) 파일을 설치합니다.
- 스킬은 에이전트에게 다음과 같이 지시합니다: 불필요한 수식어(filler)를 버리고, 본질(substance)을 유지하며, 파편(fragments)을 사용하라.
- Claude Code의 경우, 각 세션마다 아주 작은 플래그(flag) 파일을 작성하도록 후크(hook)를 연결합니다. 에이전트는 이 플래그를 확인하고 첫 번째 메시지부터 Caveman 방식으로 말합니다.
/caveman이라고 말할 필요가 없습니다. . - Stats명령은 Claude Code 세션 로그를 읽어 절약된 토큰을 계산하고, 그 숫자를 상태 표시줄(statusline)에 기록합니다.Caveman-compress하위 스킬은 메모리 파일(CLAUDE.md, 프로젝트 노트 등)을 재작성하여 각 세션이 더 작은 컨텍스트 (context)로 시작할 수 있게 합니다. 단 한 번의 답변이 아니라 영구적으로 토큰을 절약합니다.
유지 관리자 상세 정보(후크 아키텍처, 파일 소유권, CI 동기화)는 CLAUDE.md에 실시간으로 업데이트됩니다.
OpenClaw는 셀프 호스팅 게이트웨이(self-host gateway)입니다. 하나의 박스 안에 여러 에이전트(Claude Code, Codex, Pi, OpenCode)가 들어 있으며, 사용자의 Slack / Discord / iMessage / Telegram / 기타 서비스와 연결됩니다. 슬로건: "The lobster way." (바닷가재 방식). 바닷가재는 강합니다. 바닷가재는 똑똑합니다. 바닷가재는 말도 아주 많습니다.
Caveman은 바닷가재에게 간결함을 가르칩니다 — 동일한 표준 설치 프로그램을 사용하며, 하나의 에이전트에만 적용됩니다:
# macOS / Linux / WSL
curl -fsSL https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.sh | bash -s -- --only openclaw
# Windows (PowerShell): Node가 없다면? 먼저 Node ≥18을 설치한 후
...
두 가지 일만 발생하며, 그 이상은 없습니다:
Skill drop이 ~/.openclaw/workspace/skills/caveman/SKILL.md에 위치합니다.
— spec-correct frontmatter (version
- INSTALL.md — 전체 설치 매트릭스 (install matrix), 모든 플래그 (flags), 에이전트별 상세 정보
- CONTRIBUTING.md — 패치 (patch) 전송 방법
- CLAUDE.md — 유지 관리자 가이드 (파일 소유권, 훅 아키텍처 (hook architecture), CI)
- docs/ — 추가 가이드 (Windows 설치 등)
- Issues — 버그 (bug), 기능 (feature), 이상 동작
Caveman은 토큰을 아껴주고, 돈을 아껴줍니다. 스타 (Star)를 누르는 데는 비용이 들지 않습니다. 공정한 거래입니다. ⭐
Revu— FSRS 간격 반복 (spaced repetition)을 지원하는 로컬 우선 (local-first) macOS 학습 앱. revu.cards
MIT — 탁 트인 평원의 거대한 매머스처럼 자유롭습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Trending All (daily)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기