
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 persistentes y contexto 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 él.
Los que sí lo conocen no saben qué ponerle realmente.
Y esa brecha les está costando 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 reexplicando todo desde cero. O no lo haces — y Claude te da algo que no se ajusta para nada 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 marketeros 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 todo el contexto 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 tu carpeta de 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 — "¡Gran pregunta!" "¡Por supuesto!" "¡Claro!" "¡Absolutamente!"
Frases que no aportan nada y te hacen perder tiempo todos los días.
Una instrucción elimina esto de forma permanente. 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 '¡Gran 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. 🎯
Claude elige un enfoque y se lanza por defecto.
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-3 formas en que podría 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-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 reales pero no lo son. Usas esa información y el problema aparece después, cuando más importa.
Esta instrucción cambia ese comportamiento de forma permanente.
"Si no estás seguro de algún hecho, 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 está.
Ninguno 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 reciben respuestas cortas y directas. Las tareas complejas reciben 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 el 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 de lo que no te pedí — 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 descubrir 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 tomes acciones en mi nombre sin preguntar.
A medida que las herramientas de IA se vuelven más conectadas — a tu correo, calendario, redes sociales, documentos — el riesgo de que Claude tome una acción que no tenías completamente intencionada crece con cada nueva integración.
Enviar un mensaje. Publicar contenido. Agendar algo. Estas acciones tienen consecuencias reales y ocurren rápido.
"Nunca envíes, publiques, compartas ni agendes 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. Formación. Fuerte en [temas que conoces bien]. Aprendiendo aún [áreas donde necesitas más contexto]. Ajusta la profundidad de cada respuesta para que coincida con esta formación. 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é es lo que realmente importa.
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 este panorama — márcalo antes de proceder."
- Fija tu voz y estilo.
Claude tiene un estilo de escritura por defecto. Está bien. Pero no es el tuyo.
Cada vez que usas a Claude para escribir algo — terminas editándolo de vuelta hacia tu voz de todas formas.
Define tu voz una vez y Claude escribe en ella desde el primer borrador.
"Mi estilo de escritura — siempre coincide con esto: Voz. Longitud de las oraciones. Palabras que uso. Palabras que nunca uso. Preferencia de formato. Cuando escribas algo en mi nombre, coincide exactamente con este estilo. No uses tus 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 fresca.
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 fueron rechazadas.
"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 de fin de sesión — nunca más 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 un desperdicio completamente evitable que le pasa a casi todos los que usan Claude regularmente.
"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 toma cuatro intentos obtener algo utilizable. Tres semanas después vuelves con una tarea similar y Claude empieza de nuevo con las mismas malas sugerencias.
Mismo ensayo y error. Mismo tiempo perdido. Desde el principio. Cada vez.
"Mantén un archivo llamado ERRORS.md. Cuando un enfoque tome más de 2 intentos para funcionar — registra lo que no funcionó, lo que funcionó y qué recordar 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 ellos — márcalo antes de proceder."
⚡ PARTE 5: Para desarrolladores
- Mantente en el alcance — no toques nada de lo que no te pidieron.
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 tardan días en rastrear.
"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 dijiste, incluso si no te diste cuenta completamente de lo que le estabas diciendo.
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 forzadas — acciones que nunca ocurren sin permiso. 🚨
Desplegar a 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 equivocada — márcalo. Pero úsalo de todas formas 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 descubrir 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 destiló en 4 instrucciones. Ese archivo llegó al #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 — siempre implementa 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.
- Marca 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 brecha.
El resultado final.
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-4 arreglan cómo se comunica Claude. Las instrucciones 5-8 evitan que cambie cosas que no autorizaste. Las instrucciones 9-11 le dan contexto para producir resultados que se ajusten a tu trabajo real. Las instrucciones 12-15 le dan lo más parecido a una memoria real que existe actualmente. Las instrucciones 16-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 cambian la forma en que trabajas con IA. 💯


