本手册基于你的实际成功经验整理。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：一键自动安装（网络通畅时推荐）

以普通用户身份打开 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% 可靠，已验证）

1. 浏览器打开：https://github.com/JuliusBrussee/caveman/archive/refs/heads/main.zip

2. 下载并解压，得到 caveman-main 文件夹。

3. 打开 caveman-main 文件夹，全选（Ctrl+A）所有内容（commands、plugins、skills、CLAUDE.md 等），复制。

4. 在 C:\Users\你的用户名\.claude\ 目录下，新建一个名为 caveman 的文件夹。

5. 将复制的内容粘贴到 C:\Users\你的用户名\.claude\caveman\ 中。

6. 最终结构应为：C:\Users\jiugu\.claude\caveman\（内含 commands、plugins 等文件夹）。

方法C：官方插件库下载

1.powershell中运行

        npx skills add JuliusBrussee/caveman -a claude-code

2.安装器会提示选择：

Select skills to install
│  Search:  
│  ↑↓ move, space select, enter confirm
│
│ ❯ ○ cavecrew
│   ○ caveman
│   ○ caveman-commit
│   ○ caveman-compress
│   ○ caveman-help
│   ○ caveman-review
│   ○ caveman-stats

空格选择回车确认，推荐一下三个 cavecrew，caveman-help，caveman-stats

3.*  Installation scope
|  > Project (Install in current directory (committed with your 
|  project))
|    Global
|  ↑/↓ to navigate • Enter: confirm

选择Global

4.yes

5.yes

此方法会自动在C:\Users\jiugu\.claude\下生成一个skill文件夹，里面会自带caveman

---

✅ 步骤二：验证安装

在 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] 节省统计条，需手动配置。

1. 打开 C:\Users\jiugu\.claude\settings.json。

2. 在根对象中添加（或合并）以下内容：

   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\ 查看具体的版本号文件夹。

3. 保存文件，重启 Claude Code（输入 /exit 退出，再重新运行 claude）。

成功配置后，底部会显示类似 [CAVEMAN] 12.4k 的状态条，实时更新节省的 Token 总量。

---

🧪 步骤六：验证效果

1. 启动 Claude Code（保持 Headroom 终端开着，如果有）。

2. 确保 Caveman 已激活（输入 /caveman 或已执行过 init）。

3. 随便问一个问题，观察回复是否变得极其简短。

4. 输入以下命令查看精确统计：

   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... 等内容不变。