
Has estado usando Claude mal todo este tiempo. CLAUDE.md lo soluciona todo. Aquí te explico cómo. 👇
AI features
- Views
- 2.8M
- Likes
- 408
- Reposts
- 63
- Comments
- 11
- Bookmarks
- 1.4K
TL;DR
Esta guía explica cómo utilizar un archivo CLAUDE.md para proporcionar instrucciones y contexto persistentes a Claude AI. Incluye 21 prompts específicos para mejorar la comunicación, mantener la memoria del proyecto y aumentar la precisión en la programación.
Reading the ESPAÑOL translation
La mayoría de la gente que usa Claude nunca ha oído hablar de ello.
Los que sí lo conocen no saben qué ponerle realmente.
Y esa brecha le está costando a la gente horas cada semana. ⏰
Aquí está la verdad: cada vez que abres una nueva sesión de Claude, empieza con cero memoria.
No sabe tu nombre. No sabe en qué trabajas. No sabe tus preferencias ni cómo te gusta hacer las cosas.
Así que pasas los primeros minutos reexplicándolo todo desde cero. O no lo haces, y Claude te da algo que no se ajusta a cómo trabajas realmente.
CLAUDE.md soluciona esto de forma permanente. 💡
Aquí tienes las 21 instrucciones que necesitas para configurarlo correctamente. 👇
Primero: esto NO es solo una herramienta para desarrolladores. 🔥
Los escritores lo usan para fijar su voz y que Claude nunca suene como otra persona. Los especialistas en marketing lo usan para definir su audiencia y que Claude deje de escribir textos genéricos. Los investigadores lo usan para establecer cómo quieren que se estructure la información. Los dueños de negocios lo usan para darle a Claude el contexto completo de la empresa y que cada resultado se ajuste a su realidad.
Sin CLAUDE.md, empiezas desde cero en cada sesión. Te repites. Corriges los mismos errores. Explicas tus preferencias por centésima vez.
CLAUDE.md es lo primero que deberías configurar antes de cualquier trabajo serio con Claude. 🎯
Cómo crearlo en 2 minutos ⚡
Abre la carpeta de tu proyecto y crea un archivo nuevo. Nómbralo exactamente "CLAUDE.md" — en mayúsculas, sin espacios.
Ábrelo en cualquier editor de texto — Bloc de Notas, TextEdit, VS Code, el que uses. Pega tus instrucciones directamente en este archivo en texto plano.
Empieza con 3 o 4 instrucciones que resuelvan tus mayores frustraciones primero. Guarda el archivo. Claude lo lee automáticamente cada vez que abres una sesión en esa carpeta.
Sin configuración. Sin pasos extra. Funciona desde el primer mensaje. 💡
⚡ PARTE 1: Cómo te habla Claude
- Elimina el relleno para siempre. 🚫
Por defecto, Claude abre cada respuesta con — "¡Buena pregunta!" "¡Por supuesto!" "¡Claro!" "¡Absolutamente!"
Frases que no aportan nada y te hacen perder tiempo todos los días.
Una instrucción elimina esto permanentemente. Cada respuesta empieza directamente con la respuesta. Sin calentamiento. Sin actuación de utilidad. Solo lo que pediste, de inmediato.
"Nunca abras las respuestas con frases de relleno como '¡Buena pregunta!', '¡Por supuesto!', '¡Claro!' o similares. Empieza cada respuesta con la respuesta real. Sin preámbulos. Solo la información."
- Siempre muestra opciones antes de actuar. 🎯
Por defecto, Claude elige un enfoque y se lanza.
Le pides que reescriba un párrafo y cambia todo el tono del texto. Le pides que reestructure un documento y lo reorganiza de una manera que no se ajusta a cómo piensas.
Ahora estás corrigiendo algo que nunca pediste cambiar. 😤
Esta instrucción lo soluciona por completo. Antes de cualquier tarea importante, Claude te muestra 2 o 3 formas de abordar el trabajo. Tú eliges la dirección. Lo que sigue es exactamente lo que querías.
"Antes de cualquier tarea importante, muéstrame siempre 2 o 3 enfoques posibles primero. Espera mi elección antes de proceder."
- Sé honesto cuando no sepas. 🔍
Claude te dará una respuesta segura, detallada y completamente incorrecta antes de admitir incertidumbre.
Rellena los vacíos con información que suena plausible — fechas, estadísticas, citas, datos — que parecen ciertos pero no lo son. Usas esa información y el problema aparece después, cuando más importa.
Esta instrucción cambia ese comportamiento permanentemente.
"Si no estás seguro de algún dato, estadística, fecha o cita — dímelo explícitamente antes de incluirlo. 'No estoy seguro de esto' siempre es mejor que presentar una suposición como un hecho. Nunca rellenes vacíos con información que suene plausible."
- Ajusta la longitud a lo que realmente se necesita. 📏
Hazle a Claude una pregunta simple y escribe cuatro párrafos. Pregúntale algo complejo y te da un esqueleto que parece completo pero no lo es.
Ninguno de los dos es útil. La longitud de la respuesta debe coincidir con lo que la tarea realmente requiere.
"Ajusta la longitud de la respuesta a la complejidad de la tarea. Las preguntas simples obtienen respuestas cortas y directas. Las tareas complejas obtienen respuestas completas y detalladas. Nunca alargues las respuestas con reformulaciones o frases de cierre que repiten lo que acabas de decir."
⚡ PARTE 2: Cómo se comporta Claude
- Pregunta antes de hacer cambios grandes. ✋
Le pides a Claude que arregle un párrafo y reescribe todo el documento. Le pides que acorte algo y elimina secciones que realmente necesitabas.
Cada vez, pierdes algo que no querías perder.
"Antes de hacer cualquier cambio que altere significativamente contenido que ya he creado — detente por completo. Describe exactamente qué vas a cambiar y por qué. Espera mi confirmación antes de proceder. 'Creo que esto sería mejor' no es permiso para cambiarlo."
- Mantente enfocado en lo que se pidió.
Pídele a Claude que arregle una cosa y "mejorará" otras cinco mientras está ahí — ajustando tu redacción, reorganizando tu estructura, reformulando frases con las que estabas completamente satisfecho.
Ahora tienes que revisar todo solo para encontrar lo que realmente cambió.
"Solo cambia lo que te pedí específicamente que cambiaras. No reescribas, reformules ni 'mejores' nada que no haya pedido — incluso si crees que sería mejor. Si notas algo que vale la pena mejorar en otro lado, menciónalo al final. No lo toques a menos que te lo pida explícitamente."
- Siempre dime qué cambiaste. 📋
Claude termina una tarea y te quedas escaneando el resultado tratando de averiguar qué es diferente de lo que tenías antes.
¿Qué secciones cambiaron? ¿Eliminó algo? ¿Añadió algo que nunca pediste?
"Después de completar cualquier tarea de edición o escritura, termina siempre con un breve resumen: Qué se cambió. Qué se dejó intacto. Qué necesita mi atención. Que sea breve — esto es una actualización de estado, no un resumen."
- Nunca actúes en mi nombre sin preguntar.
A medida que las herramientas de IA se vuelven más conectadas — a tu correo electrónico, calendario, cuentas de redes sociales, documentos — el riesgo de que Claude tome una acción que no pretendías completamente crece con cada nueva integración.
Enviar un mensaje. Publicar contenido. Programar algo. Estas acciones tienen consecuencias reales y ocurren rápido.
"Nunca envíes, publiques, compartas ni programes nada en mi nombre sin mi confirmación explícita en el mensaje actual. 'Mencionaste que querías hacer esto' no es confirmación. Debo decir que sí en el mensaje actual."
⚡ PARTE 3: Tu contexto
- Dile a Claude quién eres y qué sabes.
Claude no sabe si eres un experto o un principiante, un fundador o un freelancer, alguien que quiere profundidad técnica o lenguaje sencillo.
Sin ese contexto, adivina. Y se equivoca tantas veces como acierta.
"Sobre mí: Nombre. Rol. Experiencia. Fuerte en [temas que conoces bien]. Aprendiendo [áreas donde necesitas más contexto]. Ajusta la profundidad de cada respuesta para que coincida con esta experiencia. Nunca expliques de más lo que ya sé."
- Dale a Claude el contexto de lo que estás trabajando.
Cada sesión, Claude empieza sin idea de en qué estás trabajando, para quién es o qué importa realmente.
Te da resultados genéricos porque no tiene otra opción.
"En lo que estoy trabajando: Proyecto. Objetivo. Audiencia. Tono. Qué evitar. Aplica este contexto a cada tarea. Cuando algo no encaje en esta imagen — indícalo antes de proceder."
- Fija tu voz y estilo.
Claude tiene un estilo de escritura predeterminado. Está bien. Pero no es el tuyo.
Cada vez que usas a Claude para escribir algo, terminas editándolo para que vuelva a tu voz.
Define tu voz una vez y Claude escribe en ella desde el primer borrador.
"Mi estilo de escritura — ajústalo siempre a esto: Voz. Longitud de las oraciones. Palabras que uso. Palabras que nunca uso. Preferencia de formato. Cuando escribas algo en mi nombre, ajusta este estilo exactamente. No uses tus propios patrones por defecto."
⚡ PARTE 4: Memoria y continuidad
- Haz que Claude mantenga un archivo de memoria.
Claude lo olvida todo entre sesiones. Cada conversación empieza completamente desde cero.
Pero Claude puede escribir archivos, y los archivos persisten.
Esta instrucción le dice a Claude que mantenga un archivo MEMORY.md con cada decisión importante que tomen juntos — qué se decidió, por qué y qué alternativas se rechazaron.
"Mantén un archivo llamado MEMORY.md. Después de cualquier decisión importante, añade una entrada con lo que se decidió, por qué y qué se rechazó. Lee MEMORY.md al inicio de cada sesión antes de hacer cualquier cosa."
- Resumen al final de la sesión — nunca pierdas el progreso.
Cierras la sesión. Vuelves dos días después. Pasas 15 minutos leyendo mensajes antiguos tratando de recordar dónde estabas y qué terminaste.
Esto es una pérdida de tiempo completamente evitable que le ocurre a casi todos los que usan Claude con regularidad.
"Cuando diga 'fin de sesión' o 'paremos aquí' — escribe un resumen de la sesión en MEMORY.md: En qué trabajamos. Qué está completo. Qué está en progreso. Qué decisiones se tomaron. Qué retomar en la próxima sesión."
- Registra lo que no funcionó — deja de resolver el mismo problema dos veces.
Pruebas un enfoque de prompt. Te lleva cuatro intentos obtener algo utilizable. Tres semanas después vuelves con una tarea similar y Claude empieza de nuevo con las mismas malas sugerencias.
El mismo ensayo y error. El mismo tiempo perdido. Desde el principio. Cada vez.
"Mantén un archivo llamado ERRORS.md. Cuando un enfoque requiera más de 2 intentos para funcionar — registra lo que no funcionó, lo que funcionó y qué recordar para la próxima vez. Revisa ERRORS.md antes de sugerir enfoques para tareas similares."
- Dale a Claude una lista de hechos que nunca cambian. 📌
Cada proyecto tiene hechos permanentes — restricciones de decisiones pasadas, reglas que existen por razones importantes, cosas que siempre son ciertas sobre tu trabajo independientemente de la tarea específica.
Sin esto, Claude sugiere casualmente cosas que contradicen completamente tu realidad.
"Estos hechos son siempre ciertos. Aplícalos a cada sesión sin excepción: [Tus hechos permanentes aquí]. Si alguna tarea entra en conflicto con uno de estos — indícalo antes de proceder."
⚡ PARTE 5: Para desarrolladores
- Mantente dentro del alcance — no toques nada que no se te haya pedido.
Pídele a Claude que arregle un error y refactorizará tres archivos, renombrará tus variables, reorganizará tus importaciones y "mejorará" código con el que has estado trabajando durante meses — todo sin preguntar.
Algunos de esos cambios rompen cosas. Otros introducen diferencias sutiles que llevan días localizar.
"Solo modifica archivos, funciones y líneas de código directamente relacionadas con la tarea actual. No refactorices, renombres ni 'mejores' nada que no te haya pedido explícitamente que cambies. Si notas algo que vale la pena arreglar en otro lado — menciónalo. No lo toques. Nunca."
- Confirma antes de cualquier acción destructiva.
Claude Code eliminará archivos, sobrescribirá funciones y borrará tablas de bases de datos sin dudarlo — porque se lo pediste, incluso si no te diste cuenta completamente de lo que le estabas pidiendo.
Una instrucción mal leída y horas de trabajo desaparecen por completo, sin posibilidad de deshacer.
"Antes de eliminar cualquier archivo, sobrescribir código existente, borrar registros de base de datos o hacer cualquier cambio que no se pueda deshacer trivialmente — detente por completo. Enumera exactamente qué se verá afectado. Pide confirmación explícita. Solo procede después de que diga que sí en el mensaje actual."
- Paradas duras — acciones que nunca ocurren sin permiso. 🚨
Desplegar en producción. Ejecutar migraciones en una base de datos en vivo. Enviar llamadas API a servicios externos.
Estas no son situaciones de "ten cuidado". Son paradas completas.
"Las siguientes acciones requieren confirmación explícita dentro de la sesión antes de ejecutarse — sin excepciones: Desplegar en cualquier entorno. Ejecutar migraciones en cualquier base de datos. Enviar cualquier correo electrónico o llamada API externa. Ejecutar cualquier comando con efectos secundarios externos irreversibles."
- Fija tu stack tecnológico. 🔧
Sin un stack definido, Claude sugerirá el framework que considere más popular, la librería que haya visto más a menudo y el gestor de paquetes que tenga por defecto.
A menudo no es lo que usas, no es lo que tu equipo conoce y no es compatible con lo que ya has construido.
"Stack tecnológico — usa siempre estos, nunca sugieras alternativas a menos que yo lo pida: Lenguaje. Framework. Gestor de paquetes. Base de datos. Testing. Linting. Si algo parece la herramienta incorrecta — indícalo. Pero úsala de todos modos a menos que yo diga lo contrario."
- Siempre muestra exactamente qué cambió.
Claude termina una tarea de codificación y te quedas escaneando el resultado tratando de averiguar qué es diferente.
¿Qué archivos cambiaron? ¿Tocó algo más? ¿Dejó algo sin terminar?
"Después de completar cualquier tarea de codificación, termina siempre con: Archivos cambiados. Qué se modificó — una línea por archivo. Archivos intencionalmente no tocados. Seguimiento necesario. Que sea breve — esto es una actualización de estado, no un resumen."
- Las 4 reglas que hicieron viral el CLAUDE.md de Andrej Karpathy.
Andrej Karpathy — ex Director de IA en Tesla, miembro fundador de OpenAI — identificó 4 comportamientos específicos que hacen que Claude Code falle en tareas de codificación.
Un desarrollador las resumió en 4 instrucciones. Ese archivo alcanzó el #1 en GitHub Trending y mejoró la precisión de codificación del 65% al 94%.
Aquí están:
- Pregunta, no asumas — si algo no está claro, pregunta antes de escribir una sola línea. Nunca hagas suposiciones silenciosas.
- Solución más simple primero — implementa siempre lo más simple que pueda funcionar. No añadas abstracciones que no fueron solicitadas.
- No toques código no relacionado — si un archivo no es parte directa de la tarea actual, no lo modifiques. Nunca.
- Indica la incertidumbre explícitamente — si no estás seguro de un enfoque, dilo antes de proceder. La confianza sin certeza causa más daño que admitir una carencia.
En resumen.
CLAUDE.md no es solo una herramienta para desarrolladores.
Es un archivo de instrucciones permanente que cualquiera que use Claude en serio debería configurar antes de su primera sesión real.
Las instrucciones 1 a 4 arreglan cómo se comunica Claude. Las instrucciones 5 a 8 evitan que cambie cosas que no autorizaste. Las instrucciones 9 a 11 le dan contexto para producir resultados que se ajusten a tu trabajo real. Las instrucciones 12 a 15 le dan lo más parecido a una memoria real que existe actualmente. Las instrucciones 16 a 21 hacen que Claude Code se comporte como una herramienta precisa en lugar de una impredecible.
Crea el archivo. Pega 3 instrucciones. Añade más sobre la marcha.
La diferencia en la calidad de los resultados será inmediata y obvia desde la primera sesión. 🚀
Sigue para más sistemas que realmente cambien cómo trabajas con IA. 💯


