Claude Code gasta tokens de más por default. No es que el modelo sea caro, es que por cómo viene configurado, hace tres cosas que te drenan la cuenta sin que te des cuenta: reescribe archivos enteros para cambiar tres líneas, te saluda en cada respuesta, y relee el mismo contexto una y otra vez. Y todo eso se arregla con un solo archivo en la raíz de tu proyecto. Para entender los conceptos clave de Claude Code antes de configurar tu CLAUDE.md, leé el diccionario de Claude Code con 8 conceptos clave. Y para sacarle aún más rendimiento al modelo, mirá los 6 tips de Boris Cherny para dominar Claude Code. CLAUDE.md es solo el primer archivo: el resto del setup vive adentro de la carpeta .claude/ que te explico cómo armar acá. Y si lo querés usar para marketing en vez de para devs (cargar el contexto de una marca antes de generar contenido), tengo el template de CLAUDE.md para marca con la estructura exacta que uso con cada cliente.
¿Qué es CLAUDE.md?
CLAUDE.md es un archivo Markdown que Claude Code lee automáticamente al abrir tu proyecto. Ahí escribís las reglas, convenciones y restricciones que querés que respete siempre. Claude lo carga antes de procesar cualquier prompt, así que no tenés que repetir las mismas instrucciones cada vez que empezás una conversación.
Es literalmente un prompt permanente. Lo ponés una vez, lo guardás en git, y Claude se comporta igual para vos, para tu equipo y para tu yo del mes que viene. Sin este archivo, cada sesión arranca desde cero y Claude asume defaults agresivos: te saluda, explica de más, reescribe archivos enteros y te cobra por todo eso.
¿Quieres que tus devs entreguen 3x más con Claude Code?
Sin reescribir el repo. Sin formaciones largas. Sin tocar tu stack.
Agendar llamadaMarcas que confiaron en Claura
- Bissu Abogados
- Isha Judd
- Luxom Developments
- RE/MAX Patagon
- Bitget Wallet
- SpacePal
- Margaret Bissu
- Soy Andina
¿Por qué importa?
Y el ahorro no es lo único que se nota:
- Consistencia entre sesiones: Claude responde igual el lunes que el viernes, te saludes como te saludes. Sin CLAUDE.md, el comportamiento depende del prompt inicial y varía sesión a sesión.
- Colaboración en equipo: El archivo va a git y tu equipo entero hereda las mismas reglas. Todos usan Claude de la misma manera, sin tener que explicarle a cada dev cómo configurarlo. Es la base para organizar tus skills como un equipo de marketing, donde el CLAUDE.md rutea cada pedido al departamento correcto.
¿Cuáles son las 8 reglas para tu CLAUDE.md?
Las siguientes son las reglas que más impacto tienen en consumo de tokens. Están ordenadas por ROI: las primeras cuatro son las que mueven la aguja, las últimas cuatro son optimizaciones adicionales.
| Comportamiento | Sin CLAUDE.md | Con CLAUDE.md | Ahorro estimado |
|---|---|---|---|
| Saludos largos y explicaciones obvias | Cada respuesta | Eliminados | ~10% |
| Re-lectura del mismo archivo en cada turn | Sí, pesadas | Solo cuando necesario | ~20% |
| Re-escritura de archivos enteros para cambios chicos | Constante | Edits quirúrgicos | ~30% |
| Ejecución automática de test suites enteras | Sí, sin pedir | Solo si lo pedís | ~15% |
| Exploración exhaustiva sin foco | Por default | Acotada con scope | ~5% |
Por default, si le pedís "agregá una función para X", puede escribir código que pisa algo existente o duplica lógica que ya vive en otro archivo. También evita que reescriba imports, borre comentarios importantes o rompa convenciones del proyecto por desconocerlas.
Esas líneas son tokens que pagás sin recibir información útil: en promedio, el 15% al 20% de cada respuesta. Con la regla activada, las respuestas van directo al código o al dato. Una sesión de 2 horas puede bajar 30% solo con este cambio.
Este es el ahorro más grande. Cambiar una línea de un archivo de 500 líneas por default reescribe el archivo completo: pagás 500 líneas para tocar una. En proyectos grandes, esta regla sola puede bajarte entre 50% y 60% del consumo.
Cada vez que abre el mismo archivo desde cero en una conversación, pagás el contexto dos veces. Memoria antes que relectura: entre 10% y 20% en sesiones largas, que es cuando empieza a saltar entre archivos.
Explorar un codebase grande carga todo el resultado en el contexto principal, infla la conversación y acorta la sesión útil. El subagente devuelve un resumen en vez del volcado completo, así podés trabajar más tiempo antes de saturar la ventana.
Por cultura, Claude explica de más: si preguntás qué hace una función, te da tres párrafos cuando alcanzaba con una oración. Combinada con la de no saludar, corta a la mitad el largo promedio de cada respuesta.
Cuando la ventana se satura, la tentación es arrancar de cero, y ahí perdés todo el contexto ganado y tenés que reexplicar el proyecto. /compact resume el histórico y libera espacio: misma información, menos tokens.
Por default asume convenciones genéricas de JavaScript y TypeScript. Si tu proyecto usa otras, te las va a pisar una y otra vez hasta que se lo digas, y cada corrección son tokens que pagás. Esta es la parte que adaptás a tu stack.
¿Cómo empiezo?
El setup entero tarda 30 segundos. No hay configuración, no hay comandos, no hay que reiniciar nada.
- Creá el archivo en la raíz de tu proyecto:
CLAUDE.md. Al lado de package.json o pyproject.toml. - Pegá las 8 reglas de una sola vez con el bloque de acá abajo, y adaptá las convenciones al stack que uses.
- Guardá y abrí una nueva sesión de Claude Code. Las reglas se cargan automáticamente.
- Medí el consumo antes y después con
/usagedentro de Claude Code. La diferencia aparece en la primera semana.
## Reglas - Siempre usar Read o Grep antes de Edit/Write. - Nunca asumir la estructura de un archivo: verificarla. ## Tono - Respuestas directas, sin saludos ni cierres. - Nunca decir "¡Claro!" o "¡Excelente pregunta!". - Nunca resumir lo que acabás de hacer después de hacerlo. ## Edits - Usar siempre la herramienta Edit con old_string/new_string para cambios chicos. - Solo usar Write cuando el archivo es nuevo o requiere rewrite completo justificado. ## Contexto - Si un archivo ya fue leído en esta conversación, no volverlo a leer. - Para búsquedas en más de 3 archivos, usar el subagente Explore. - Usar /compact antes de empezar una conversación nueva. ## Respuestas - Una oración si alcanza con una oración. - Sin markdown innecesario (listas de 1 item, headers para 2 líneas). ## Convenciones - Usamos pnpm, no npm. - Imports con alias @/ en vez de rutas relativas. - Tests en Vitest, no Jest.
Va en la raíz del proyecto, al lado de package.json. Lo resaltado es lo único que tenés que cambiar por lo tuyo.
Si querés que el archivo se aplique a todos tus proyectos, copialo también en ~/.claude/CLAUDE.md. Esa es la memoria global de usuario y se combina con la del proyecto.
¿Qué hay que recordar?
Lo que se corta son los rodeos, no el criterio: los ahorros típicos van del 50% al 80% del consumo mensual sin perder calidad.
Cada conversación nueva arranca a ciegas. El archivo se carga solo al abrir el proyecto, antes de que escribas el primer prompt.
Ahí perdés todo el contexto ganado y tenés que reexplicar el proyecto. /compact lo comprime en vez de descartarlo.
Es una función de Claude Code, la herramienta que vive en tu terminal. En la web el equivalente son los Projects con instrucciones personalizadas.
El modelo no cambia. Lo que cambia es cuántos tokens le regalás por trabajar en automático. Si querés inspeccionar cómo Anthropic implementa el archivo en su propio CLI, el repositorio oficial de Claude Code en GitHub tiene ejemplos reales que podés clonar.
Para bajar todavía más el consumo desde la sesión, mirá los 3 trucos y la lista completa de comandos de Claude Code.
Y si buscás no pagar nada de API, la guía de Claude Code gratis con FreeLLMAPI explica cómo conectar un backend gratuito paso a paso.
Aplícalo a tu caso
Pídeselo a tu agente
Copia este prompt y pégalo en Claude o ChatGPT. Te pregunta lo que necesita saber de tu caso y arma el plan con los pasos de esta guía.
Quiero aplicar a mi caso la guía "Cómo ahorrar 80% de tu cuenta de Claude Code con un archivo CLAUDE.md" de Claura.
Guía: https://claura-ai.com/resources/ahorrar-tokens-claude-code-archivo-claude-md
Mi caso: a qué me dedico, qué herramientas uso y qué quiero lograr
La guía cubre:
- ¿Qué es CLAUDE.md?
- ¿Por qué importa?
- ¿Cuáles son las 8 reglas para tu CLAUDE.md?
- ¿Cómo empiezo?
Lee la guía (si no puedes abrir el link, trabaja con los temas de arriba). Si te falta información sobre mi caso, hazme hasta 3 preguntas antes de empezar. Después arma un plan para aplicar la guía paso a paso a mi caso y dime qué puedo hacer hoy en menos de una hora.¿Prefieres que lo armemos nosotros? Agenda una llamada
¿Quieres que tus devs entreguen 3x más con Claude Code?
Sin reescribir el repo. Sin formaciones largas. Sin tocar tu stack.
Agendar llamadaMarcas que confiaron en Claura
- Bissu Abogados
- Isha Judd
- Luxom Developments
- RE/MAX Patagon
- Bitget Wallet
- SpacePal
- Margaret Bissu
- Soy Andina
Preguntas frecuentes sobre CLAUDE.md
CLAUDE.md es un archivo Markdown que vive en la raíz de tu proyecto y que Claude Code lee automáticamente al iniciar cada sesión. Funciona como un prompt permanente: ahí definís reglas, convenciones, comandos del proyecto y restricciones de comportamiento que Claude va a respetar en todas las respuestas. Sin CLAUDE.md, cada conversación arranca "a ciegas" y Claude asume defaults agresivos: te saluda, reescribe archivos enteros y relee contexto que ya tiene. Con CLAUDE.md, acordás las reglas una sola vez y ahorrás tokens en cada interacción. La documentación oficial de Anthropic lo describe como el mecanismo principal de memoria del proyecto, y es lo primero que deberías configurar antes de usar Claude Code en serio. Para entender el resto de los conceptos clave, leé el diccionario de Claude Code.
Sin reglas explícitas, Claude Code opera con patrones por defecto que son caros en tokens. Cada vez que le pedís un cambio chico, reescribe el archivo completo en vez de hacer un diff quirúrgico. Antes de responder, te saluda ("¡Claro!", "¡Excelente pregunta!") y suma párrafos de resumen después. Si abre un archivo que ya vio en la conversación, lo vuelve a leer desde cero y paga el contexto dos veces. A eso sumale respuestas largas que repiten lo que ya dijo. El resultado es que podés quemar el 80% de tu cuota mensual en sesiones que deberían costar la quinta parte. El archivo CLAUDE.md corta todos esos comportamientos de raíz, sin tener que repetir las reglas en cada prompt. Para más tips sobre eficiencia, mirá los 6 tips de Boris Cherny para dominar Claude Code.
Claude Code busca CLAUDE.md en tres lugares, de menos a más específico. Primero, ~/.claude/CLAUDE.md como memoria global de usuario, que aplica a todos tus proyectos. Segundo, la raíz del repositorio actual, que es el lugar estándar para reglas compartidas con el equipo (va a git). Tercero, CLAUDE.local.md en la raíz, que es igual al anterior pero queda en gitignore: ideal para reglas personales que no querés compartir. Los tres archivos se combinan en orden, así que podés tener reglas globales en ~/.claude/CLAUDE.md y overrides específicos por proyecto en la raíz. Si trabajás en monorepo, también podés poner un CLAUDE.md por subcarpeta y Claude Code carga el más cercano al archivo que estás editando. Más detalles en la documentación oficial de Anthropic.
Las cuatro reglas con mayor impacto en tokens son: leer antes de escribir (que Claude use Read/Grep antes de editar, así nunca crea código que pisa algo existente); respuestas directas (sin saludos, sin resúmenes, sin "¡Excelente pregunta!"); edits quirúrgicos (usar la herramienta Edit con old_string y new_string en vez de reescribir archivos de 500 líneas para tocar 3); y no releer (si ya vio un archivo en la conversación, confiar en el contexto en vez de volver a abrirlo). Con solo esas cuatro reglas en CLAUDE.md, la mayoría de los devs reporta ahorros de entre 50% y 80% en el uso mensual. El resto son optimizaciones finas sobre subagentes, uso de /compact y convenciones del proyecto. Para el contexto completo sobre conceptos de Claude Code, leé el diccionario de Claude Code.
CLAUDE.md es una feature específica de Claude Code, la herramienta CLI de Anthropic que vive en tu terminal. En Claude.ai, el equivalente son los Projects con instrucciones personalizadas o los archivos de contexto que subís manualmente. La lógica es la misma (dar reglas persistentes al modelo) pero el mecanismo es distinto. En Claude Code además podés tener CLAUDE.md por subcarpeta y Claude lo combina automáticamente, algo que no existe en la web. Si usás ambas, lo más práctico es mantener tus reglas de comportamiento en un solo lugar (por ejemplo en Notion) y copiarlas a los dos entornos. Eso evita divergencia entre cómo te responde Claude en Code vs en el chat web. Para el equivalente en la app web, leé sobre las 5 funciones gratis de Claude.
Los ahorros varían según cómo uses Claude Code, pero los números típicos son altos. Reemplazar rewrites por edits quirúrgicos solo, suele cortar entre 40% y 60% del consumo, porque dejás de pagar el archivo entero cada vez. Quitar saludos y resúmenes recorta otro 10-20% de cada respuesta. Evitar relecturas redundantes suma otro 15%. En mi caso personal, pasé de agotar el plan Pro a los 10 días del mes a llegar tranquilo a fin de mes con el mismo volumen de trabajo. El archivo tarda 30 segundos en instalar: lo copiás en la raíz del proyecto, guardás, y Claude lo levanta en la próxima sesión. No hay que tocar configuración ni reiniciar nada más. Más tips de optimización en los 6 tips de Boris Cherny para Claude Code.
Fuentes e inspiración
Mira los posts originales donde desarrollamos estas ideas en redes.
