ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

Caveman 部署与使用完全手册(Windows + Claude Code):TaoToken 统一 Key 配置与插件接入

Caveman 部署与使用完全手册(Windows + Claude Code):TaoToken 统一 Key 配置与插件接入 1. Windows 上跑 Caveman 插件为什么先要把 Token 通道理顺Caveman 是一个 Claude Code 的提示词插件核心作用就一句话强制 AI 用“穴居人”风格回答把客套话、过渡句、重复解释全部砍掉平均节省约 65% 的输出 Token最高能到 87%。它和 Headroom压缩输入正好互补一个管输入一个管输出双向省钱。适合谁适合每天在 Claude Code 里跑长任务、看大段解释看到烦、又在意 API 账单的 Windows 开发者。但我在 Windows 上第一次装的时候卡住的不是 Caveman 本身而是 Token 接入这一层。Claude Code 要能正常调用模型得先有一个稳定的 API 通道和统一的 KeyCaveman 装好之后所有请求还是走这条通道如果通道没配好插件装了也验证不了。所以这篇手册的顺序是先把 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 3CC Switch 的配置思路一样新建一个 profilebase_url 填https://taotoken.net/apiKey 填同一串模型名按你实际要用的填。这样 Claude Code、Cline、CC Switch 三边共用一套凭证换工具不用重新申请。3.3 安装 Caveman 插件网络通畅时用一键脚本以普通用户身份打开 PowerShellirm https://raw.githubusercontent.com/JuliusBrussee/caveman/main/install.ps1 | iex提示选择 Agent 时输入1Claude 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 或 403Key 错了或没生效。确认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这样每次打开就自动进入精简模式不用手动敲命令。
返回列表