返回列表

caveman|给编程 Agent 省 Token 的精简输出技能与代理

caveman 让编程 Agent 少说少读、压缩日志与网页等上下文来降低 Token 消耗,并提供按任务自动选模型的代理层,适合常用 Claude Code、Codex 等终端 Agent 写代码、想压低调用成本的人。

Agent SkillsAgent SkillCodexClaude CodeGemini CLI提示词工程成本优化Token 压缩编程 Agent本地代理Apache-2.0站长实测状态尚未登记

工具介绍

它是做什么的

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 等)在境内的调用条件与账号要求,请按各自服务条款自行确认。

待核查事项

  1. 各类节省比例(输入 Token 减少、成本下降、任务通过率等)均来自项目自述或其引用的第三方研究,本站未复现;README 自身也标注了部分数据为阶段性结果、存在误差区间与反例。
  2. 声称的第三方论文、厂商博客与榜单排名未逐条核实。
  3. 各 Agent 版本兼容列表、Blocks 的预发布状态、Windows 支持细节会随版本变化。
  4. 许可证与商标:「Caveman」名称与岩石图标为作者商标,仓库另有 LICENSE-MIT 与第三方声明,商用与再分发前请自行阅读 LICENSE / LICENSING.md / TRADEMARKS.md。
  5. 站内未做安装、功能与安全测试,不构成推荐或效果承诺。

版权与来源

项目作者与维护者为 Julius Brussee(仓库 JuliusBrussee/caveman),本页为中文整理稿,非官方中文文档。内容依据仓库 README、v4.1.0 发行说明与 Apache-2.0 许可证文本整理。

来源与加工说明

来源:https://github.com/JuliusBrussee/caveman

许可证:Apache-2.0

依据 GitHub 原始资料由 AI 整理的中文待审核草稿,未经本站实测。原始版权与许可归原作者;未声明许可不代表允许转载或再分发。

来源类型:GitHub;授权范围待核验

运行与适配

使用难度
如何理解使用难度?
  • 直接使用:通常打开网页或登录账号即可使用。
  • 简单配置:需要填写密钥、连接服务或导入配置。
  • 需要部署:需要安装依赖、配置运行环境或自行部署。
  • 技术开发:需要编程、接口集成或开发调试。

格数越多,使用门槛越高;具体要求请看下方说明。

国内可用性待核验

访问来源 ↗

国内使用情况与网友核验

网友核验 用户经验分享

与站长实测独立,不代表官方认证或本站已实测。

我要核验
0 位参与者0 份有效分项记录

最近核验:暂无有效核验。参与人数按当前项目有效身份去重;不同核验项分别统计,不合并成用户总结果。仅统计审核通过且未过期的记录。

分项统计、有效期与样本量
核验项目有效人数成功 / 部分 / 失败 / 无法判断成功率最近核验 / 有效期
官方网站访问00 / 0 / 0 / 0样本不足暂无 / 7 天
GitHub 仓库访问00 / 0 / 0 / 0样本不足暂无 / 7 天
安装与运行00 / 0 / 0 / 0样本不足暂无 / 30 天
官方服务国内连接 / MCP 连接00 / 0 / 0 / 0样本不足暂无 / 30 天
国内网络情况00 / 0 / 0 / 0样本不足暂无 / 7 天
国内模型兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
自定义 API00 / 0 / 0 / 0样本不足暂无 / 30 天
海外服务依赖
00 / 0 / 0 / 0样本不足暂无 / 30 天
海外账号要求
00 / 0 / 0 / 0样本不足暂无 / 30 天
中文界面
00 / 0 / 0 / 0样本不足暂无 / 30 天
客户端兼容性00 / 0 / 0 / 0样本不足暂无 / 30 天
账号及费用信息
00 / 0 / 0 / 0样本不足暂无 / 30 天

成功率 = 成功 ÷(成功 + 部分成功 + 失败);无法判断不计入分母。至少 5 份可判断结果才显示成功率。账号、费用、海外依赖与语言等事实项,成功表示核查结论与资料吻合,具体观察另行统计;不表示免费或没有海外依赖。不同网络、客户端和版本的结果不能直接等同。

最近有效核验

暂无审核通过且未过期的网友核验。欢迎提交真实使用记录。

查看全部有效核验 →

反馈此内容的问题