工具介绍
它是做什么的
caveman 是一个面向终端编程 Agent(如 Claude Code、Codex、Gemini CLI、OpenCode 等)的「省 Token」工具集。项目自述的核心思路是:让 Agent 输出更短的答复、读取压缩后的日志与文件内容,从而减少每次请求消耗的 Token 与费用。按官方 README 描述,安装后它会自动识别机器上已有的 Agent 和登录状态,并接入到这些 Agent 上。
需要说明的是,本页面整理自项目 README、发行说明与许可证文件,站内未做独立实测,所有性能与节省比例均为项目方或第三方论文/博客的自述数据,见下方「待核查」。
主要功能(按官方说明)
- 精简输出(Caveman voice):要求 Agent 先给结论、句子短、代码与命令保持原样,以减少回复长度。命令如
/caveman、/ultracave、/megacave对应不同精简强度。 - 压缩输入:对日志、CSV、JSON、YAML、测试输出等做压缩后再交给模型;原始文件保留在本地磁盘,Agent 可按需取回。
- Auto 自动选模型:登录后,在 Agent 的模型选择器中出现 Auto 选项,由 caveman 按任务难度选择模型与推理强度(此功能需要账号)。
- Blocks 代码模式:把 Agent 反复编写的脚本沉淀为仓库内可复用的「块」(官方标注为预发布状态,仅支持 Python,暂无沙箱)。
- 其他辅助:
caveman stats/caveman learn查看 Token 去向,caveman browse抓取压缩后的网页,caveman-compress压缩CLAUDE.md一类记忆文件并备份,以及面向开发者的中间件(TypeScript / Python)与 Caveman Cloud 观测与评测服务。
适用人群
- 每天在终端里用 AI 写代码、按 Token 或按调用量付费,想压低账单个的开发者;
- 需要让 Agent 读大段日志、测试输出、JSON 数据的调试与排障场景;
- 同时使用多个编程 Agent、希望统一配置精简策略的团队;
- 想研究「输出精简对成本影响」这一方向的工程与研究人员。
不适合:完全不使用终端 Agent 的人;对回复措辞有正式文档要求、不能接受极简表达的对外交付场景。
环境门槛
- 需要 Node.js 22.13+(README 的安装说明);项目仓库
package.json中安装器自述的 engines 为 node >= 18,两处表述不一致,实际要求以最新 INSTALL.md 为准(待核查)。 - 官方称支持 Mac、Linux、Windows(Windows 提供 PowerShell 5.1+ 脚本);各平台与各 Agent 版本的实际兼容情况待核查。
- 需要有可用的模型服务凭据:自带的 API Key、Claude Pro/Max 登录或 ChatGPT 登录等。
安装与使用(摘自项目文档,未在站内复现)
- 命令行安装(README 给出的方式):
npx @caveman-ai/cli@latest - 只想要精简输出技能、不要代理层:
npx skills add JuliusBrussee/caveman -g - 安装后可用的常用命令包括
caveman status、caveman on browse、caveman login、caveman learn、caveman doctor等;Agent 内可用/caveman、/caveman-review、/caveman-commit等斜杠命令。 - 卸载方式与各 Agent 的详细安装矩阵见仓库
INSTALL.md;以上命令与参数请以官方文档最新版本为准,不要直接照搬旧版本博客。
费用
- 项目本体以 Apache-2.0 开源,可自行阅读、修改、部署;仓库另含
LICENSE-MIT、NOTICE、LICENSING.md等文件,第三方组件与历史版本授权需以这些文件为准(待核查)。 - 使用 Agent 本身产生的 Token 费用仍由你向模型提供商支付;caveman 自称可使用你已有的订阅或 Key。
- Auto 功能需要注册免费账号;Caveman Cloud 的免费额度、付费方案与定价未在本页核实,标为待核查。
- 官方提醒:在按请求计费的部分渠道(如 GitHub Copilot)下,回复变短不一定省钱,因为规则本身也占用输入 Token。
隐私与数据
按 README 的隐私说明(原文自述,未经本站验证):
- 单独安装的技能在本地运行、不上传数据,但
/caveman-compress会把待压缩文件发送给你配置的模型提供商。 - CLI 默认上报使用统计(命令、Token 数、随机安装 ID、操作系统、IP 等),可用
caveman telemetry off或DO_NOT_TRACK=1关闭。 - 登录并使用 Auto 后,最近的提问、部分上下文与请求元信息会发送到 Caveman Cloud;免费方案下可能保留用于改进路由,可用
caveman off routing停止。
涉及内部代码或敏感数据的团队,建议在启用前自行审阅 SECURITY.md,并先在小范围项目试用。
国内使用注意事项(待核查)
- 安装依赖 npm 源与 GitHub 下载,网络可达性与镜像配置需自行确认。
- Auto、Caveman Cloud 等在线功能依赖境外服务,可用性与合规性待核查。
- 底层模型服务(Claude、ChatGPT、Gemini 等)在境内的调用条件与账号要求,请按各自服务条款自行确认。
待核查事项
- 各类节省比例(输入 Token 减少、成本下降、任务通过率等)均来自项目自述或其引用的第三方研究,本站未复现;README 自身也标注了部分数据为阶段性结果、存在误差区间与反例。
- 声称的第三方论文、厂商博客与榜单排名未逐条核实。
- 各 Agent 版本兼容列表、Blocks 的预发布状态、Windows 支持细节会随版本变化。
- 许可证与商标:「Caveman」名称与岩石图标为作者商标,仓库另有 LICENSE-MIT 与第三方声明,商用与再分发前请自行阅读 LICENSE / LICENSING.md / TRADEMARKS.md。
- 站内未做安装、功能与安全测试,不构成推荐或效果承诺。
版权与来源
项目作者与维护者为 Julius Brussee(仓库 JuliusBrussee/caveman),本页为中文整理稿,非官方中文文档。内容依据仓库 README、v4.1.0 发行说明与 Apache-2.0 许可证文本整理。
来源与加工说明
来源:https://github.com/JuliusBrussee/caveman
许可证:Apache-2.0
依据 GitHub 原始资料由 AI 整理的中文待审核草稿,未经本站实测。原始版权与许可归原作者;未声明许可不代表允许转载或再分发。
来源类型:GitHub;授权范围待核验
运行与适配
如何理解使用难度?
- 直接使用:通常打开网页或登录账号即可使用。
- 简单配置:需要填写密钥、连接服务或导入配置。
- 需要部署:需要安装依赖、配置运行环境或自行部署。
- 技术开发:需要编程、接口集成或开发调试。
格数越多,使用门槛越高;具体要求请看下方说明。
国内可用性待核验
访问来源 ↗国内使用情况与网友核验
网友核验 用户经验分享
与站长实测独立,不代表官方认证或本站已实测。
最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。
分项统计、有效期与样本量
| 核验项目 | 有效人数 | 成功 / 部分 / 失败 / 无法判断 | 成功率 | 最近核验 / 有效期 |
|---|---|---|---|---|
| 官方网站访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| GitHub 仓库访问 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 安装与运行 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 官方服务国内连接 / MCP 连接 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 国内网络情况 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 7 天 |
| 国内模型兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 自定义 API | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外服务依赖 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 海外账号要求 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 中文界面 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 客户端兼容性 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
| 账号及费用信息 | 0 | 0 / 0 / 0 / 0 | 样本不足 | 暂无 / 30 天 |
成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。
最近有效核验
暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。
查看全部有效核验 →