Claude Code: el soporte de AGENTS.md depende de las telemetrías y falla en silencio
Un usuario detecta que la función solo opera con telemetría activa, rompiendo la promesa de soporte local para instrucciones compartidas.
Claude Code 2.1.277 anunció el soporte para AGENTS.md como alternativa a CLAUDE.md, pero la implementación tiene un fallo grave: el archivo solo se carga si la telemetría está habilitada. Un desarrollador ha documentado en el issue #95690 cómo la función se bloquea silenciosamente cuando se desactivan las variables de telemetría, dejando a los usuarios creyendo que el modelo ignora sus instrucciones.
El problema reside en cómo está empaquetado el soporte. El lector de AGENTS.md se entrega como un plugin integrado llamado agents-md. En el código de la versión 2.1.280, la disponibilidad del plugin depende de una bandera remota llamada tengu_agents_md_mod. Si Claude Code no puede recuperar esa bandera porque el tráfico no esencial está bloqueado, el plugin se marca como no disponible y el archivo local nunca se lee, independientemente de que exista en el directorio de trabajo.
Las pruebas son concluyentes: establecer CLAUDE_CODE_DISABLE_NONESSSENTIAL_TRAFFIC=1 o DISABLE_TELEMETRY=1 impide la carga de instrucciones. Contradice la documentación, que sugiere que cualquier valor en las variables de entorno cuenta, y los ajustes a nivel de proyecto en .claude/settings.json no tienen efecto. La única forma de forzar la carga es pasar una configuración de sesión específica que limpie estas variables, pero esto no resuelve el problema para entornos gestionados por políticas corporativas.
Este fallo afecta directamente a equipos que utilizan Bedrock, Vertex o gateways de terceros, donde el bloqueo de tráfico no esencial es estándar por razones de privacidad y seguridad. Al no poder resolver la bandera remota, la función aparece en los anuncios pero no opera en la práctica. Lo más preocupante es que no se emite ninguna advertencia: la sesión arranca, el modelo responde sin las instrucciones del proyecto y el desarrollador debe invertir tiempo en depurar prompts que en realidad nunca llegaron al modelo.
La solución temporal propuesta es crear un CLAUDE.md de una sola línea que importe el archivo AGENTS.md usando la sintaxis @AGENTS.md. Dado que las importaciones no dependen de la bandera remota, esto fuerza la carga del contenido incluso con telemetría desactivada. El coste es mantener un archivo adicional por repositorio, justo lo que el soporte nativo de AGENTS.md pretendía eliminar.
El autor del informe critica que una configuración de privacidad no debería desactivar funciones locales que no requieren red. Pide que, si la bandera remota se mantiene para un despliegue gradual, el comportamiento por defecto al fallar la conexión sea cargar el archivo o, al menos, mostrar un mensaje visible indicando qué instrucciones se han omitido y por qué. También señala la ausencia de un archivo AGENTS.md global a nivel de usuario, algo que sí existe en herramientas como Codex.
