¿Qué es CLAUDE.md y qué pongo en él para un proyecto de datos?
Entiende por qué cada sesión empieza sin saber nada de tus datos, y separa lo que va en CLAUDE.md de lo que va en una sola petición.
Curso gratis. Tu Maestro, una IA, .
En los módulos anteriores descubriste varias reglas sobre tu carpeta exoplanetas: que planetas.csv tiene 40,350 filas porque cada fila registra una publicación, que para contar los 6,451 planetas únicos hay que filtrar default_flag = 1, que el archivo original se deja intacto y que en resumen.xlsx los conteos deben ser fórmulas vivas. Todo eso quedó claro en aquellas conversaciones. Sin embargo, cuando cierras Claude Code y abres una sesión nueva hoy, el programa arranca desde cero.
Lo que platicaron ayer, lo que descubrió al explorar planetas.csv y las condiciones que le pusiste para armar el Excel se quedan en la sesión pasada. En una sesión nueva, lo único que el modelo tiene enfrente es su Palabra del glosario: las instrucciones que cargue al abrir, lo que le escribas en ese momento, los archivos que lea durante la conversación y lo que le devuelvan sus herramientas. Además de empezar limpio en cada sesión, ese espacio tiene un límite de tamaño.
Piensa en alguien recién llegado a tu equipo que entra cada mañana a la oficina sin recordar nada del día anterior. Sabe analizar tablas y escribir código con soltura, pero cada mañana tendrías que explicarle de nuevo qué representa una fila en el reporte de ventas, qué columna filtra los registros vigentes y qué archivo maestro nunca se debe sobrescribir. Lo práctico sería dejarle una nota breve sobre el escritorio para que la lea siempre al llegar, antes de tocar cualquier archivo.
En Claude Code, esa nota sobre el escritorio se llama CLAUDE.md. Es un archivo de texto dentro de tu carpeta que el Palabra del glosario del programa carga automáticamente al empezar cada sesión. En general, a este tipo de documento se le conoce como un Palabra del glosario; CLAUDE.md es el nombre que usa Claude Code.
Dónde va y cómo comprobar que se cargó
El archivo se guarda en la carpeta de tu proyecto con ese nombre exacto, en mayúsculas la primera parte y minúsculas la extensión: exoplanetas/CLAUDE.md. También puede vivir dentro de la subcarpeta de configuración, en exoplanetas/.claude/CLAUDE.md. Cuando abres Claude Code en exoplanetas, el programa lee ese archivo antes de que escribas tu primera palabra.
Para comprobar qué archivos de memoria se cargaron en tu sesión actual, escribe el comando /context y revisa la lista que aparece en pantalla. Si corres /context en tu sesión y tienes dudas sobre lo que muestra la lista, pégale la salida a tu Maestro.
Si trabajas en una carpeta que todavía no tiene CLAUDE.md, pero ya cuenta con un archivo AGENTS.md (el nombre equivalente que leen otros agentes, como Codex), Claude Code también puede leerlo en su lugar.
Qué va en CLAUDE.md y qué va en la petición de hoy
Para decidir dónde poner cada instrucción, hazte una sola pregunta: ¿esto es cierto en cualquier sesión que abra en esta carpeta?
En un proyecto de datos, la respuesta separa las reglas permanentes de tu tabla de las preguntas puntuales de cada día. La Palabra del glosario de una tabla, los filtros obligatorios para contar sin duplicados, las advertencias sobre periodos incompletos y las reglas sobre cómo entregar resultados aplican hoy, mañana y el mes que entra. En cambio, el cruce específico que necesitas para una junta cambia en cada tarea.
| Va en CLAUDE.md | Va en la petición de hoy |
|---|---|
Qué representa una fila de cada tabla y cómo filtrar lo que importa (como default_flag = 1) | Qué pregunta específica quieres responder en esta sesión |
| Qué archivos originales deben quedar intactos sin modificarse | Qué gráfica, tabla o archivo .xlsx necesitas generar ahora |
| Particularidades conocidas de tus datos (el año en curso está incompleto, una sucursal reporta con retraso) | Para quién es el resultado o qué formato pide tu entrega de hoy |
| Tu forma de trabajo: que cada cifra salga de código ejecutado, diga cuántas filas usó y deje fórmulas en Excel | Qué años, métodos o categorías quieres comparar esta vez |
Lo que está en la columna izquierda lo sabes tú por conocer tu trabajo, y los encabezados del archivo rara vez lo explican por sí solos. Dejarlo por escrito hace que cualquier sesión nueva cuente bien desde su primer intento.
Separa una petición mezclada antes de enviarla
Ejemplo resuelto · 3 pasos
Imagina que en tu trabajo abres una sesión nueva en una carpeta de ventas y estás por escribir todo este mensaje junto:
"Usa ventas.csv, pero nunca modifiques ese archivo original. Acuérdate de que cada fila es una línea de producto dentro de un ticket y de que las devoluciones vienen marcadas en su columna para excluirlas al sumar ventas. Hoy necesito comparar las ventas de este mes por sucursal."
Antes de mandarlo, sepáralo: ¿qué pasa a CLAUDE.md y qué se queda en tu petición de hoy?
Piensa el siguiente paso por tu cuenta y luego ábrelo para comparar.
Cuidado: Mantén tu archivo corto y sigue revisando
Claude trata CLAUDE.md como contexto que lee al iniciar, más que como una configuración forzada por el sistema. Si metes ahí instrucciones de tareas pasadas o textos largos, el archivo se llena de ruido y el modelo sigue peor tus reglas; la documentación de Claude Code recomienda mantenerlo por debajo de 200 líneas. Y como sigue siendo contexto que el modelo interpreta, tú conservas la costumbre de revisar las fórmulas y los totales antes de compartir cualquier cifra.
Por qué en proyectos de datos conviene escribirlo con tus palabras
Claude Code incluye el comando /init, que explora los archivos de tu carpeta y redacta un primer borrador de CLAUDE.md. En proyectos de programación resulta muy útil, porque los propios archivos de configuración del código dicen cómo se instala y se ejecuta el programa.
En una carpeta de datos pasa algo distinto: si corres /init dentro de exoplanetas, Claude Code verá planetas.csv y los nombres de sus columnas, pero los encabezados por sí solos no explican la historia de cómo se recolectó esa tabla ni qué filtro oficial usa tu equipo en los reportes. Ese conocimiento del negocio lo tienes tú, así que en la siguiente página redactarás tu propio CLAUDE.md y pondrás a prueba cómo cambia la respuesta de una sesión nueva. Si quieres aterrizar qué reglas irían en el CLAUDE.md de las tablas de tu trabajo, cuéntale a tu Maestro qué archivos usas.
Inténtalo
Antes de pasar a escribir el archivo en la siguiente página, haz este ejercicio rápido:
- Abre una sesión de Claude Code en tu carpeta
exoplanetasy escribe/contextpara observar qué carga hoy tu sesión al arrancar. - Anota tres reglas que aprendiste sobre
planetas.csvyresumen.xlsxen los módulos 2 y 3 que deberían cumplirse en cualquier sesión futura. - Contesta la siguiente pregunta para comprobar la diferencia entre contexto permanente y petición del día: