本手册基于你的实际成功经验整理。Caveman 是一个 Claude Code 插件通过强制 AI 使用极简“穴居人”风格回答平均节省 65% 的输出 Token与 Headroom压缩输入形成完美互补。 Caveman 项目简介这是什么Caveman是一个 Claude Code 的提示词插件。它通过修改系统提示词让 Claude 用最简洁、直接的语言回答问题去掉客套话、过渡句和重复内容从而大幅减少输出 Token消耗。核心特性特性说明️输出压缩平均节省65%的输出 Token最高可达87%保留关键内容代码、命令、路径、错误信息等核心技术内容完整保留实时统计提供/caveman:caveman-stats命令直观查看节省效果完全本地无网络调用数据不上传一键永久化通过init命令写入项目配置一次激活永久生效为什么需要它输出 Token 也是计费的重要组成部分压缩输出可直接降低 API 费用。在 Headroom 压缩输入的基础上Caveman 进一步压缩输出实现“双向省钱”。 前置条件Windows 操作系统已安装 Claude Code CLI并能正常使用已配置好 API可选但推荐已安装 Headroom用于压缩输入 Token前一篇文章 已知踩坑点与应对坑点现象解决方案PowerShell 执行策略限制安装脚本无法运行先执行Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedraw.githubusercontent.com网络不通安装卡住或自动退出改用手动安装直接下载 ZIP 解压复制状态栏不显示底部没有[CAVEMAN]统计条需手动配置settings.json中的statusLine见步骤五/caveman-stats提示未知命令命令格式错误正确命令为/caveman:caveman-stats️ 步骤一安装 Caveman根据你的网络情况选择以下任一方法。方法 A一键自动安装网络通畅时推荐 以下安装命令来源于 [Caveman 官方安装脚本](https://github.com/JuliusBrussee/caveman/blob/main/install.ps1)经本人验证有效。以普通用户身份打开 PowerShell无需管理员运行powershellirm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex安装器会提示选择 AgenttextDetected agents: [1] Claude Code [2] Codex CLI [3] Kiro CLI [a] all [q] quit Install which? (default: all)输入1并回车等待出现✅ Caveman installed successfully!即可。方法 B手动安装网络不通时 100% 可靠已验证浏览器打开https://github.com/JuliusBrussee/caveman/archive/refs/heads/main.zip下载并解压得到caveman-main文件夹。打开caveman-main文件夹全选CtrlA所有内容commands、plugins、skills、CLAUDE.md等复制。在C:\Users\你的用户名\.claude\目录下新建一个名为caveman的文件夹。将复制的内容粘贴到C:\Users\你的用户名\.claude\caveman\中。最终结构应为C:\Users\jiugu\.claude\caveman\内含commands、plugins等文件夹。方法C官方插件库下载推荐前置条件已安装 Node.js含 npx已安装 Claude Code操作步骤第1步在 PowerShell 中运行安装命令powershellnpx skills add JuliusBrussee/caveman -a claude-code第2步选择要安装的 Skill用空格键选中以下3个推荐☑cavecrew☑caveman-help☑caveman-stats然后按Enter确认。第3步选择安装范围text选择Global全局安装按 Enter 确认。第4步提示确认时输入yes第5步再次提示确认时输入yes安装结果安装完成后Skills 会自动存放在textC:\Users\jiugu\.claude\skills\该目录下会包含已安装的 caveman 系列 Skills 优化写法。✅ 步骤二验证安装在 PowerShell 中运行powershellls C:\Users\jiugu\.claude\caveman如果显示文件夹内容如commands、plugins、CLAUDE.md等说明安装成功。 步骤三激活 Caveman两种方式方式 1当前会话临时激活在 Claude Code 对话框中输入text/caveman看到Caveman mode active即生效。仅对当前会话有效关闭后失效。方式 2永久激活推荐在 Claude Code 对话框中输入text/caveman:caveman-init该命令会将“始终启用 Caveman”规则写入当前项目的CLAUDE.md文件。此后每次在该项目目录启动 Claude Code都会自动进入精简模式无需再手动输入。 步骤四常用命令速查命令中文说明/caveman-help显示帮助速查卡/caveman或/caveman:caveman切换精简强度lite轻度、full完全默认、ultra极致、wenyan文言文/caveman:caveman-init⭐一键永久启用写入项目 CLAUDE.md/caveman:caveman-stats显示实时 Token 节省统计输出 Token 节省量及百分比/caveman-compress压缩项目记忆文件CLAUDE.md、todos 等/caveman:caveman-commit生成极简 Git 提交信息/caveman:caveman-review生成单行代码审查评论输入normal mode恢复正常非精简回答风格️ 步骤五可选配置状态栏如果你希望 Claude Code 底部实时显示[CAVEMAN]节省统计条需手动配置。打开C:\Users\jiugu\.claude\settings.json。在根对象中添加或合并以下内容json{ ...已有配置, statusLine: { type: command, command: powershell -ExecutionPolicy Bypass -File \C:\\Users\\jiugu\\.claude\\plugins\\cache\\caveman\\caveman\\0d95a81d35a9\\src\\hooks\\caveman-statusline.ps1\ } }注意路径中的0d95a81d35a9是插件缓存版本号若你的目录下不同请以实际路径为准。如果不确定可以先在文件资源管理器中进入C:\Users\jiugu\.claude\plugins\cache\caveman\caveman\查看具体的版本号文件夹。保存文件重启 Claude Code输入/exit退出再重新运行claude。成功配置后底部会显示类似[CAVEMAN] 12.4k的状态条实时更新节省的 Token 总量。 步骤六验证效果启动 Claude Code保持 Headroom 终端开着如果有。确保 Caveman 已激活输入/caveman或已执行过init。随便问一个问题观察回复是否变得极其简短。输入以下命令查看精确统计text/caveman:caveman-stats你会看到类似输出textOutput tokens: 215 Est. without caveman: 614 Est. tokens saved: 399 (~65% of output) 步骤七关闭或切换模式关闭精简模式在对话中输入normal mode即可恢复正常回答风格。重新开启再次输入/caveman。切换强度输入/caveman ultra或/caveman lite。 常见问题 FAQQ: 输入/caveman提示Unknown commandA: 说明安装未成功。检查C:\Users\jiugu\.claude\caveman\是否存在且内容完整若没有则按步骤一手动安装。Q:/caveman-stats提示未知命令A: 正确格式是/caveman:caveman-stats注意中间有个冒号。Q: 状态栏不显示A: 检查settings.json中的statusLine配置是否正确并确保已重启Claude Code。Q: Caveman 会影响代码质量吗A: 不会。Caveman 只改变自然语言描述的风格代码、命令、错误信息等关键内容会完整保留。Q: Caveman 需要联网吗A: 不需要。它是纯提示词插件完全本地运行。 最终成果✅ Caveman 成功部署输出 Token 平均节省~65%。✅ 可随时查看节省统计/caveman:caveman-stats。✅ 可通过init命令永久激活一劳永逸。✅ 与 Headroom 协同工作实现输入输出双向压缩。现在你已拥有完整的 Token 优化方案Headroom压缩输入 Caveman压缩输出双重省钱高效编程追加更新内容经过caveman压缩后输出的可能都为英文解决办法如下✅ 修改位置检查~\.skills\caveman\找到skill.md在## Rules这一节的开头添加一行“强制中文”的规则。这样它会成为最高优先级的指令覆盖后面的“跟随用户语言”逻辑。修改前当前内容markdown## Rules Drop: articles (a/an/the), filler... Preserve users dominant language. User write Portuguese → reply Portuguese caveman...修改后推荐在## Rules的第一行插入markdown## Rules **CRITICAL: Always reply in Chinese (中文) for all natural language.** Code, commands, paths, API names, and exact error strings stay in their original language — do not translate them. This rule overrides all other language rules.然后保留原有的Drop: ...和Preserve users dominant language...等内容不变。 **本文声明**本文为个人实践记录内容基于 [Caveman 项目官方文档](https://github.com/JuliusBrussee/caveman) 整理。所有命令和配置均经过本人亲测验证。代码块中的脚本来源已标注如有侵权请联系删除。
Caveman 部署与使用完全手册（Windows + Claude Code）
本手册基于你的实际成功经验整理。Caveman 是一个 Claude Code 插件通过强制 AI 使用极简“穴居人”风格回答平均节省 65% 的输出 Token与 Headroom压缩输入形成完美互补。 Caveman 项目简介这是什么Caveman是一个 Claude Code 的提示词插件。它通过修改系统提示词让 Claude 用最简洁、直接的语言回答问题去掉客套话、过渡句和重复内容从而大幅减少输出 Token消耗。核心特性特性说明️输出压缩平均节省65%的输出 Token最高可达87%保留关键内容代码、命令、路径、错误信息等核心技术内容完整保留实时统计提供/caveman:caveman-stats命令直观查看节省效果完全本地无网络调用数据不上传一键永久化通过init命令写入项目配置一次激活永久生效为什么需要它输出 Token 也是计费的重要组成部分压缩输出可直接降低 API 费用。在 Headroom 压缩输入的基础上Caveman 进一步压缩输出实现“双向省钱”。 前置条件Windows 操作系统已安装 Claude Code CLI并能正常使用已配置好 API可选但推荐已安装 Headroom用于压缩输入 Token前一篇文章 已知踩坑点与应对坑点现象解决方案PowerShell 执行策略限制安装脚本无法运行先执行Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSignedraw.githubusercontent.com网络不通安装卡住或自动退出改用手动安装直接下载 ZIP 解压复制状态栏不显示底部没有[CAVEMAN]统计条需手动配置settings.json中的statusLine见步骤五/caveman-stats提示未知命令命令格式错误正确命令为/caveman:caveman-stats️ 步骤一安装 Caveman根据你的网络情况选择以下任一方法。方法 A一键自动安装网络通畅时推荐 以下安装命令来源于 [Caveman 官方安装脚本](https://github.com/JuliusBrussee/caveman/blob/main/install.ps1)经本人验证有效。以普通用户身份打开 PowerShell无需管理员运行powershellirm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex安装器会提示选择 AgenttextDetected agents: [1] Claude Code [2] Codex CLI [3] Kiro CLI [a] all [q] quit Install which? (default: all)输入1并回车等待出现✅ Caveman installed successfully!即可。方法 B手动安装网络不通时 100% 可靠已验证浏览器打开https://github.com/JuliusBrussee/caveman/archive/refs/heads/main.zip下载并解压得到caveman-main文件夹。打开caveman-main文件夹全选CtrlA所有内容commands、plugins、skills、CLAUDE.md等复制。在C:\Users\你的用户名\.claude\目录下新建一个名为caveman的文件夹。将复制的内容粘贴到C:\Users\你的用户名\.claude\caveman\中。最终结构应为C:\Users\jiugu\.claude\caveman\内含commands、plugins等文件夹。方法C官方插件库下载推荐前置条件已安装 Node.js含 npx已安装 Claude Code操作步骤第1步在 PowerShell 中运行安装命令powershellnpx skills add JuliusBrussee/caveman -a claude-code第2步选择要安装的 Skill用空格键选中以下3个推荐☑cavecrew☑caveman-help☑caveman-stats然后按Enter确认。第3步选择安装范围text选择Global全局安装按 Enter 确认。第4步提示确认时输入yes第5步再次提示确认时输入yes安装结果安装完成后Skills 会自动存放在textC:\Users\jiugu\.claude\skills\该目录下会包含已安装的 caveman 系列 Skills 优化写法。✅ 步骤二验证安装在 PowerShell 中运行powershellls C:\Users\jiugu\.claude\caveman如果显示文件夹内容如commands、plugins、CLAUDE.md等说明安装成功。 步骤三激活 Caveman两种方式方式 1当前会话临时激活在 Claude Code 对话框中输入text/caveman看到Caveman mode active即生效。仅对当前会话有效关闭后失效。方式 2永久激活推荐在 Claude Code 对话框中输入text/caveman:caveman-init该命令会将“始终启用 Caveman”规则写入当前项目的CLAUDE.md文件。此后每次在该项目目录启动 Claude Code都会自动进入精简模式无需再手动输入。 步骤四常用命令速查命令中文说明/caveman-help显示帮助速查卡/caveman或/caveman:caveman切换精简强度lite轻度、full完全默认、ultra极致、wenyan文言文/caveman:caveman-init⭐一键永久启用写入项目 CLAUDE.md/caveman:caveman-stats显示实时 Token 节省统计输出 Token 节省量及百分比/caveman-compress压缩项目记忆文件CLAUDE.md、todos 等/caveman:caveman-commit生成极简 Git 提交信息/caveman:caveman-review生成单行代码审查评论输入normal mode恢复正常非精简回答风格️ 步骤五可选配置状态栏如果你希望 Claude Code 底部实时显示[CAVEMAN]节省统计条需手动配置。打开C:\Users\jiugu\.claude\settings.json。在根对象中添加或合并以下内容json{ ...已有配置, statusLine: { type: command, command: powershell -ExecutionPolicy Bypass -File \C:\\Users\\jiugu\\.claude\\plugins\\cache\\caveman\\caveman\\0d95a81d35a9\\src\\hooks\\caveman-statusline.ps1\ } }注意路径中的0d95a81d35a9是插件缓存版本号若你的目录下不同请以实际路径为准。如果不确定可以先在文件资源管理器中进入C:\Users\jiugu\.claude\plugins\cache\caveman\caveman\查看具体的版本号文件夹。保存文件重启 Claude Code输入/exit退出再重新运行claude。成功配置后底部会显示类似[CAVEMAN] 12.4k的状态条实时更新节省的 Token 总量。 步骤六验证效果启动 Claude Code保持 Headroom 终端开着如果有。确保 Caveman 已激活输入/caveman或已执行过init。随便问一个问题观察回复是否变得极其简短。输入以下命令查看精确统计text/caveman:caveman-stats你会看到类似输出textOutput tokens: 215 Est. without caveman: 614 Est. tokens saved: 399 (~65% of output) 步骤七关闭或切换模式关闭精简模式在对话中输入normal mode即可恢复正常回答风格。重新开启再次输入/caveman。切换强度输入/caveman ultra或/caveman lite。 常见问题 FAQQ: 输入/caveman提示Unknown commandA: 说明安装未成功。检查C:\Users\jiugu\.claude\caveman\是否存在且内容完整若没有则按步骤一手动安装。Q:/caveman-stats提示未知命令A: 正确格式是/caveman:caveman-stats注意中间有个冒号。Q: 状态栏不显示A: 检查settings.json中的statusLine配置是否正确并确保已重启Claude Code。Q: Caveman 会影响代码质量吗A: 不会。Caveman 只改变自然语言描述的风格代码、命令、错误信息等关键内容会完整保留。Q: Caveman 需要联网吗A: 不需要。它是纯提示词插件完全本地运行。 最终成果✅ Caveman 成功部署输出 Token 平均节省~65%。✅ 可随时查看节省统计/caveman:caveman-stats。✅ 可通过init命令永久激活一劳永逸。✅ 与 Headroom 协同工作实现输入输出双向压缩。现在你已拥有完整的 Token 优化方案Headroom压缩输入 Caveman压缩输出双重省钱高效编程追加更新内容经过caveman压缩后输出的可能都为英文解决办法如下✅ 修改位置检查~\.skills\caveman\找到skill.md在## Rules这一节的开头添加一行“强制中文”的规则。这样它会成为最高优先级的指令覆盖后面的“跟随用户语言”逻辑。修改前当前内容markdown## Rules Drop: articles (a/an/the), filler... Preserve users dominant language. User write Portuguese → reply Portuguese caveman...修改后推荐在## Rules的第一行插入markdown## Rules **CRITICAL: Always reply in Chinese (中文) for all natural language.** Code, commands, paths, API names, and exact error strings stay in their original language — do not translate them. This rule overrides all other language rules.然后保留原有的Drop: ...和Preserve users dominant language...等内容不变。 **本文声明**本文为个人实践记录内容基于 [Caveman 项目官方文档](https://github.com/JuliusBrussee/caveman) 整理。所有命令和配置均经过本人亲测验证。代码块中的脚本来源已标注如有侵权请联系删除。
