字
字节笔记本
2026年5月6日
claude-token-efficient：一个 CLAUDE.md 文件减少 63% Token 消耗
API中转
¥120
claude-token-efficient 是一个开源的 CLAUDE.md 配置文件，通过限制 Claude 的输出冗余来节省 Token 消耗。项目基准测试显示可减少约 63% 的输出 Token，适用于高频使用的自动化流水线和批量代码生成场景。
项目简介
claude-token-efficient 由 Drona Gangarapu 开发，是一个极简的「即插即用」方案。整个项目本质上就是一个经过精心调优的 CLAUDE.md 文件，通过预设规则约束 Claude 的输出行为，消除不必要的寒暄、重复和过度工程化。
核心问题：Claude 默认的回复风格存在大量浪费 Token 的行为：
- 每次回复以 "Sure!"、"Great question!" 开头
- 结尾附带 "I hope this helps!" 等客套话
- 使用破折号、智能引号等特殊字符
- 先复述问题再回答
- 主动添加未经请求的建议
- 过度工程化代码实现
- 对错误说法表示赞同（"You're absolutely right!"）
核心特性
- 零配置接入 — 一个文件丢进项目根目录即可生效，无需修改代码
- 63% 输出缩减 — 基准测试显示同等信息量下 Token 大幅减少
- 多种 Profile — 提供编码、基准测试、代理系统、数据分析等不同场景的配置文件
- 版本化配置 — v5/v6/v8 三个版本适应不同复杂度的任务
- 覆盖机制 — 用户指令始终优先，需要详细回复时直接提问即可
- 模型无关 — 规则基于上下文约束，理论上适用于任何模型
基准测试结果
使用相同 5 个提示词，对比无 CLAUDE.md（基线）和有 CLAUDE.md（优化后）的结果：
| 测试项 | 基线 | 优化后 | 缩减比例 |
|---|---|---|---|
| 解释 async/await | 180 词 | 65 词 | 64% |
| 代码审查 | 120 词 | 30 词 | 75% |
| 什么是 REST API | 110 词 | 55 词 | 50% |
| 幻觉纠正 | 55 词 | 20 词 | 64% |
| 合计 | 465 词 | 170 词 | 63% |
规模化成本节省
| 使用量 | 每日节省 Token | 月度节省（Sonnet） |
|---|---|---|
| 100 提示/天 | ~9,600 | ~$0.86 |
| 1,000 提示/天 | ~96,000 | ~$8.64 |
| 3 个项目合计 | ~288,000 | ~$25.92 |
效果对比
代码审查 — 无 CLAUDE.md：
text
Great question! I can see you're working with a loop. Let me take a look at that.
That's a thoughtful piece of code! However, I notice there's actually a subtle bug
here that's worth pointing out. The condition i <= arr.length should be i < arr.length.
Using <= means the loop will run one extra iteration... You might also want to consider
using modern array methods like forEach, map, or for...of which are cleaner...
Great catch on reviewing this - it's always good practice to double-check loop
boundaries! I hope this review was helpful. Feel free to share more code anytime!120 词。
代码审查 — 有 CLAUDE.md，相同提示词：
text
Bug: <= causes an off-by-one error. On the final iteration arr[arr.length] is undefined.
Fix:
for (let i = 0; i < arr.length; i++)30 词。同样的修复内容，减少 75% 的 Token。
安装与使用
方式一：直接下载（推荐）
bash
curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md方式二：克隆并选择 Profile
bash
git clone https://github.com/drona23/claude-token-efficient
cp claude-token-efficient/profiles/CLAUDE.coding.md your-project/CLAUDE.md可用 Profile
| Profile | 适用场景 |
|---|---|
CLAUDE.md | 通用 — 适用于任何项目 |
profiles/CLAUDE.benchmark.md | Token 成本优化基准测试 |
profiles/CLAUDE.coding.md | 开发项目、代码审查、调试 |
profiles/CLAUDE.agents.md | 自动化流水线、多代理系统 |
profiles/CLAUDE.analysis.md | 数据分析、研究、报告 |
版本化配置
| 版本 | 策略 | 工具调用预算 | 适用场景 |
|---|---|---|---|
v5 | 多文件结构化 | 50 次 | 需要详细工作流和代理定义的复杂项目 |
v6 | 单次执行 | 50 次 | 最少迭代即可完成的任务 |
v8 | 超精简最少轮次 | 20 次 | 对成本敏感的简单任务流水线 |
适用场景分析
适合使用的场景
- 高输出量的自动化流水线（批量代码生成、代理循环）
- 需要一致、可解析输出格式的团队协作
- 重复性结构化任务，冗余回复会在数百次调用中累积
不适合使用的场景
- 单次短查询 — CLAUDE.md 本身占用输入 Token，低输出时反而增加成本
- 探索性或架构性工作 — 需要深入讨论和多方案对比时，精简输出会限制思考
- 需要保证可解析输出的场景 — 使用 JSON 模式或工具调用的 Schema 更可靠
项目链接
- GitHub 仓库：https://github.com/drona23/claude-token-efficient
- 作者：Drona Gangarapu
- 许可证：MIT
分享: