EL MUNDO NO SE DETIENE.RSS
BIG CHANGE.
BIG CHANGE, a un toque
BIG CHANGE, a un toque

Haz sitio para una visión amplia.

Agrega BIG CHANGE a tu pantalla de inicio o escritorio. Se abre en su propia ventana, con las historias más recientes cuando estás en línea.

iPhone y iPad
Abre bigchange.ai en Safari. Toca Compartir y luego Agregar a inicio. Activa Abrir como app web si aparece y después toca Agregar.
Android
Abre bigchange.ai en Chrome. En el menú del navegador, elige «Instalar aplicación» o «Añadir a la pantalla de inicio».
Escritorio
En Chrome o Edge, usa el icono de instalación de la barra de direcciones o el menú de aplicaciones del navegador. En Safari para Mac, elige Archivo → Añadir al Dock.

Edición en Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Claude Code puede omitir AGENTS.md si la telemetría está desactivada

> La compatibilidad nativa de Claude Code con AGENTS.md depende de la versión, el acceso a indicadores de funciones, el proveedor y la precedencia de archivos. Las filas de telemetría del complemento agents-md publicado omiten las rutas y el texto de los archivos.

By BIG CHANGE Editorial

Published: 2026-09-23T13:54:58.721Z
Updated: 2026-09-23T13:54:58.721Z
Canonical: https://bigchange.ai/blog/claude-code-agents-md-telemetry-feature-flags

![A desktop monitor shows a minimal project-instructions view with plain AGENTS.md and CLAUDE.md labels above a keyboard and mouse.](https://bigchange.ai/api/media/file/claude-code-project-instructions-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

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.md` está 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.md` como alternativa compatible.

## Qué confirman el lanzamiento y el informe

Las [notas de la versión 2.1.277](https://github.com/anthropics/claude-code/releases/tag/v2.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](https://code.claude.com/docs/en/memory) 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,](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) 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](https://code.claude.com/docs/en/env-vars) 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](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) 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](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) 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](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) 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 |
| --- | --- |
| `AGENTS.md`, sin un archivo de instrucciones de Claude en el proyecto | `AGENTS.md` se carga |
| Archivo de proyecto `CLAUDE.md`, `.claude/CLAUDE.md` o `CLAUDE.local.md` en el directorio de trabajo o en un directorio superior | La carga directa de `AGENTS.md` cede prioridad ante esos archivos |
| Archivo de usuario o administrado `CLAUDE.md`, o `.claude/rules/` | No desplazan a `AGENTS.md` |

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í.

## Sources

- [Claude Code lee AGENTS.md solo si la telemetría está activada](https://blog.szypowi.cz/p/claude-code-reads-agents.md-only-when-telemetry-is-on) — Pruebas canary de la versión 2.1.280 y alternativa descritas por Przemek Szypowski. BIG CHANGE no reprodujo la prueba con el modelo de pago; el artículo distingue sus observaciones de la documentación oficial del producto y de la interpretación de las fuentes.
- [Claude Code v2.1.277: lanzamiento](https://github.com/anthropics/claude-code/releases/tag/v2.1.277) — Registro oficial del lanzamiento que incorporó la compatibilidad con AGENTS.md y excluyó Bedrock, Vertex y Foundry de su disponibilidad inicial.
- [Cómo recuerda Claude tu proyecto](https://code.claude.com/docs/en/memory) — Documentación oficial vigente sobre la versión mínima, la precedencia de archivos, los modos de instrucciones del proyecto, las condiciones en las que la función no está disponible, los diagnósticos y la alternativa de importación con CLAUDE.md.
- [Variables de entorno de Claude Code](https://code.claude.com/docs/en/env-vars) — Documentación oficial vigente que explica que desactivar la telemetría también desactiva la obtención de indicadores de funciones, lo que impide la carga directa de AGENTS.md, y enumera otras sesiones afectadas.
- [Código y funcionamiento del complemento integrado agents-md de Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/README.md) — Descripción del código publicado sobre los modos de archivo de instrucciones, la precedencia y las filas de telemetría opcionales. Indica que esas filas contienen recuentos y opciones predefinidas, no rutas ni texto de archivos.
- [Complementos integrados de Claude Code, v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/README.md) — Resumen publicado que confirma que la telemetría y agents-md son complementos integrados independientes y que el código etiquetado se distribuye dentro de Claude Code.
- [Módulo de registro de agents-md, Claude Code v2.1.280](https://github.com/anthropics/claude-code/blob/v2.1.280/mods/agents-md/hooks/register.ts) — Código de registro publicado, consultado junto con el README. Sus bytes coincidían con los del archivo correspondiente en main cuando se comprobaron el 23 de septiembre.