La herramienta de programación Claude Code, de Anthropic, empezó a admitir AGENTS.md a partir de la versión 2.1.277. La regla es sencilla: cuando una carpeta no tiene CLAUDE.md, Claude Code busca un archivo AGENTS.md en esa misma carpeta y lo carga en el contexto como instrucción del proyecto; donde ya existe un CLAUDE.md, la herramienta sigue leyendo únicamente ese archivo, como antes.
Esta versión se publicó en GitHub el 18 de septiembre. Thariq, miembro del equipo de Claude Code, anunció el cambio en una red social:
"Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md."
(Desde hoy, con la versión 2.1.277, si una carpeta no tiene CLAUDE.md, Claude buscará y usará AGENTS.md.)
Cuatro niveles de configuración
El soporte de AGENTS.md está implementado como un plugin integrado, con código abierto en el repositorio de GitHub de Claude Code. El usuario cambia de modo en "Project instructions", dentro de /config, con cuatro niveles en total:
| Modo | Comportamiento |
|---|---|
| claude-md | Solo lee CLAUDE.md, equivale a desactivar esta función |
| claude-md-or-agents-md (predeterminado) | Si la carpeta tiene CLAUDE.md, ignora el AGENTS.md ahí; si no, lo lee |
| claude-md-and-agents-md | Lee ambos tipos de archivo en todo el árbol de carpetas |
| managed-only | Descarta los archivos de instrucciones confirmados en el repositorio y los personales, y conserva solo los que distribuye la organización de forma centralizada, junto con la memoria |
El modo predeterminado es un respaldo, no una fusión de contenidos. Los repositorios que ya tienen un CLAUDE.md preparado para Claude Code no cambian de comportamiento tras la actualización; solo los repositorios que nunca tuvieron CLAUDE.md, y que antes solo habían preparado un AGENTS.md para otras herramientas, cargarán ese archivo por primera vez. Si el mismo archivo se identifica como duplicado por su ruta o su contenido, no se carga dos veces.
Todavía hay diferencias con CLAUDE.md
La documentación del plugin enumera varias diferencias respecto a CLAUDE.md. Un AGENTS.md en una subcarpeta solo se adjunta cuando el agente usa Read para leer un archivo de texto en esa carpeta; la selección de texto en el IDE, los notebooks, las imágenes y los PDF no activan este comportamiento. Los archivos adjuntados de esta forma no quedan registrados como leídos y no se recuperan automáticamente después de comprimir el contexto. El comando /memory y el atajo de memoria rápida con # tampoco llegan a AGENTS.md, las carpetas añadidas con --add-dir no aportan AGENTS.md, y las rutas de enlaces simbólicos se comparan de forma literal, sin resolverse.
En cuanto a los canales, AWS Bedrock, Google Vertex y Microsoft Foundry todavía no son compatibles. La misma versión trae otro cambio relacionado con los archivos de instrucciones: al iniciar en modo SDK o sin interfaz, la primera ronda de conversación ya no espera a que termine la búsqueda de CLAUDE.md.
Un repositorio, varios agentes
AGENTS.md equivale a un README escrito para agentes de programación: cómo compilar, cómo ejecutar las pruebas, qué convenciones de estilo de código seguir, qué carpetas evitar. Este formato lo impulsaron inicialmente en 2025 OpenAI Codex y otras herramientas de forma conjunta, y más tarde pasó a manos de la Agentic AI Foundation, dependiente de la Linux Foundation; Cursor, GitHub Copilot y otras herramientas lo reconocen. Hasta ahora, Claude Code solo leía su propio CLAUDE.md, lo que obligaba a los equipos que usan varias herramientas a mantener dos archivos con contenido casi idéntico; una solución habitual en la comunidad era usar un enlace simbólico para que ambos apuntaran al mismo archivo.
Los equipos en China suelen combinar un conjunto de herramientas todavía más variado: además de Claude Code, es común encontrar Kimi Code, Qwen Code, Cursor y Codex, muchas de las cuales leen AGENTS.md por defecto o permiten renombrar el archivo de instrucciones. En el modo predeterminado, los repositorios antiguos no necesitan ningún cambio; los equipos que quieran mantener solo un AGENTS.md pueden eliminar CLAUDE.md y concentrar ahí las instrucciones, pero antes deben repasar las limitaciones mencionadas, sobre todo que las instrucciones de las subcarpetas no vuelven solas tras comprimirse el contexto en sesiones largas.
El nivel managed-only está pensado para administradores empresariales. Los archivos de instrucciones confirmados en el repositorio son ejecutados por el agente como instrucciones, lo que de por sí es una puerta de entrada que puede ser envenenada; con este nivel, los administradores pueden permitir solo las reglas que distribuye la organización de forma centralizada. Todavía no hay datos públicos sobre cómo funciona este nivel en equipos grandes.
Fuentes: notas de versión de Claude Code en GitHub, CocoLoop, publicación pública del ingeniero de Anthropic Thariq; los cuatro modos, el orden de carga y las restricciones se verificaron en la documentación del plugin agents-md.