Claude Code ahora recurre a AGENTS.md, facilitando los repositorios multiagente

Claude Code ahora leerá el archivo AGENTS.md de un repositorio cuando no exista un archivo de instrucciones específico de Claude, cerrando una brecha para los equipos que ejecutan varios agentes de codificación de IA sobre el mismo código base. El cambio llegó en Claude Code 2.1.277, anunciado el 18 de septiembre de 2026 por el equipo de Claude Code: si una carpeta no tiene CLAUDE.md, Claude buscará y usará AGENTS.md en su lugar.

Un respaldo, no una sustitución

El comportamiento solo se aplica cuando no hay ningún archivo específico de Claude. Si Claude Code encuentra un CLAUDE.md, un .claude/CLAUDE.md o un CLAUDE.local.md en cualquier punto de la ruta hasta el directorio de trabajo, ese archivo prevalece y AGENTS.md se ignora. Cuando no existe ninguno de ellos, AGENTS.md puede proporcionar las reglas de codificación, los pasos de compilación y los requisitos de prueba del proyecto. La función se distribuye como un complemento integrado, y los equipos pueden ajustar el comportamiento —solo CLAUDE.md, AGENTS.md como respaldo, ambos cargados juntos o una lista restringida de fuentes— mediante /config, la configuración de usuario o la configuración gestionada.

Por qué los repositorios acumulan archivos duplicados

Los equipos que usan varias herramientas suelen acabar con más de un archivo de instrucciones en el mismo repositorio: CLAUDE.md para Claude Code, AGENTS.md para Codex, Cursor y otros. Empiezan como copias entre sí y se van distanciando hasta que uno de ellos apunta a un agente a un comando de compilación que ya no funciona. Un AGENTS.md compartido elimina esa duplicación en los repositorios que no necesitan instrucciones específicas de Claude.

Qué comprobar antes de depender de ello

• CLAUDE.md sigue prevaleciendo por defecto: los equipos que quieran que se respeten ambos archivos deben cambiar explícitamente el ajuste de fuente de instrucciones.
• El soporte presenta actualmente lagunas en los despliegues de Bedrock, Vertex y Foundry, por lo que el mismo repositorio puede resolver las instrucciones de forma distinta según el proveedor contra el que trabaje cada miembro del equipo.
• Un problema registrado en GitHub (#96005) señala instrucciones duplicadas cuando la misma guía llega también por un segundo canal, como un arnés de agente; conviene comprobarlo antes de asumir que AGENTS.md es la única fuente autoritativa.

Para los MSP que estandarizan un único archivo de instrucciones en repositorios de clientes que usan herramientas de agentes mixtas, esto elimina una fuente real de divergencia, pero conviene confirmar qué proveedor y versión de Claude Code ejecuta cada equipo antes de tratar AGENTS.md como la única fuente de verdad.

Fuentes: DevOps.com, dev.to.