Los archivos CLAUDE.md dan a Claude Code instrucciones persistentes para un proyecto, tu flujo de trabajo personal o tu organización. Se cargan al inicio de la sesión como contexto, no como configuración impuesta. Las reglas pueden dividirse en archivos de .claude/rules/, opcionalmente limitados a rutas.
Qué hace
Dónde se ejecuta CLAUDE.md y qué añade, según su documentación
Carga instrucciones del proyecto desde ./CLAUDE.md o ./.claude/CLAUDE.md, compartidas mediante control de versiones
Admite ~/.claude/CLAUDE.md a nivel de usuario y ./CLAUDE.local.md privado
Admite un CLAUDE.md de política gestionada para instrucciones de toda la organización
Importa otros archivos con la sintaxis @path/to/file (profundidad máxima de cuatro saltos)
Divide las instrucciones en .claude/rules/*.md, con frontmatter paths opcional para reglas limitadas a archivos
/init genera un CLAUDE.md inicial a partir del código base
Cuándo usarla
Buen encaje
Vuelves a explicar los mismos comandos de compilación o convenciones en cada sesión
Un equipo quiere estándares de código compartidos en el control de versiones
Una organización necesita políticas de toda la empresa aplicadas a todos los usuarios
No apto para
Aplicación garantizada: la documentación indica usar un hook PreToolUse para bloquear acciones
Procedimientos de varios pasos o instrucciones de un solo ámbito: usa una skill o una regla limitada a rutas
Cómo instalar CLAUDE.md
Necesitas: Claude Code
Crea ./CLAUDE.md o ./.claude/CLAUDE.md en la raíz del proyecto
Añade comandos de compilación y pruebas, convenciones y estructura del proyecto, procurando menos de 200 líneas
O ejecuta /init para generar un archivo inicial
Ejecuta /context y revisa la lista de archivos de Memory para confirmar que se cargó
Añade CLAUDE.local.md a .gitignore para preferencias personales
Ejemplo de configuración (de la documentación oficial)
See @README for project overview and @package.json for available npm commands for this project.
# Additional Instructions
- git workflow @docs/git-instructions.md
Permisos y seguridad
Notas de seguridad de los responsables
Se trata como contexto, no como configuración impuesta; usa hooks para garantizar el comportamiento
Los usuarios no pueden excluir el CLAUDE.md de política gestionada
Revisa el código fuente antes de dar a un agente acceso a credenciales o sistemas de producción. Documentamos lo que declaran los responsables; no auditamos el código.
Limitaciones
Los archivos más largos consumen más contexto y reducen el cumplimiento; procura menos de 200 líneas
Las instrucciones contradictorias pueden resolverse de forma arbitraria
Las importaciones no reducen el coste de contexto: los archivos importados también se cargan al iniciar
¿Dónde pueden estar los archivos CLAUDE.md en Claude Code?
Proyecto: ./CLAUDE.md o ./.claude/CLAUDE.md; usuario: ~/.claude/CLAUDE.md; local: ./CLAUDE.local.md; política gestionada en una ruta del sistema específica de cada SO. fuente
¿Qué tamaño debe tener un CLAUDE.md?
Procura menos de 200 líneas por archivo; los archivos más largos reducen el cumplimiento. fuente
¿Claude Code obedece estrictamente CLAUDE.md?
No. Se entrega como contexto, no como configuración impuesta; usa hooks para comportamiento obligatorio. fuente
¿Cómo excluyo un CLAUDE.md en un monorepo?
Usa el ajuste claudeMdExcludes con globs de ruta absoluta; los archivos de política gestionada no se pueden excluir. fuente
