El mayor derroche de tokens en Claude Code es que el agente redescubra y reexplique cosas que deberían estar escritas una vez. El CLAUDE.md es el sitio para escribirlas. Estas ocho reglas, metidas en tu CLAUDE.md, recortan el consumo evitable de forma drástica, porque atacan justo los comportamientos que gastan de más. Cópialas, adáptalas y pruébalas.
Por qué el CLAUDE.md es la palanca del ahorro
Cada vez que Claude Code explora tu proyecto para entender cómo funciona, gasta tokens en descubrir lo que podrías haberle dicho. El CLAUDE.md le da ese contexto de entrada. Escribir reglas claras ahí es la inversión que más ahorra: se escribe una vez y evita gasto en cada sesión.
Las 8 reglas
1. Documenta los comandos clave
Escribe cómo se ejecutan los tests, cómo se arranca el proyecto, cómo se compila. Sin esto, el agente los busca o pregunta, gastando tokens. Con esto, va directo.
«`
Comandos
- Tests: [tu comando]
- Arrancar: [tu comando]
- Build: [tu comando]
«`
2. Describe la estructura del proyecto
Un mapa breve de dónde está cada cosa evita que el agente explore carpetas para orientarse.
«`
Estructura
- [carpeta]: [qué contiene]
«`
3. Fija las convenciones
Estilo de código, nombres, patrones. Así no las deduce (a veces mal) leyendo archivos.
4. Marca qué NO tocar
Indica los archivos o zonas que no debe modificar. Evita que explore y toque cosas irrelevantes.
5. Pide instrucciones precisas de trabajo
Incluye una regla de "trabaja por pasos, no rehagas archivos enteros, edita solo lo que cambia". Reescribir archivos completos gasta muchísimo; editar lo justo, poco.
6. Evita la re-lectura innecesaria
Una regla como "no releas archivos que ya has leído salvo que hayan cambiado" corta un derroche silencioso muy común.
7. Define el estilo de respuesta
"Sin preámbulos, sin resúmenes largos, al grano." Menos texto generado es menos tokens, y además vas más rápido.
8. Indica cómo filtrar información
Pide que trabaje solo con lo relevante y filtre lo innecesario antes de procesar. Menos ruido de entrada, menos gasto.
La plantilla mínima
«`
CLAUDE.md
Comandos
[tests, arrancar, build]
Estructura
[mapa breve]
Convenciones
[estilo y nombres]
Reglas de trabajo
- Edita solo lo que cambia, no reescribas archivos enteros.
- No releas archivos ya leídos salvo que hayan cambiado.
- Trabaja por pasos.
- Sin preámbulos ni resúmenes innecesarios.
- Filtra lo irrelevante antes de procesar.
No tocar
[archivos/zonas] «`
Por qué esto llega al 80%
El "80%" es el efecto sumado: si el agente ya no explora para orientarse, no relee, no reescribe archivos enteros y no genera texto de relleno, el gasto evitable casi desaparece. Ninguna regla por sí sola hace el milagro; las ocho juntas eliminan los grandes focos de derroche.
Preguntas frecuentes
¿Estas reglas empeoran la calidad?
Al contrario. Un contexto claro y unas reglas de trabajo precisas dan mejores resultados, no peores. Ahorras tokens y ganas calidad a la vez.
¿Sirven para cualquier proyecto?
Los principios sí. Los detalles (comandos, estructura, convenciones) los adaptas a tu proyecto. La estructura de reglas es reutilizable.
¿Cuál es la regla más importante?
Documentar comandos y estructura (reglas 1 y 2) y editar solo lo que cambia (regla 5). Son las que más gasto evitan.
Conclusión
El consumo excesivo de tokens en Claude Code casi siempre viene de que el agente redescubre, relee, reescribe y rellena. Un CLAUDE.md con estas ocho reglas ataca cada uno de esos focos: comandos y estructura documentados, convenciones fijadas, zonas vetadas y reglas de trabajo precisas. Cópialas, adáptalas a tu proyecto y verás cómo el gasto evitable se desploma mientras la calidad sube.
¿Quieres aplicar esto en tu empresa?
En ITfluence implementamos agentes de IA, automatizaciones y estrategias de contenido a medida. Pasamos de la guía a los resultados.