☰
Caveman 部署与使用完全手册(Windows + Claude Code):TaoToken 统一 Key 配置与插件接入
2026/9/28 18:58:30 网站建设 项目流程

1. Windows 上跑 Caveman 插件,为什么先要把 Token 通道理顺

Caveman 是一个 Claude Code 的提示词插件,核心作用就一句话:强制 AI 用“穴居人”风格回答,把客套话、过渡句、重复解释全部砍掉,平均节省约 65% 的输出 Token,最高能到 87%。它和 Headroom(压缩输入)正好互补,一个管输入一个管输出,双向省钱。适合谁?适合每天在 Claude Code 里跑长任务、看大段解释看到烦、又在意 API 账单的 Windows 开发者。

但我在 Windows 上第一次装的时候,卡住的不是 Caveman 本身,而是 Token 接入这一层。Claude Code 要能正常调用模型,得先有一个稳定的 API 通道和统一的 Key;Caveman 装好之后,所有请求还是走这条通道,如果通道没配好,插件装了也验证不了。所以这篇手册的顺序是:先把 TaoToken 的统一 Key 和 API 通道配好,再装 Caveman,最后跑一次完整调用验证,确认整条链路通了。

TaoToken 在这里的角色是统一入口:一个 Key 覆盖 Claude Code、Cline、CC Switch 这些客户端,base_url 指向https://taotoken.net/api,不用每个工具单独申请一套凭证。下面所有配置都围绕这个通道展开,Windows 路径以C:\Users\你的用户名\为基准,你替换成自己的实际用户名即可。

2. 前置准备:TaoToken Key 与 Claude Code 环境

2.1 拿到统一 Key

打开控制台创建 API Key,地址是https://taotoken.net/console。创建完复制那串sk-开头的字符串,先存到记事本里,后面 settings.json 和 config.toml 都要用。如果你还没决定用哪个模型,可以先去模型对话页面试一下https://taotoken.net/models,确认通道能正常返回再往下走。

2.2 确认 Claude Code CLI 可用

在 PowerShell 里执行:

claude --version

能打印版本号就说明 CLI 装好了。如果提示找不到命令,先装 Node.js(含 npm),再执行npm install -g @anthropic-ai/claude-code。装完重开一个 PowerShell 窗口,让 PATH 生效。

2.3 环境变量方式(可选,但推荐)

Claude Code 支持用环境变量指定通道,这样 settings.json 里就不用重复写 Key。在 PowerShell 里临时设置:

$env:ANTHROPIC_BASE_URL = "https://taotoken.net/api" $env:ANTHROPIC_API_KEY = "sk-你的Key"

想永久生效就写进用户环境变量:

[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://taotoken.net/api", "User") [Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-你的Key", "User")

设完关掉当前窗口重开,用echo $env:ANTHROPIC_BASE_URL确认读到了。

3. 可复制配置:settings.json 与 config.toml 骨架

3.1 settings.json 骨架

Claude Code 的用户级配置在C:\Users\你的用户名\.claude\settings.json。如果文件不存在就新建,内容如下(把 Key 换成你自己的):

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "sk-你的Key" }, "statusLine": { "type": "command", "command": "powershell -ExecutionPolicy Bypass -File \"C:\\Users\\你的用户名\\.claude\\plugins\\cache\\caveman\\caveman\\版本号\\src\\hooks\\caveman-statusline.ps1\"" } }

注意两点:statusLine里的版本号目录(类似0d95a81d35a9)要按你实际安装后的路径填,不确定就进C:\Users\你的用户名\.claude\plugins\cache\caveman\caveman\看一眼真实文件夹名;JSON 里反斜杠要写成双反斜杠,否则解析会报错。

3.2 config.toml 骨架(Cline / CC Switch 用)

如果你同时用 Cline 或 CC Switch 这类客户端,它们读的是 TOML 配置。以 Cline 为例,在设置里选 “OpenAI Compatible” 或自定义 provider,填入:

[provider] name = "taotoken" base_url = "https://taotoken.net/api" api_key = "sk-你的Key" model = "claude-sonnet-4-20250514" [options] timeout = 120 max_retries = 3

CC Switch 的配置思路一样:新建一个 profile,base_url 填https://taotoken.net/api,Key 填同一串,模型名按你实际要用的填。这样 Claude Code、Cline、CC Switch 三边共用一套凭证,换工具不用重新申请。

3.3 安装 Caveman 插件

网络通畅时用一键脚本,以普通用户身份打开 PowerShell:

irm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex

提示选择 Agent 时输入1(Claude Code)回车,看到Caveman installed successfully!即可。如果脚本拉不下来,走手动方式:下载仓库 ZIP 解压,把commands、plugins、skills、CLAUDE.md等内容复制到C:\Users\你的用户名\.claude\caveman\下。也可以用 skills 方式装:

npx skills add JuliusBrussee/caveman -a claude-code

空格选中cavecrew、caveman-help、caveman-stats三项,选 Global 全局安装,两次确认都输yes。

4. 验证请求:一次完整调用确认链路通了

4.1 先验证 Token 通道

在 PowerShell 里直接打一次 API,确认 Key 和 base_url 没问题:

curl.exe https://taotoken.net/api/v1/messages ` -H "x-api-key: sk-你的Key" ` -H "anthropic-version: 2023-06-01" ` -H "content-type: application/json" ` -d "{\"model\":\"claude-sonnet-4-20250514\",\"max_tokens\":64,\"messages\":[{\"role\":\"user\",\"content\":\"say hi\"}]}"

返回里带content字段就说明通道通了。这一步不通,后面 Caveman 装了也白搭,先排查 Key 和 base_url。

4.2 再验证 Caveman 生效

启动 Claude Code,输入/caveman,看到Caveman mode active说明插件加载成功。想永久生效就执行/caveman:caveman-init,它会把规则写进当前项目的CLAUDE.md,之后每次在该目录启动都自动进入精简模式。

随便问一个问题,观察回复是否变得极简。然后执行统计命令:

/caveman:caveman-stats

正常会输出类似:

Output tokens: 215 Est. without caveman: 614 Est. tokens saved: 399 (~65% of output)

看到这个就说明整条链路——TaoToken 通道 + Claude Code + Caveman 插件——全部跑通了。如果底部还显示了[CAVEMAN] 12.4k状态条,说明 settings.json 里的 statusLine 也配对了。

5. 本篇常见错排查

PowerShell 执行策略拦截脚本:报 “无法加载文件,因为在此系统上禁止运行脚本”。执行Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned,输 Y 确认,再重跑安装。

/caveman提示 Unknown command:说明插件没装成功。检查C:\Users\你的用户名\.claude\caveman\是否存在且内容完整,缺了就按手动方式重新复制。

/caveman-stats提示未知命令:命令格式错了,正确写法是/caveman:caveman-stats,中间有个冒号,别漏。

状态条不显示:检查 settings.json 里statusLine的路径是否指向真实存在的.ps1文件,版本号目录要对,改完重启 Claude Code。

API 返回 401 或 403:Key 错了或没生效。确认ANTHROPIC_API_KEY和 settings.json 里的是同一串,且没有多余空格。改完环境变量要重开窗口。

Caveman 压缩后回复变英文:找到~\.claude\skills\caveman\skill.md,在## Rules开头加一行**CRITICAL: Always reply in Chinese (中文) for all natural language.**,代码、命令、路径、报错原文保持原样不翻译,这条规则优先级最高,会覆盖后面的语言跟随逻辑。

Caveman 会影响代码质量吗:不会。它只改自然语言表述风格,代码、命令、路径、错误信息这些关键内容完整保留。

6. 后续怎么用:把通道和插件固定下来

配置跑通之后,日常就三件事:Key 统一放在 TaoToken 控制台管理,需要轮换或加额度直接去https://taotoken.net/api-keys操作;Claude Code 的接入细节和参数说明看https://taotoken.net/doc;如果你要长期跑编码任务或 Agent,用 Coding Plan 把额度固定下来更省心,入口在https://taotoken.net/coding-plan。

Caveman 这边,常用命令记住几个就够:/caveman切换开关,/caveman ultra或/caveman lite调强度,/caveman:caveman-stats看节省,normal mode恢复正常回答。它和 Headroom 一起用就是输入输出双向压缩,账单会明显下来。我自己的习惯是把caveman-init写进常用项目的 CLAUDE.md,这样每次打开就自动进入精简模式,不用手动敲命令。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询