token-saver: Otimização Profissional de Tokens para Claude Code

🇧🇷 Português

O que é token-saver?

token-saver é uma ferramenta profissional de diagnóstico e otimização de consumo de tokens no Claude Code. Reduz o consumo de tokens em até 85% através de 5 camadas de otimizações validadas.

⚡ Quick Start (3 passos)

1. Instale o skill:

   • Copie token-saver.skill para ~/.claude/skills/
   • Reinicie o Claude Code

2. Execute o diagnóstico:

   hljs language-bash

   Copy

   /token-saver AUDIT
   

3. Aplique as otimizações:

   hljs language-bash

   Copy

   /token-saver SETUP
   

🎯 5 Camadas de Otimização

📚 Documentação Completa

• SKILL.md — Guia completo com todas as otimizações
• sources.md — Referências validadas e benchmarks
• CHANGELOG.md — Histórico de versões

🛠 Scripts de Setup Automático

• Linux/macOS/WSL: scripts/setup.sh
• Windows (PowerShell): scripts/setup-windows.ps1

Execute automaticamente para:

• Configurar ~/.claude/settings.json
• Criar .claudeignore no projeto
• Diagnosticar MCPs instalados
• Auditar CLAUDE.md

🔍 Modo AUDIT vs SETUP

AUDIT (Diagnóstico)

/token-saver AUDIT

• Relatório rápido do consumo atual
• Identifica oportunidades de otimização
• Sem fazer mudanças

SETUP (Aplicar Otimizações)

/token-saver SETUP

• Aplica as 5 camadas automaticamente
• Configura settings.json
• Cria .claudeignore
• Pronto para uso imediato

📊 Impactos Validados

• Tool Search: −85% de tokens de definições de ferramentas
• .claudeignore: −30 a −40% por sessão
• Subagent Haiku: −80% custo de subagentes
• MAX_THINKING=10000: −70% thinking tokens
• /compact a 60%: Previne degradação de contexto

🐛 Bugs Conhecidos (Abril 2026)

🤝 Contribua

Encontrou um problema ou tem uma sugestão? Abra uma Issue ou uma Discussion.

📄 Licença

MIT License — veja LICENSE para detalhes.

🇬🇧 English

What is token-saver?

token-saver is a professional tool for diagnosing and optimizing token consumption in Claude Code. Reduces token usage by up to 85% through 5 validated optimization layers.

⚡ Quick Start (3 steps)

1. Install the skill:

   • Copy token-saver.skill to ~/.claude/skills/
   • Restart Claude Code

2. Run diagnosis:

   hljs language-bash

   Copy

   /token-saver AUDIT
   

3. Apply optimizations:

   hljs language-bash

   Copy

   /token-saver SETUP
   

🎯 5 Optimization Layers

📚 Full Documentation

• SKILL.md — Complete guide with all optimizations
• sources.md — Validated references and benchmarks
• CHANGELOG.md — Version history

🛠 Automatic Setup Scripts

• Linux/macOS/WSL: scripts/setup.sh
• Windows (PowerShell): scripts/setup-windows.ps1

Execute automatically to:

• Configure ~/.claude/settings.json
• Create .claudeignore in your project
• Diagnose installed MCPs
• Audit CLAUDE.md

🔍 AUDIT vs SETUP Mode

AUDIT (Diagnosis)

/token-saver AUDIT

• Quick report of current consumption
• Identifies optimization opportunities
• No changes made

SETUP (Apply Optimizations)

/token-saver SETUP

• Applies all 5 layers automatically
• Configures settings.json
• Creates .claudeignore
• Ready for immediate use

📊 Validated Impacts

• Tool Search: −85% tool definition tokens
• .claudeignore: −30 to −40% per session
• Subagent Haiku: −80% subagent cost
• MAX_THINKING=10000: −70% thinking tokens
• /compact to 60%: Prevents context degradation

🐛 Known Bugs (April 2026)

🤝 Contribute

Found an issue or have a suggestion? Open an Issue or Discussion.

📄 License

MIT License — see LICENSE for details.