@caveman-ai/cli

中文文档
4.1.0发布于 2026/11/08Apache-2.0ES Module零依赖构建来源已验证近 30 天下载 8.4万

Caveman CLI——用可回收的本地上下文压缩和真实度量法包装编码剂(caveman claude),再从终端驾驶洞口云. 压缩和计量运行在同伴 Go 二进制:运行 caveman setup 以查看安装状态.

中文使用文档
文档目录4 节
  1. 这个包是(而不是)
  2. 获取二进制
  3. 诚实的规矩
  4. 代理本地设置

@caveman-ai/cli (法语)

这个 caveman (别名) caveCLI(英语:CLI). 环绕所支持的编码代理, 因此他们的 LLM 流量可以使用本地计量和可回收上下文压缩:

caveman claude        # shorthand for `caveman wrap claude`; bootstraps signed runtime on first TTY run
caveman kilo          # Kilo Code CLI; `caveman kilocode` works too
caveman qwen          # Qwen Code CLI through a temporary system-settings overlay
caveman learn         # interactive local Setup Score + grouped top moves
caveman setup         # show which companion binaries are installed
caveman stats         # local dashboard: tokens, API estimates, subscription equivalents

caveman learn 显示动画进度、紧凑结果卡和键盘 菜单,完整细节,或视觉报告。 使用 --plain 页:1 稳定的紧凑文本, --all 每个水槽和探测器, --json 用于自动化,或 caveman learn implement [claude|codex] --prompt "<focus>" 打开代理 逐一审查 代理路径安装已有的学习指南 ,从不编辑含有负载的发现,并在每次编辑前询问.

caveman stats 打开一个私人的离线仪表板, 上面有符号历史, 提供者 以及模型分解、缓存使用和可扩展计算收据。 使用 --days 7 或者说 --all-time过滤器 --provider, (中文(简体) ), --model, (中文(简体) ), --agent 或者说 --auth,然后导出到 --json。 。 。 . --plain 打印摘要而不打开 浏览器。 API的费用估计数和订阅API的等价仍分开; 未知价格一直没有。 早期部分估计数仍然可见 在新要求提供全面比较和定价证据之前,单独进行. 见 会计方法。 。 。 .

为 Bedrock 配置的 Claude 代码有一条明确的本地跑道:

CAVEMAN_WRAP_PROVIDER=bedrock \
AWS_REGION=us-east-1 \
AWS_BEARER_TOKEN_BEDROCK=… \
caveman wrap claude

IAM 全权证书AWS_ACCESS_KEY_ID, (中文(简体) ), AWS_SECRET_ACCESS_KEY选择 AWS_SESSION_TOKEN工作也一样。 粪便仍然选择使用 CAVEMAN_BEDROCK_ENDPOINT=mantle这是一个独特的贝德罗克终点合同, 不是正常的Anthropic交通的别名。 运行时间使用属性 /bedrock 碱; 地幔使用 /bedrock/anthropic 因为克劳德代码附件 /v1/messages 它的曼特尔控制.

当网关 URL 被管理时, 将完全合并到一个 x-cave-api-key: <CAVE_API_KEY> 进入克劳德代码的记录 ANTHROPIC_CUSTOM_HEADERS并替换 任何变体。 若为 AWS_BEARER_TOKEN_BEDROCK 已存在, 包装也 合并为 x-cave-upstream-key;否则一个完整的IAM环境就是 编码为 AWS_ACCESS_KEY_ID:AWS_SECRET_ACCESS_KEY[:AWS_SESSION_TOKEN]。当 两种表格都存在。 运行时仍然使用 Claude Code 记录的 AWS 证书链; 没有支持的运行时当量 CLAUDE_CODE_SKIP_MANTLE_AUTH。在两种明确环境形式中,没有 添加了上游标题, 但 Claude Code 仍然必须解决本地 AWS 在管理网关取代项目的证书/简介之前 存储证书。 对于只存储的服务器输入的 Claude 代码认证,请选择 选入曼特尔道,其网关认证绕行被记录. 施特尔 x-cave-upstream-key 变体被删除, 因此无法覆盖存储 证书。 新线和不完整的IAM对在发射前失败.

本地 Bedrock 包装从不添加 Caveman 网关头并保留继承 AWS环境. 这个头后接合器经过了寄存器测试; 一个活的克洛德 代码 – AWS 烟雾仍然是放行门. 见官员 自定义标题 财务报告和审定财务报表 Bedrock 网关设置。 。 。 .

这个包是(而不是)

这个Npm包裹船 仅 JavaScript 前端 - 一个CLI入境点 加上一个懒惰的 25 KB 交互式学习块, 零运行时间依赖性 . 举重(压缩、计量、流出) 恢复,浏览) 运行在洞穴人的同伴 去二进制数字 :

二进制权力
caveman-proxystart • 妇女 wrap • 妇女 stats ——局部压缩+真实度量
caveman-enginecompress • 妇女 shrink • 妇女 retrieve • 妇女 toon • 妇女 evals
caveman-mcp代理端恢复, 这样流流请求可以压缩
cavemem地方记忆 · 回忆 · 已学习的文本卸载
caveman-browse压缩页面快照( 可选)
caveman-shrinktools compress catalog ——工具-schema压缩、用意和回收(可选)

两个收缩表面保持清晰: caveman tools shrink -- <command> 压缩 命令输出; caveman tools compress catalog [lint|recover] 代表团 caveman-shrink 用于MCP/OpenAI工具目录.

在第一次互动本地包装, caveman <agent> 安装已签名的运行时间捆绑 继续同样的命令。 明确 CAVEMAN_*_BIN 覆盖和不交互 运行不变。 没有二进制 CLI 将受影响的命令降解为清晰 过关:没有东西是压缩的,储蓄报告0,警告说原因. 运行 caveman setup 看看什么是可行的 如何修复缺失的碎片.

wrap 这是"通过"的一个例外:它指向代理商 ANTHROPIC_BASE_URL编号 :OPENAI_BASE_URL 在代理,所以没有代理监听 代理人的请求 无法路由 而不是路过。 一个 互动包装抓住了这个并主动提出直接发射该剂; 一个非交互式的包装打印出警告并仍然发射, 所以脚本/ CI 调用者必须确保代理已上线( 或使用) --no-proxy) (中文(简体) ).

获取二进制

正常安装 :

npm i -g @caveman-ai/cli
caveman claude

第一次交互式包装下载 密钥签名发布文物,验证 校验和单加上每架SHA-256,在原子上安装到 ~/.caveman/bin,然后发射代理。 手动安装/修复为 caveman setup --install。 。 。 .

关于克洛德代码和代码,第一个 caveman <agent> 运行(或 caveman enable <agent> )也写语音技能 (单位:千美元)caveman, (中文(简体) ), ultracave, (中文(简体) ), megacave)进入代理的用户技能目录,所以 /caveman 已提供。 现有 SKILL.md 从来不是覆写 caveman disable <agent> 把技能留在原地.

Npm CLI需要节点22.13或更新. 卡夫曼揭露出十个本地特工 快捷键 : aider, (中文(简体) ), claude, (中文(简体) ), codex, (中文(简体) ), gemini, (中文(简体) ), hermes, (中文(简体) ), kilo (单位:千美元)kilocode (b) 化名, openclaw, (中文(简体) ), opencode, (中文(简体) ), pi,以及 qwen。 。 。 .

单独安装Quen码,然后通过Caveman发射:

npm i -g @qwen-code/qwen-code
caveman qwen

Wen 将本地或管理的 OpenAI 兼容路由包成一个 通过选择的临时系统设置文件 QWEN_CODE_SYSTEM_SETTINGS_PATH。明确的现有系统设置路径 胜出; 否则 Caveman 从 Quen 的 macOS, Linux 或 Windows 企业开始 平台默认。 它保留了不相关的政策和提供者的密钥,从不 重写源或 ~/.qwen/settings.json. 被钉住真实的CLI烟雾盖 当地模式和管理模式中的Quen代码为0.22.3.

在 Quen 用户设置中分别安装代理端恢复 :

caveman tools mcp install qwen --server caveman
caveman tools mcp uninstall qwen --server caveman

MCP生命周期保留了兄弟会的条目,期刊"洞穴人"的所有权,以及 拒绝覆盖或删除用户拥有或随后更改的条目.

贡献者仍可从源头建造 ./scripts/install-local-cli.sh 在 macOS/Linux 上或 pwsh -File scripts/install-local-cli.ps1 在视窗上。 查询顺序 : CAVEMAN_*_BIN env 覆盖 ~ PATH → ~/.caveman/bin。 。 。 .

诚实的规矩

  • 当地储蓄总是贴上标签 inferred· ; verified_savings 保留到 0 一个优化器在实际流量的活性模式下运行.
  • 可回收压缩:更换前丢失的变换存储为正本. 缺少安全恢复路径、解析失败或非较小输出通过 没有改变,而且没有任何索赔. record 模式是字节保存.

已连接动词( N)login, (中文(简体) ), plan, (中文(简体) ), score, (中文(简体) ), costs,.)与洞口云交谈 超过HTTP,不需要二进制.

对于客户拥有的安装,连接到其API源头:

caveman login --instance https://caveman.example.com

批准您实例浏览器中显示的代码, 选择一个工程并 允许进入范围。 此连接不会产生推断密钥, 也不会 同步本地请求历史 。 CLI的使用遥测设置仍然有效; caveman telemetry off 关闭它。 全权证书使用现有安全仓库; caveman logout 撤销会话。 除了HTTP回放开发外,需要HTTPS. 为主机"洞口云"跑 caveman login 没有旗帜。 服务器决定 是否打开了签名;如果没有打开,则打印出 CLI Sign-in is not open on <host> yet.

读取连接工程中的代理 caveman cloud agent factory list 财务报告和审定财务报表 caveman cloud agent factory show <id>。这些命令需要 trace:read_metadata 进入。 工厂案件、执行批准和政策 保留在仪表板上;CLI连接不能授予该权限. 现有 cloud agent list|show|run 命令仍然地址优化 建议.

连接的遥测进口仍属现有 cloud audit 治理动词:

caveman cloud audit import --format langfuse traces.json
caveman cloud audit eval-import evidence.jsonl --dry-run
caveman cloud audit eval-import evidence.jsonl

Eval JSONL 每行最多接受一个犬类外证对象 每批1000个记录 / 4. MiB. 服务器邮票 Org/ 项目, observed 基础, 财务报告和审定财务报表 external_observed ; 进口证据不能批准推出或 薄荷经核实的节省.

代理本地设置

安装完整的本地 Caveman 集成到 Codex 或 Claude 代码: 本地 线路、生命周期钩、建筑-第一核心、恢复MCP、项目范围 以及设置/发现/审查/优化/管理技能:

caveman setup --agent-native codex
# or
caveman setup --agent-native claude

这写一个 MCP 命令,而不是访问符,输入代理配置 。 运行时间 请求使用现有的 caveman login 证书店,还经过 控制-api认证、项目范围、非洲区域局、审计和租户隔离. 阅读工具显示结构化报告、洞穴计划、微量元数据/页码以及 实验证据。 MCP剂故意暴露无生命周期突变: control-api首先需要服务器的授权转换和证据门. Agent-facing CLI实验命令出于同样的原因只读.

核心变化编码行为,但仍可独立控制. 压抑, 在Core关闭时继续遥测:

caveman tools config get think.core
caveman tools config set think.core off
caveman tools config set think.core on

运行 caveman doctor codex 或者说 caveman doctor claude 要看到活动的核心状态, 源, 剖面, 和包版本 。 更改会影响以后的钩子事件; 启动新的 代理会话以清除 Core 已交付到模式上下文 。 爱德很浅, 无法应用核心 think.core· ; caveman disable aider 将取去. caveman disable (或 caveman disable --all)取消所有本土融合. caveman disable claude 清除每一个发现的 Claude 简介:默认, 名称 ~/.claude-* 编号 : ~/.claude_* 简介, CLAUDE_CONFIG_DIR和习惯 先前记忆中的配置文件已启用 。 也可以去除可识别的洞穴人 运行时没有安装日记, 备份已更改 文档。 无关的路线,证书,钩子,以及MCP服务器被保存. 之后重新开始运行 Claude 会话: 禁用无法更改其已存在的 进程环境。 由旧版本创建的任意自定义配置必须 将通过 CLAUDE_CONFIG_DIR 如果它们在指定地点之外. caveman disable <agent> 在保留无关内容的同时去除本地路由/ 呼号 主机编辑.

撰写、日记前的代理内设飞行前主机/运行时间要求 捆绑所有权,验证已安装的组件,并回滚失败的安装. 重跑使日记拥有的漂移趋同. 只删除捆绑的自有棋子 以 :

caveman setup --agent-native codex --remove

安装前检查 :

caveman tools skills list --json
caveman tools skills preview caveman-evidence-review
caveman tools skills install --suite agent-native --agent codex --no-pixel
caveman tools mcp install codex --server caveman-cloud

通过正式技能CLI安装任何第三方技能,然后存储其 指令机构为可盈利的像素页面 :

caveman tools skills add mattpocock/skills --skill tdd --agent codex -y
caveman tools skills add https://github.com/vercel-labs/agent-skills --agent claude-code --global -y

GitHub 简称、 Git/ GitLab URL、 直接技能 URL、 本地路径和上游 --skill编号 :--agent编号 :--global编号 :--list编号 :--all 旗帜没有改变. Caveman 在像素化时强迫上游复制模式, 只转换新版本或更改 Claude Code/Codex 技能,保留 SKILL.orig.md 用于字节精确返回,以及 估计数量减少的报告 inferred 每引用一次. --no-pixel 保持上游纯文本行为。 第三方指示和 caveman不对其进行安全审查. 官方技能 CLI 遥测行为也适用; 设置 DISABLE_TELEMETRY=1 选择退出上游.

在Matt Pockock的35个技能仓库上 约会过本地烟雾 转换了27个盈利 并安全地留下八个作为文本。 每项援引的合计数 转换技能:32 314 = 9 537个估计值(-70%) inferred) (中文(简体) ). 这是 估计产出,而不是提供者报告的账单或技能质量基准.

版本与发布记录

@caveman-ai/cli 共发布 17 个版本,首次发布于 2026/08/11;过去 12 个月发布了 17 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.1.0latest2026/11/081 天前
4.0.12026/10/1426 天前
4.0.02026/10/1426 天前
2.1.02026/10/081 个月前
2.0.12026/10/041 个月前
2.0.02026/10/011 个月前

关于 @caveman-ai/cli 的常见问题

@caveman-ai/cli 是什么?

Caveman CLI——用可回收的本地上下文压缩和真实度量法包装编码剂(caveman claude),再从终端驾驶洞口云. 压缩和计量运行在同伴 Go 二进制:运行 caveman setup 以查看安装状态.

如何安装 @caveman-ai/cli?

在项目目录运行 npm install @caveman-ai/cli,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 cave、caveman,可以用 npx cave 直接运行。

@caveman-ai/cli 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/caveman-ai__cli 是否存在。

@caveman-ai/cli 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@caveman-ai/cli 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.13。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@caveman-ai/cli 可以商用吗?

@caveman-ai/cli 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@caveman-ai/cli 的下载量有多少?

根据 npm 官方下载统计,@caveman-ai/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 83,858 次,日均约 2,795 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@caveman-ai/cli 还在维护吗?

最新版本 4.1.0 发布于 2026/11/08(1 天前);至今共发布 17 个版本,其中过去 12 个月发布了 17 个;首次发布于 2026/08/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。