Si notas que tu cuenta de Claude Code se consume más rápido de lo que esperabas, la causa más probable no es que trabajes mucho, sino que trabajas sin contexto. Y hay un único archivo que arregla la mayor parte del problema: el CLAUDE.md. Esta guía explica por qué un solo fichero tiene tanto impacto en el gasto y cómo escribirlo para que de verdad marque la diferencia.
El problema: el agente parte de cero cada vez
Cada sesión de Claude Code sin contexto empieza igual: el agente explora tu proyecto para entender cómo funciona, qué comandos usar, qué estructura hay. Toda esa exploración cuesta, y la repite una y otra vez. Es como pagarle a un colaborador nuevo para que aprenda tu empresa cada mañana desde cero.
Multiplica ese desperdicio por todas tus sesiones y entiendes por qué la cuenta vuela.
La solución: escribirlo una vez
El CLAUDE.md es un archivo en tu proyecto donde documentas lo que el agente necesita saber. Con él delante, deja de explorar para orientarse porque ya lo tiene todo. Esa exploración evitada es la mayor parte del ahorro.
Es la inversión más rentable en Claude Code: unos minutos de escritura que se amortizan en la primera sesión y siguen ahorrando en todas las demás.
Qué debe contener para ahorrar de verdad
Un CLAUDE.md orientado al ahorro incluye:
- Comandos clave: cómo se ejecutan los tests, cómo se arranca, cómo se compila. Para que no los busque.
- Estructura del proyecto: un mapa breve de dónde está cada cosa. Para que no explore.
- Convenciones: estilo y patrones. Para que no los deduzca leyendo archivos.
- Reglas de trabajo: editar solo lo que cambia, no reescribir archivos enteros, no releer lo ya leído, ir al grano. Para que no derroche generando y rehaciendo.
- Zonas vetadas: qué no debe tocar. Para que no pierda tiempo (y tokens) donde no debe.
Por qué un solo archivo llega tan lejos
Porque ataca la causa raíz. El gasto excesivo no viene de mil cosas distintas, viene principalmente de una: el agente trabajando sin saber dónde está. El CLAUDE.md resuelve esa causa de golpe. Por eso un único fichero bien hecho tiene un impacto tan desproporcionado en la factura.
El error de no tenerlo (o tenerlo vacío)
Mucha gente trabaja sin CLAUDE.md o con uno de dos líneas y luego se sorprende del gasto. Es el equivalente a no dar ninguna indicación y esperar eficiencia. El archivo no es un extra opcional para proyectos grandes: es la herramienta básica de ahorro desde el primer día.
Cómo empezar hoy mismo
- Crea un CLAUDE.md en la raíz de tu proyecto.
- Rellena los comandos y la estructura. Es lo que más ahorra.
- Añade las reglas de trabajo (editar lo justo, no releer, ir al grano).
- Mejóralo con el uso. Cuando veas al agente hacer algo ineficiente, añade una regla que lo corrija.
Preguntas frecuentes
¿De verdad un archivo baja tanto el gasto?
Si partías de trabajar sin contexto, el impacto es grande porque eliminas la exploración repetida, que es el mayor foco de derroche. Si ya trabajabas con buen contexto, el margen es menor.
¿Ahorrar así empeora los resultados?
No. Dar contexto mejora la calidad además de bajar el gasto. Es de los pocos casos donde ahorrar y mejorar van de la mano.
¿Tengo que ser técnico para escribirlo?
Ayuda conocer tu proyecto, pero el archivo es texto normal: comandos, estructura y reglas en lenguaje claro. No hay que programar nada para escribirlo.
Conclusión
Si tu cuenta de Claude Code se consume demasiado rápido, lo más probable es que trabaje sin contexto y desperdicie tokens redescubriendo tu proyecto en cada sesión. Un solo archivo CLAUDE.md bien hecho —con comandos, estructura, convenciones y reglas de trabajo— corta esa causa de raíz y recorta la mayor parte del gasto evitable, mejorando además la calidad. Créalo hoy: es la inversión más rentable que puedes hacer en la herramienta.
¿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.