Archivo CLAUDE.md: buenas prácticas, ejemplos y 3 plantillas

CLAUDE.md y la memoria de Claude Code

Cada sesión de Claude Code empieza con la memoria en blanco. Dos cosas llevan conocimiento de una sesión a la siguiente: los archivos CLAUDE.md que escribes tú y las notas de memoria automática que Claude escribe para sí mismo.

Cuando dices "recuerda que facturo en euros", Claude lo guarda en la memoria automática, y notas como "Saved 2 memories" aparecen cuando eso pasa. Para poner una regla en CLAUDE.md, di "agrega esto a CLAUDE.md".

La memoria automática está activada por defecto y vive en ~/.claude/projects/<project>/memory/: un índice MEMORY.md con una línea por nota, más un archivo pequeño para cada nota. Ejecuta /memory para leerla, editarla o desactivarla.

¿Claude lee CLAUDE.md siempre?

Sí, automáticamente, al inicio de cada conversación, incluida la conversación nueva que obtienes después de /clear. Claude Code se lo pasa a Claude como un mensaje justo después de sus propias instrucciones integradas, así que Claude lo lee e intenta seguirlo, pero nada lo obliga. Para bloquear algo pase lo que pase, usa una regla de permisos, que vemos más abajo.

Ubicación del archivo CLAUDE.md: dónde va cada uno

~ significa tu carpeta de usuario (%USERPROFILE% en Windows), y ./ significa la carpeta principal de tu proyecto.

En una Mac, el archivo global es /Users/yourname/.claude/CLAUDE.md; Finder oculta las carpetas que empiezan con un punto, así que presiona Cmd+Shift+. para verlas. Así se ve en el disco el proyecto de un pequeño negocio, con la plantilla para dueños de negocio de más abajo guardada como su CLAUDE.md:

Claude Code carga el CLAUDE.md de la carpeta donde lo inicias y el de cada carpeta superior, y los archivos se suman en lugar de reemplazarse. Un CLAUDE.md dentro de una subcarpeta solo se carga cuando Claude empieza a trabajar con archivos de esa subcarpeta.

Como el archivo más específico se lee al final, una regla del proyecto queda más cerca del trabajo. Aun así, evita contradecir tu archivo personal, porque cuando dos reglas chocan Claude puede seguir cualquiera de las dos.

Cómo crear un archivo CLAUDE.md

1. Abre la carpeta de tu proyecto en Claude Code. En la terminal, entra en la carpeta y ejecuta claude; en la app de escritorio, usa la pestaña Code y Select folder.
2. Ejecuta /init. Claude recorre la carpeta y escribe un CLAUDE.md inicial. Si ya existe uno, propone mejoras en lugar de sobrescribirlo, y trae las reglas que hayas escrito para Cursor o GitHub Copilot.
3. O deja que Claude te entreviste. Para una carpeta que todavía tiene poco, el prompt de abajo da mejores resultados que /init.
4. Edítalo. /memory enumera tus archivos CLAUDE.md y abre uno en tu editor, o simplemente puedes decir "agrega esta regla a CLAUDE.md".
5. Vuelve a cargarlo. El archivo se lee al inicio de la sesión, así que ejecuta /clear o empieza una sesión nueva después de editarlo; la página de prompt caching de Anthropic explica por qué los cambios a mitad de sesión esperan.
6. Comprueba que se cargó. Ejecuta /context y busca el archivo en Memory files.

Ejecutamos /init en el pequeño proyecto de landing page de nuestra guía de vibe coding. Leyó los dos archivos, mostró el CLAUDE.md para aprobarlo (la imagen del inicio de esta guía) y luego resumió lo que había recogido:

Quiero un CLAUDE.md para esta carpeta. Hazme hasta 8 preguntas, una a la vez, sobre mi negocio, para quién es el trabajo, mi tono de voz, las reglas que siempre quiero que se cumplan y qué significa "terminado" para mí. Luego escribe un CLAUDE.md de menos de 60 líneas con títulos claros, y muéstramelo antes de guardarlo.

Buenas prácticas para CLAUDE.md: qué poner y qué dejar fuera

Piensa en CLAUDE.md como el lugar para lo que de otro modo volverías a explicar. Una buena señal para agregar una línea es que Claude cometa el mismo error dos veces, o que escribas la misma corrección que escribiste la semana pasada.

¿Qué largo debe tener un archivo CLAUDE.md?

Menos de 200 líneas, y para la mayoría de las carpetas de negocio bastante menos de 100. Claude Code te avisa al iniciar, y en /status, cuando un archivo supera el largo recomendado o cuando todos tus archivos de instrucciones juntos son demasiado grandes, y se salta cualquier archivo individual de más de 4 MiB. Cada línea se carga en cada sesión, así que un archivo liviano también hace rendir más tu plan, como explica la guía de límites de uso de Claude Code.

Trae otros archivos con importaciones @

Si tus reglas ya están en otro archivo, impórtalo en lugar de copiarlo. Una línea como @brand/voice.md carga ese archivo al inicio, y la ruta se lee desde la carpeta donde está el CLAUDE.md. Los archivos importados pueden importar otros, hasta cuatro niveles de profundidad.

• Los espacios en una ruta necesitan una barra invertida antes de cada uno: @Brand\ Kit/voice.md.
• Para mencionar una ruta sin importarla, ponla entre comillas invertidas.
• Los archivos fuera del proyecto, como @~/.claude/my-rules.md, abren una sola vez un diálogo de aprobación en ese proyecto.

Las importaciones ordenan las cosas pero no hacen el archivo más liviano, porque los archivos importados también se cargan al inicio.

Tres plantillas de CLAUDE.md listas para copiar

Estos ejemplos de CLAUDE.md están escritos para personas que no programan. Cada uno tiene de 21 a 25 líneas, más o menos un octavo del tope de 200 líneas de Anthropic, así que queda lugar para tus propias reglas. Reemplaza todo lo que está entre corchetes, borra lo que no aplique y vuelve a recortar después de una semana de uso real.

Plantilla 1: dueño de negocio

Guárdala como ~/.claude/CLAUDE.md para que aplique en todas partes, o como CLAUDE.md en la carpeta que usas para tareas administrativas.

# Sobre mí y mi negocio
- Dirijo [NOMBRE DEL NEGOCIO], un [TIPO DE NEGOCIO] en [CIUDAD O MERCADO].
- Los clientes son [QUIÉNES SON]. Productos o servicios principales: [LISTA].
- No soy desarrollador. Explica cualquier cosa técnica en una frase simple.

# Cómo trabajar conmigo
- Hazme preguntas antes de empezar cualquier cosa que lleve más de unos pocos pasos.
- Muéstrame un plan corto antes de cambiar más de 3 archivos.
- Responde en [IDIOMA], en párrafos cortos, sin jerga.

# Reglas que siempre aplican
- Nunca envíes correos, mensajes ni pagos. Prepara borradores para que yo los envíe.
- Nunca borres archivos. Mueve lo que quieras quitar a una carpeta llamada _trash.
- Nunca inventes números, precios ni datos. Si falta algo, pregúntame.
- La moneda es [MONEDA]. Las fechas se escriben [FORMATO DE FECHA].

# Archivos y carpetas
- Los documentos que llegan están en /inbox. El trabajo terminado va en /output.
- Nombra los archivos como AAAA-MM-DD_tema.

# Cuando termines una tarea
- Enumera lo que cambiaste, lo que no pudiste hacer y todo lo que no tenías claro.

# Al compactar
- Conserva la lista de archivos cambiados y las preguntas abiertas.

La última sección sigue un consejo de la página de buenas prácticas de Anthropic: una instrucción "al compactar" le dice a Claude qué conservar cuando resume una conversación larga.

Plantilla 2: marketer

Guárdala como CLAUDE.md en tu carpeta de marketing. Para flujos de marketing completos que la usan, mira Claude Code para marketing.

# Marca
- Marca: [NOMBRE DE LA MARCA]. Vendemos [OFERTA] a [AUDIENCIA].
- Voz: [TRES ADJETIVOS]. Sonamos como [EJEMPLO], nunca como [ANTIEJEMPLO].
- Palabras que nunca usamos: [LISTA].
- Ortografía: español [VARIANTE].

# Datos y afirmaciones
- Usa solo los datos de /brand/facts.md y de los archivos que te doy.
- Cada estadística necesita un enlace a la fuente. Si no encuentras uno, deja fuera el número.
- No nombres a competidores salvo que te lo pida.

# Canales y formatos
- LinkedIn: menos de [NÚMERO] palabras, una idea por publicación.
- Correo: asunto de menos de [NÚMERO] caracteres, una llamada a la acción.
- Textos de Instagram: el gancho va en la primera línea, menos de [NÚMERO] palabras en total.

# Archivos
- Los briefs están en /briefs. Los borradores van en /drafts, un archivo por pieza, nombrado canal_tema_fecha.

# Antes de decir que terminaste
- Compara cada afirmación con los archivos fuente y enumera todo lo que no tenga respaldo.

Plantilla 3: proyecto de sitio web

Guárdala como CLAUDE.md en la carpeta principal del sitio. La guía para crear un sitio web con IA recorre un proyecto completo que combina bien con ella.

# Proyecto
- Sitio web para [NOMBRE DEL NEGOCIO]: [PARA QUÉ ES EL SITIO].
- La única acción que queremos de los visitantes: [POR EJEMPLO, AGENDAR UNA LLAMADA].
- Hecho con [TECNOLOGÍA, POR EJEMPLO HTML Y CSS SIMPLES]. Alojado en [HOSTING].

# Comandos
- Vista previa local: [COMANDO]
- Revisión antes de publicar: [COMANDO]

# Reglas de diseño
- Colores: [CÓDIGOS HEX]. Fuentes: [FUENTES]. Deja mucho espacio en blanco.
- Primero móvil: revisa cada cambio en ancho de teléfono antes de decir que está listo.
- Cada imagen necesita texto alternativo. Los botones dicen qué pasa después ("Agendar una llamada", no "Enviar").

# Reglas de contenido
- Usa solo los textos de /content y los datos que yo confirme. Nada de reseñas, números ni logos inventados.
- Cada página necesita su propio título y su meta descripción.

# No
- No agregues bibliotecas, plugins ni servicios nuevos sin preguntarme.
- No cambies la configuración del dominio, el DNS ni el hosting.

# Terminado significa
- El comando de revisión pasa, la página funciona en ancho de teléfono y enumeras lo que cambiaste.

¿Conviene copiar el CLAUDE.md de Karpathy?

El archivo que la gente llama "el CLAUDE.md de Karpathy" es un archivo de la comunidad armado a partir de las publicaciones de Andrej Karpathy sobre los errores que cometen las herramientas de programación con IA; él no lo publicó. Tiene 65 líneas en cuatro secciones (pensar antes de programar, primero la simplicidad, cambios quirúrgicos, ejecución guiada por objetivos), y su repositorio de GitHub tenía unas 221,000 estrellas en octubre de 2026.

Si programas, es una buena base para pegar encima de las reglas de tu propio proyecto. Si no programas, dos de sus ideas te sirven igual: preguntar cuando algo no está claro en lugar de adivinar, y acordar cómo se va a comprobar el éxito antes de empezar. Las plantillas 1 y 3 ya cubren las dos en lenguaje simple, con "hazme preguntas antes de empezar" y la sección "Terminado significa".

Cuando CLAUDE.md no alcanza

La guía sobre cómo crear una skill de Claude muestra cómo convertir un procedimiento en una skill. Para las reglas de denegación, la guía de permisos de Anthropic tiene la sintaxis, y nuestra chuleta de Claude Code incluye un archivo de configuración inicial.

CLAUDE.md vs AGENTS.md

AGENTS.md es la misma idea para otras herramientas de programación, como Codex de OpenAI. Desde la versión 2.1.277, Claude Code lee un AGENTS.md por su cuenta, pero solo cuando no hay un CLAUDE.md ni un CLAUDE.local.md en tu carpeta o en las superiores.

Para mantener un solo conjunto de reglas para todas las herramientas, pon @AGENTS.md en la primera línea de tu CLAUDE.md y agrega debajo las reglas que son solo para Claude. Para que Claude lea los dos archivos sin una importación, abre /config y pon Project instructions en claude-md-and-agents-md.

¿CLAUDE.md no funciona? Soluciones a problemas comunes

Si una regla tiene que cumplirse siempre, pásala a una regla de permisos o a un hook en lugar de escribirla más fuerte.

Qué hacer ahora

Abre la carpeta de proyecto que más usas, ejecuta /init o el prompt de entrevista, y mantén el resultado por debajo de 60 líneas durante la primera semana. Cada vez que corrijas a Claude, pregúntate si esa corrección va en el archivo, y quita todo lo que Claude ya hace solo. El tutorial de Claude Code para principiantes muestra CLAUDE.md funcionando dentro de un proyecto real, y la formación en Claude Code de ai school tiene una lección completa sobre el archivo CLAUDE.md, seguida de otra sobre skills y MCP.