Reduce 63% los Tokens de Claude con un Solo Archivo
Un archivo CLAUDE.md que elimina la verbosidad innecesaria de Claude y puede reducir hasta 63% los tokens de salida en flujos de trabajo intensivos.
Recurso de la comunidad zeltra
Descarga el proyecto completo, úsalo y personalízalo para tu negocio. Seleccionado y adaptado por Benjamin para la comunidad.
El problema que nadie nombra
Cada palabra que Claude genera tiene un costo. Y Claude, por defecto, genera muchas palabras que no pediste.
Saludos formulaicos. Cierres condescendientes. Restateados de tu pregunta antes de responderla. Sugerencias que no pediste. Codigo sobreingenieriado con abstracciones que nadie solicito. Halagos vacios antes de decirte que te equivocaste.
Todo eso son tokens. Y en flujos de trabajo con alto volumen de salida, ese desperdicio escala rapido.
La solucion: un archivo, una vez
El repositorio claude-token-efficient de Drona Gangarapu resuelve esto con una sola pieza: un archivo CLAUDE.md que le dice a Claude exactamente como comunicarse sin adornos.
Lo deja en la raiz de tu proyecto. Claude lo lee en cada conversacion. Listo.
No es un prompt. No es una extension. Es configuracion persistente que funciona automaticamente.
Creditos: este recurso fue creado por drona23. Gracias por compartirlo con licencia MIT.
Resultados reales
Benchmark interno (5 prompts):
| Configuracion | Palabras | Resultado |
|---|---|---|
| Sin archivo | 465 palabras | Baseline |
| Con CLAUDE.md | 170 palabras | -63% |
Misma informacion entregada. Cero perdida de señal.
Benchmark externo independiente (3 desafios de codigo, config v8):
| Tarea | Costo base | Con CLAUDE.md |
|---|---|---|
| CSV Reporter | $1.131 parte | $0.244 |
| SQLite Windows | - | $0.406 |
| WebSocket | - | $0.285 |
| Total | $1.131 | $0.935 (-17.4%) |
Proyeccion a escala (precios Sonnet):
- 100 prompts/dia = ~$0.86 de ahorro mensual
- 1.000 prompts/dia = ~$8.64 de ahorro mensual
- 3 proyectos activos = ~$25.92 de ahorro mensual
Antes vs despues
La misma revision de codigo. Dos respuestas distintas.
Sin CLAUDE.md:
"Claro, con mucho gusto te ayudo a revisar tu codigo! Es un gran ejercicio para mejorar. He notado que tu funcion tiene un pequeño problema que podria causar comportamiento inesperado en ciertos casos. Antes de continuar, me gustaria destacar que la estructura general es muy buena. El problema esta en el operador
<=en el bucle..."
120 palabras. Mucho ruido.
Con CLAUDE.md:
Bug: <= causa error de fuera de rango. Ultima iteracion accede a arr[arr.length] = undefined.
Fix:
for (let i = 0; i < arr.length; i++)
30 palabras. La misma correccion. 75% menos tokens.
Los 8 comportamientos que elimina
- Codigo escrito sin leer el contexto primero
- Respuestas verbosas por defecto
- Reescritura innecesaria de archivos completos
- Re-lectura redundante de archivos ya leidos
- Validacion y pruebas omitidas
- Halagos al inicio y al final
- Soluciones sobreingenieriadas
- Jerarquia de instrucciones poco clara
Perfiles disponibles
El repositorio incluye cuatro configuraciones segun el tipo de trabajo:
| Perfil | Archivo | Uso ideal |
|---|---|---|
| Base | CLAUDE.md |
Uso general |
| Benchmark | CLAUDE.benchmark.md |
Desafios de codigo |
| Coding | CLAUDE.coding.md |
Desarrollo, revision, debug |
| Agents | CLAUDE.agents.md |
Pipelines de automatizacion |
| Analysis | CLAUDE.analysis.md |
Analisis de datos e informes |
Y tres versiones de configuracion con distintos niveles de agresividad:
| Version | Estrategia | Budget de herramientas | Mejor para |
|---|---|---|---|
| v5 | Multi-archivo estructurado | 50 llamadas | Proyectos complejos |
| v6 | Ejecucion de un solo paso | 50 llamadas | Completado en un pase |
| v8 | Ultra-lean minimo-turno | 20 llamadas | Maxima eficiencia de costo |
Como usarlo
Opcion A — Descarga directa
curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.md
Opcion B — Clonar y elegir perfil
git clone https://github.com/drona23/claude-token-efficient
cp claude-token-efficient/profiles/CLAUDE.coding.md tu-proyecto/CLAUDE.md
Opcion C — Sin instalacion
Copia el contenido del archivo y pegalo al inicio de cualquier conversacion. Funciona igual para tareas puntuales sin necesidad de setup.
Cuando vale la pena y cuando no
Lo vale:
- Pipelines de automatizacion con alto volumen de salida
- Tareas repetitivas y estructuradas a lo largo de cientos de llamadas
- Equipos que necesitan output consistente y parseable
No lo vale:
- Consultas cortas y unicas (el overhead del archivo supera el ahorro)
- Uso casual ocasional
- Sesiones nuevas por cada tarea aislada
- Cuando necesitas garantia de formato para parsers (usa structured outputs en su lugar)
Como funcionan los archivos en capas
Claude apila automaticamente los CLAUDE.md cuando encuentra varios:
~/.claude/CLAUDE.md ← preferencias globales de tono y formato
tu-proyecto/CLAUDE.md ← restricciones del proyecto
tu-proyecto/src/CLAUDE.md ← reglas especificas de esa carpeta
Las instrucciones del usuario siempre tienen prioridad. Si le pides una respuesta detallada explicitamente, Claude la da sin importar lo que diga el archivo.
Pro tips de la comunidad
- Apunta a fallas especificas, no a reglas genericas. Una regla concreta ("no reescribas archivos completos") supera a una vaga ("se conciso").
- Composicion de reglas es mejor que un monolito. Un archivo global + uno por proyecto es mas mantenible que uno enorme.
- Para garantizar formato de salida en parsers a escala, usa structured outputs (JSON mode, schemas) en lugar de instrucciones en lenguaje natural.