claude-token-efficient

在使用 Claude Code 或基于 Claude 的自动化工作流时，你是否厌倦了模型那些“礼貌但无用”的废话？

• “当然！这是一个好问题！”
• “希望这对你有帮助，如果有其他需要请告诉我！”
• 在你没要求的情况下复述问题、过度设计代码、或者使用破坏解析器的特殊字符。

这些内容不仅干扰阅读，更在疯狂燃烧你的 Token。对于高频调用的智能体或自动化脚本，这些冗余输出累积起来的成本令人咋舌。

现在，解决方案来了：只需在项目根目录放一个 CLAUDE.md 文件，即可立即“驯化”Claude，让它变得简洁、高效、直击要害。

核心原理：用输入换输出

CLAUDE.md 是一个特殊的指令文件，Claude Code 会自动读取并遵循其中的规则。

• 机制：通过预先定义严格的输出规范（如“禁止客套话”、“只输出代码”、“先思考后行动”），强制模型跳过所有不必要的生成步骤。
• 代价与收益：
  • 代价：每次对话都会消耗少量 Input Token 来读取该文件。
  • 收益：大幅削减 Output Token（通常减少 50%-75%）。
  • 结论：只要你的任务输出量足够大（如代码生成、长文本分析、多轮调试），净节省非常可观。

实测数据：省钱才是硬道理

1. 内部基准测试（5 个典型提示）

效果对比：

• 默认：“好问题！我看到你在处理循环...这是一段深思熟虑的代码！然而...你可能还想考虑...很高兴你能审查...希望有帮助！” (120 词)
• 优化：“Bug：<= 导致差一错误。修复：for (let i = 0; i < arr.length; i++)” (30 词)

2. 外部独立基准测试 (v8 配置 vs C-structured)

在 3 个编码挑战中，优化后的配置在总成本上降低了 17.4%，特别是在复杂的 WebSocket 任务中，避免了昂贵的调试循环。

3. 规模化收益估算 (按 Claude Sonnet 定价)

(注：对于企业级高频调用，每月节省可达数百甚至数千美元)

它能修复什么？

如何使用？

方法一：一键下载（推荐）

在你的项目根目录执行：

curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md

方法二：手动复制

创建一个名为 CLAUDE.md 的文件，填入以下核心规则（示例）：

# Claude Code Efficiency Rules

1. **No Fluff**: Do not start with "Certainly!", "Here is the code", or end with "Hope this helps". Go straight to the solution.
2. **Concise**: Be brief. Explain only when necessary.
3. **Targeted Edits**: Do not rewrite entire files unless absolutely necessary. Show only the changed lines or blocks.
4. **Think First**: Before coding, briefly outline your plan if the task is complex.
5. **Verify**: Run tests or verification steps before claiming a task is complete.
6. **No Sycophancy**: If the user is wrong, correct them politely but firmly. Do not agree with incorrect premises.
7. **Plain Text**: Avoid smart quotes, em-dashes, or unicode characters that break parsers. Use standard ASCII.

方法三：选择特定配置文件

该项目提供了针对不同场景的优化配置（位于 profiles/ 目录）：

• CLAUDE.coding.md: 适合日常开发、Code Review。
• CLAUDE.agents.md: 适合自动化流程、多智能体协作。
• CLAUDE.benchmark.md: 极致压缩，适合跑分或对成本极度敏感的场景。
• CLAUDE.analysis.md: 适合数据分析、研究报告生成。

⚠️ 何时不建议使用？

虽然强大，但 CLAUDE.md 并非万能：

1. 单次简短查询：如果只是一两次简单问答，文件本身的 Input Token 开销可能超过节省的输出。
2. 探索性/架构性工作：如果你需要模型进行头脑风暴、反驳你的观点或提供多种替代方案，过于严格的规则会限制模型的创造力。
3. 需要绝对结构化输出：如果需要 JSON/XML 等严格格式供程序解析，请使用 API 的结构化输出功能 (Structured Outputs)，这比 Prompt 规则更可靠。
4. 频繁新建会话：新会话无法利用持久会话中的上下文积累，且每次都要加载文件，收益较低。

💡 专家提示：组合拳策略

CLAUDE.md 支持层级继承！你可以同时拥有多个文件：

1. 全局文件 (~/.claude/CLAUDE.md)：放置通用偏好（如语气、ASCII 规则）。
2. 项目文件 (./CLAUDE.md)：放置项目特定约束（如“禁止修改 /config 目录”）。
3. 子目录文件 (./src/utils/CLAUDE.md)：放置针对特定模块的规则。

建议：将规则聚焦于你实际遇到的痛点，而不是堆砌通用规则。具体的失败模式（如“静默吞掉错误”）比泛泛的“保持简洁”更有价值。