Claude Code 2.1.277 añadió compatibilidad nativa con las instrucciones del repositorio en AGENTS.md. La función tiene una limitación importante: la documentación actual de Anthropic indica que las sesiones que no pueden obtener indicadores de funciones, incluidas las que tienen desactivada la telemetría y muchas configuraciones con proveedores externos, cargan únicamente CLAUDE.md.
El complemento de agents-md publicado separa la carga de archivos de sus filas de telemetría opcionales. Esas filas contienen recuentos y opciones predefinidas, y omiten las rutas y el texto de los archivos. La dependencia se encuentra un nivel antes, donde un indicador remoto determina si está disponible el cargador integrado.
El gran cambio
- Qué cambió: Ahora un archivo local de instrucciones depende de una decisión remota de despliegue: el acceso a los indicadores de funciones determina si el lector integrado de
AGENTS.mdestá disponible. - Por qué importa: Dos desarrolladores que trabajan sobre la misma confirmación de código pueden recibir instrucciones de proyecto distintas según su versión, proveedor o configuración de privacidad, lo que dificulta reproducir el comportamiento del agente dentro del equipo.
- Qué observar: Los equipos que usan varios proveedores o entornos restringidos pueden tratar la carga de instrucciones como una dependencia del entorno de ejecución, verificarla en cada configuración y conservar una importación de
CLAUDE.mdcomo alternativa compatible.
Qué confirman el lanzamiento y el informe
Las notas de la versión 2.1.277, fechadas el 18 de septiembre, dicen que Claude Code lee AGENTS.md cuando el proyecto no tiene un archivo CLAUDE.md. Las notas también excluyen Bedrock, Vertex y Foundry de esa versión.
La documentación actual sobre la memoria del proyecto también excluye la primera sesión después de instalar o actualizar a una versión compatible y las sesiones en las que está desactivado el complemento integrado.
El informe de Przemek Szypowski, que dio origen a este artículo, describe una prueba canary en la versión 2.1.280. El autor afirma que DISABLE_TELEMETRY y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC impidieron que se cargara su archivo AGENTS.md, mientras que funcionó una importación de CLAUDE.md en un archivo adyacente. BIG CHANGE no reprodujo esa prueba, que se realizó con un modelo de pago. La documentación de Anthropic ahora confirma por separado las mismas condiciones de disponibilidad.
La disponibilidad de la función y el registro de telemetría son cosas distintas
La documentación de variables de entorno de Anthropic indica que cualquier valor no vacío de DISABLE_TELEMETRY, incluidos 0 o false, desactiva la telemetría y la obtención de indicadores de funciones. DO_NOT_TRACK, DISABLE_GROWTHBOOK y CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC también pueden detener esa obtención. Las sesiones con proveedores externos quedan excluidas, salvo que el host de integración establezca CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST; las sesiones a través de la pasarela de las aplicaciones Claude también quedan excluidas.
El README del complemento publicado explica que las llamadas de telemetría que no se pueden realizar se descartan sin alterar el resto del trabajo del complemento. El resumen de los módulos del repositorio identifica la telemetría y agents-md como complementos integrados independientes.
El código fuente describe un cargador operativo; la documentación del producto explica si una sesión dispone de ese cargador. El registro opcional dentro del módulo no elimina la condición de disponibilidad que existe fuera de él.
El 23 de septiembre, BIG CHANGE descargó el README del complemento agents-md y el módulo de registro desde main y desde la etiqueta 2.1.280, publicada el 22 de septiembre; cada par de archivos era idéntico byte por byte.
Cuándo carga Claude Code el archivo
Cuando el complemento está disponible y habilitado, el modo predeterminado sigue este orden de precedencia:
Archivos de instrucciones | Resultado predeterminado |
|---|---|
| |
Archivo de proyecto | La carga directa de |
Archivo de usuario o administrado | No desplazan a |
Cambia las instrucciones del proyecto en /config para cargar ambos tipos de archivo. La opción JSON debe estar en los ajustes de usuario, --settings o en los ajustes administrados; se ignoran los archivos de configuración del proyecto y locales.
La alternativa es una importación explícita
Para las sesiones sin compatibilidad directa, Anthropic recomienda crear un archivo llamado CLAUDE.md junto al archivo compartido, con esta línea:
@AGENTS.md
La importación incluye el archivo; una indicación en prosa que pida a Claude que lo lea deja esa decisión en manos del modelo.
Comprueba la versión con claude --version y revisa las instrucciones del proyecto en /config. En la versión 2.1.280, /memory o /context pueden mostrar un archivo AGENTS.md cargado directamente; las versiones compatibles anteriores no lo mostraban allí.
