Home / Glossary / CLAUDE.md

Definition

CLAUDE.md

CLAUDE.md es un archivo de configuración en formato markdown colocado en la raíz de tu proyecto que proporciona a Claude Code instrucciones persistentes y específicas del proyecto. Le dice al agente sobre tus convenciones de código, arquitectura, comandos comunes y reglas—actuando como una forma de memoria a largo plazo que se aplica a cada sesión en ese proyecto.

Cómo funciona CLAUDE.md

Cuando Claude Code inicia una sesión, lee automáticamente el archivo CLAUDE.md en la raíz de tu proyecto (y cualquier archivo CLAUDE.md en directorios padre o subdirectorios). Los contenidos se convierten en parte del contexto del sistema del agente, por lo que sigue tus instrucciones sin necesidad de recordatorios en cada sesión. Esto hace que el agente se comporte de manera consistente con las convenciones de tu equipo.

Qué incluir en CLAUDE.md

  • +Visión general de la arquitectura del proyecto y ubicaciones de archivos clave
  • +Convenciones de código (nomenclatura, formato, patrones a usar o evitar)
  • +Comandos comunes para pruebas, compilación y despliegue
  • +Reglas como "siempre escribe pruebas para funciones nuevas" o "nunca modifiques el módulo de autenticación directamente"
  • +Detalles del stack tecnológico que el agente debe conocer
markdown
# CLAUDE.md

## Proyecto
App Next.js 14 con App Router, TypeScript, Tailwind CSS.

## Comandos
- `npm run dev` — iniciar servidor de desarrollo
- `npm test` — ejecutar pruebas Jest
- `npm run lint` — verificación ESLint

## Convenciones
- Usar server components por defecto
- Client components van en `components/client/`
- Todas las rutas API deben validar entrada con Zod
- Escribir pruebas para cada nueva función utilitaria

## NO hacer
- Modificar archivos en `lib/core/` sin aprobación explícita
- Usar tipo `any` en TypeScript
- Añadir nuevas dependencias sin justificación

Mantén CLAUDE.md conciso. El agente lo lee en cada sesión, así que incluye solo información relevante para múltiples tareas. Mueve los detalles específicos de tareas a tus prompts.

¿Dónde debo colocar el archivo CLAUDE.md?+
Colócalo en la raíz de tu directorio de proyecto. Claude Code también soporta archivos CLAUDE.md en subdirectorios para instrucciones específicas de módulos, y en directorios padre para reglas a nivel de organización. Todos los archivos aplicables se combinan.
¿CLAUDE.md funciona con otras herramientas de IA?+
CLAUDE.md es específico de Claude Code. Sin embargo, algunas otras herramientas han adoptado conceptos similares. Cursor usa .cursorrules, y otros agentes pueden leer archivos de configuración personalizados. El concepto de instrucciones de IA a nivel de proyecto se está convirtiendo en un patrón común.
¿Qué tan largo debe ser CLAUDE.md?+
Manténlo por debajo de 500 líneas. Enfócate en las convenciones y reglas más importantes. El agente siempre puede leer archivos individuales para detalles—CLAUDE.md debe proporcionar el contexto de alto nivel que aplica a través de las tareas.

Related terms

Programación AgénticaClaude CodeIngeniería de Prompts para Código

Master Claude Code in days, not months

37 hands-on lessons from beginner to CI/CD automation. Module 1 is free.

START FREE →
← ALL TERMS