Claude Code solo lee AGENTS.md con la telemetría activada

Claude Code solo lee AGENTS.md cuando su telemetría está activada, según un informe de error presentado contra el agente de programación de Anthropic el 20 de septiembre de 2026. La función llegó en la versión 2.1.277. Quien haya desactivado el envío de datos de uso, o use la herramienta a través de Amazon Bedrock o Google Vertex, no obtiene ningún AGENTS.md. Nada en pantalla lo indica.

El informe es la issue #95690 del repositorio público de Claude Code. Una entrada de blog publicada el 23 de septiembre explica el mismo comportamiento y una solución provisional.

Qué debía hacer el soporte de AGENTS.md

AGENTS.md es un archivo de instrucciones en texto plano que comparten varios agentes de programación. Le dice a un agente cómo se compila, se prueba y se organiza un proyecto. Claude Code tiene su propio archivo para esa tarea, llamado CLAUDE.md.

La versión 2.1.277 prometía una regla sencilla. En palabras de las notas de la versión que cita la issue, "en un proyecto sin CLAUDE.md, Claude Code lee AGENTS.md en su lugar". Tech AI Wire cubrió ese cambio cuando salió: Claude Code 2.1.277 lee AGENTS.md como respaldo.

Por qué deja de funcionar sin telemetría

Según la issue, la función no está integrada en la carga normal. Es un plugin integrado que viene desactivado por defecto. Un interruptor remoto lo activa.

Ese interruptor es un feature flag llamado tengu_agents_md_mod, servido por Statsig. Statsig es un servicio externo que permite a una empresa activar o desactivar funciones para sus usuarios sin publicar una nueva versión. Para comprobar el flag, Claude Code tiene que contactar con ese servicio.

No puede hacerlo en varias configuraciones comunes, coinciden la issue y la entrada del blog.

Configuración	¿Se carga AGENTS.md?
Instalación por defecto, telemetría activa	Sí, cuando el flag está activo
DISABLE_TELEMETRY=1 definido	No
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 definido	No
A través de Bedrock o Vertex	No

En cada caso "no", el archivo simplemente se omite. La issue describe el resultado sin rodeos: "Sin error. Sin aviso. Simplemente no se carga." El autor del informe calificó el impacto como crítico.

La queja: un archivo local tras un interruptor remoto

Ambas fuentes plantean el mismo argumento. Leer un archivo Markdown de la carpeta del proyecto no necesita red. Atarlo a un flag del servidor hace que una decisión de privacidad desactive en silencio una función que no tiene relación.

La issue lo llama "leer un archivo Markdown local, un acto que no necesita red en absoluto", que "queda bloqueado en silencio por un interruptor del lado del servidor". La entrada del blog lo formula como regla: "Un ajuste de privacidad nunca debería desactivar en silencio un comportamiento local sin relación."

La solución provisional

La entrada del blog ofrece un arreglo que funciona hoy. Cree un CLAUDE.md en el proyecto y haga que importe el otro archivo con una línea: @AGENTS.md. Claude Code siempre lee CLAUDE.md, y la importación trae AGENTS.md con él. No interviene ningún flag.

Qué significa esto para los desarrolladores

Compruebe si su configuración cae en alguna de las filas "no" de arriba. Los equipos que desactivan la telemetría por política de empresa y los que acceden a Claude a través de un proveedor de nube son los casos probables. Si le aplica alguno, asuma que AGENTS.md no se está leyendo, digan lo que digan las notas de la versión.

La importación de una línea en CLAUDE.md es la opción segura por ahora. Cuesta un solo archivo pequeño y se comporta igual en todas las configuraciones. Si borró un CLAUDE.md tras la versión 2.1.277, vuelva a poner uno mínimo.

Pruebe las instrucciones en lugar de confiar en ellas. Pida al agente que repita una regla que solo existe en AGENTS.md, como su comando de pruebas. Si no puede, el archivo no se cargó. Hágalo una vez por cada entorno que use su equipo.

Siga la issue #95690 a la espera de un arreglo. La lección más amplia es que el comportamiento de una herramienta puede depender de interruptores que no se ven. Mantener las instrucciones en un archivo que la herramienta siempre lee es la opción fiable.