sup3x/claude-code-eco

31 stars · Last commit 2026-08-16

Eco mode for Claude Code. /eco: -31% to -73% output tokens with critical findings intact; /eco-max: up to -75% with lowered effort. Measured hardest on Claude Fable 5 (fable5), deep-studied on Sonnet 5, works on Opus 4.8 too. We publish our negative results. 82 raw benchmark runs.

README preview

# claude-eco — eco mode for Claude Code

**Claude Code spends your money on work you never asked for: re-reading files it just edited, pasting back diffs it already applied, writing three-paragraph reports for two-line fixes. I measured every token of it, deleted it, and published all 267 raw runs — including the ones where I lose.**

*`/eco`: **−35% to −57% output tokens** on the same review task across Opus 5, Sonnet 5, Opus 4.8 and Fable 5 (n=5 per arm, measured the same day), up to **−73%** on long agentic tasks at high effort — with both planted bugs found in every single run. Haiku is the documented exception. `/eco-max`: up to −75% by dialing reasoning effort down — opt-in, labeled. Since 1.2.0 the same rules also ship as an **output style** (zero invocation cost), plus **opt-in hooks** that enforce the expensive rules mechanically instead of asking the model nicely.*

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Claude Code](https://img.shields.io/badge/Claude%20Code-plugin-blueviolet)](https://code.claude.com/docs/en/plugins) [![Benchmarks](https://img.shields.io/badge/benchmarks-267%20raw%20runs-success)](benchmarks/results.md) [![Claims](https://img.shields.io/badge/every%20number-verified%20in%20CI-brightgreen)](benchmarks/claims.json)

[Quickstart](#quickstart) · [Results](#measured-results) · [What you get](#what-you-get) · [Benchmarks](benchmarks/results.md) · [FAQ](#faq)

![Same answer at half the tokens: baseline 678 output tokens versus 327 with /eco on Sonnet 5, both finding the same bugs](assets/social-preview.png)

## Quickstart

```
/plugin marketplace add sup3x/claude-code-eco
/plugin install claude-eco@claude-eco
/eco
```

View full repository on GitHub →