Esta guía nació contando un truco: bajas un CLAUDE.md con 8 reglas y ahorras 63%. El truco sirve. El número engañaba: ese 63% eran palabras de la respuesta, no consumo de tu cuenta. Esta es la versión completa y honesta — la capa de instrucciones: lo que escribes una sola vez y se te vuelve a cobrar en cada mensaje, en los tres lugares donde vive.
Las seis paradas · de un vistazo
Dónde vive lo que escribes
Por qué las instrucciones se cobran en cada mensaje y no una sola vez, y los tres lugares donde viven.
8 Proyectos listos
Código, escritura, análisis, soporte, investigación, estudio, marketing y operación. Cada uno con instrucciones para copiar.
5 perfiles de CLAUDE.md
Base, código, agentes, análisis y ultra-lean. Más el archivo personal que aplica a todos tus proyectos.
Lo que NO va ahí
CLAUDE.md carga siempre. Las reglas con paths cargan al tocar archivos. Las skills, solo cuando se invocan.
14 prompts
Para escribir tus instrucciones, para auditarlas cuando ya crecieron de más y para operar sin quemar la sesión.
Los números reales
Cuánto ahorra de verdad esta capa, cuándo no sirve, y a qué guía irte para el resto del problema.
Guía comunidad · reescrita en julio 2026
En corto: tus instrucciones de Proyecto y tu CLAUDE.md no se leen una vez. Viajan otra vez en cada mensaje que mandas, toda la sesión. Por eso importa que estén cortos, que estén en el lugar correcto, y que lo que no debería estar ahí no esté.
Casi todo el mundo trata sus instrucciones como si fueran un archivo de configuración que se lee al arrancar y ya. No es así: cada vez que mandas un mensaje, Claude recibe otra vez tus instrucciones, tu conversación completa y todo lo que leyó en el camino. Escribir bien esa capa es lo único que se paga solo, porque la escribes una vez y trabaja en todas las sesiones. Aquí van los ocho Proyectos listos para la app de Claude — código, escritura, análisis, soporte, investigación, estudio, marketing y operación — cada uno con sus instrucciones para copiar, qué subir a Conocimiento y su truco de ahorro. Van también los cinco perfiles de CLAUDE.md para Claude Code, la regla oficial de las 200 líneas, y lo que NO debe vivir ahí (skills y reglas con paths cargan solo cuando hacen falta; CLAUDE.md carga siempre). Cierra con catorce prompts para escribir, auditar y podar tus propias instrucciones, y con una sección donde pongo los números reales: el propio repo publicó en junio de 2026 un benchmark reproducible con 4% en Haiku, 12% en Sonnet y 7% en Opus de tokens de salida. Nada que ver con el 63% del titular viejo. Si lo que buscas son comandos y rutina diaria, esa guía es otra y aquí la enlazo.
01 la capa
Cuando le mandas un mensaje a Claude, no le mandas el mensaje. Le mandas el mensaje, más toda la conversación anterior, más todo lo que leyó en el camino, más tus instrucciones. Otra vez. Completas. En cada mensaje.
Ahí está el malentendido que tenía esta guía desde abril. Un archivo que hace que Claude conteste más corto te ahorra la mitad de la respuesta. Pero la respuesta es la parte chica: lo grande es todo lo que va de ida. Por eso alguien puede poner las 8 reglas, ver respuestas cortísimas, y aun así quedarse sin cuenta a media tarde.
lo del 63%
De dónde salió ese número y qué medía en realidad
El 63% salió de contar palabras de respuesta en cinco prompts sueltos, y el propio repo lo marca como señal direccional, no como medición controlada. En junio de 2026 publicaron un benchmark reproducible con tokens de verdad: alrededor de 4% menos de salida en Haiku, 12% en Sonnet y 7% en Opus. En un set de seis retos de código, el ahorro total de costo fue de 17.4%. Son números buenos para un archivo de texto. Pero no son 63%, y la diferencia importa cuando alguien lo instala esperando que su cuenta le rinda el triple.
Lo que viaja en cada mensaje que mandas
Esta es la lista, de lo que más pesa a lo que menos, en una sesión normal de trabajo:
La conversación completa
Todo lo que se dijeron antes. Es lo que más crece y lo que casi nadie mira. Una sesión de cuatro horas manda cuatro horas de historial para contestarte una línea.
Todo lo que Claude leyó
Archivos abiertos, resultados de comandos, respuestas de herramientas. Un log de diez mil líneas se queda en la conversación aunque ya no sirva.
Tus instrucciones
Instrucciones de Proyecto, CLAUDE.md, instrucciones de perfil, reglas. Esta es la única parte que tú decides de un jalón y que se repite igual toda la sesión.
Lo que trae de fábrica
Instrucciones del sistema, nombres de las herramientas disponibles, tu memoria automática. No lo controlas, pero explica por qué una sesión nunca arranca en cero.
Lo que sí se paga solo son las instrucciones: las escribes una vez y trabajan en todas las sesiones. Y por lo mismo, escribir de más ahí te cobra siempre, en cada mensaje, sin que te enteres. A eso le llamo la capa de instrucciones, y vive en tres lugares.
Los tres lugares donde vive tu capa
Mismo bote de uso, tres formas distintas de escribirle. Verificado en las docs: lo que gastas en el chat, en Claude Code y en Cowork sale de la misma bolsa — la ventana de cinco horas y el tope semanal son compartidos.
dónde se escribe
Instrucciones del proyecto, dentro de cada Proyecto. Y las instrucciones de perfil, en Configuración.
qué es
Un bloque de texto que le dice a Claude quién eres, en qué contexto trabajas y cómo quieres que te conteste dentro de ese proyecto.
cuándo se lee
En cada mensaje de cada chat de ese proyecto.
dónde se escribe
CLAUDE.md en la raíz del proyecto, ~/.claude/CLAUDE.md para todos tus proyectos, y .claude/rules/ para lo específico.
qué es
Las reglas de la casa: cómo se construye, cómo se prueba, qué convenciones respetar, qué nunca hacer.
cuándo se lee
El CLAUDE.md del proyecto se carga al arrancar la sesión y se vuelve a inyectar después de un /compact.
dónde se escribe
Hereda tus instrucciones de perfil y las del proyecto donde trabajes.
qué es
El mismo texto que ya escribiste, trabajando en las tareas que Cowork corre por su cuenta.
cuándo se lee
En cada tarea. Y una tarea de Cowork consume bastante más que un mensaje de chat.
la regla que ordena todo
Lo que sigue son las instrucciones ya escritas: ocho Proyectos para la app y cinco perfiles de CLAUDE.md. Copia el que se parezca a lo que haces, cámbiale los dos o tres datos tuyos y ya. No hay que entender nada más para que funcione.
02 la app de claude
Un Proyecto en la app de Claude es una carpeta con memoria: tiene sus propios chats, sus propios archivos y su propio bloque de instrucciones. Todo lo que trabajes dentro hereda ese bloque, sin que lo vuelvas a escribir.
Aquí están ocho, ya escritos. Elige el que se parezca a lo que haces, cambia lo que está entre corchetes y borra lo que no aplique. Están cortos a propósito: cada línea de más se te vuelve a cobrar en cada mensaje que mandes dentro de ese Proyecto.
Cómo se arma, en cuatro pasos
Crea el Proyecto
Pega las instrucciones
Sube lo que se repite
Trabaja dentro
instrucciones vs. conocimiento
para quién es
Programas o le entras al código de tu propio producto y usas el chat de Claude para resolver, no para que te den clase.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. Llena los corchetes y borra lo que no aplique.
Eres mi copiloto de código en [LENGUAJE O STACK]. El proyecto es [QUÉ HACE, EN UNA LÍNEA]. Cómo responder: - Directo a la solución. Sin "excelente pregunta", sin repetirme lo que pedí y sin cierres de cortesía. - Si el cambio es de unas líneas, muéstrame solo esas líneas con dos de contexto. Nunca me devuelvas el archivo completo. - Código primero, explicación después y solo si el porqué no es obvio. Máximo tres renglones. - Si hay varios caminos razonables, dime cuál recomiendas en una línea y sigue. No me armes un comparativo salvo que te lo pida. Reglas de este proyecto: - Convenciones: [DOS O TRES REGLAS QUE SIEMPRE SE ROMPEN EN TU CÓDIGO]. - Nunca toques: [LO QUE NO SE TOCA]. Si te falta un dato, pregunta una sola cosa concreta y espera. No inventes nombres de archivos, funciones ni librerías: si no lo tienes, dilo con esas palabras.
la línea que más te ahorra
“Nunca me devuelvas el archivo completo.” Un archivo de 300 líneas reescrito entero por un cambio de cuatro es la fuga más cara del chat, y pasa todo el tiempo.
para quién es
Escribes seguido para la misma marca o el mismo público y estás harto de volver a explicarle el tono en cada chat.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto y ajusta la voz a la tuya.
Escribes conmigo para [MARCA O PROYECTO]. Mi público es [QUIÉN] y el tono es [TRES ADJETIVOS]. Cómo responder: - Entrégame el texto y nada más. Sin introducción, sin "aquí tienes" y sin explicarme tus decisiones salvo que te las pida. - Cuando te pida cambiar algo, devuélveme solo la parte que cambió. No repitas el texto completo. - Si te pido opciones, dame tres variantes cortas, numeradas y sin comentario entre ellas. - Respeta el largo que te pida. Si no te digo largo, quédate por debajo de [NÚMERO] palabras. Voz: - Sí suena a mí: [DOS O TRES COSAS]. - Nunca uses: [PALABRAS Y MULETILLAS PROHIBIDAS]. Si el encargo está incompleto, marca el supuesto y sigue. Prefiero un borrador con un supuesto anotado que tres preguntas antes de empezar.
la línea que más te ahorra
“Devuélveme solo la parte que cambió.” Reescribir un artículo completo para ajustar un párrafo se paga completo, y se paga cada vuelta.
para quién es
Le subes hojas de cálculo o reportes a Claude y quieres respuestas que se lean en diez segundos, no ensayos.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. Las definiciones son la parte que más importa.
Me ayudas a analizar datos de [NEGOCIO O ÁREA]. Los archivos de Conocimiento son mi fuente: úsalos antes de suponer nada. Cómo responder: - Primero la conclusión, en una línea. Después la tabla o los números. El cómo va al final y solo si aporta. - Tablas, no párrafos. No repitas en prosa lo que ya está en la tabla. - Toda cifra con su unidad y su periodo. Si redondeas, dilo. - No me expliques qué es un promedio ni por qué elegiste ese corte. Definiciones que uso: - [MÉTRICA] = [CÓMO SE CALCULA]. - Periodo por defecto: [MES O TRIMESTRE]. Si un dato no está en los archivos, escribe "no está en los datos". No lo estimes salvo que te lo pida, y si lo estimas, márcalo como estimación.
la línea que más te ahorra
“Primero la conclusión.” Cuando la primera línea ya te sirve dejas de leer y dejas de repreguntar — y cada repregunta es un mensaje completo más.
para quién es
Contestas clientes todo el día y quieres el mensaje listo para pegar, no una asesoría sobre cómo contestarlo.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. Las políticas van en Conocimiento, no aquí.
Redactas respuestas a clientes de [NEGOCIO]. En Conocimiento están mis políticas, precios y respuestas tipo: eso manda por encima de lo que tú supongas. Cómo responder: - Devuélveme el mensaje listo para enviar y nada más. Sin explicarme tu razonamiento ni ofrecerme alternativas salvo que las pida. - Tono: [CÓMO LE HABLAS A TUS CLIENTES]. Trato de [tú/usted]. - Máximo [NÚMERO] líneas. Si el caso pide más, dime en una línea por qué. - Nunca prometas nada que no esté en las políticas de Conocimiento. Cuando te pegue un mensaje de cliente, asume que quiero la respuesta redactada. No me preguntes si procede. Si el caso no está cubierto por las políticas, escribe la respuesta hasta donde alcance y márcame en una línea qué falta decidir.
la línea que más te ahorra
“Asume que quiero la respuesta.” La mitad de los mensajes que se gastan son Claude preguntando si procede y tú contestando que sí.
para quién es
Investigas temas, mercados o competencia y necesitas fichas comparables — y que te diga cuando no sabe.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. El tope de hallazgos es la línea que ahorra.
Me ayudas a investigar sobre [TEMA O SECTOR]. Trabajo con fuentes, no con impresiones. Cómo responder: - Formato fijo por hallazgo: qué se afirma · quién lo dice · de cuándo es · qué tan sólido es. Una línea cada uno. - Máximo [NÚMERO] hallazgos por respuesta, los más relevantes. Si quedaron más fuera, dime cuántos. - Sin introducción y sin cierre. Empieza en el primer hallazgo. - Si dos fuentes se contradicen, dilo en una línea en vez de promediarlas. Regla dura: si no lo sabes o no está en las fuentes, escribe "no lo sé". Un dato inventado me cuesta más caro que un hueco. Cuando te pida profundizar, profundiza en un solo hallazgo, no en todos.
la línea que más te ahorra
El tope de hallazgos. Sin tope, cada búsqueda vuelve con quince, tú lees tres y pagaste los quince.
para quién es
Estás aprendiendo algo y Claude te contesta con el capítulo entero cuando lo que querías era entender una idea.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. Ajusta el nivel con honestidad.
Me estás enseñando [TEMA]. Mi nivel es [PRINCIPIANTE / INTERMEDIO / AVANZADO] y aprendo mejor con ejemplos que con definiciones. Cómo responder: - Una idea por respuesta. No me des el capítulo entero. - Máximo [NÚMERO] líneas, con un ejemplo concreto, y cierra con una pregunta que compruebe si entendí. - Si me equivoco, corrígeme en una línea y dime por qué. Sin suavizarlo y sin volver a explicar todo desde el principio. - Nada de resúmenes de lo que ya vimos salvo que te lo pida. Cuando te diga "siguiente", pasa al siguiente tema sin repasar. Cuando te diga "no entendí", explícalo distinto, no más largo.
la línea que más te ahorra
“Una idea por respuesta.” El temario completo en un mensaje se ve impresionante, no se aprende, y se paga entero.
para quién es
Sacas copy, campañas y respuestas comerciales seguido, y quieres piezas listas para publicar en vez de teoría de marketing.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. El precio y la oferta van en Conocimiento.
Trabajas conmigo en marketing de [PRODUCTO]. Mi cliente es [QUIÉN] y lo que vendo le resuelve [PROBLEMA, EN UNA LÍNEA]. El precio y la oferta están en Conocimiento. Cómo responder: - Copy listo para publicar. Sin explicarme la estrategia detrás salvo que te la pida. - Cuando pida variantes, dame tres, numeradas, sin comentario entre ellas. - Respeta el canal: [FORMATO Y LARGO POR CANAL]. - Nada de superlativos vacíos, nada de "revoluciona", nada de emojis salvo que te los pida. - Un solo llamado a la acción por pieza. Prohibido inventar cifras, testimonios o resultados. Si el copy pide un número que no tienes, deja [DATO] y sigue. Si te pego una pieza para mejorar, devuélveme solo la versión mejorada y una línea con qué cambiaste.
la línea que más te ahorra
“Tres variantes, numeradas, sin comentario.” Pedir opciones sin poner número es cómo terminas con siete párrafos de análisis que no ibas a leer.
para quién es
Traes un negocio o un equipo y usas Claude para decidir, dar seguimiento y documentar sin que se te vuelva un acta de veinte párrafos.
qué subir a conocimiento
Pégalo en Instrucciones del proyecto. Actualiza la prioridad del trimestre cada trimestre.
Eres mi copiloto para operar [NEGOCIO]. Somos [NÚMERO] personas y lo que más se me acumula es [DECIDIR / DAR SEGUIMIENTO / DOCUMENTAR]. Cómo responder: - Formato fijo: decisión recomendada · riesgo principal · siguiente paso concreto. En ese orden, una línea cada uno. - Sin resumirme lo que te acabo de contar. Empieza en la recomendación. - Si te falta información para decidir, dime exactamente qué dato cambia la respuesta. Uno, no cinco. - Cuando te pase notas de una junta, devuélveme solo los acuerdos y los pendientes con responsable. Nada de acta. Contexto permanente: - Prioridad de este trimestre: [UNA LÍNEA]. - Restricciones que no se negocian: [PRESUPUESTO / TIEMPO / EQUIPO]. Si te pido una opinión, dámela. No me devuelvas "depende" con una lista de factores.
la línea que más te ahorra
“Sin resumirme lo que te acabo de contar.” Ese repaso de cortesía aparece en casi cada respuesta larga y no le sirve a nadie.
Y una vez para toda la cuenta: las instrucciones de perfil
Este es el único bloque que se escribe una sola vez y aplica a todos tus chats, estés o no dentro de un Proyecto. Va en Configuración, en las instrucciones de perfil. Sirve para lo que es cierto siempre: quién eres y cómo quieres que te hablen.
Déjalo corto. Aquí no va tu biografía ni tu proyecto de la semana: eso vive en el Proyecto que corresponda.
Configuración → Perfil. Cámbiale los corchetes y quédate en este largo.
Soy [NOMBRE] y me dedico a [UNA LÍNEA]. Escribo en español. Cómo quiero que me contestes siempre: - Directo. Sin "excelente pregunta", sin repetirme lo que pedí y sin cierres tipo "espero que te sirva". - Primero la respuesta, después el porqué, y solo si hace falta. - Si no lo sabes, dilo en una línea en vez de rodearlo. - Cuando te pida algo largo, respeta el largo. Cuando no te diga nada, quédate corto. - Si mi premisa está mal, dímelo antes de contestar. Nada de advertencias genéricas ni disclaimers salvo que el tema de verdad los pida.
Con eso ya tienes la capa de la app puesta. Lo que sigue es la misma idea en Claude Code, donde el bloque no se pega en una caja de texto sino que vive en un archivo del proyecto.
03 claude code
En Claude Code la capa no se pega en una caja de texto: vive en un archivo llamado CLAUDE.md, en la raíz de tu proyecto. Claude lo carga al arrancar cada sesión y lo vuelve a meter después de cada compactación. Es lo más cerca que hay de “reglas de la casa”.
Si no tienes uno, el comando /init te genera un primer borrador leyendo tu proyecto: encuentra cómo se construye, cómo se prueba y qué convenciones usas. De ahí en adelante lo afinas tú. Estos cinco perfiles son ese “de ahí en adelante”.
Dónde va cada archivo
| Archivo | Dónde va | A qué aplica | Quién lo ve |
|---|---|---|---|
| CLAUDE.md | En la raíz del proyecto | Ese proyecto, en cada sesión. Se vuelve a inyectar después de compactar. | Tu equipo, porque va en el repo |
| ~/.claude/CLAUDE.md | En tu carpeta de usuario | Todos tus proyectos, siempre. Se carga antes que el del proyecto. | Solo tú, en tu máquina |
| CLAUDE.local.md | En la raíz, pero fuera de git | Ese proyecto, solo en tu máquina. Para tus rutas y datos de prueba. | Solo tú |
| .claude/rules/*.md | Carpeta rules del proyecto | Se puede acotar por tipo de archivo con paths, y entonces carga solo cuando aplica. | Tu equipo, porque va en el repo |
la regla de las 200 líneas
cuándo usar este
Cualquier proyecto. Es el punto de partida: las ocho reglas originales reescritas más las tres que faltaban.
Crea el archivo CLAUDE.md en la raíz de tu proyecto y pega esto.
# CLAUDE.md — reglas de la casa ## Cómo trabajas 1. Lee antes de escribir. Nunca edites un archivo que no leíste. 2. No releas lo que ya leíste en esta sesión, salvo que haya cambiado. 3. Edita, no reescribas: cambia las líneas que hay que cambiar, no el archivo entero. 4. Prueba antes de decir que terminaste. Si no lo corriste, dilo. 5. Solución simple y directa. Nada de abstracciones que no pedí. ## Cómo respondes 6. Sin preámbulo y sin cierre de cortesía. Empieza en la respuesta. 7. No me repitas lo que te pedí ni resumas lo que acabo de ver en pantalla. 8. Si me equivoqué, dímelo. No me des la razón por educación. ## Cuando el trabajo es grande 9. Manda las lecturas pesadas —logs, salidas largas, documentación— a un subagente y tráeme solo el resumen. 10. Si vas a tocar más de tres archivos, dame el plan en cinco líneas y espera. ## Quién manda 11. Lo que te pida en el chat gana sobre este archivo, siempre.
cuándo usar este
Desarrollo del día a día: features, revisión y debugging. Es el base con las reglas duras de un repo real.
Llena los corchetes con los comandos de tu proyecto. Esos tres comandos son la mitad del valor del archivo.
# CLAUDE.md — perfil código ## El proyecto - Stack: [LENGUAJE Y FRAMEWORK] - Correr: [COMANDO] - Probar: [COMANDO] - Construir: [COMANDO] ## Reglas duras - Lee el archivo antes de editarlo. No releas lo que ya leíste. - Edita en lugar de reescribir. Muéstrame el cambio, no el archivo completo. - Nada de dependencias nuevas sin preguntar. - Sigue el estilo del archivo que estás tocando, no el tuyo. - Prohibido dejar código muerto, prints de depuración o TODOs en lo que entregas. ## Cómo respondes - Sin preámbulo. Código primero; la explicación, en tres renglones máximo y solo si el porqué no es obvio. - Ante un error: causa en una línea, arreglo abajo. Nada de teoría. - Si no lo puedes verificar, dilo con esas palabras en vez de dar por hecho que funciona. ## Antes de decir "listo" - Corre las pruebas y el build. Si algo falla, pégame la salida; no lo escondas. - Si te quedaste a medias, dime exactamente qué falta. Lo que te pida en el chat gana sobre este archivo.
cuándo usar este
Cuando Claude corre solo: tareas programadas, pipelines, procesos por lote. Nadie está leyendo la respuesta en vivo.
Para proyectos donde la salida la consume otro programa, no una persona.
# CLAUDE.md — perfil agentes y automatización Este proyecto corre sin que nadie lea las respuestas en vivo. La salida la consume otro programa, así que optimiza para eso. ## Salida - Cero texto conversacional: ni saludos, ni cierres, ni explicaciones. - Si te pido un formato —JSON, CSV, una sola línea—, devuelve exactamente eso y nada alrededor. - Un fallo se reporta como fallo, con la causa en una línea. No lo maquilles. ## Trabajo - Presupuesto: máximo [NÚMERO] llamadas a herramientas por tarea. Si te pasas, para y di por qué. - No explores de más: si ya sabes qué archivo tocar, tócalo. - No pidas confirmación. Si falta un dato, usa el valor por defecto documentado y márcalo en la salida. ## Prohibido - Reintentar en silencio. - Cambiar el formato de salida sin avisar. - Suponer credenciales o rutas que no estén en la configuración. Lo que te pida en el chat gana sobre este archivo.
cuándo usar este
Proyectos de datos: consultas, reportes recurrentes, revisión de métricas. Sirve igual si tu “código” son hojas y consultas.
Las definiciones son lo que evita las tres vueltas de aclaración por cada número.
# CLAUDE.md — perfil análisis y reportes ## Cómo respondes - Conclusión primero, en una línea. Después la evidencia. El método al final y solo si aporta. - Tablas, no párrafos. No repitas en prosa lo que ya está en la tabla. - Toda cifra con su unidad y su periodo. Si redondeaste, dilo. - Si un dato no está, escribe "no está en los datos". No lo estimes salvo que te lo pida. ## Los datos - Fuente de verdad: [RUTA O ARCHIVOS]. - Definiciones: [MÉTRICA] = [CÓMO SE CALCULA]. - Periodo por defecto: [MES O TRIMESTRE]. ## Trabajo - Antes de un análisis largo, dime en tres líneas qué vas a hacer y espera. - Las salidas pesadas —volcados, logs, consultas grandes— las procesas y me traes el resumen, no el volcado. - Nada de gráficas salvo que te las pida. Lo que te pida en el chat gana sobre este archivo.
cuándo usar este
La misma tarea repetida muchas veces, o cuando andas raspando el fondo de tu plan. Es el más agresivo y el que peor se lleva con el trabajo exploratorio.
Mínimo de turnos. Úsalo cuando ya sabes qué quieres; estorba cuando estás explorando.
# CLAUDE.md — ultra-lean Mínimo de turnos. Cada vuelta extra cuesta. - Resuelve en un solo paso siempre que se pueda. No me des avances parciales. - Máximo [NÚMERO] llamadas a herramientas por tarea. - Sin preámbulo, sin cierre y sin resumen de lo hecho. - Edita, no reescribas. Muéstrame el cambio, no el archivo. - No releas archivos que ya leíste. - No preguntes: si falta un dato, elige lo razonable y anótalo en una línea al final. - Si no se puede dentro de ese presupuesto, dilo en una línea y para. Lo que te pida en el chat gana sobre este archivo.
Si tu equipo trabaja en inglés, baja el original
curl -o CLAUDE.md https://raw.githubusercontent.com/drona23/claude-token-efficient/main/CLAUDE.mdEse es el archivo del repo que dio origen a esta guía, en inglés y con licencia MIT. Los perfiles de arriba son la versión en español, con las reglas que faltaban: delegar lecturas grandes a un subagente, no releer lo ya leído y poner un tope de herramientas.
El que aplica a todos tus proyectos
Este va en ~/.claude/CLAUDE.md y se carga en cada proyecto que abras, antes que el CLAUDE.md del proyecto. Aquí van tus manías, no las reglas del código: cómo quieres que te hable, en qué idioma, qué te choca.
Crea el archivo en tu carpeta de usuario y pega esto. Aplica a todos tus proyectos.
# Preferencias personales - Contéstame en español. - Sin preámbulo, sin cierres de cortesía y sin repetirme lo que te pedí. - Primero la respuesta, después el porqué, y solo si hace falta. - Si no lo sabes o no lo verificaste, dilo con esas palabras en vez de rodearlo. - Si mi premisa está mal, dímelo antes de hacer el trabajo. - Cuando algo falle, dime qué falló con la salida real. No lo suavices.
Con el perfil puesto ya tienes la mitad. La otra mitad es sacar de ahí lo que no debería estar, que es lo que hace que un CLAUDE.md pase de 80 líneas a 600 sin que nadie se dé cuenta.
04 el filtro
Todos los CLAUDE.md empiezan cortos. Después alguien agrega el procedimiento de despliegue, la guía de estilo del frontend, las convenciones de la API y cómo se escriben los mensajes de commit. Nada de eso está mal escrito. El problema es que ahora las cuatro cosas se cargan en cada sesión, aunque hoy solo estés arreglando un botón.
Claude Code tiene tres lugares distintos para poner instrucciones, y se cargan en momentos distintos. Usarlos bien es lo que separa un archivo que ayuda de uno que solo pesa.
Los tres lugares, y cuándo se carga cada uno
| Dónde lo pones | Cuándo se carga | Ponlo aquí si… |
|---|---|---|
| CLAUDE.md | Al arrancar la sesión, siempre. Y se paga en cada mensaje que mandes después. | Aplica siempre y a todo el proyecto: cómo se construye, cómo se prueba, qué nunca se toca. |
| .claude/rules/ con paths | Solo cuando Claude abre un archivo que hace match con el patrón. Antes de eso no cuesta nada. | Aplica a una parte: las reglas de la API, las del frontend, las de las pruebas. |
| Una skill | Solo cuando la invocas o cuando Claude ve que viene al caso. El resto del tiempo no está. | Es un procedimiento de varios pasos que corres de vez en cuando: publicar, migrar, revisar un PR. |
| El chat | Solo en ese mensaje. | Aplica hoy y nada más. Si te descubres escribiéndolo por tercera vez, ya no es del chat: súbelo al CLAUDE.md. |
La prueba de las tres preguntas
Antes de agregar una línea a tu CLAUDE.md, pásala por aquí. En orden, y te quedas en la primera que dé sí.
¿Aplica siempre, en todo el proyecto?
Comandos para correr y probar, convenciones de nombres, la arquitectura en cuatro renglones, lo que nunca se toca.
CLAUDE.md¿Aplica solo a una parte del código?
Reglas de la API, del frontend, de las pruebas. Se escriben igual, pero con un patrón de rutas arriba para que carguen solo cuando toca.
.claude/rules/¿Es un procedimiento de varios pasos que corres a ratos?
Publicar una versión, migrar la base, preparar un reporte mensual. Eso es una skill: carga cuando la llamas y desaparece cuando termina.
una skill¿Ninguna de las tres te convence?
Entonces no va en las instrucciones. Dilo en el chat esta vez y ya. Si vuelve a aparecer tres veces, regresa a la pregunta 1.
el chatla trampa del import
reglas que se pelean
Qué sobrevive cuando la sesión se compacta
Cuando la conversación se llena, Claude Code la resume para seguir trabajando. Tus instrucciones no corren todas la misma suerte, y esto explica por qué a veces “se le olvida” una regla a media sesión.
| Qué | Qué le pasa al compactar |
|---|---|
| CLAUDE.md de la raíz | Se vuelve a leer del disco y se reinyecta. Sobrevive. |
| Memoria automática | Se vuelve a leer del disco y se reinyecta. Sobrevive. |
| Reglas con paths | Se pierden hasta que Claude vuelva a abrir un archivo que haga match. Si la regla tiene que aguantar siempre, quítale el patrón o súbela al CLAUDE.md de la raíz. |
| CLAUDE.md de subcarpetas | Se pierden hasta que Claude vuelva a leer algo en esa carpeta. |
| Skills que ya invocaste | Se reinyectan, pero recortadas si son grandes. Por eso lo importante va al principio del archivo de la skill. |
| Lo que dijiste solo en el chat | Se resume junto con todo lo demás. Si era una regla de verdad, no vivía en el lugar correcto. |
notas gratis
Tres comandos para comprobar que quedó bien
No son comandos de ahorro, son comandos de verificación: te dicen si tu capa de instrucciones está donde crees que está.
/context¿Qué se cargó de verdad?
Te muestra qué está ocupando tu ventana. Busca la lista de Memory files: ahí salen los CLAUDE.md que sí entraron. Si el tuyo no aparece, Claude no lo está viendo y ninguna de tus reglas está corriendo.
/memoryAbrir y editar
Lista tus archivos de instrucciones y de memoria automática, y te deja abrir cualquiera para editarlo. También es donde revisas qué se guardó Claude por su cuenta.
/doctorPodar el archivo
Revisa tu configuración y propone recortes al CLAUDE.md: quita lo que Claude puede deducir leyendo el código —listas de carpetas, dependencias, descripciones de arquitectura— y deja las trampas y las convenciones que no se adivinan.
Con el filtro puesto, tu CLAUDE.md se queda en el tamaño donde sí se obedece. Lo que sigue son los prompts para escribir todo esto sin escribirlo tú.
05 el arsenal
Nadie escribe buenas instrucciones desde cero a la primera. Lo que sí funciona es que Claude te entreviste, escriba el borrador y después lo audite cuando ya creció de más. Estos catorce prompts hacen eso.
Cada uno dice dónde se usa. Los de Claude Code van en la terminal; los de la app, en cualquier chat. Los que dicen “los dos” funcionan igual en ambos lados.
grupo 1
Escribir la capa
Los cuatro que te dejan las instrucciones puestas. Si nunca has escrito ninguna, empieza por el primero.
cuándo usarlo
Cuando vas a crear un Proyecto y ninguno de los ocho de arriba se parece exactamente a lo tuyo.
Pégalo en un chat normal. Te entrevista y te entrega el bloque listo para pegar.
Voy a crear un Proyecto en Claude para [QUÉ TRABAJO]. Quiero que me escribas el bloque de instrucciones del proyecto. Antes de escribirlo, hazme máximo 5 preguntas, de una en una, para saber: qué hago exactamente, quién es mi público o mi cliente, qué formato de respuesta me sirve, qué me choca de cómo me contestan normalmente y qué archivos voy a tener a la mano. Cuando tengas las respuestas, escribe el bloque con estas condiciones: - Máximo 20 líneas. Estas instrucciones se releen en cada mensaje, así que cada línea tiene que ganarse su lugar. - Empieza por el rol y el contexto, sigue con cómo responder y cierra con qué hacer cuando falte información. - Reglas de formato concretas, no adjetivos. "Máximo 5 líneas" sirve; "sé conciso" no. - Nada de instrucciones sobre tareas específicas: eso va en el chat. Entrégame solo el bloque, listo para pegar.
cuándo usarlo
Cuando no tienes CLAUDE.md, o cuando el que te generó /init se quedó en inventario de carpetas.
Córrelo dentro del proyecto. Te da un plan antes de escribir nada.
Lee este proyecto y escríbeme un CLAUDE.md. Reglas: - Menos de 120 líneas. - Solo lo que NO se deduce leyendo el código: los comandos reales para correr, probar y construir; las convenciones que se rompen seguido; las trampas del proyecto; lo que nunca se toca. - Nada de listas de carpetas, nada de inventario de dependencias, nada de describir la arquitectura que ya se ve en el código. - Agrega una sección corta de cómo quiero que me respondas: sin preámbulo, editar en vez de reescribir, probar antes de decir listo. - Si encuentras algo que no aplica siempre sino solo a una parte del proyecto, no lo metas: apártalo en una lista al final y dime que eso va en .claude/rules con paths. Antes de escribir, dime en cinco líneas qué encontraste y espera mi visto bueno.
cuándo usarlo
Una sola vez en la vida de tu cuenta. Aplica a todos tus chats, con Proyecto o sin él.
Úsalo en un chat donde ya llevas rato trabajando: va a leer cómo le hablas.
Quiero escribir las instrucciones de perfil de mi cuenta de Claude: el bloque que aplica a todos mis chats. Revisa cómo te he hablado en esta conversación y hazme 3 preguntas para completar lo que falte: a qué me dedico, en qué idioma trabajo y qué me molesta de cómo me contestan. Después escríbeme el bloque en máximo 12 líneas. Solo lo que es cierto siempre, en cualquier tema. Nada de proyectos ni de tareas. Entrégame solo el bloque.
cuándo usarlo
Al final de una conversación donde tuviste que corregirlo tres veces hasta que quedó como querías.
Pégalo al final del hilo, antes de cerrarlo.
Esta conversación salió como yo quería y no quiero que se pierda. Revisa todo el hilo y sepárame lo que fue una corrección o una preferencia mía —cómo pedí las cosas, qué te hice cambiar, qué formato terminó funcionando— de lo que fue el trabajo de hoy. Con lo primero, escríbeme dos listas: 1. Las líneas que debería agregar a mis instrucciones permanentes, ya redactadas como reglas. 2. Las que NO debería agregar porque solo aplicaban a esta tarea, con una línea diciendo por qué. Sin resumirme la conversación. Empieza en la primera lista.
grupo 2
Diagnosticar y podar
Los cinco para cuando la capa ya creció. Este grupo es el que baja de verdad el peso de tus sesiones.
cuándo usarlo
Cuando tu archivo pasó de 200 líneas o cuando sientes que ya nadie le hace caso.
No reescribe: clasifica y te deja decidir.
Lee mi CLAUDE.md y audítalo. No lo reescribas todavía. Clasifica cada regla en una de estas cuatro: - SE QUEDA: aplica siempre y no se deduce leyendo el código. - SE MUDA A REGLA: aplica solo a una parte del proyecto. Dime a qué patrón de rutas. - SE MUDA A SKILL: es un procedimiento de varios pasos. - SE VA: se deduce del código, ya no es cierta, o nadie la sigue. Entrégame la clasificación como tabla, con la línea original y el veredicto. Al final dime cuántas líneas quedarían de cuántas, y espera antes de tocar nada.
cuándo usarlo
Cuando Claude hace una cosa un día y la contraria al siguiente, sin que tú hayas cambiado nada.
Revisa todas las capas cargadas, no solo el CLAUDE.md del proyecto.
Corre /context y dime qué archivos de instrucciones se cargaron en esta sesión. Después léelos todos —CLAUDE.md del proyecto, el mío personal, las reglas y los CLAUDE.md de subcarpetas— y búscame contradicciones. Para cada choque dime tres cosas: qué dice el archivo A, qué dice el archivo B y cuál debería ganar según el orden en que se cargan. Si no hay contradicciones, dilo en una línea y ya. No me hagas un reporte de lo que sí está bien.
cuándo usarlo
Cuando la auditoría te marcó un bloque como procedimiento de varios pasos.
Saca el bloque del contexto permanente y lo deja disponible bajo demanda.
Este bloque de mi CLAUDE.md es un procedimiento y no debería cargarse en todas mis sesiones: [PEGA EL BLOQUE] Conviértelo en una skill: créala en .claude/skills/[NOMBRE]/SKILL.md, con una descripción que dispare cuando de verdad haga falta y no antes. Pon las instrucciones más importantes al principio del archivo, porque si la sesión se compacta las skills se recortan. Después bórralo del CLAUDE.md y dime cuántas líneas bajó el archivo.
cuándo usarlo
Cuando tienes reglas de frontend, de API o de pruebas viviendo en el CLAUDE.md general.
Cargan solo cuando Claude abre archivos que hacen match.
Estas reglas de mi CLAUDE.md solo aplican a una parte del proyecto: [PEGA LAS REGLAS] Múdalas a .claude/rules/[TEMA].md con el frontmatter de paths que corresponda, para que carguen solo cuando se abran esos archivos. Dime qué patrón elegiste y por qué. Bórralas del CLAUDE.md. Si alguna tiene que seguir aplicando aunque la sesión se compacte, no la mudes: déjala donde está y dime cuál es.
cuándo usarlo
Cuando tu bloque del Proyecto ya no cabe en una pantalla.
Pégalo en un chat fuera del Proyecto, junto con tus instrucciones actuales.
Estas son las instrucciones de un Proyecto mío:
[PEGA TUS INSTRUCCIONES]
Dime, línea por línea, cuáles se ganan su lugar y cuáles no. Se lo ganan las que cambian tu comportamiento de forma verificable. No se lo ganan: los adjetivos sin regla ("sé profesional"), lo que ya haces por defecto, y lo que solo aplicaba a una tarea.
Al final escríbeme la versión podada, sin perder nada que sí importe, y dime cuántas líneas quedaron de cuántas.grupo 3
Operar sin quemar
Los cinco del día a día. No son instrucciones permanentes: son mensajes sueltos que evitan las vueltas caras.
cuándo usarlo
Antes de cerrar una conversación larga. Es el prompt que más gente debería usar y menos usa.
Te da el mensaje con el que vas a arrancar el chat siguiente.
Voy a cerrar esta conversación y abrir una nueva. Escríbeme el mensaje con el que voy a arrancar la siguiente para que no perdamos nada importante. Incluye: en qué estamos, qué ya se decidió y por qué, qué se descartó y por qué, qué archivos o datos importan, y cuál es el siguiente paso concreto. Que quepa en una pantalla. Nada de narrar la conversación: solo el estado actual y lo que sigue.
cuándo usarlo
A media conversación, cuando ya te cansaste de respuestas de tres pantallas.
Aplica al resto del hilo, sin tener que abrir un Proyecto.
De aquí en adelante, en esta conversación: - Sin preámbulo y sin cierre. Empieza en la respuesta. - Formato: [TABLA / LISTA DE 3 / UNA LÍNEA MÁS EL CÓDIGO / LO QUE NECESITES]. - Máximo [NÚMERO] líneas salvo que te pida más. - Si no lo sabes, dilo en una línea en vez de rodearlo. Confírmame solo con "ok" y seguimos.
cuándo usarlo
Antes de cualquier cambio que toque más de dos archivos. Una vuelta mal dada cuesta más que el plan.
Corta el trabajo en falso, que es la fuga más cara de todas.
Antes de escribir una sola línea de código: dime en máximo 5 líneas qué archivos vas a tocar y qué vas a hacer en cada uno. Espera mi visto bueno. Si te falta información para armar el plan, pregunta una sola cosa concreta. Si el plan no cabe en 5 líneas, la tarea está mal cortada: dime cómo la partirías.
cuándo usarlo
Cuando lo que sigue va a escupir miles de líneas: logs, documentación, un recorrido por medio repo.
El volcado se queda en el contexto del subagente y a ti te llega el resumen.
Esto va a generar mucha salida: [LEER ESOS LOGS / RECORRER LA DOCUMENTACIÓN / REVISAR TODOS LOS ARCHIVOS DE X]. Mándalo a un subagente para que el volcado se quede en su contexto y no en el nuestro. Que me regrese solo: qué encontró, en qué archivos y las líneas exactas que importan. Nada de pegarme el contenido completo.
cuándo usarlo
Cuando traes tres dudas del mismo tema. Mandarlas por separado paga tres veces el mismo contexto.
El hábito más simple de esta guía y el que más rinde en el chat.
Tengo varias preguntas sobre lo mismo y no quiero mandártelas de una en una: 1. [PREGUNTA] 2. [PREGUNTA] 3. [PREGUNTA] Contéstalas en una sola respuesta, numeradas, en el mismo orden y sin introducción. Si dos se responden igual, dilo en vez de repetirte.
Con esto ya tienes la capa completa: escrita, podada y con los hábitos que la sostienen. Falta la parte que casi ninguna guía pone.
06 lo honesto
Esta guía llevaba meses diciendo 63% en la primera línea. Lo justo es explicar de dónde salió ese número, qué mide y qué dice el propio repo hoy, después de haber corrido un benchmark de verdad.
Lo que mide cada número
4–12%
menos tokens de salida
El benchmark reproducible del repo, de junio de 2026: alrededor de 4% en Haiku, 12% en Sonnet y 7% en Opus. Este es el número que sí mide tokens.
17.4%
menos costo en un set de código
Comparando la configuración más agresiva del archivo contra la mejor anterior, sobre seis retos de programación completos. Es el mejor caso documentado.
63%
menos palabras en la respuesta
El número del titular viejo. Sale de contar palabras en cinco prompts sueltos y el propio repo lo marca como señal direccional, no como medición controlada.
0%
de lo que pesa tu conversación
Ninguna instrucción arregla una sesión de cuatro horas sin limpiar. Esa es otra palanca, y está en otra guía de la bóveda.
cómo se lee esto
Cuándo esta capa no te va a servir
Para una pregunta suelta
Si abres Claude, preguntas una cosa y cierras, el archivo cuesta más de lo que ahorra. Esta capa se paga con repetición: entre más uses el mismo Proyecto, más rinde.
Cuando andas explorando
Si lo que quieres es que te muestre alternativas y te discuta el enfoque, un perfil que le prohíbe explayarse te estorba. Usa el base, no el ultra-lean, o dile en el chat que hoy sí quieres largo.
Cuando el problema no es la respuesta
Si te quedas sin cuenta a media tarde trabajando en sesiones larguísimas, lo caro es el historial que viaja en cada mensaje. Ninguna regla de estilo te arregla eso.
Cuando algo tiene que pasar sí o sí
Las instrucciones son contexto, no configuración obligatoria: Claude las lee y trata de seguirlas, sin garantía de obediencia estricta. Si en Claude Code algo debe ejecutarse siempre, eso es un hook, no una regla escrita.
Si tu problema es otro, esta no es tu guía
La bóveda ya tiene dueño para cada pedazo del problema. Aquí está el mapa para que no leas de más:
| El síntoma | Qué está pasando | A dónde ir |
|---|---|---|
| Se me acaba a media tarde | Sesiones larguísimas sin limpiar: cada mensaje vuelve a pagar todo el historial. | La rutina de comandos, en “Ahorra tokens en Claude Code”. |
| Se pone tonto conforme avanza | La ventana se llenó y lo viejo se está resumiendo. | “Por qué Claude se vuelve tonto”. |
| No sé si voy en el modelo correcto | Modelo y nivel de esfuerzo son dos perillas distintas, y las dos cobran. | “Qué modelo de Claude uso” y “Niveles de esfuerzo”. |
| Gasto aunque casi no lo use | Conectores prendidos, archivos viejos en tus Proyectos, ajustes que nadie revisó. | “Configura Claude y ahorra”. |
| Quiero herramientas, no reglas | Hay repos y plugins que le entran al contexto por otro lado. | “5 repos para no quemar tu cuenta”. |
El archivo original sí sirve, y su autor fue el primero en poner los números buenos cuando los tuvo. Lo que no sirve es venderlo como si te fuera a triplicar la cuenta. Bien puesto, esto es lo que es: la parte de tu setup que escribes una vez, no vuelves a tocar, y trabaja sola todos los días.
Guía de la comunidad
Esta guía es parte de la bóveda de la comunidad de tododeia.
el repo del que salió todo
El archivo original de ocho reglas que dio nombre a esta guía. Hoy trae también perfiles alternativos, un benchmark reproducible y su propia letra chica sobre cuánto ahorra de verdad. Licencia MIT: úsalo, cámbialo y mándale un PR si mejoras algo.
drona23/claude-token-efficient
MIT · el CLAUDE.md en inglés, los perfiles y el benchmark de junio 2026
Abrir el repo en GitHub
Guías hermanas · antes o después de esta
La rutina de comandos, completa
Aquí solo toqué los tres comandos que sirven para verificar tus instrucciones. Esa guía trae la rutina diaria entera: cuándo limpiar, cuándo compactar con foco y cómo leer tu propio consumo.
Cuando se le llena la memoria
El otro lado del mismo problema. Si Claude va bien las primeras dos horas y después se pone raro, no son tus reglas: es la ventana llenándose.
Los cinco ajustes que nadie revisa
Lo que se gasta por configuración y no por uso: conectores prendidos, archivos viejos en tus Proyectos y el tope de gasto extra.
Qué modelo de Claude uso
Ninguna instrucción compensa traer Opus prendido para tareas de Haiku. Los cuatro modelos con su “cuándo no”.
Niveles de esfuerzo
La otra perilla que cobra, y la que más gente deja en máximo sin necesitarlo. Modelo y esfuerzo no son lo mismo.
Cinco repos para no quemar tu cuenta
Si prefieres instalar algo en vez de escribir reglas. Ahí está este mismo repo junto con otros cuatro que le entran al contexto por otro lado.
por qué la reescribí
“Esta guía la escribí dos veces. La primera repetí el 63% del repo porque sonaba increíble y todo el mundo lo estaba compartiendo. La segunda me senté a leer el benchmark. Prefiero que te lleves un diez por ciento que sí existe y sepas dónde está el resto del problema, a que te lleves un sesenta y tres que no.”
Lo honesto antes de cerrar
Los porcentajes de esta página son los que publica el repo original, no mediciones mías. Las rutas de la app de Claude y los comandos de Claude Code están verificados contra la documentación oficial el 30 de julio de 2026: si algo cambió de lugar para cuando leas esto, la idea de fondo sigue igual — lo que escribes una vez se te cobra en cada mensaje, así que escríbelo corto y ponlo donde toca.