CLAUDE.md es un archivo de texto que vive en la carpeta donde trabaja Claude Code y que Claude lee al empezar cada conversación. Sirve para no repetir cómo funciona esa carpeta: qué hay, cómo se nombran las cosas, qué no se toca. Se escribe en castellano normal y no hace falta programar. Aquí va qué poner, una plantilla para una carpeta de documentos, cómo crearlo pidiéndoselo a Claude y qué hacer cuando no te hace caso.
Qué es CLAUDE.md, explicado con la nota de las vacaciones
Antes de irte de vacaciones le dejas una nota a quien te cubre. «Las facturas de proveedores están en tal carpeta. Se nombran así. La carpeta de firmados no se toca. Si dudas, pregunta a Lucía.» Media página que ahorra veinte llamadas.
CLAUDE.md es esa nota, pero para Claude Code (la versión de Claude que trabaja directamente sobre las carpetas de tu ordenador). Qué es y para qué sirve la herramienta, en qué es Claude Code.
¿Y por qué hace falta la nota? Porque cada conversación de Claude Code empieza en blanco. No recuerda que ayer le explicaste cómo se llaman los archivos ni que esa subcarpeta no se toca. Sin el archivo, se lo vuelves a contar cada vez.
Con el archivo, lo lee solo al empezar. Según la documentación de Claude Code, se carga al inicio de cada sesión, junto con los CLAUDE.md de las carpetas superiores si los hay.
Qué poner en un archivo CLAUDE.md (y qué no)
La regla es sencilla: lo que no se deduce mirando la carpeta y que vale para todas las conversaciones.
| Sí va | No va |
|---|---|
| Qué es la carpeta: «contratos y facturas de proveedores, de 2023 a 2026» | La lista de archivos: eso lo ve mirando |
| Cómo se nombran las cosas: «proveedor_fecha_tipo.pdf» | Lo que cambia cada semana, como la tarea de hoy |
| Lo que nunca se hace: «no borres ni muevas; no toques Firmados» | Consejos vagos: «trabaja con cuidado» |
| Cómo se entrega: «hojas de cálculo en Excel, una pestaña por año» | Explicaciones largas o manuales enteros |
| Qué hacer si duda: «si no sabes clasificar algo, ponlo en una lista aparte» | Procedimientos de diez pasos que usas una vez al mes |
La fila de lo que nunca se hace es la que más disgustos evita, y la que casi nadie escribe. Los procedimientos largos que solo usas a veces van mejor en una skill de Claude, que se carga solo cuando hace falta.
Un CLAUDE.md de ejemplo para una carpeta de documentos
Casi todos los ejemplos que encontrarás son para programadores. Este es para una carpeta de proveedores. Cópialo, cambia lo que va entre corchetes y guárdalo con el nombre exacto CLAUDE.md dentro de la carpeta:
# Carpeta de proveedores
Qué es: contratos y facturas de proveedores de [2023 a 2026], un archivo por documento.
Nombres: proveedor_fecha_tipo.pdf (ejemplo: acme_2026-03-01_contrato.pdf).
Las fechas, siempre como AAAA-MM-DD.
Reglas:
- Nunca borres ni muevas un archivo: copia y deja el original.
- Antes de cambiar un documento, dime qué vas a cambiar y por qué.
- No toques la subcarpeta Firmados.
- Si no sabes clasificar un archivo, ponlo en una lista aparte. No adivines.
Entregas: hojas de cálculo en Excel, una pestaña por año, con una columna
«origen» que diga de qué archivo sale cada dato.Quince líneas. Con eso, «saca a una hoja los importes de todos los contratos» sale bien a la primera, y con la columna de origen para comprobar.
La línea que más vale es «no adivines». ¿Por qué? Porque ante un hueco Claude rellena con lo más probable, y en una carpeta de contratos lo probable no sirve. Mejor una lista de dudas que un archivo mal clasificado. Cómo se trabaja así con una carpeta real, en Claude Code sin programar.
Cómo crear un CLAUDE.md sin programar
No hace falta abrir ningún editor. Tienes tres formas:
- Con /init. Escribe
/initen Claude Code y genera un borrador mirando la carpeta. En una carpeta de código sale bastante completo; en una de documentos, flojo. Úsalo como punto de partida. - Pidiéndoselo. «Añade al CLAUDE.md que la carpeta Firmados no se toca.» Claude lo escribe él. Es la forma más cómoda cuando acabas de corregirle algo.
- Con /memory. Abre la lista de archivos de memoria y te deja editar el que quieras.
Un matiz útil: si dices «recuerda que…», Claude lo guarda en su memoria automática (unas notas que toma él solo), no en el CLAUDE.md. Si quieres que quede en el archivo, dilo así: «añádelo al CLAUDE.md».
Dónde vive. El normal está en la carpeta donde trabajas. Hay otro personal, en tu carpeta de usuario, que vale para todas tus carpetas (tu idioma, tu forma de escribir), y un CLAUDE.local.md para notas tuyas en una carpeta compartida. En una pyme casi siempre basta con uno por carpeta.
Por qué a veces Claude no sigue tu CLAUDE.md
Pasa, y tiene explicación. La documentación lo dice sin rodeos: Claude trata el CLAUDE.md como contexto, no como una configuración que le obligue. Son instrucciones que sigue, no una cerradura.
Por eso importa cómo lo escribes. Cuatro cosas que lo arreglan casi siempre:
- Más corto. Anthropic recomienda menos de 200 líneas. Todo lo que hay ocupa sitio en la ventana de contexto de cada conversación, y un archivo largo se cumple peor.
- Más concreto. «Fechas como AAAA-MM-DD» se cumple; «sé ordenado» no.
- Sin contradicciones. Si una línea dice «pregunta antes de cambiar» y otra «hazlo sin preguntar», Claude puede elegir cualquiera de las dos.
- Comprueba que lo ha leído. El comando
/contextte enseña qué archivos de memoria se han cargado. Si el tuyo no sale, Claude no lo ve.
Y lo que no debe pasar nunca (borrar, enviar algo fuera) no se confía solo al CLAUDE.md: se controla con los permisos de Claude Code, que te pide aprobación antes de actuar.
Circulan CLAUDE.md «definitivos» de quinientas líneas. El que funciona es el tuyo, y la señal para añadir una línea la da la ayuda de Anthropic: cuando Claude se equivoca dos veces en lo mismo, falta una regla.
La misma idea en el chat: Proyectos y system prompt
CLAUDE.md es propio de Claude Code. Si tú trabajas en el chat, el equivalente son las instrucciones de un Proyecto de Claude: contexto fijo que no hay que repetir. Las plantillas por departamento están en instrucciones de un Proyecto de Claude.
Y las dos cosas son lo mismo por debajo: un system prompt, las reglas de fondo que se leen antes de cada encargo. Quien aprende a escribir uno sabe escribir los tres.
El CLAUDE.md es la nota que le dejas a quien te cubre, escrita una vez y leída siempre. Cada corrección que repites dos veces es una línea que le falta.
Por dónde empezar
Por la carpeta en la que más corriges a Claude Code. Esta semana, copia la plantilla, cambia lo tuyo y añade las tres cosas que siempre acabas explicando. Si aún no lo has arrancado nunca, el orden está en el tutorial de Claude Code.
El curso de Claude sin programar está en preparación. Mientras sale, la habilidad de fondo (dar el contexto antes de pedir) es la que se practica desde el primer módulo en Claude para principiantes. Para un equipo que quiera un CLAUDE.md por departamento, desde la página de empresas.
Preguntas frecuentes
¿Qué es el archivo CLAUDE.md?
Un archivo de texto que se guarda en la carpeta donde trabaja Claude Code y donde escribes cómo funciona esa carpeta: qué hay, cómo se nombran las cosas y qué no se toca. Claude Code lo lee al empezar cada conversación, así que no tienes que repetírselo.
¿Qué se pone en un CLAUDE.md?
Lo que no se deduce mirando la carpeta y vale para todas las conversaciones: qué es la carpeta, cómo se nombran los archivos, lo que nunca se hace y cómo se entregan los resultados. La lista de archivos o la tarea de hoy no van ahí.
¿Dónde se guarda el CLAUDE.md?
En la carpeta desde la que arrancas Claude Code, con ese nombre exacto. También lee los de las carpetas superiores y, si lo tienes, uno personal en tu carpeta de usuario que vale para todas tus carpetas.
¿Cuánto debe medir un CLAUDE.md?
Anthropic recomienda menos de 200 líneas. Todo lo que contiene ocupa sitio en cada conversación, y un archivo largo se cumple peor. Quince o veinte líneas bien elegidas suelen bastar para una carpeta de documentos.
¿Por qué Claude Code no sigue mi CLAUDE.md?
Porque lo trata como contexto, no como una norma obligatoria. Suele arreglarse haciéndolo más corto y más concreto, quitando instrucciones que se contradicen y comprobando con /context que se ha cargado.