Claude Code incorpora compatibilidad de respaldo para AGENTS.md

Cómo se cargan ahora las instrucciones del proyecto

Claude Code por fin cuenta con un respaldo práctico para AGENTS.md: si no encuentra archivos de la familia CLAUDE.md, utiliza el archivo de instrucciones estándar del proyecto. A fecha del 24 de septiembre de 2026, este es el comportamiento que documenta Claude Code. Parece un cambio pequeño, pero reduce mucho el trabajo de mantener archivos paralelos.

Primero, Claude Code busca CLAUDE.md, .claude/CLAUDE.md y CLAUDE.local.md en el directorio de trabajo y en toda la cadena de directorios superiores. Solo carga AGENTS.md cuando no existe ninguno de ellos. La documentación también indica el mensaje de la interfaz: Claude read AGENTS.md instead of CLAUDE.md.

El detalle clave es que se trata de una ruta de respaldo, no de una combinación automática de todas las instrucciones. Si encuentra хотя бы один archivo de la familia CLAUDE.md, AGENTS.md se omite de forma predeterminada. La carga conjunta puede activarse en Project instructions con el valor claude-md-and-agents-md.

No conviene limitarse a comprobar si se cargó un archivo: hay que revisar qué instrucciones tienen prioridad en el árbol real del proyecto. Un CLAUDE.local.md antiguo y olvidado en un nivel superior puede desactivar silenciosamente el respaldo esperado. La utilidad depende de que la búsqueda sea transparente: un archivo adicional cambia la fuente de contexto de toda la sesión.

Qué cambia para los repositorios

La ventaja principal es simple: los proyectos que usan AGENTS.md ya no necesitan un CLAUDE.md independiente solo para ser compatibles con Claude Code. Menos duplicación reduce el riesgo de que dos conjuntos de instrucciones diverjan y den al agente reglas contradictorias.

Para los equipos que ya mantienen CLAUDE.md, el comportamiento apenas cambia. Sin embargo, al migrar gradualmente hacia un AGENTS.md compartido, hay que tener presente la condición estricta del respaldo: mientras quede un archivo antiguo en la cadena de directorios, la nueva fuente no se activará. Es un caso en el que una configuración olvidada importa más que un anuncio elegante.

El cambio parece menor, pero tiene valor técnico real: Claude Code resulta más fácil de integrar en repositorios que usan un único archivo común de instrucciones para agentes. El reto pendiente ya no es el formato, sino la previsibilidad cuando chocan ajustes locales y de directorios superiores.

Antes explicamos cómo los agentes paralelos de Claude Code pueden revisar pull requests y detectar condiciones de carrera en flujos de CI/CD. Ese proceso también depende de instrucciones claras a nivel de repositorio, algo que AGENTS.md ahora simplifica.