Qué es CLAUDE.md, qué debe contener y por qué es lo que hace que Claude trabaje igual de bien en cada sesión.
Claude no recuerda la sesión anterior. Lo que quieras que sepa siempre tiene que estar escrito en CLAUDE.md.
Si trabajas con Codex, el archivo se llama AGENTS.md y funciona igual. Puedes tener los dos con el mismo contenido.
Qué es
Un archivo de texto en la raíz del proyecto que Claude Code lee al empezar cada sesión. Es el manual de la casa: qué es el proyecto, cómo se arranca y qué reglas sigue.
Créalo
Crea un archivo CLAUDE.md para este proyecto. Incluye:
- Qué es el proyecto, en dos líneas.
- Tecnologías que usa.
- Comandos para instalar, arrancar en local y probar.
- Estructura de carpetas, explicada en una línea por carpeta.
- Reglas de trabajo.
Sé breve: menos de 60 líneas.
Reglas que conviene añadir
Añade al final una sección con las tuyas. Estas funcionan bien para quien no programa:
## Reglas de trabajo
- Explícame los cambios en español y sin jerga.
- Haz un solo cambio cada vez y dime cómo comprobarlo.
- No instales dependencias nuevas sin decirme para qué sirven.
- Nunca escribas claves ni contraseñas en el código: usa variables de entorno.
- No borres archivos sin preguntarme.
- Si algo no está claro en brief.md, pregunta antes de suponer.
- Al terminar una tarea, márcala en tareas.md.
Mantenlo vivo
Cuando corrijas a Claude dos veces lo mismo, conviértelo en regla:
Añade a CLAUDE.md esta regla: [la regla].
Qué no poner
- Contraseñas, claves o datos personales.
- Explicaciones largas: Claude lo lee entero cada vez y lo breve se cumple mejor.
- Reglas contradictorias.
Comprueba
¿Prefieres construirlo con ayuda?
Este curso te da el método completo. Si quieres ir más rápido o tu proyecto maneja pagos o datos sensibles, lo revisamos contigo y lo dejamos funcionando.
Consulta gratuita