claude-token-efficient 是什么?

claude-token-efficient 是一个极简项目:一份 CLAUDE.md 文件,丢进你的项目就能让 Claude 的回复更简洁,在「输出量大」的工作流里减少总 token 消耗。它通过规则约束 Claude 默认的啰嗦行为——去掉「Sure!/Great question!」开场与「I hope this helps!」收尾、不复述问题、不加无关建议、不过度工程化、避免破折号/智能引号等会破坏解析器的字符。作者很坦诚:指令文件每轮都占输入 token,文件要短,否则可能得不偿失;规则与模型无关、但基准只在 Claude 上跑过。MIT、约 5,400 星。

⭐ 4,115 Stars 🍴 289 Forks 作者: drona23
来源:README The Problem/Two Options/When This Helps、GitHub meta(drona23/claude-token-efficient,MIT) 查看 GitHub 仓库 →

为什么值得关注

用 Claude Code 时每个字都花 token,而默认输出里大量是客套、复述与过度工程,纯属浪费。claude-token-efficient 用「一份 CLAUDE.md、零代码改动、即插即用」的最轻方式让回复变简洁、在自动化/高输出流水线里省钱,并难得地把「什么时候有用、什么时候反而更贵」讲清楚。简单实用、诚实,因此积累约 5,400 星。

来源:README The Problem/When This Helps vs When It Doesn't、GitHub meta(stars 5399、created_at 2026-03-30、pushed_at 2026-04-22)

核心功能

一份 CLAUDE.md 让回复简洁

把规则写进项目根的 CLAUDE.md,每条消息自动生效:去客套开场/收尾、不复述问题、不加无关建议、不过度工程化、不附和错误说法、避免破折号/智能引号/Unicode 等破坏解析的字符——只输出有价值的内容。

来源:README The Problem/Option 2
两种用法:贴规则 或 放文件

Option 1 在新会话里粘贴一行精简规则(即时、零设置、适合一次性任务);Option 2 放 CLAUDE.md(即装即忘、每条消息自动、更适合常规与流水线、规模化更省)。按工作流二选一。

来源:README Two Options/How They Compare
诚实的适用边界

明确「适合高输出量自动化(简历 bot、agent 循环、代码生成)、重复结构化任务、需一致可解析输出的团队」;「不值得用于单条短查询、偶尔一次性使用、修复幻觉/架构漂移这类深层问题、每任务新开会话的流水线、或以讨论/反驳为主的探索性工作」。需保证可解析输出时建议改用 API 的结构化输出。

来源:README When This Helps vs When It Doesn't

技术架构

项目极简,核心是一份 CLAUDE.md(约束 Claude 输出风格的规则),外加 RULES.md(规则说明)、BENCHMARK.md(在 Claude 上的省 token 基准)、profiles/(不同强度的规则档)与 examples/。它不含运行时代码——CLAUDE.md 是 Claude Code 在会话中自动读取的项目级指令文件,规则即生效。作者反复提醒:这类指令文件每轮都加输入 token,所以文件要短、只在持久会话与高输出场景才划算;要可靠的可解析输出应改用 API 的 JSON/工具 schema 等结构化输出,而非靠提示规则。

来源:README/仓库结构(CLAUDE.md/RULES.md/BENCHMARK.md/profiles/examples)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) Claude Code(读取 CLAUDE.md)Claude Code(… 规则模型无关(基准仅在 Claude 上验证)规则模型无关(基… 一份 CLAUDE.md 让回复简洁一份 CLAUDE.md 让回… 两种用法:贴规则 或 放文件两种用法:贴规则 或… 诚实的适用边界 claude-token-efficient 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言Markdown 指令(CLAUDE.md/规则)框架Claude Code 项目级指令(CLAUDE.md)
Claude Code(读取 CLAUDE.md)规则模型无关(基准仅在 Claude 上验证)
纯文件,无服务端;放进项目根目录即生效,或粘贴规则到会话
来源:README Two Options/Model support

快速上手

两种用法任选。快速:在新会话里粘贴一行规则,如「Rules: Read files first. Write complete solution. Test once. No over-engineering.」即时生效。常规:把仓库的 CLAUDE.md 放到你项目根目录(your-project/CLAUDE.md),零代码改动,之后每条消息自动让 Claude 输出更简洁。可按需选 profiles/ 里不同强度的规则档。注意保持文件短小——它每轮都占输入 token,只在高输出/持久会话场景才更省;需要严格可解析输出时改用 API 结构化输出。
来源:README Two Options/When This Helps

使用场景

适合在高输出量场景控制 Claude 啰嗦、省 token:自动化流水线(简历 bot、agent 循环、批量代码生成)、重复的结构化任务、需要跨会话一致且可解析输出的团队。对单条短查询、偶尔一次性使用、或以讨论/探索为主的工作则不划算(文件每轮占 token,低输出时反而更贵)。把它当作「在重复、高输出工作流里给 Claude 套一层简洁规则」的轻量工具即可。

来源:README When This Helps vs When It Doesn't

优势与局限

优势

  • 极简即用:一份 CLAUDE.md、零代码改动、每条消息自动生效,或一行规则即时套用。
  • 针对真实浪费(客套/复述/过度工程),在高输出流水线里能实测省 token(附 BENCHMARK)。
  • 难得的诚实:明确讲清适用与不适用边界,不夸大,并指出结构化输出才是可靠解析的正解。
  • MIT 开源、模型无关思路、约 5,400 星。

局限

  • 本身是提示规则:指令文件每轮占输入 token,低输出/一次性场景反而更贵,需保持短小。
  • 只约束风格,修不了幻觉、架构漂移等深层问题(那需要 hooks/gate/机制化强制)。
  • 基准仅在 Claude 上验证,本地/其它模型效果未测。
  • 每任务新开会话的流水线享受不到持久会话的省 token 效果。
来源:README When This Helps vs When It Doesn't/Model support/The Problem

最新版本

项目以单文件 CLAUDE.md(配 RULES.md/BENCHMARK.md/profiles/examples)形式发布,无打 tag 的正式 Release。MIT 开源、约 5,400 星。最近一次更新在 2026-04-22。

来源:仓库结构、GitHub meta pushed_at 2026-04-22、created_at 2026-03-30

总结评价

claude-token-efficient 是个「小而诚实」的实用项目:一份 CLAUDE.md 就能让 Claude 去掉客套、复述与过度工程,在高输出量的自动化流水线里实测省 token,零代码改动、即装即忘。难得的是它把适用边界讲得明明白白——单条短查询或一次性使用反而更贵、修不了幻觉这类深层问题、要可靠解析应用 API 结构化输出。对跑重复、高输出 Claude Code 工作流的人,它是顺手的省钱小工具;对偶尔用或探索性工作的人则不必。把它当作「按场景套用的简洁规则」来用,恰如其分。

来源:综合 README、适用边界与 GitHub meta 的事实判断
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 11:51. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件