Caveman 编码代理省令牌工具
压缩代理读取的内容并缩短回复，减少编码代理会话中的令牌消耗。
- Star 数
- ★ 114k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- Go
- FA 评分
- 75/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude CodeClaude.ai · OpenAI API · Claude API（部分支持）
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 使用 Claude Code、Codex 或 Gemini CLI 的开发者，想在保持代码和命令原样的同时缩短代理解释。
- 不适合
- 要求所有内容始终留在本机的团队
- 不使用文档所列编码代理的开发者
- 需要稳定版 Blocks 代码模式的团队
- 源码审查
- 75/100 · 表现良好
这个 Agent 能做什么，适合哪些场景？
Caveman 是一个本机运行的 CLI，可为 Claude Code、Codex、Gemini CLI、OpenCode 等编码代理安装和管理多项令牌节省功能。它提供 /caveman 等技能来缩短回复，也可压缩日志、JSON、CSV 和测试输出，再交给代理读取。Auto 在登录后可按请求选择模型和推理力度；Blocks 则提供可复用脚本，减少重复编写和读取脚本的工作。主安装流程需要 Node.js 22.13+，并通过终端配置本机代理；各功能可单独启停。CLI 默认发送使用统计，Auto 会把部分对话上下文发送到 Caveman Cloud，因此需要评估数据流向的团队应先了解隐私说明。
用户运行 npx @caveman-ai/cli@latest 启动安装程序，选择代理并查看变更，然后在终端用 caveman status 检查功能状态或用 caveman on、caveman off 切换功能。安装后，技能可通过 /caveman 缩短代理答复，保持代码、命令、路径和错误消息原样。输入压缩功能会在代理读取日志、JSON、CSV、YAML 或测试输出之前生成精简内容，原文件仍保留在磁盘。登录并选择 Auto 后，路由功能会根据请求选择模型和力度；Blocks 会检查重复脚本使用，并在已有脚本适用时提示使用对应 block。CLI 还支持 caveman learn 分析本机代理历史、caveman browse <url> 压缩网页，以及 caveman stats 查看令牌统计。
- 使用 Claude Code、Codex 或 Gemini CLI 的开发者，想在保持代码和命令原样的同时缩短代理解释。
- 经常把大型日志、JSON、CSV 或测试输出交给编码代理的工程师，想减少模型读取的输入量。
- 使用 Claude Code、OpenCode 或 Codex 的团队，想让 Auto 为不同请求选择模型和推理力度。
- 重复运行测试或处理 JSON 的开发者，想通过 Blocks 重用仓库中的小脚本。
- 使用 Vercel AI SDK、LangChain、OpenAI 或 Anthropic 调用的开发团队，想在现有调用中加入中间件压缩。
如何安装或部署这个 Agent？
主 CLI 安装需要 Node.js 22.13+。运行安装命令，按提示检查并确认配置变更；README 未要求主安装必须提供 API 密钥。Auto 需要免费账号，添加其他模型提供方时可配置自己的密钥。
npx @caveman-ai/cli@latest如何使用这个 Agent？
安装后先查看状态，再按需启用功能。直接启动代理时可用 caveman claude；也可以在已支持的代理中使用 /caveman。Auto 需先登录并在模型选择器中选择；添加 OpenAI 提供方为可选步骤。
caveman status
caveman on browse
caveman claudecaveman login
caveman providers add openai/caveman这个 Agent 有哪些优点和局限？
- 一个 CLI 可安装并管理 30 多种代理的支持配置，且可按功能开关。
- 技能规则要求代码、命令、路径和错误消息逐字保留，并允许安全警告或不可逆操作使用完整句子。
- README 报告 54 次 Claude Code 运行的会话输入令牌减少 33.2%，18 个回答全部正确，同时披露 HTML 场景变差及测试限制。
- 包含面向测试输出、JSON、日志等内容的压缩功能，也提供 TypeScript 和 Python 中间件。
- 主安装需要 Node.js 22.13+ 和终端操作。
- CLI 默认发送命令、令牌计数等使用统计；可通过
caveman telemetry off或DO_NOT_TRACK=1关闭。 - Auto 需登录，且会向 Caveman Cloud 发送最近请求及部分上下文；免费计划可能保留这些内容以改进路由。
- Blocks 标为预发布版本 v0.1.0-rc.5，仅支持 Python，且尚无沙箱。
- 部分基准使用旧引擎或尚未完成的任务集，README 明确指出结果可能因使用情况而异。
这个 Agent 与同类方案有什么区别？
README 将 /caveman、/ultracave 与 /megacave 的回复长度作比较，也报告了与无指令和 Answer concisely. 的对照结果；Auto 基准以 Opus 5.5、xhigh 推理力度为参照。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Caveman 编码代理省令牌工具 当前 | 75 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 114k | 今天 | Go | Codex · Claude Code |
| Code Abyss：编码助手人格与工程技能套件 | 66 · 存在缺口 | 命令行工具 | ★ 242 | 3 个月前 | JavaScript | Codex · Claude Code |
| OSpec | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 396 | 1 个月前 | JavaScript | Codex · Claude Code |
| Plannotator | 78 · 表现良好 | 命令行工具免费版 + 付费版 | ★ 9.6k | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
文件细致说明本地代理、云端路由、遥测、凭据、SSRF 与浏览器行为，并提供遥测关闭、显式路由开关及安全部署要求，因此数据流透明度较强。安装器会检测并展示改动、提供 dry-run，部分流程需用户确认；但默认遥测开启，Auto 会发送用户请求上下文，压缩也可能改变上下文，故最小权限、敏感数据处理和外部影响未满分。文档说明签名校验、备份与卸载恢复，但不同安装面仍有残留或依赖主机插件流程。作者署名及安全报告渠道清楚，发布者注册表身份未验证，且维护承诺属于目标而非 SLA。
文档较一致地描述组件、配置默认值、失败时回退和诊断命令；但依赖面广，安装需要 Node/npm、主机插件系统及部分下载的伴随二进制，且一些宿主的原生加载尚未核实。故依赖可用性仅部分支持。失败信息和安全回退有说明，但此静态材料不能证明实际运行表现。
覆盖多种编码代理、操作系统、本地与共享部署，以及技能单装、代理、SDK/中间件等场景；明确区分技能、运行时、云路由和压缩能力，也标注 Windows 与宿主验证边界。技能触发可自动或手动，需按宿主配置；边界清楚但并非每个场景都能确认原生自动调用。
README、安装矩阵、技术文档、安全说明、配置参考和安装/卸载示例较完整，限制、隐私和 Apache-2.0 许可证明确。版本与更新指南存在，但 README 中多种组件和版本并列，维护责任主要以单人维护及安全响应目标描述；注册表身份未知，不据此扣分。
示例展示回答压缩、输入压缩、路由和脚本复用的潜在用途，并披露若干负面或未测结果及基准限制。输出仍以自由文本为主，效益证据多为仓库自述，适用性、质量和节省会因工作负载及计费方式变化，因此价值与成本收益仅部分成立。
多项数字链接到方法、基准或外部研究，且明确标注未测、临时结果、推断边界及限制；外部证据仅在 README 中被引用，给定材料没有外部来源正文，也没有独立复核，故交叉印证有限。
- 默认启用的 CLI 遥测会发送使用事件及 IP；Auto 会将最近请求上下文发送到 Caveman Cloud，免费方案可能保留这些内容用于改进路由。启用前请按 SECURITY.md 核对数据范围，并在需要时关闭遥测或路由。
- 压缩和其他有损转换可能让模型看不到原始细节；对字节完整性敏感的流程应使用文档所述 record 模式。共享代理须配置认证并限制网络暴露。
常见问题
使用 Caveman 是否必须付费？
安装后会发送哪些数据？
/caveman-compress 会将待压缩文件发送给配置的模型提供方。CLI 默认发送使用统计；Auto 登录启用后会向 Caveman Cloud 发送最近请求及部分代理上下文。能否只安装缩短回复的技能？
npx skills add JuliusBrussee/caveman -g 安装技能的方式；在 Codex 中可使用 $caveman，也可输入 /caveman。Auto 和 Blocks 是否适合直接用于生产？
怎样关闭统计或单项功能？
caveman telemetry off 或设置 DO_NOT_TRACK=1 关闭统计；可用 caveman off browse 关闭 Browse，caveman status 查看当前状态。