用途
Token Saver for Claude Code 旨在帮助用户更高效地使用 Claude Code 的 5 小时和每周计划限制（或 API 花费），在保证输出质量的前提下减少 token 消耗。它有两个主要任务：一是在激活期间遵循精简工作规则；二是在用户请求审计或频繁触达限制时，执行审计与配置调优流程。
主要能力
精简工作规则
- 行动前：若请求存在影响结果的歧义，先提一个简短问题而非猜测；对于多文件或高风险修改，先列出计划再编辑；一旦信息足够就停止探索，不因窄需求而浏览整个代码库。
- 阅读：先定位（grep、glob、符号搜索、LSP），再只读取大文件的相关范围；不重复读取已在上下文中且未更改的文件；绝不读取锁文件、生成文件、压缩文件、构建输出、第三方依赖或完整日志，而是搜索它们。
- 工具输出：优先使用摘要形式（如
git status -s、git diff --stat、git log --oneline -n 20、单目录ls）；运行最窄的验证命令并加静默标志，长输出通过tail -n 40或grep -E "FAIL|Error|error:"过滤；独立工具调用合并到同一轮，同一文件的多次编辑一次完成。 - 委托：默认自己完成；仅当需要阅读约十个以上文件、输出可浓缩为简短摘要、有三个以上独立只读任务可并行，或需要独立审查时才委托子代理。委托时使用更便宜的模型、给出精确简报，并要求返回带
path:line引用的结论。 - 回答：先给结果；不重述请求、不罗列未更改内容、不倾倒整个文件；答案大小与问题匹配；可选附加项用一行提供。
- 不牺牲正确性：对于难以发现的 bug、安全、数据丢失风险或架构问题，充分阅读和推理；绝不为了省 token 跳过验证，而是让验证更有针对性。
会话指导
在自然断点处（每次断点最多一次）给出一行建议：切换到无关任务时建议新会话；长会话同一任务建议用聚焦提示压缩；常规工作使用旗舰模型或高推理强度时建议更便宜的设置；难题使用小模型时建议升级。
Claude Code 特有事项
- 子代理：遵循上述委托规则；内置 Explore 代理（只读，运行于 Haiku）适合代码库搜索；否则在简单简报中传递
model: "haiku"或 sonnet。注意新子代理会重新加载 CLAUDE.md 且缓存冷，而 fork 继承会话并读取父缓存，当任务需要已有知识时 fork 启动成本更低。代理团队成本是普通会话的数倍，绝不要为了省 token 而启动。 - 缓存意识：切换模型、在多数模型上更改推理强度、开启快速模式、会话中连接 MCP 服务器，都会使下一次请求重新读取整个历史且无缓存。建议仅在任务边界进行这些更改。
- 可建议用户执行的命令（用户自行运行，技能不能执行）：如
/clear（免费，切换无关任务前，必要时先/rename以便日后/resume）、/compact <保留内容>（长会话同一任务且上下文较大时，在自然断点使用，成本一次大请求，不要重复）、/rewind（走错路径时，比说服模型回退更省）、/model sonnet或/effort low/medium（常规编辑、Opus 或高推理强度时在任务边界切换）、/model opusplan（规划后实施）、/usage和/context（查看用量去向）、计划模式（复杂修改前使用）。
使用方式
审计与配置
当用户请求审计、设置、减少用量或频繁触达限制时：
- 从项目根目录运行
node <技能目录>/scripts/audit.mjs --agent claude-code。该脚本只读，会打印警告及修复建议。没有 Node.js 时，按references/levers.md手动检查相同项。 - 按预期节省量排序报告发现，每项几行。始终加载的内容（CLAUDE.md、未限定范围的规则、MCP 服务器、技能描述）通常影响最大，因为每次请求都要支付。
- 提出具体修改，使用
references/levers.md中的确切设置键。设置和 CLAUDE.md 属于用户：展示差异，获得同意后再应用。注意 CLAUDE.md 的修改在/clear、/compact或重启后生效。 - 主动提出添加始终开启的片段：技能只在触发时加载，因此精简工作规则需要一个永久位置。将
assets/always-on.md追加到 CLAUDE.md（项目）或~/.claude/CLAUDE.md（所有项目），除非已有等效章节。
适用场景
- 用户接近或达到 Claude Code 使用限制，或看到高消耗。
- 用户希望审计并优化 Claude Code 配置以减少 token 使用。
- 日常使用 Claude Code 时希望遵循精简工作习惯。
限制
- 技能只能提供建议，许多命令（如
/clear、/compact、/rewind、模型切换）需用户自行执行，技能无法直接运行。 - 审计脚本需要 Node.js；否则需手动检查。
- 配置修改（设置、CLAUDE.md）属于用户，必须展示差异并经同意后应用。
- 不保证具体节省比例或效果，需根据实际使用情况评估。