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 RemoteSigned |
raw.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（无需管理员），运行：
powershell
irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex
安装器会提示选择 Agent：
text
Detected 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文件夹，全选（Ctrl+A）所有内容（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 中运行安装命令
powershell
npx 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 会自动存放在：
text
C:\Users\jiugu\.claude\skills\
该目录下会包含已安装的 caveman 系列 Skills 优化写法。
✅ 步骤二：验证安装
在 PowerShell 中运行：
powershell
ls 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
你会看到类似输出：
text
Output tokens: 215 Est. without caveman: 614 Est. tokens saved: 399 (~65% of output)
🛑 步骤七：关闭或切换模式
关闭精简模式：在对话中输入
normal mode，即可恢复正常回答风格。重新开启：再次输入
/caveman。切换强度：输入
/caveman ultra或/caveman lite。
🔧 常见问题 FAQ
Q: 输入/caveman提示Unknown command？
A: 说明安装未成功。检查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 user's 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 user's dominant language...等内容不变。
📌 **本文声明**：本文为个人实践记录，内容基于 [Caveman 项目官方文档](https://github.com/JuliusBrussee/caveman) 整理。所有命令和配置均经过本人亲测验证。代码块中的脚本来源已标注，如有侵权请联系删除。