Un solo archivo CLAUDE.md con 8 reglas que cortan el relleno típico de Claude (saludos, despedidas, re-lectura innecesaria, reescritura de archivos enteros). Reportes reales: 63% menos palabras en general, 75% menos en code reviews. Setup: 30 segundos.
Claude te cobra por cada token que lee o escribe. Sin instrucciones específicas:
Todo eso son tokens que pagás (en plan API o que consumen tu cuota en plan flat).
Token Efficient es un archivo CLAUDE.md con 8 reglas que cortan ese desperdicio. Repo: drona23/claude-token-efficient.
Si te fijás en 10 outputs típicos de Claude:
Total fluff/output: 40-50 tokens que no aportan valor.
En 100 interacciones diarias: 4000-5000 tokens que se podrían destinar a contenido útil.
Sin esta regla, le pedís "cambiame el color del botón Primary" y Claude:
Total: 3000 tokens.
Con la regla:
Total: 1530 tokens. ~50% menos.
Creá archivo CLAUDE.md en la raíz de tu proyecto con:
# CLAUDE.md - Token Efficient Rules
1. Think before acting. Read existing files before writing code.
2. Be concise in output but thorough in reasoning.
3. Prefer editing over rewriting whole files.
4. Do not re-read files you have already read unless the file may have changed.
5. Test your code before declaring done.
6. No sycophantic openers or closing fluff.
7. Keep solutions simple and direct.
8. User instructions always override this file.curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.mdEn la raíz del proyecto — al mismo nivel que package.json o README.md. Claude Code lo detecta automáticamente al abrir el proyecto.
Usuarios que probaron las 8 reglas:
El 16% de ahorro total es conservador — depende del balance entre input (donde no ahorrás mucho) y output (donde ahorrás mucho).
Para sesiones con mucho output (generación de código grande, refactors largos), el ahorro real puede ser 30-50%.
> Cambiame el color del botón primary a azul
Claude:
"¡Excelente! Voy a ayudarte a cambiar el color del botón primary
a azul. Para hacerlo correctamente, primero voy a leer el archivo
del botón para entender su estructura actual.
[lee archivo]
Como puedes ver, el botón está definido usando Tailwind CSS con
clases utility. Voy a actualizar el color de fondo de bg-purple-600
a bg-blue-600, y también actualizar el hover state correspondiente.
Aquí está el archivo completo actualizado:
[200 líneas del archivo entero, con cambios mínimos]
¡Listo! He cambiado el color del botón a azul. El cambio incluye:
- bg-purple-600 → bg-blue-600
- hover:bg-purple-700 → hover:bg-blue-700
¿Hay algo más que quieras ajustar? Estoy aquí para ayudar!"Tokens: ~600+
> Cambiame el color del botón primary a azul
Claude:
[lee archivo]
[edit: bg-purple-600 → bg-blue-600, hover:bg-purple-700 → hover:bg-blue-700]
Hecho.Tokens: ~200
Ahorro: 67%. La misma acción, sin fluff.
Sequential Thinking lo hace pensar mejor antes de actuar (regla 1 reforzada). Las reglas + Sequential = combo de pensamiento profundo + output conciso.
Code Simplifier actúa sobre el código que genera. Las reglas actúan sobre el output narrativo. Los dos se complementan sin pisarse.
Si ya tenés CLAUDE.md con reglas de tu proyecto, agregá estas 8 al final:
[Tu CLAUDE.md actual con reglas del proyecto]
## Token Efficient Rules
1. Think before acting. Read existing files before writing code.
2. Be concise in output but thorough in reasoning.
3. Prefer editing over rewriting whole files.
4. Do not re-read files you have already read unless the file may have changed.
5. Test your code before declaring done.
6. No sycophantic openers or closing fluff.
7. Keep solutions simple and direct.
8. User instructions always override this file.El 63% es para output narrativo. Si tu sesión es mayoritariamente código generado, el ahorro es menor. Las reglas afectan principalmente el "habla" no el "código".
Si estás aprendiendo y querés que Claude te explique las cosas, las reglas matan eso. Quitalas para sesiones educativas.
Si después de cargar pedís "explicame en detalle", la regla 8 (user override) gana. Bien. Pero no te frustres si Claude es menos charlatán por defecto — eso es lo que pediste con las reglas.
Las 8 son baseline. Después de 1-2 semanas, podés:
~/.claude/CLAUDE.md sin pensar#Si las pegás global, aplican a todos los proyectos. A veces no querés eso (ej: para learning projects sí querés explicaciones largas). Cargalas por proyecto salvo que sepas que querés global.
Las 8 base + agregar:
9. Always run tests after each change.
10. Never disable error handling to "make it work".
11. Comments only when intent isn't obvious from code.Las 8 base excepto la 2 y 6 (ahí sí querés explicaciones):
1. Think before acting. Read existing files before writing code.
3. Prefer editing over rewriting whole files.
4. Do not re-read files you have already read unless the file may have changed.
5. Test your code before declaring done.
7. Keep solutions simple and direct.
8. User instructions always override this file.
[Nuevas reglas educativas]
9. After making changes, briefly explain WHAT you did and WHY.
10. If the user asks "why", give detailed reasoning.Las 8 + agregar:
9. Document all decisions in commit messages.
10. When in doubt about scope, ask before expanding.Para uso intensivo (~3-5h/día con Claude Code):
Ahorro anual estimado para dev intensivo: $200-500/año en costo API o equivalente en horas de plan flat.
Inversión: 30 segundos de setup.
ROI: difícil de mejorar.