Caveman首次使用指南：如何在Claude Code中省掉65%输出token？附真实基准数据-平芜编程栈

Caveman首次使用指南：如何在Claude Code中省掉65%输出token？附真实基准数据

【免费下载链接】caveman🪨 why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman

Caveman是一款专为 Claude Code 打造的开源 token 压缩 skill，核心目标只有一个：让你的 AI 像"原始人"一样用最少的话说同样的事，平均砍掉65% 的输出 token。它不动代码、命令和报错原文，只压缩啰嗦的解释性文字，让你读得更省力、响应更快、账单更低。本文带你从零完成安装、激活、模式切换，并附上可复现的真实基准数据。

🦴 一句话心智模型：少用 token，也能把活干对。

Caveman 是什么：为什么你的 AI 回复在白白烧 token

你问一句"我的 React 组件为什么重复渲染"，普通 agent 会先客套、再铺垫、再给方案，动辄上百个 token。Caveman 把这些"填充词"删掉，但技术细节一个不丢：

场景	普通回复	Caveman 回复
React 重复渲染	"很高兴帮你！这个组件重新渲染很可能是因为你在每次渲染时都创建了新的对象引用……建议用`useMemo`……"（69 token）	"New object ref each render. Inline object prop = new ref = re-render. Wrap in`useMemo`."（19 token）

同一张问题、同样的答案，token 直接缩到原来的四分之一：

这种"少字不少料"的压缩，就是 Caveman 省输出 token 的全部秘密——skills/caveman/SKILL.md 里写明了规则：删掉冠词、客套、语气词，保留技术术语、代码块、命令与报错原文。

一分钟安装 Caveman：Claude Code 最快配置步骤

Caveman 支持 30+ 种 agent，但 Claude Code 是它最"原生"的家，支持自动激活。二选一即可。

方式一 · 插件安装（官方路径，自动激活）

在终端执行：

claude plugin marketplace add JuliusBrussee/caveman && claude plugin install caveman@caveman

装完重启 Claude Code，它会自动进入 Caveman 模式，无需额外操作。这是大多数人的首选，完整矩阵见 INSTALL.md。

方式二 · 手动 clone 安装（想先看代码的人）

git clone https://gitcode.com/GitHub_Trending/caveman1/caveman cd caveman node bin/install.js --dry-run --all # 先预览要执行的所有命令 node bin/install.js --all # 确认后正式安装

--dry-run会打印全部命令却不落盘，安全可重复执行。安装器不联网回传、不碰你的提示词与文件路径，细节见 SECURITY.md。

首次使用：用 /caveman 切换压缩强度

装好后，Caveman 默认是full强度。想更松或更紧，直接输入命令即可：

/caveman lite # 去掉填充词，保留完整句子（专业但紧） /caveman full # 默认：去冠词、可用短句 /caveman ultra # 极致压缩，一个词能说清就一个词 /caveman off # 或说 "normal mode"，恢复正常

各强度的差别一览（源自 skills/caveman/SKILL.md）：

强度	改动程度
lite	去填充/犹豫，保留冠词与完整句，专业紧凑
full	去冠词、可用片段，经典原始人风格
ultra	去掉可省的连词，一词足矣，但绝不缩写技术名

⚠️ 注意一个聪明设计：遇到安全警告、不可逆操作、易误读的多步序列时，Caveman 会自动切回正常措辞，答完再继续压缩——省 token 但不牺牲正确性。

真实基准数据：65% 输出 token 省是怎么测的

README 里的官方基准表覆盖 10 个真实开发任务，逐任务对比"普通 vs Caveman"的 token 数：

任务	普通	Caveman	省下
解释 React 重渲染 bug	1180	159	87%
修复鉴权中间件 token 过期	704	121	83%
搭建 PostgreSQL 连接池	2347	380	84%
解释 git rebase vs merge	702	292	58%
重构回调为 async/await	387	301	22%
微服务 vs 单体架构	446	310	30%
安全视角 review PR	678	398	41%
Docker 多阶段构建	1042	290	72%
排查 PostgreSQL 竞态	1200	232	81%
实现 React 错误边界	3454	456	87%
平均	1214	294	65%

数据可离线复现：评测快照在 evals/snapshots/results.json，测量脚本为 evals/measure.py，在线复跑用 benchmarks/run.py。

诚实提醒（官方 docs/HONEST-NUMBERS.md 明说）：65% 是输出 token的降幅，输入/推理 token 不受影响，且 skill 本身每轮会新增约 1–1.5k 输入 token。所以整段会话的真实省幅会小于 65%，在"本来就短"的任务上甚至可能净亏。真正的收益是可读性与响应速度，省费是附赠。

进阶省钱：用 Caveman 代理再砍 33.2% 输入 token

省输出是 skill 的活；省输入是另一套本地代理（Caveman Proxy）的活。一条命令包裹你的 agent，让它在每次调用前把"读进去的内容"先压缩：

npm install -g @caveman-ai/cli && caveman setup --install caveman claude # 或 codex · gemini · aider · opencode · hermes · openclaw

官方固定基准（54 次运行）显示，包裹后的 Claude Code 比直连少用 33.2% 的输入 token，且 18/18 精确答案全过，详见 docs/WRAP-BENCHMARK.md。引擎按内容类型分流压缩：

检测类型	保留什么	目标省幅
JSON	键、结构、error/message 子树，折叠重复数组	70–90%
日志	错误、堆栈、首尾行，丢掉 INFO/进度噪声	85–95%
代码	import、签名、类型；省略函数体但语法仍合法	40–70%
diff	文件/hunk 头与变更行	60–80%
搜索结果	首尾命中 + 诊断/安全命中	80–95%

压缩是字节级可恢复的：原始内容留在你本地磁盘，需要时一行取回，代理不经过任何 Caveman 后端。

动手验证你的省 token 效果

别只看别人的数字，验证三步走：

/caveman-stats # Claude Code 内：读会话日志，打印真实输出/缓存计数 caveman learn # 扫描你本地真实 agent 历史，给出 Cave Score + token 黑洞排行 caveman learn implement # 把整改计划交给你的 agent，逐项 diff、你点头才改

caveman learn会本地、只读地分析你几个月积累的会话，按"流"给每个 token 黑洞排序并附一行修法，还能回放"如果早装 Caveman，过去这些会话本可以省多少"。报告长这样：

caveman learn完全本地运行、无需账号。若你的 A/B 对比显示净亏，官方建议直接对那类任务/caveman off——不硬撑数字。

常见问题：什么时候该关掉 Caveman

它让答案变短，但会不会答错？不会。代码块、命令、报错字符串、技术术语都逐字保留，not/never/no这类会翻义词严禁删。

按请求计费（如 Copilot 额度）能省吗？不能。短回答=同一次请求，省的是 token 不是次数。

多开窗口时，一个开了一个没开？故意的。模式按窗口独立，在哪个窗口想用就在哪个窗口输入/caveman。

想彻底卸载？一条命令清干净 hooks、插件与状态文件，见 INSTALL.md 的 Uninstall 章节。

总结：Caveman 是 Claude Code 里"少字不少料"的 token 压缩方案——skill 省 65% 输出、代理再省 33.2% 输入，全程本地、代码与报错逐字保真。安装一行命令，/caveman一句切换，/caveman-stats一句验证，就能把 agent 说得省、读得快、花得少。