Claude Code 2.1.277 añadió soporte para el archivo AGENTS.md, un recurso local que contiene instrucciones para agentes de inteligencia artificial. Sin embargo, esta funcionalidad está condicionada a que la telemetría esté activada, ya que el cargador de AGENTS.md depende de una bandera remota que se consulta en línea.
Condición para la lectura de AGENTS.md
Según informó el desarrollador en un análisis detallado, el plugin que permite leer AGENTS.md está desactivado por defecto y requiere una bandera remota llamada tengu_agents_md_mod para activarse. Cuando la telemetría o el tráfico no esencial están deshabilitados mediante variables de entorno como CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1 o DISABLE_TELEMETRY=1, el archivo AGENTS.md no se carga, sin que se emita ninguna advertencia al usuario.
Impacto en usuarios y equipos
Esta limitación afecta especialmente a usuarios y equipos que desactivan la telemetría por motivos de privacidad o políticas internas, ya que pierden la capacidad de que Claude Code lea instrucciones locales importantes sin saberlo. El desarrollador critica que esta dependencia de una bandera remota para leer un archivo local es inaceptable, pues la lectura de archivos locales no debería depender de la telemetría ni de servidores externos.
Alternativas y recomendaciones
Como solución temporal, se recomienda usar un archivo CLAUDE.md con una línea que importe AGENTS.md, ya que este método funciona incluso con la telemetría desactivada, aunque implica mantener un archivo adicional por repositorio. Además, se sugiere que Anthropic, la empresa detrás de Claude Code, implemente una advertencia visible cuando AGENTS.md sea detectado pero no leído debido a la configuración de telemetría.
Contexto y comparativa
Otras plataformas como Bedrock y Vertex presentan problemas similares, ya que también dependen de esta bandera remota para activar la lectura de AGENTS.md, afectando a usuarios que bloquean el tráfico no esencial. En contraste, Codex, otro sistema de agentes, soporta archivos globales y locales sin esta dependencia, facilitando la gestión de instrucciones compartidas.
