# @caveman-ai/cli 中文文档 规范地址：https://npmcn.com/package/%40caveman-ai/cli/ 版本：4\.1\.0 npm 元数据更新时间：2026-11-08T04:12:33.499Z 中文译文更新时间：2026-11-09T05:05:44.714Z 软件包许可：Apache-2\.0 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40caveman-ai/cli 原文对照：https://npmcn.com/package/%40caveman-ai/cli/?lang=original 项目主页：https://getcaveman.dev/ 源码仓库：https://github.com/JuliusBrussee/caveman ## 关键信息（来自 npm 元数据） - 包体积（解压后）：1.7 MB，40 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22\.13 - 运行依赖：0 个 - 首次发布：2026-08-11T15:51:47.357Z - 最新版本发布：2026-11-08T04:12:33.161Z - 近 30 天下载量：83858（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：17（近 12 个月 17 个） ## 中文简介 Caveman CLI——用可回收的本地上下文压缩和真实度量法包装编码剂(`caveman claude`),再从终端驾驶洞口云. 压缩和计量运行在同伴 Go 二进制:运行 `caveman setup` 以查看安装状态. ## 安装 ```sh npm install @caveman-ai/cli ``` 也可以使用：`pnpm add @caveman-ai/cli`、`yarn add @caveman-ai/cli`、`bun add @caveman-ai/cli` ## README # @caveman-ai/cli (法语) 这个 `caveman` (别名) `cave`CLI(英语:CLI). 环绕所支持的编码代理, 因此他们的 LLM 流量可以使用本地计量和可回收上下文压缩: ```sh 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 ""` 打开代理 逐一审查 代理路径安装已有的学习指南 ,从不编辑含有负载的发现,并在每次编辑前询问. `caveman stats` 打开一个私人的离线仪表板, 上面有符号历史, 提供者 以及模型分解、缓存使用和可扩展计算收据。 使用 `--days 7` 或者说 `--all-time`过滤器 `--provider`, (中文(简体) ), `--model`, (中文(简体) ), `--agent` 或者说 `--auth`,然后导出到 `--json`。 。 。 . `--plain` 打印摘要而不打开 浏览器。 API的费用估计数和订阅API的等价仍分开; 未知价格一直没有。 早期部分估计数仍然可见 在新要求提供全面比较和定价证据之前,单独进行. 见 [会计方法](https://npmcn.com/package/docs/technical/stats-accounting.md)。 。 。 . 为 Bedrock 配置的 Claude 代码有一条明确的本地跑道: ```sh 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: ` 进入克劳德代码的记录 `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 烟雾仍然是放行门. 见官员 [自定义标题](https://code.claude.com/docs/en/env-vars) 财务报告和审定财务报表 [Bedrock 网关设置](https://code.claude.com/docs/en/bedrock-vertex-proxies)。 。 。 . ## 这个包是(而不是) 这个Npm包裹船 **仅 JavaScript 前端** - 一个CLI入境点 加上一个懒惰的 25 KB 交互式学习块, 零运行时间依赖性 . 举重(压缩、计量、流出) 恢复,浏览) 运行在洞穴人的同伴 **去二进制**数字 : | 二进制 | 权力 | | --- | --- | | `caveman-proxy` | `start` • 妇女 `wrap` • 妇女 `stats` ——局部压缩+真实度量 | | `caveman-engine` | `compress` • 妇女 `shrink` • 妇女 `retrieve` • 妇女 `toon` • 妇女 `evals` | | `caveman-mcp` | 代理端恢复, 这样流流请求可以压缩 | | `cavemem` | 地方记忆 · 回忆 · 已学习的文本卸载 | | `caveman-browse` | 压缩页面快照( 可选) | | `caveman-shrink` | `tools compress catalog` ——工具-schema压缩、用意和回收(可选) | 两个收缩表面保持清晰: `caveman tools shrink -- ` 压缩 命令输出; `caveman tools compress catalog [lint|recover]` 代表团 `caveman-shrink` 用于MCP/OpenAI工具目录. 在第一次互动本地包装, `caveman ` 安装已签名的运行时间捆绑 继续同样的命令。 明确 `CAVEMAN_*_BIN` 覆盖和不交互 运行不变。 没有二进制 CLI 将受影响的命令降解为清晰 过关:没有东西是压缩的,储蓄报告0,警告说原因. 运行 `caveman setup` 看看什么是可行的 如何修复缺失的碎片. `wrap` 这是"通过"的一个例外:它指向代理商 `ANTHROPIC_BASE_URL`编号 :`OPENAI_BASE_URL` 在代理,所以没有代理监听 代理人的请求 **无法路由** 而不是路过。 一个 互动包装抓住了这个并主动提出直接发射该剂; 一个非交互式的包装打印出警告并仍然发射, 所以脚本/ CI 调用者必须确保代理已上线( 或使用) `--no-proxy`) (中文(简体) ). ## 获取二进制 正常安装 : ```sh npm i -g @caveman-ai/cli caveman claude ``` 第一次交互式包装下载 密钥签名发布文物,验证 校验和单加上每架SHA-256,在原子上安装到 `~/.caveman/bin`,然后发射代理。 手动安装/修复为 `caveman setup --install`。 。 。 . 关于克洛德代码和代码,第一个 `caveman ` 运行(或 `caveman enable ` )也写语音技能 (单位:千美元)`caveman`, (中文(简体) ), `ultracave`, (中文(简体) ), `megacave`)进入代理的用户技能目录,所以 `/caveman` 已提供。 现有 `SKILL.md` 从来不是覆写 `caveman disable ` 把技能留在原地. Npm CLI需要节点22.13或更新. 卡夫曼揭露出十个本地特工 快捷键 : `aider`, (中文(简体) ), `claude`, (中文(简体) ), `codex`, (中文(简体) ), `gemini`, (中文(简体) ), `hermes`, (中文(简体) ), `kilo` (单位:千美元)`kilocode` (b) 化名, `openclaw`, (中文(简体) ), `opencode`, (中文(简体) ), `pi`,以及 `qwen`。 。 。 . 单独安装Quen码,然后通过Caveman发射: ```sh 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 用户设置中分别安装代理端恢复 : ```sh 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源头: ```sh caveman login --instance https://caveman.example.com ``` 批准您实例浏览器中显示的代码, 选择一个工程并 允许进入范围。 此连接不会产生推断密钥, 也不会 同步本地请求历史 。 CLI的使用遥测设置仍然有效; `caveman telemetry off` 关闭它。 全权证书使用现有安全仓库; `caveman logout` 撤销会话。 除了HTTP回放开发外,需要HTTPS. 为主机"洞口云"跑 `caveman login` 没有旗帜。 服务器决定 是否打开了签名;如果没有打开,则打印出 CLI `Sign-in is not open on yet.` 读取连接工程中的代理 `caveman cloud agent factory list` 财务报告和审定财务报表 `caveman cloud agent factory show `。这些命令需要 `trace:read_metadata` 进入。 工厂案件、执行批准和政策 保留在仪表板上;CLI连接不能授予该权限. 现有 `cloud agent list|show|run` 命令仍然地址优化 建议. 连接的遥测进口仍属现有 `cloud audit` 治理动词: ```sh 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、项目范围 以及设置/发现/审查/优化/管理技能: ```sh caveman setup --agent-native codex # or caveman setup --agent-native claude ``` 这写一个 MCP 命令,而不是访问符,输入代理配置 。 运行时间 请求使用现有的 `caveman login` 证书店,还经过 控制-api认证、项目范围、非洲区域局、审计和租户隔离. 阅读工具显示结构化报告、洞穴计划、微量元数据/页码以及 实验证据。 MCP剂故意暴露无生命周期突变: control-api首先需要服务器的授权转换和证据门. Agent-facing CLI实验命令出于同样的原因只读. 核心变化编码行为,但仍可独立控制. 压抑, 在Core关闭时继续遥测: ```sh 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 ` 在保留无关内容的同时去除本地路由/ 呼号 主机编辑. 撰写、日记前的代理内设飞行前主机/运行时间要求 捆绑所有权,验证已安装的组件,并回滚失败的安装. 重跑使日记拥有的漂移趋同. 只删除捆绑的自有棋子 以 : ```sh caveman setup --agent-native codex --remove ``` 安装前检查 : ```sh 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安装任何第三方技能,然后存储其 指令机构为可盈利的像素页面 : ```sh 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 是什么？ 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 和提交记录判断。