Inicio / Inteligencia Artificial / Ahorrar tokens en Claude Code con un archivo CLAUDE.md

Ahorrar tokens en Claude Code con un archivo CLAUDE.md

×
Aprende cómo usar un archivo CLAUDE.md para reducir respuestas innecesarias en Claude Code, trabajar con menos relleno y mejorar la eficiencia en proyectos largos.
8 min de lectura

En esta guía

Deja de fundir créditos en respuestas que no has pedido

Si usas Claude Code, seguramente esto te ha pasado.

Estás trabajando en un proyecto, vas avanzando bien, le pides un cambio concreto y de repente Claude empieza a responderte con medio testamento.

Te explica cosas que ya sabes.
Vuelve a leer archivos que ya había analizado.
Te propone reestructurar partes del proyecto que no le has pedido tocar.
Te mete introducción, conclusión, recomendaciones extra y cierre motivacional.

Muy educado todo.

Pero hay un problema:

todo eso consume créditos.

Y cuando se acaban, se acaban.

Aunque estés pagando Claude Pro.
Aunque estés en mitad de una tarea importante.
Aunque solo necesitases que editara una línea.

Te toca esperar.

La buena noticia es que puedes reducir bastante ese ruido con algo muy simple: un archivo llamado CLAUDE.md.

El problema no es Claude. Es Claude sin reglas.

Claude Code es una herramienta muy potente.

Pero si no le dices cómo quieres que trabaje, va a trabajar a su manera.

Y su manera muchas veces significa:

  • explicar de más,
  • tocar más código del necesario,
  • repetir análisis,
  • releer archivos sin necesidad,
  • generar respuestas demasiado largas,
  • proponer soluciones sobredimensionadas,
  • llenar la conversación de saludos, cierres y frases de relleno.

El problema no es que Claude sea malo.

El problema es que intenta ser útil sin tener claro qué significa “útil” para ti.

Y en proyectos reales, eso tiene un coste.

Porque cada palabra consume.
Cada archivo leído consume.
Cada vuelta innecesaria consume.
Cada explicación que no has pedido consume.

Qué son los tokens y por qué deberías preocuparte

Los tokens son las unidades que usan los modelos de IA para procesar texto.

Dicho fácil:

cada palabra que Claude lee o escribe consume tokens.

Cuando Claude analiza un archivo, consume tokens.
Cuando responde con una explicación larga, consume tokens.
Cuando relee un archivo que ya había leído, consume tokens.
Cuando te escribe cinco párrafos para decirte algo que podía decir en una línea, consume tokens.

Y esos tokens impactan directamente en tus límites de uso.

Por eso, ahorrar tokens no va solo de “pagar menos”.

Va de poder trabajar más tiempo sin quedarte bloqueado.

La solución: crear un archivo CLAUDE.md

Claude Code permite usar un archivo llamado CLAUDE.md como instrucciones del proyecto.

Este archivo funciona como un pequeño manual de trabajo.

Le dice a Claude cómo debe comportarse dentro de ese proyecto:

  • cómo debe leer archivos,
  • cómo debe modificar código,
  • cómo debe responder,
  • cuándo debe probar,
  • qué debe evitar,
  • qué estilo de trabajo debe seguir.

No es magia.

No es un prompt secreto.

No es una fórmula milagrosa.

Es simplemente poner reglas.

Y cuando trabajas con IA, poner reglas marca una diferencia enorme.

Dónde colocar el archivo CLAUDE.md

El archivo debe llamarse exactamente:

CLAUDE.md

Por ejemplo:

 
mi-proyecto/
├── CLAUDE.md
├── package.json
├── README.md
└── src/
 

Es decir, en la carpeta principal del proyecto, al mismo nivel que otros archivos importantes.

Claude Code lo detectará y lo usará como contexto para trabajar en ese proyecto.

El archivo para ahorrar tokens en Claude Code

Puedes crear un archivo CLAUDE.md y pegar estas reglas:

 

Contenido del archivo CLAUDE.md

Copia todo esto y pégalo en un archivo llamado CLAUDE.md en la raíz de tu proyecto

# 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.

Cómo instalarlo paso a paso

Paso 1: crea el archivo

Dentro de tu proyecto, crea un archivo llamado:

CLAUDE.md

Paso 2: pega las reglas

Copia las 8 reglas anteriores y pégalas dentro del archivo.

Paso 3: abre Claude Code

Abre Claude Code dentro de ese proyecto.

Claude debería tener en cuenta ese archivo como instrucciones del proyecto.

 

Paso 4: trabaja normal

No tienes que repetirle las reglas en cada mensaje.

Ese es precisamente el punto.

El archivo queda como guía persistente para que Claude trabaje con más criterio.

 

Cuándo compensa usar este archivo

Cuándo compensa usar este archivo

El archivo CLAUDE.md puede ayudarte a reducir el texto innecesario que genera Claude Code, pero no significa que siempre vayas a ahorrar un 63% de créditos.

El propio archivo también se carga como contexto, así que también consume tokens. Por eso, en tareas pequeñas o preguntas sueltas, la diferencia puede ser mínima.

Donde realmente compensa es cuando usas Claude Code en proyectos reales:

  • desarrollo web,

  • automatizaciones,

  • debugging,

  • revisión de código,

  • documentación técnica,

  • cambios iterativos,

  • edición de varios archivos.

Ahí es donde Claude suele enrollarse, releer archivos, proponer de más o tocar más código del necesario.

Con reglas claras, trabaja con más método: responde más directo, reduce el ruido y te obliga a revisar menos.

Al final, no se trata solo de ahorrar tokens.

Se trata de que la IA deje de improvisar y trabaje como tú necesitas.

Resumen rápido

Si usas Claude Code y notas que se te acaban los créditos demasiado rápido, prueba esto:

  1. Crea un archivo CLAUDE.md.
  2. Ponlo en la raíz del proyecto.
  3. Añade reglas claras de comportamiento.
  4. Dile que sea conciso, edite solo lo necesario y no repita trabajo.
  5. Úsalo como base en todos tus proyectos.

No va a convertir Claude en perfecto.

Pero sí puede ayudarte a reducir bastante el relleno.

Y cuando pagas por tokens, reducir relleno no es un detalle.

Es eficiencia.

Sesión Diagnóstico Gratuita

¿Quieres aplicar IA en tu empresa sin perderte entre prompts, herramientas y automatizaciones sueltas?

En Beyond The Big ayudamos a empresas a integrar IA, automatización y captación de clientes con un enfoque práctico. Si quieres ver cómo podrías aplicar IA en tu negocio, agenda una auditoría y lo vemos.

FAQs

¿Qué es un archivo CLAUDE.md?

Es un archivo de instrucciones que Claude Code puede leer dentro de un proyecto para saber cómo debe trabajar, qué reglas seguir y qué contexto tener en cuenta.Hoy, más del 60% de las empresas ya utiliza IA en su marketing, y aquellas que automatizan correctamente pueden mejorar sus resultados entre un 20% y un 40% en captación y conversión, simplemente optimizando cómo gestionan los leads. Pero no se trata solo de generar contenido o poner un bot. Se trata de construir un sistema donde: Las campañas atraen tráfico cualificado Las landing pages convierten Los leads se gestionan automáticamente Y el seguimiento comercial no depende de tareas manuales En Beyond The Big trabajamos este enfoque para que no solo consigas más leads, sino que puedas responderlos antes, hacer mejor seguimiento y convertir más clientes sin aumentar el equipo.

¿Sirve para Claude normal?

Este enfoque está pensado especialmente para Claude Code, porque trabaja con proyectos, archivos y contexto persistente.

¿Ahorraré siempre un 63% de tokens?

No. Ese porcentaje viene de pruebas concretas del proyecto original. El ahorro real depende de cómo uses Claude, del tipo de tarea y de cuánto texto genere.

¿Puedo modificar las reglas?

Sí. De hecho, deberías adaptarlas a tu forma de trabajar. Lo importante es que sean claras, concretas y no se contradigan entre sí.

¿Esto sustituye a un buen prompt?

No. El archivo CLAUDE.md define reglas generales de comportamiento. El prompt sigue siendo importante para explicar la tarea concreta que quieres que Claude haga.

¿Dónde tengo que poner el archivo?

En la raíz del proyecto, al mismo nivel que archivos como package.json, README.md o carpetas como src.